diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..d6122cd
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,34 @@
+# Docker runtime files
+data/dispensa.db
+data/*.db-wal
+data/*.db-shm
+data/backups/
+data/cron.log
+data/smart_shopping_cache.json
+data/bring_token.json
+data/bring_catalog.json
+data/dupliclick_token.json
+data/client_debug.log
+data/*.crt
+data/*.pem
+
+# Config (mounted as volume)
+.env
+
+# Git
+.git
+.gitignore
+
+# Docs (not needed in container)
+README.md
+CHANGELOG.md
+CONTRIBUTING.md
+LICENSE
+docs/
+*.md
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..d6ab44b
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,88 @@
+name: CI
+
+on:
+ push:
+ branches: [main, develop]
+ pull_request:
+ branches: [main]
+
+jobs:
+ lint-php:
+ name: PHP Syntax Check
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: '8.2'
+ extensions: pdo_sqlite, curl, mbstring
+
+ - name: Check PHP syntax
+ run: |
+ find api/ -name '*.php' -exec php -l {} \;
+
+ lint-js:
+ name: JavaScript Lint
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Check JS syntax
+ run: |
+ node -c assets/js/app.js
+
+ docker-build:
+ name: Docker Build Test
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Build Docker image
+ run: docker build -t dispensa-test .
+
+ - name: Test container starts
+ run: |
+ docker run -d --name test-dispensa -p 8080:80 dispensa-test
+ sleep 5
+ curl -f http://localhost:8080/ || exit 1
+ docker stop test-dispensa
+
+ validate-translations:
+ name: Validate Translation Files
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Validate JSON syntax
+ run: |
+ for f in translations/*.json; do
+ echo "Checking $f..."
+ python3 -c "import json; json.load(open('$f'))" || exit 1
+ done
+ echo "All translation files valid."
+
+ - name: Check translation completeness
+ run: |
+ python3 -c "
+ import json, sys
+ base = json.load(open('translations/it.json'))
+ base_keys = set(base.keys())
+ ok = True
+ import glob
+ for f in glob.glob('translations/*.json'):
+ if 'it.json' in f:
+ continue
+ lang = json.load(open(f))
+ lang_keys = set(lang.keys())
+ missing = base_keys - lang_keys
+ if missing:
+ print(f'{f}: {len(missing)} missing keys')
+ for k in sorted(missing)[:10]:
+ print(f' - {k}')
+ if len(missing) > 10:
+ print(f' ... and {len(missing)-10} more')
+ else:
+ print(f'{f}: complete ✓')
+ "
diff --git a/.gitignore b/.gitignore
index 308f760..36ad6c6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,6 +12,7 @@ data/bring_token.json
data/bring_catalog.json
data/dupliclick_token.json
data/client_debug.log
+data/rate_limits/
# SSL certificates (local only)
data/*.crt
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..f306e87
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,141 @@
+# Contributing to Dispensa Manager
+
+Thank you for your interest in contributing! This guide will help you get started.
+
+## 🚀 Getting Started
+
+1. **Fork** the repository
+2. **Clone** your fork:
+ ```bash
+ git clone https://github.com/YOUR_USERNAME/dispensa.git
+ cd dispensa
+ ```
+3. **Create a branch** from `develop`:
+ ```bash
+ git checkout develop
+ git checkout -b feature/your-feature-name
+ ```
+4. **Set up** your development environment:
+ ```bash
+ cp .env.example .env
+ # Edit .env with your API keys
+ php -S localhost:8080
+ ```
+
+## 📐 Project Structure
+
+```
+├── index.html # Single-page app (all HTML)
+├── api/
+│ ├── index.php # API router + all endpoint functions
+│ ├── database.php # SQLite schema + migrations
+│ └── cron_smart_shopping.php
+├── assets/
+│ ├── js/app.js # All application JavaScript
+│ └── css/style.css # All styles
+├── translations/ # i18n translation files
+│ ├── it.json # Italian (base language)
+│ ├── en.json # English
+│ └── ...
+└── data/ # Runtime data (gitignored)
+```
+
+## 🌍 Contributing Translations
+
+Translations are one of the easiest ways to contribute! Each language is a single JSON file in the `translations/` directory.
+
+### Adding a new language
+
+1. Copy `translations/it.json` (the base language)
+2. Rename it to your language code (e.g., `fr.json`, `de.json`, `es.json`)
+3. Translate all the values (keep the keys unchanged)
+4. Submit a Pull Request
+
+### Translation file format
+
+```json
+{
+ "app.title": "Dispensa Manager",
+ "nav.dashboard": "Dashboard",
+ "nav.inventory": "Inventario",
+ ...
+}
+```
+
+**Rules:**
+- Keys are in English, dot-separated (`section.key`)
+- Values are the translated strings
+- Keep `{0}`, `{1}` placeholders — they are filled dynamically
+- Don't translate brand names (Bring!, Gemini, etc.)
+- The CI pipeline will check your file for missing keys
+
+### Language codes
+
+Use [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) two-letter codes:
+`it`, `en`, `de`, `fr`, `es`, `pt`, `nl`, `pl`, `ru`, `ja`, `zh`, `ko`, etc.
+
+## 🔧 Development Guidelines
+
+### Code Style
+- **PHP**: PSR-12 compatible, use type hints where practical
+- **JavaScript**: No build tools, vanilla ES6+, single-file architecture
+- **CSS**: Mobile-first, use CSS custom properties from `:root`
+- **Comments**: English only, concise
+
+### Commits
+- Use descriptive commit messages
+- Reference issue numbers when applicable: `Fix #42: barcode scanner timeout`
+- Keep commits focused on a single change
+
+### Branching
+- `main` — stable releases only
+- `develop` — active development (PRs target here)
+- `feature/*` — new features
+- `fix/*` — bug fixes
+- `i18n/*` — translation contributions
+
+## 🧪 Testing
+
+Before submitting a PR:
+
+```bash
+# Check PHP syntax
+php -l api/index.php
+php -l api/database.php
+
+# Check JS syntax
+node -c assets/js/app.js
+
+# Validate translation files
+python3 -c "import json; json.load(open('translations/it.json'))"
+
+# Test Docker build
+docker build -t dispensa-test .
+```
+
+## 📝 Pull Request Process
+
+1. Ensure your code passes all CI checks
+2. Update `CHANGELOG.md` if applicable
+3. Target the `develop` branch
+4. Provide a clear description of your changes
+5. Link any related issues
+
+## 🐛 Reporting Bugs
+
+Open an issue with:
+- Steps to reproduce
+- Expected vs. actual behavior
+- Browser/device information
+- Screenshots if applicable
+
+## 💡 Feature Requests
+
+Open an issue with the `enhancement` label. Describe:
+- The problem you're trying to solve
+- Your proposed solution
+- Any alternatives you've considered
+
+## 📄 License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..795f13a
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,41 @@
+FROM php:8.2-apache
+
+# Install required PHP extensions
+RUN apt-get update && apt-get install -y \
+ libsqlite3-dev \
+ libcurl4-openssl-dev \
+ && docker-php-ext-install pdo_sqlite curl mbstring \
+ && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Enable Apache mod_rewrite
+RUN a2enmod rewrite
+
+# Set working directory
+WORKDIR /var/www/html
+
+# Copy application files
+COPY . /var/www/html/
+
+# Create data directory with proper permissions
+RUN mkdir -p /var/www/html/data/backups \
+ && chown -R www-data:www-data /var/www/html/data \
+ && chmod -R 775 /var/www/html/data
+
+# Create .env from example if it doesn't exist (will be overridden by volume mount)
+RUN [ ! -f /var/www/html/.env ] && cp /var/www/html/.env.example /var/www/html/.env || true
+
+# Apache configuration: serve from app root
+RUN echo '\n\
+ AllowOverride All\n\
+ Require all granted\n\
+' > /etc/apache2/conf-available/dispensa.conf \
+ && a2enconf dispensa
+
+# Expose port 80
+EXPOSE 80
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
+ CMD curl -f http://localhost/ || exit 1
+
+CMD ["apache2-foreground"]
diff --git a/README.md b/README.md
index 29969bb..db1886a 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,14 @@
[](LICENSE)
[](https://www.php.net/)
[](https://www.sqlite.org/)
+[](Dockerfile)
+[](translations/)
+
---
@@ -63,6 +67,25 @@
### Installation
+#### Option A: Docker (recommended)
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/dadaloop82/dispensa.git
+cd dispensa
+
+# 2. Create configuration file
+cp .env.example .env
+nano .env
+
+# 3. Start with Docker Compose
+docker compose up -d
+
+# → Open http://localhost:8080
+```
+
+#### Option B: Manual
+
```bash
# 1. Clone the repository
git clone https://github.com/dadaloop82/dispensa.git
@@ -248,16 +271,30 @@ The application uses no build tools — edit files directly and refresh.
- [ ] Multi-language support (i18n)
- [ ] User authentication / multi-user support
- [ ] Docker container for easy deployment
-- [ ] REST API documentation (OpenAPI/Swagger)
+- [x] REST API documentation (OpenAPI/Swagger) — see [docs/openapi.yaml](docs/openapi.yaml)
- [ ] Offline mode with service worker
- [ ] Export/import inventory data
- [ ] Notification system (Telegram, email) for expiring products
---
+## 🌐 Translations
+
+The app supports multiple languages via JSON translation files in the `translations/` folder.
+
+| Language | Status |
+|----------|--------|
+| 🇮🇹 Italian (it) | ✅ Complete (base) |
+| 🇬🇧 English (en) | ✅ Complete |
+| 🇩🇪 German (de) | ✅ Complete |
+
+**Want to add your language?** See the [Translation Guide](CONTRIBUTING.md#-adding-translations) — just copy `translations/it.json`, translate the values, and submit a PR!
+
+---
+
## 🤝 Contributing
-Contributions are welcome! Please:
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/my-feature`)
diff --git a/api/index.php b/api/index.php
index 5c0ba01..678e876 100644
--- a/api/index.php
+++ b/api/index.php
@@ -52,6 +52,74 @@ if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
exit;
}
+// ===== RATE LIMITING =====
+/**
+ * Simple file-based rate limiter.
+ * Limits: 120 req/min general, 15 req/min for AI endpoints, 5 req/min for login.
+ */
+function checkRateLimit(string $action): void {
+ $rateLimitDir = __DIR__ . '/../data/rate_limits';
+ if (!is_dir($rateLimitDir)) {
+ mkdir($rateLimitDir, 0755, true);
+ }
+
+ // Determine limit based on action
+ $aiActions = ['gemini_readExpiry', 'gemini_chat', 'gemini_identify', 'gemini_suggest_shopping'];
+ $loginActions = ['dupliclick_login'];
+
+ if (in_array($action, $aiActions)) {
+ $limit = 15;
+ $window = 60;
+ $bucket = 'ai';
+ } elseif (in_array($action, $loginActions)) {
+ $limit = 5;
+ $window = 60;
+ $bucket = 'login';
+ } else {
+ $limit = 120;
+ $window = 60;
+ $bucket = 'general';
+ }
+
+ $ip = $_SERVER['REMOTE_ADDR'] ?? '127.0.0.1';
+ $file = $rateLimitDir . '/' . md5($ip . '_' . $bucket) . '.json';
+
+ // Clean up old rate limit files periodically (1% chance per request)
+ if (mt_rand(1, 100) === 1) {
+ foreach (glob($rateLimitDir . '/*.json') as $f) {
+ if (filemtime($f) < time() - 300) @unlink($f);
+ }
+ }
+
+ $now = time();
+ $data = [];
+ if (file_exists($file)) {
+ $raw = @file_get_contents($file);
+ if ($raw) $data = json_decode($raw, true) ?: [];
+ }
+
+ // Remove entries outside the window
+ $data = array_values(array_filter($data, function($ts) use ($now, $window) {
+ return $ts > $now - $window;
+ }));
+
+ if (count($data) >= $limit) {
+ http_response_code(429);
+ header('Retry-After: ' . $window);
+ echo json_encode(['error' => 'Too many requests. Please try again later.']);
+ exit;
+ }
+
+ $data[] = $now;
+ @file_put_contents($file, json_encode($data), LOCK_EX);
+}
+
+// Apply rate limiting
+$rateLimitAction = $_GET['action'] ?? '';
+if ($rateLimitAction) {
+ checkRateLimit($rateLimitAction);
+}
+
try {
$db = getDB();
} catch (Exception $e) {
diff --git a/assets/css/style.css b/assets/css/style.css
index 1a2973b..ee895da 100644
--- a/assets/css/style.css
+++ b/assets/css/style.css
@@ -5072,3 +5072,113 @@ body {
background: rgba(255,255,255,0.25);
transform: scale(0.92);
}
+
+/* ===== SETUP WIZARD ===== */
+.setup-wizard-content {
+ max-width: 480px;
+ width: 95%;
+ margin: auto;
+ border-radius: 20px;
+ overflow: hidden;
+ max-height: 90vh;
+ display: flex;
+ flex-direction: column;
+}
+.setup-header {
+ background: var(--primary);
+ color: #fff;
+ padding: 24px 20px 16px;
+ text-align: center;
+}
+.setup-header h2 {
+ margin: 0 0 12px;
+ font-size: 1.5rem;
+}
+.setup-progress {
+ display: flex;
+ gap: 8px;
+ justify-content: center;
+}
+.setup-dot {
+ width: 10px;
+ height: 10px;
+ border-radius: 50%;
+ background: rgba(255,255,255,0.3);
+ transition: background 0.3s, transform 0.3s;
+}
+.setup-dot.active {
+ background: #fff;
+ transform: scale(1.3);
+}
+.setup-dot.done {
+ background: var(--success-light);
+}
+.setup-body {
+ padding: 24px 20px;
+ overflow-y: auto;
+ flex: 1;
+}
+.setup-body h3 {
+ margin: 0 0 8px;
+ font-size: 1.2rem;
+}
+.setup-body p {
+ color: #666;
+ margin: 0 0 16px;
+ font-size: 0.9rem;
+ line-height: 1.5;
+}
+.setup-body .form-group {
+ margin-bottom: 16px;
+}
+.setup-body .form-input {
+ width: 100%;
+ box-sizing: border-box;
+}
+.setup-lang-grid {
+ display: grid;
+ grid-template-columns: repeat(auto-fill, minmax(130px, 1fr));
+ gap: 10px;
+ margin: 12px 0;
+}
+.setup-lang-btn {
+ padding: 14px 12px;
+ border: 2px solid #e2e8f0;
+ border-radius: 12px;
+ background: #fff;
+ cursor: pointer;
+ text-align: center;
+ font-size: 1rem;
+ transition: border-color 0.2s, background 0.2s;
+}
+.setup-lang-btn.selected {
+ border-color: var(--primary);
+ background: rgba(45,80,22,0.08);
+}
+.setup-lang-btn:hover {
+ border-color: var(--primary-light);
+}
+.setup-footer {
+ padding: 16px 20px;
+ display: flex;
+ justify-content: space-between;
+ border-top: 1px solid #e2e8f0;
+ gap: 12px;
+}
+.setup-footer .btn {
+ flex: 1;
+ padding: 12px;
+ font-size: 1rem;
+}
+.setup-skip-link {
+ display: block;
+ text-align: center;
+ color: #999;
+ font-size: 0.8rem;
+ margin-top: 12px;
+ cursor: pointer;
+ text-decoration: underline;
+}
+.setup-skip-link:hover {
+ color: #666;
+}
diff --git a/assets/img/screenshots/README.md b/assets/img/screenshots/README.md
new file mode 100644
index 0000000..27659d2
--- /dev/null
+++ b/assets/img/screenshots/README.md
@@ -0,0 +1,31 @@
+# Screenshots
+
+Add screenshots here to showcase the app in the README.
+
+## Recommended screenshots
+
+Take screenshots of these pages for the README `Screenshots` section:
+
+1. **dashboard.png** — Main dashboard with stats cards and expiry alerts
+2. **inventory.png** — Inventory list with product cards
+3. **scan.png** — Barcode scanning page
+4. **recipe.png** — Generated recipe with cooking mode
+5. **shopping.png** — Shopping list with smart predictions
+6. **chat.png** — Gemini Chef AI conversation
+7. **settings.png** — Settings page
+8. **setup.png** — First-run setup wizard
+
+## How to add
+
+1. Take screenshots on a mobile device or using Chrome DevTools device emulation
+2. Recommended size: 375×812 (iPhone X viewport)
+3. Save as PNG with descriptive names
+4. Update the README.md `## Screenshots` section to reference them:
+
+```markdown
+## Screenshots
+
+| Dashboard | Inventory | Scan |
+|:-:|:-:|:-:|
+|  |  |  |
+```
diff --git a/assets/js/app.js b/assets/js/app.js
index bd14c47..33a7f5b 100644
--- a/assets/js/app.js
+++ b/assets/js/app.js
@@ -57,6 +57,123 @@ window.addEventListener('unhandledrejection', function(e) {
// ===== CONFIGURATION =====
const API_BASE = 'api/index.php';
+
+// ===== i18n TRANSLATION SYSTEM =====
+let _i18nStrings = null; // current language translations (flat)
+let _i18nFallback = null; // Italian fallback (flat)
+let _currentLang = localStorage.getItem('dispensa_lang') || navigator.language?.slice(0, 2) || 'it';
+const _SUPPORTED_LANGS = { it: 'Italiano', en: 'English', de: 'Deutsch' };
+if (!_SUPPORTED_LANGS[_currentLang]) _currentLang = 'it';
+
+// Flatten nested JSON: { a: { b: "x" } } → { "a.b": "x" }
+function _flattenI18n(obj, prefix = '') {
+ const result = {};
+ for (const [k, v] of Object.entries(obj)) {
+ const key = prefix ? `${prefix}.${k}` : k;
+ if (v && typeof v === 'object' && !Array.isArray(v)) {
+ Object.assign(result, _flattenI18n(v, key));
+ } else {
+ result[key] = v;
+ }
+ }
+ return result;
+}
+
+// Translation function: t('toast.thrown_away', {name: 'Latte'})
+function t(key, params) {
+ let str = (_i18nStrings && _i18nStrings[key]) || (_i18nFallback && _i18nFallback[key]) || key;
+ if (params) {
+ for (const [k, v] of Object.entries(params)) {
+ str = str.replace(new RegExp(`\\{${k}\\}`, 'g'), v);
+ }
+ }
+ return str;
+}
+
+// Load translations from JSON files
+async function loadTranslations(lang) {
+ lang = lang || _currentLang;
+ try {
+ // Always load Italian as fallback
+ if (!_i18nFallback) {
+ const fbRes = await fetch(`translations/it.json?v=${Date.now()}`);
+ if (fbRes.ok) _i18nFallback = _flattenI18n(await fbRes.json());
+ }
+ if (lang === 'it') {
+ _i18nStrings = _i18nFallback;
+ } else {
+ const res = await fetch(`translations/${encodeURIComponent(lang)}.json?v=${Date.now()}`);
+ if (res.ok) _i18nStrings = _flattenI18n(await res.json());
+ else _i18nStrings = _i18nFallback;
+ }
+ _currentLang = lang;
+ localStorage.setItem('dispensa_lang', lang);
+ _applyI18nToLabels();
+ translatePage();
+ } catch (e) {
+ console.warn('i18n: Failed to load translations for', lang, e);
+ _i18nStrings = _i18nFallback;
+ }
+}
+
+// Update LOCATIONS / SHOPPING_SECTIONS labels from translations
+function _applyI18nToLabels() {
+ if (!_i18nStrings) return;
+ for (const key of Object.keys(LOCATIONS)) {
+ const tKey = `locations.${key}`;
+ if (_i18nStrings[tKey]) LOCATIONS[key].label = _i18nStrings[tKey];
+ }
+ for (const sec of SHOPPING_SECTIONS) {
+ const tKey = `shopping_sections.${sec.key}`;
+ if (_i18nStrings[tKey]) sec.label = _i18nStrings[tKey];
+ }
+}
+
+// Translate all elements with data-i18n attributes
+function translatePage() {
+ document.querySelectorAll('[data-i18n]').forEach(el => {
+ const key = el.getAttribute('data-i18n');
+ if (key) el.textContent = t(key);
+ });
+ document.querySelectorAll('[data-i18n-html]').forEach(el => {
+ const key = el.getAttribute('data-i18n-html');
+ if (key) el.innerHTML = t(key);
+ });
+ document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
+ const key = el.getAttribute('data-i18n-placeholder');
+ if (key) el.placeholder = t(key);
+ });
+ document.querySelectorAll('[data-i18n-title]').forEach(el => {
+ const key = el.getAttribute('data-i18n-title');
+ if (key) el.title = t(key);
+ });
+ // Update HTML lang attribute
+ document.documentElement.lang = _currentLang;
+ // Populate language selector if present
+ _populateLanguageSelector();
+}
+
+// Populate the language selector dropdown
+function _populateLanguageSelector() {
+ const sel = document.getElementById('setting-language');
+ if (!sel) return;
+ sel.innerHTML = '';
+ for (const [code, name] of Object.entries(_SUPPORTED_LANGS)) {
+ const opt = document.createElement('option');
+ opt.value = code;
+ opt.textContent = name;
+ if (code === _currentLang) opt.selected = true;
+ sel.appendChild(opt);
+ }
+}
+
+// Change language and reload the page
+function changeLanguage(lang) {
+ if (lang === _currentLang) return;
+ localStorage.setItem('dispensa_lang', lang);
+ location.reload();
+}
+
const LOCATIONS = {
'dispensa': { icon: '🗄️', label: 'Dispensa' },
'frigo': { icon: '🧊', label: 'Frigo' },
@@ -822,21 +939,21 @@ function addAppliance() {
const s = getSettings();
if (!s.appliances) s.appliances = [];
if (s.appliances.some(a => a.toLowerCase() === name.toLowerCase())) {
- showToast('Elettrodomestico già presente', 'error');
+ showToast(t('error.appliance_exists'), 'error');
return;
}
s.appliances.push(name);
saveSettingsToStorage(s);
renderAppliances(s.appliances);
input.value = '';
- showToast('Elettrodomestico aggiunto', 'success');
+ showToast(t('toast.appliance_added'), 'success');
}
function addApplianceQuick(name) {
const s = getSettings();
if (!s.appliances) s.appliances = [];
if (s.appliances.some(a => a.toLowerCase() === name.toLowerCase())) {
- showToast('Già presente', 'error');
+ showToast(t('error.already_exists'), 'error');
return;
}
s.appliances.push(name);
@@ -1364,7 +1481,7 @@ function confirmReviewItem(inventoryId) {
}
}, 300);
}
- showToast('✓ Quantità confermata', 'success');
+ showToast(t('toast.quantity_confirmed'), 'success');
}
function editReviewItem(inventoryId, productId) {
@@ -1747,7 +1864,7 @@ async function quickUse(productId, location) {
} catch (err) {
showLoading(false);
console.error('quickUse error:', err);
- showToast('Errore nel caricamento del prodotto', 'error');
+ showToast(t('error.loading'), 'error');
}
}
@@ -1755,7 +1872,7 @@ async function deleteInventoryItem(id) {
if (confirm('Vuoi davvero rimuovere questo prodotto dall\'inventario?')) {
await api('inventory_delete', {}, 'POST', { id });
closeModal();
- showToast('Prodotto rimosso', 'success');
+ showToast(t('toast.product_removed'), 'success');
refreshCurrentPage();
}
}
@@ -1779,7 +1896,7 @@ function editInventoryItem(id) {
const item = currentInventory.find(i => i.id === id);
if (!item) {
closeModal();
- showToast('Prodotto non trovato', 'error');
+ showToast(t('error.not_found'), 'error');
return;
}
@@ -2359,7 +2476,7 @@ function submitManualBarcode() {
const input = document.getElementById('manual-barcode-input');
const barcode = (input.value || '').trim();
if (!barcode) {
- showToast('Inserisci un codice a barre', 'error');
+ showToast(t('error.barcode_empty'), 'error');
input.focus();
return;
}
@@ -2377,7 +2494,7 @@ async function submitQuickName() {
const input = document.getElementById('quick-product-name');
const name = (input.value || '').trim();
if (!name || name.length < 2) {
- showToast('Scrivi almeno 2 caratteri', 'error');
+ showToast(t('error.min_chars'), 'error');
input.focus();
return;
}
@@ -2402,7 +2519,7 @@ async function submitQuickName() {
} catch (err) {
showLoading(false);
console.error('Quick name search error:', err);
- showToast('Errore nella ricerca', 'error');
+ showToast(t('error.search_short'), 'error');
}
}
@@ -2506,7 +2623,7 @@ async function createQuickProduct(name) {
} catch (err) {
showLoading(false);
console.error('Quick product creation error:', err);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -2794,7 +2911,7 @@ async function submitProduct(e) {
}
} catch (err) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -3270,7 +3387,7 @@ async function deleteActionInventoryItem(id) {
if (confirm('Vuoi davvero rimuovere questo prodotto dall\'inventario?')) {
await api('inventory_delete', {}, 'POST', { id });
closeModal();
- showToast('Prodotto rimosso', 'success');
+ showToast(t('toast.product_removed'), 'success');
showProductAction(); // Refresh the action page
}
}
@@ -3371,7 +3488,7 @@ async function throwAll() {
}
} catch(e) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -3396,7 +3513,7 @@ async function throwPartial() {
}
} catch(e) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -3412,7 +3529,7 @@ function toggleActionEdit() {
async function saveEditedProductInfo() {
const name = (document.getElementById('edit-action-name')?.value || '').trim();
if (!name) {
- showToast('Inserisci il nome del prodotto', 'error');
+ showToast(t('product.name_required'), 'error');
document.getElementById('edit-action-name')?.focus();
return;
}
@@ -3446,7 +3563,7 @@ async function saveEditedProductInfo() {
}
} catch (err) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -3915,7 +4032,7 @@ async function submitAdd(e) {
}
showToast(`✅ ${currentProduct.name} aggiunto!${qtyInfo}`, 'success');
if (result.removed_from_bring) {
- setTimeout(() => showToast('🛒 Rimosso dalla lista della spesa', 'info'), 1500);
+ setTimeout(() => showToast(t('toast.removed_from_shopping'), 'info'), 1500);
} else if (shoppingItems.length > 0 && shoppingListUUID) {
// PHP matching may have missed the item (custom name / no catalog match) —
// try a client-side fuzzy remove using the already-loaded shoppingItems
@@ -3928,7 +4045,7 @@ async function submitAdd(e) {
}).then(r => {
if (r && r.success) {
shoppingItems = shoppingItems.filter(i => i !== match);
- setTimeout(() => showToast('🛒 Rimosso dalla lista della spesa', 'info'), 1500);
+ setTimeout(() => showToast(t('toast.removed_from_shopping'), 'info'), 1500);
}
}).catch(() => {});
}
@@ -3961,7 +4078,7 @@ async function submitAdd(e) {
}
} catch (err) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -4384,7 +4501,7 @@ async function addLowStockToBring(productName) {
if (data.success && data.added > 0) {
showToast('🛒 Aggiunto alla lista della spesa!', 'success');
} else if (data.success && data.skipped > 0) {
- showToast('ℹ️ Già nella lista della spesa', 'info');
+ showToast(t('shopping.already_in_list_short'), 'info');
}
} catch (e) {
showToast('Errore nell\'aggiunta a Bring!', 'error');
@@ -4512,7 +4629,7 @@ async function submitUseAll() {
}
} catch (err) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -4556,7 +4673,7 @@ async function submitUse(e) {
}
} catch (err) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -4770,12 +4887,12 @@ async function selectAIMatch(idx) {
showProductAction();
} else {
showLoading(false);
- showToast('Errore nel salvataggio', 'error');
+ showToast(t('error.save'), 'error');
}
} catch (err) {
showLoading(false);
console.error('AI match select error:', err);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -4804,7 +4921,7 @@ async function saveAIProductDirect() {
}
} catch (err) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -5062,7 +5179,7 @@ async function selectProductForAction(productId) {
showProductAction();
} else {
showLoading(false);
- showToast('Prodotto non trovato', 'error');
+ showToast(t('error.not_found'), 'error');
}
} catch (err) {
showLoading(false);
@@ -5663,7 +5780,7 @@ async function addSmartToBring() {
}
} catch (e) {
showLoading(false);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -6191,7 +6308,7 @@ async function removeBringItem(idx) {
if (data.success) {
shoppingItems.splice(idx, 1);
renderShoppingItems();
- showToast('Rimosso dalla lista', 'success');
+ showToast(t('toast.removed_from_list_short'), 'success');
logOperation('bring_manual_remove', { name: item.name });
// Update dashboard shopping count
loadShoppingCount();
@@ -6242,7 +6359,7 @@ async function generateSuggestions() {
btn.disabled = false;
btn.innerHTML = '🤖 Suggerisci cosa comprare';
console.error('Suggestion error:', err);
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -6328,7 +6445,7 @@ async function addSelectedSuggestions() {
showToast(data.error || 'Errore', 'error');
}
} catch (err) {
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
btn.disabled = false;
@@ -7186,7 +7303,7 @@ async function submitRecipeUse(useAll) {
console.error('Recipe use error:', err);
btn.disabled = false;
btn.textContent = '📦 Usa';
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
_recipeUseContext = null;
}
@@ -7921,7 +8038,7 @@ async function generateRecipe() {
console.error('Recipe error:', err);
document.getElementById('recipe-loading').style.display = 'none';
document.getElementById('recipe-ask').style.display = '';
- showToast('Errore di connessione', 'error');
+ showToast(t('error.connection'), 'error');
}
}
@@ -8694,6 +8811,198 @@ function initInactivityWatcher() {
// ===== INITIALIZATION =====
document.addEventListener('DOMContentLoaded', () => {
+ // Load translations first, then initialize the app
+ loadTranslations(_currentLang).then(() => {
+ _initApp();
+ }).catch(() => {
+ _initApp(); // fallback: initialize even if translations fail
+ });
+});
+
+// ===== SETUP WIZARD =====
+let _setupStep = 0;
+const _setupData = { lang: _currentLang, gemini_key: '', bring_email: '', bring_password: '' };
+
+function _isFirstRun() {
+ return !localStorage.getItem('dispensa_setup_done');
+}
+
+function _setupSteps() {
+ return [
+ {
+ title: '🌐 ' + t('settings.language.label'),
+ desc: t('settings.language.hint'),
+ render: () => {
+ let html = '';
+ for (const [code, name] of Object.entries(_SUPPORTED_LANGS)) {
+ const sel = code === _setupData.lang ? ' selected' : '';
+ html += ``;
+ }
+ html += '
';
+ return html;
+ }
+ },
+ {
+ title: '🤖 Google Gemini AI',
+ desc: t('settings.gemini.hint'),
+ render: () => `
+
+ ${t('btn.cancel')} — ${_currentLang === 'it' ? 'configura dopo' : 'configure later'}
+ `
+ },
+ {
+ title: '🛒 Bring! Shopping List',
+ desc: t('settings.bring.hint'),
+ render: () => `
+
+
+
+
+
+
+
+
+ ${t('btn.cancel')} — ${_currentLang === 'it' ? 'configura dopo' : 'configure later'}
+ `
+ },
+ {
+ title: '✅ ' + (_currentLang === 'it' ? 'Tutto pronto!' : _currentLang === 'de' ? 'Alles bereit!' : 'All set!'),
+ desc: _currentLang === 'it' ? 'La configurazione è completata. Puoi sempre modificare queste impostazioni dalla pagina Configurazione.'
+ : _currentLang === 'de' ? 'Die Konfiguration ist abgeschlossen. Du kannst diese Einstellungen jederzeit ändern.'
+ : 'Setup is complete. You can always change these settings from the Settings page.',
+ render: () => {
+ let summary = '🎉
';
+ return summary;
+ }
+ }
+ ];
+}
+
+function showSetupWizard() {
+ _setupStep = 0;
+ document.getElementById('setup-wizard').style.display = '';
+ _renderSetupStep();
+}
+
+function _renderSetupStep() {
+ const steps = _setupSteps();
+ const step = steps[_setupStep];
+
+ // Progress dots
+ const dotsHtml = steps.map((_, i) => {
+ let cls = 'setup-dot';
+ if (i < _setupStep) cls += ' done';
+ if (i === _setupStep) cls += ' active';
+ return ``;
+ }).join('');
+ document.getElementById('setup-progress').innerHTML = dotsHtml;
+
+ // Body
+ document.getElementById('setup-body').innerHTML = `${step.title}
${step.desc}
${step.render()}`;
+
+ // Buttons
+ const prevBtn = document.getElementById('setup-prev');
+ const nextBtn = document.getElementById('setup-next');
+ prevBtn.style.display = _setupStep > 0 ? '' : 'none';
+ prevBtn.textContent = t('btn.back');
+
+ if (_setupStep === steps.length - 1) {
+ nextBtn.textContent = _currentLang === 'it' ? '🚀 Inizia!' : _currentLang === 'de' ? '🚀 Los geht\'s!' : '🚀 Start!';
+ } else {
+ nextBtn.textContent = _currentLang === 'it' ? 'Avanti →' : _currentLang === 'de' ? 'Weiter →' : 'Next →';
+ }
+}
+
+function _setupSelectLang(lang) {
+ _setupData.lang = lang;
+ document.querySelectorAll('.setup-lang-btn').forEach(b => b.classList.remove('selected'));
+ event.target.classList.add('selected');
+}
+
+function _setupSkipStep() {
+ _setupStep++;
+ _renderSetupStep();
+}
+
+function _setupCollectCurrent() {
+ if (_setupStep === 1) {
+ const el = document.getElementById('setup-gemini-key');
+ if (el) _setupData.gemini_key = el.value.trim();
+ } else if (_setupStep === 2) {
+ const email = document.getElementById('setup-bring-email');
+ const pass = document.getElementById('setup-bring-password');
+ if (email) _setupData.bring_email = email.value.trim();
+ if (pass) _setupData.bring_password = pass.value.trim();
+ }
+}
+
+function setupWizardNav(dir) {
+ _setupCollectCurrent();
+ const steps = _setupSteps();
+
+ if (dir === 1 && _setupStep === steps.length - 1) {
+ // Finish wizard
+ _finishSetup();
+ return;
+ }
+
+ // If language changed, apply it
+ if (_setupStep === 0 && dir === 1 && _setupData.lang !== _currentLang) {
+ localStorage.setItem('dispensa_lang', _setupData.lang);
+ localStorage.setItem('dispensa_setup_step', '1');
+ localStorage.setItem('dispensa_setup_data', JSON.stringify(_setupData));
+ location.reload();
+ return;
+ }
+
+ _setupStep = Math.max(0, Math.min(steps.length - 1, _setupStep + dir));
+ _renderSetupStep();
+}
+
+async function _finishSetup() {
+ // Save settings
+ const s = getSettings();
+ if (_setupData.gemini_key) s.gemini_key = _setupData.gemini_key;
+ if (_setupData.bring_email) s.bring_email = _setupData.bring_email;
+ if (_setupData.bring_password) s.bring_password = _setupData.bring_password;
+ saveSettingsToStorage(s);
+
+ // Save server-side settings (.env)
+ try {
+ await api('save_settings', {}, 'POST', {
+ gemini_key: _setupData.gemini_key,
+ bring_email: _setupData.bring_email,
+ bring_password: _setupData.bring_password
+ });
+ } catch(e) { /* will work locally */ }
+
+ localStorage.setItem('dispensa_setup_done', '1');
+ localStorage.removeItem('dispensa_setup_step');
+ localStorage.removeItem('dispensa_setup_data');
+ document.getElementById('setup-wizard').style.display = 'none';
+}
+
+function _initApp() {
+ // Check for setup wizard resume (after language change)
+ const resumeStep = localStorage.getItem('dispensa_setup_step');
+ const resumeData = localStorage.getItem('dispensa_setup_data');
+ if (resumeStep) {
+ try { Object.assign(_setupData, JSON.parse(resumeData)); } catch(e) {}
+ _setupStep = parseInt(resumeStep) || 0;
+ localStorage.removeItem('dispensa_setup_step');
+ localStorage.removeItem('dispensa_setup_data');
+ document.getElementById('setup-wizard').style.display = '';
+ _renderSetupStep();
+ } else if (_isFirstRun()) {
+ showSetupWizard();
+ }
+
// Migrate old session-based flags to time-based
if (sessionStorage.getItem('_autoAddedCritical')) {
sessionStorage.removeItem('_autoAddedCritical');
@@ -8738,7 +9047,7 @@ document.addEventListener('DOMContentLoaded', () => {
// Silent background sync: update urgency specs on Bring and add missing critical items
// Runs once at startup (time-gated: max every 10 min) without affecting the UI
_backgroundBringSync();
-});
+}
/**
* Background sync at startup:
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..fb808bf
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,18 @@
+services:
+ dispensa:
+ build: .
+ container_name: dispensa
+ ports:
+ - "8080:80"
+ volumes:
+ # Persist database and runtime data
+ - dispensa_data:/var/www/html/data
+ # Mount your local .env configuration
+ - ./.env:/var/www/html/.env:ro
+ restart: unless-stopped
+ environment:
+ - TZ=Europe/Rome
+
+volumes:
+ dispensa_data:
+ driver: local
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
new file mode 100644
index 0000000..4e1447e
--- /dev/null
+++ b/docs/openapi.yaml
@@ -0,0 +1,691 @@
+openapi: "3.1.0"
+info:
+ title: Dispensa Manager API
+ description: |
+ REST API for Dispensa Manager — a self-hosted pantry management system.
+ All endpoints use the query parameter `action` to determine the operation.
+
+ **Base URL:** `api/index.php?action={action_name}`
+
+ Rate limits apply:
+ - General: 120 requests/minute
+ - AI endpoints: 15 requests/minute
+ - Login endpoints: 5 requests/minute
+ version: "1.0.0"
+ contact:
+ name: Stimpfl Daniel
+ email: dadaloop82@gmail.com
+ license:
+ name: MIT
+ url: https://opensource.org/licenses/MIT
+
+servers:
+ - url: /api
+ description: Local server
+
+paths:
+ /index.php?action=search_barcode:
+ get:
+ summary: Search product by barcode in local database
+ tags: [Products]
+ parameters:
+ - name: barcode
+ in: query
+ required: true
+ schema:
+ type: string
+ responses:
+ "200":
+ description: Product found
+ content:
+ application/json:
+ schema:
+ $ref: "#/components/schemas/Product"
+ "404":
+ description: Product not found
+
+ /index.php?action=lookup_barcode:
+ get:
+ summary: Lookup barcode on Open Food Facts
+ tags: [Products]
+ parameters:
+ - name: barcode
+ in: query
+ required: true
+ schema:
+ type: string
+ responses:
+ "200":
+ description: Product data from Open Food Facts
+
+ /index.php?action=product_save:
+ post:
+ summary: Create or update a product
+ tags: [Products]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ $ref: "#/components/schemas/ProductInput"
+ responses:
+ "200":
+ description: Product saved
+
+ /index.php?action=product_get:
+ get:
+ summary: Get product by ID
+ tags: [Products]
+ parameters:
+ - name: id
+ in: query
+ required: true
+ schema:
+ type: integer
+ responses:
+ "200":
+ description: Product details
+ content:
+ application/json:
+ schema:
+ $ref: "#/components/schemas/Product"
+
+ /index.php?action=product_delete:
+ post:
+ summary: Delete a product
+ tags: [Products]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ id:
+ type: integer
+ responses:
+ "200":
+ description: Product deleted
+
+ /index.php?action=products_list:
+ get:
+ summary: List all products
+ tags: [Products]
+ responses:
+ "200":
+ description: Array of all products
+ content:
+ application/json:
+ schema:
+ type: array
+ items:
+ $ref: "#/components/schemas/Product"
+
+ /index.php?action=products_search:
+ get:
+ summary: Search products by name
+ tags: [Products]
+ parameters:
+ - name: q
+ in: query
+ required: true
+ schema:
+ type: string
+ responses:
+ "200":
+ description: Matching products
+
+ /index.php?action=inventory_list:
+ get:
+ summary: List all inventory items
+ tags: [Inventory]
+ responses:
+ "200":
+ description: Inventory items grouped by product
+ content:
+ application/json:
+ schema:
+ type: array
+ items:
+ $ref: "#/components/schemas/InventoryItem"
+
+ /index.php?action=inventory_add:
+ post:
+ summary: Add item to inventory
+ tags: [Inventory]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required: [product_id, quantity, location]
+ properties:
+ product_id:
+ type: integer
+ quantity:
+ type: number
+ location:
+ type: string
+ enum: [dispensa, frigo, freezer, altro]
+ expiry_date:
+ type: string
+ format: date
+ conf_size:
+ type: number
+ vacuum:
+ type: boolean
+ responses:
+ "200":
+ description: Item added to inventory
+
+ /index.php?action=inventory_use:
+ post:
+ summary: Use/consume items from inventory
+ tags: [Inventory]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required: [product_id, quantity, location]
+ properties:
+ product_id:
+ type: integer
+ quantity:
+ type: number
+ location:
+ type: string
+ use_all:
+ type: boolean
+ responses:
+ "200":
+ description: Item consumed
+
+ /index.php?action=inventory_update:
+ post:
+ summary: Update an inventory entry
+ tags: [Inventory]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required: [id]
+ properties:
+ id:
+ type: integer
+ quantity:
+ type: number
+ location:
+ type: string
+ expiry_date:
+ type: string
+ format: date
+ responses:
+ "200":
+ description: Inventory entry updated
+
+ /index.php?action=inventory_delete:
+ post:
+ summary: Remove an inventory entry
+ tags: [Inventory]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ required: [id]
+ properties:
+ id:
+ type: integer
+ responses:
+ "200":
+ description: Inventory entry removed
+
+ /index.php?action=inventory_summary:
+ get:
+ summary: Get inventory summary (counts per location)
+ tags: [Inventory]
+ responses:
+ "200":
+ description: Summary object with counts
+
+ /index.php?action=transactions_list:
+ get:
+ summary: List operations log
+ tags: [Log]
+ parameters:
+ - name: limit
+ in: query
+ schema:
+ type: integer
+ default: 50
+ - name: offset
+ in: query
+ schema:
+ type: integer
+ default: 0
+ responses:
+ "200":
+ description: Array of transactions
+
+ /index.php?action=stats:
+ get:
+ summary: Get waste/consumption statistics
+ tags: [Log]
+ responses:
+ "200":
+ description: Statistics for the last 30 days
+
+ /index.php?action=gemini_expiry:
+ post:
+ summary: Use AI to read expiry date from image
+ tags: [AI / Gemini]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ image:
+ type: string
+ description: Base64-encoded image
+ responses:
+ "200":
+ description: Parsed expiry date
+
+ /index.php?action=generate_recipe:
+ post:
+ summary: Generate a recipe based on available ingredients
+ tags: [AI / Gemini]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ persons:
+ type: integer
+ preferences:
+ type: object
+ responses:
+ "200":
+ description: Generated recipe
+
+ /index.php?action=gemini_identify:
+ post:
+ summary: Identify a product from photo using AI
+ tags: [AI / Gemini]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ image:
+ type: string
+ description: Base64-encoded image
+ responses:
+ "200":
+ description: Identified product data
+
+ /index.php?action=gemini_chat:
+ post:
+ summary: Chat with Gemini AI kitchen assistant
+ tags: [AI / Gemini]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ message:
+ type: string
+ history:
+ type: array
+ items:
+ type: object
+ responses:
+ "200":
+ description: AI response
+
+ /index.php?action=bring_list:
+ get:
+ summary: Get Bring! shopping list
+ tags: [Bring! Integration]
+ responses:
+ "200":
+ description: Shopping list items
+
+ /index.php?action=bring_add:
+ post:
+ summary: Add item to Bring! shopping list
+ tags: [Bring! Integration]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ name:
+ type: string
+ spec:
+ type: string
+ responses:
+ "200":
+ description: Item added
+
+ /index.php?action=bring_remove:
+ post:
+ summary: Remove item from Bring! shopping list
+ tags: [Bring! Integration]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ name:
+ type: string
+ responses:
+ "200":
+ description: Item removed
+
+ /index.php?action=bring_suggest:
+ post:
+ summary: Get AI shopping suggestions
+ tags: [Bring! Integration]
+ responses:
+ "200":
+ description: AI-generated shopping suggestions
+
+ /index.php?action=smart_shopping:
+ get:
+ summary: Get smart shopping predictions
+ tags: [Bring! Integration]
+ responses:
+ "200":
+ description: Predicted shopping needs
+
+ /index.php?action=save_settings:
+ post:
+ summary: Save server-side settings (.env values)
+ tags: [Settings]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ responses:
+ "200":
+ description: Settings saved
+
+ /index.php?action=get_settings:
+ get:
+ summary: Get server settings (masked passwords)
+ tags: [Settings]
+ responses:
+ "200":
+ description: Current settings
+
+ /index.php?action=app_settings_get:
+ get:
+ summary: Get application settings from database
+ tags: [Settings]
+ responses:
+ "200":
+ description: App settings object
+
+ /index.php?action=app_settings_save:
+ post:
+ summary: Save application settings to database
+ tags: [Settings]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ responses:
+ "200":
+ description: App settings saved
+
+ /index.php?action=recipes_list:
+ get:
+ summary: List saved recipes
+ tags: [Recipes]
+ responses:
+ "200":
+ description: Array of saved recipes
+
+ /index.php?action=recipes_save:
+ post:
+ summary: Save a recipe
+ tags: [Recipes]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ responses:
+ "200":
+ description: Recipe saved
+
+ /index.php?action=recipes_delete:
+ post:
+ summary: Delete a recipe
+ tags: [Recipes]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ id:
+ type: integer
+ responses:
+ "200":
+ description: Recipe deleted
+
+ /index.php?action=dupliclick_login:
+ post:
+ summary: Login to DupliClick (online shopping)
+ tags: [DupliClick]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ email:
+ type: string
+ password:
+ type: string
+ responses:
+ "200":
+ description: Login successful
+
+ /index.php?action=dupliclick_search:
+ get:
+ summary: Search DupliClick product catalog
+ tags: [DupliClick]
+ parameters:
+ - name: q
+ in: query
+ required: true
+ schema:
+ type: string
+ responses:
+ "200":
+ description: Search results
+
+ /index.php?action=tts_proxy:
+ post:
+ summary: Proxy TTS request to external endpoint
+ tags: [TTS]
+ requestBody:
+ required: true
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ text:
+ type: string
+ responses:
+ "200":
+ description: TTS request sent
+
+ /index.php?action=expiry_history:
+ get:
+ summary: Get expiry scan history for a product
+ tags: [Inventory]
+ parameters:
+ - name: product_id
+ in: query
+ required: true
+ schema:
+ type: integer
+ responses:
+ "200":
+ description: Expiry history entries
+
+components:
+ schemas:
+ Product:
+ type: object
+ properties:
+ id:
+ type: integer
+ name:
+ type: string
+ brand:
+ type: string
+ barcode:
+ type: string
+ category:
+ type: string
+ enum:
+ - latticini
+ - carne
+ - pesce
+ - frutta
+ - verdura
+ - pasta
+ - pane
+ - surgelati
+ - bevande
+ - condimenti
+ - snack
+ - conserve
+ - cereali
+ - igiene
+ - pulizia
+ - altro
+ unit:
+ type: string
+ enum: [pz, conf, g, ml]
+ default_quantity:
+ type: number
+ package_size:
+ type: number
+ package_unit:
+ type: string
+ notes:
+ type: string
+ created_at:
+ type: string
+ format: date-time
+
+ ProductInput:
+ type: object
+ required: [name]
+ properties:
+ id:
+ type: integer
+ description: If provided, updates existing product
+ name:
+ type: string
+ brand:
+ type: string
+ barcode:
+ type: string
+ category:
+ type: string
+ unit:
+ type: string
+ default_quantity:
+ type: number
+ package_size:
+ type: number
+
+ InventoryItem:
+ type: object
+ properties:
+ id:
+ type: integer
+ product_id:
+ type: integer
+ product_name:
+ type: string
+ quantity:
+ type: number
+ location:
+ type: string
+ expiry_date:
+ type: string
+ format: date
+ opened:
+ type: boolean
+ created_at:
+ type: string
+ format: date-time
+
+ responses:
+ TooManyRequests:
+ description: Rate limit exceeded
+ headers:
+ Retry-After:
+ schema:
+ type: integer
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ error:
+ type: string
+
+tags:
+ - name: Products
+ description: Product catalog management
+ - name: Inventory
+ description: Inventory tracking (stock in/out)
+ - name: Log
+ description: Operations log and statistics
+ - name: AI / Gemini
+ description: Google Gemini AI integration (identification, recipes, chat)
+ - name: Bring! Integration
+ description: Bring! shopping list integration
+ - name: Recipes
+ description: Recipe storage
+ - name: Settings
+ description: Application and server settings
+ - name: DupliClick
+ description: DupliClick online shopping integration
+ - name: TTS
+ description: Text-to-Speech proxy
diff --git a/index.html b/index.html
index f331d93..b911b08 100644
--- a/index.html
+++ b/index.html
@@ -20,12 +20,12 @@