release: merge develop → main for v1.7.23

.gitignore

@@ -51,3 +51,4 @@ data/latest_release_cache.json
 data/food_facts_cache.json
 data/category_ai_cache.json
 assets/img/logo/*_backup.*
+logs/*.log

CHANGELOG.md

@@ -11,6 +11,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Recipe scraps tips** — During cooking steps, detect "waste" generated (peels, cores, bones, eggshells, coffee grounds, citrus zest, etc.) and surface AI-powered tips on how to reuse them (compost, natural cleaner, broth, candied peel, etc.). Could be shown as an optional collapsible hint card below the step that generates the scrap.
 
+## [1.7.23] - 2026-05-18
+
+### Added
+- **⚙️ Generali tab** — new first tab in Settings groups all global settings: language, currency, theme, screensaver, zero-waste tips, inventory export. Old Language tab removed.
+- **DB auto-cleanup** — `RECIPE_RETENTION_DAYS` (default 7) and `TRANSACTION_RETENTION_DAYS` (default 7) added to `.env`; old rows are deleted automatically every cron cycle, followed by `VACUUM` to compact the database. Manual trigger: `GET /api/?action=db_cleanup`.
+- **Vacuum-sealed expiry grace period** — `VACUUM_EXPIRY_EXTENSION_DAYS` (default 30): vacuum-sealed products are only flagged as expired N days *after* the printed date, preventing false alarms on long-lasting items like cured meats.
+- **Gemini AI usage tracking** — monthly and yearly token/cost stats now shown in Settings → ℹ️ Info tab, using tracked data from `data/ai_usage.json`. Cost rates configurable via `GEMINI_COST_25F_IN/OUT` and `GEMINI_COST_20F_IN/OUT` in `.env`.
+
+### Changed
+- **Auto theme is now time-based** — "Automatico" mode switches to dark at 20:00 and back to light at 07:00, based on server/device clock (not OS preference). Re-evaluates every 5 minutes; ideal for always-on kiosk displays.
+- **`dispensa.db` auto-deleted** — if the legacy empty `dispensa.db` file appears alongside `evershelf.db`, it is now removed automatically by the health check.
+- **ZeroWaste tips and screensaver timeout** — these settings were not being persisted to `.env` on save (missing from POST payload); fixed.
+
 ## [1.7.22] - 2026-05-17
 
 ### Fixed

README.md

@@ -38,10 +38,11 @@
 
 ## ✨ Features
 
-> ♻️ **New in v1.7.19 — Zero-waste cooking tips**
-> During cooking, EverShelf shows a contextual ♻️ tip card for each step that generates reusable scraps — peels, cooking water, egg whites, cheese rinds, bread crusts and more.
-> Tips are generated by Gemini *as part of the recipe* at zero extra API cost, shown inline in cooking mode, and dismissible per step.
-> Enable the toggle in **Settings → Zero-waste tips** (default: off).
+> ⚙️ **New in v1.7.23 — Global settings tab, DB auto-cleanup, vacuum-sealed expiry**
+> A new **Generali** tab groups all global settings (language, currency, theme, screensaver, zero-waste, export) in one place.
+> Recipes older than `RECIPE_RETENTION_DAYS` and transactions older than `TRANSACTION_RETENTION_DAYS` are deleted automatically every cron cycle, followed by a SQLite `VACUUM` to keep the database small.
+> Vacuum-sealed products get an extended grace period (`VACUUM_EXPIRY_EXTENSION_DAYS`, default 30 days) before being flagged as expired.
+> Auto theme now follows **time of day** (dark 20:00–07:00) instead of the OS setting, making it server-friendly.
 
 ### 📦 Inventory Management
 - **Export inventory** — Download the full inventory as a UTF-8 CSV (Excel-compatible) or open a print-ready page to save as PDF; export button always visible in the inventory page header
@@ -50,7 +51,7 @@
 - **Smart locations** — Track items across Pantry, Fridge, Freezer, and custom locations
 - **Expiry tracking** — Automatic shelf-life estimation based on product type and storage
 - **Opened product tracking** — Reduced shelf-life calculation when packages are opened; opened-product expiry is now also checked when building banner alerts (not just the dashboard section)
-- **Vacuum-sealed support** — Extended expiry dates for vacuum-sealed items
+- **Vacuum-sealed support** — Extended expiry dates for vacuum-sealed items; products sealed under vacuum are only flagged as expired after a configurable grace period past the printed date (`VACUUM_EXPIRY_EXTENSION_DAYS`, default 30 days, configurable in `.env`)
 - **Anomaly detection** — Banner alerts for suspicious quantities and consumption predictions with inline correction; dismiss button now shows the current inventory quantity so the action is unambiguous ("Quantity is correct (2 pcs)")
 
 ### 🤖 AI-Powered (Google Gemini)
@@ -98,9 +99,15 @@
 - **Quick-access buttons** — Recently used and most popular products shown on the inventory page for fast access
 
 ### 🌙 Appearance
-- **Dark mode** — Three modes: Light, Dark, and Auto (follows the OS/browser setting); theme is applied before the first render to prevent a white flash on dark-mode systems; toggle in Settings → Appearance
+- **Dark mode** — Three modes: Light, Dark, and Auto (time-based: dark from 20:00 to 07:00, light otherwise); applies immediately without page reload; auto mode re-evaluates every 5 minutes, so night/day transitions happen automatically even on always-on kiosk displays; theme is applied before the first render to prevent a white flash
+- **Global settings tab** — A dedicated **⚙️ Generali** tab groups all system-wide settings (language, currency, theme, screensaver, zero-waste tips, export) at the top of the Settings panel
 
-### 📱 Progressive Web App
+### �️ Database Maintenance
+- **Automatic cleanup** — Recipes older than `RECIPE_RETENTION_DAYS` (default 7) and transactions older than `TRANSACTION_RETENTION_DAYS` (default 7) are deleted automatically on every cron cycle; SQLite `VACUUM` runs after each cleanup to keep the file compact
+- **Manual cleanup** — Trigger immediately via `GET /api/?action=db_cleanup`
+- **Compact by default** — Fresh installs stay small; large accumulated databases shrink back to a few hundred KB within one cron cycle
+
+### �📱 Progressive Web App
 - **Mobile-first design** — Optimized for phones, works on tablets and desktop
 - **Installable** — Add to home screen for a native app experience
 - **Multi-device** — All user data (shopping tags, pinned items, location preferences, scan history) is stored server-side in SQLite and shared across every device on the same instance; no data is siloed in a single browser's localStorage
@@ -192,12 +199,32 @@ TTS_URL=http://your-home-assistant:8123/api/events/tts_speak
 TTS_TOKEN=your_long_lived_token
 TTS_ENABLED=true
 
+# Optional: DB retention and cleanup (applied automatically each cron cycle)
+RECIPE_RETENTION_DAYS=7        # delete recipe plans older than N days
+TRANSACTION_RETENTION_DAYS=7   # delete stock transactions older than N days
+
+# Optional: Vacuum-sealed expiry grace period
+VACUUM_EXPIRY_EXTENSION_DAYS=30 # extra days before vacuum-sealed items are flagged expired
+
+# Optional: Gemini cost rates (USD per million tokens, for the Info tab cost estimate)
+GEMINI_COST_25F_IN=0.15
+GEMINI_COST_25F_OUT=0.60
+GEMINI_COST_20F_IN=0.10
+GEMINI_COST_20F_OUT=0.40
+
 # Optional: Security — protect the save_settings endpoint
 # Set a strong random string; the Settings UI will ask for it before saving
 SETTINGS_TOKEN=
 
 # Optional: Demo mode — block all write operations at the router level
 DEMO_MODE=false
+
+# Optional: Logging
+# LOG_LEVEL sets the minimum severity written to disk (DEBUG / INFO / WARN / ERROR)
+# DEBUG also logs every SQL query executed against the database
+LOG_LEVEL=INFO
+LOG_ROTATE_HOURS=24   # hours before opening a new log file (default: 24)
+LOG_MAX_FILES=14      # maximum number of rotated files to keep (default: 14)
 ```
 
 ### Web Server Configuration

api/cron_smart_shopping.php

@@ -79,6 +79,19 @@ try {
         echo '[' . date('Y-m-d H:i:s') . '] Shelf life pre-warm warning: ' . $pe->getMessage() . "\n";
     }
 
+    // ── DB cleanup (retention policy) ────────────────────────────────────
+    // Delete old recipes and transactions based on .env retention settings.
+    try {
+        ob_start();
+        dbCleanup($db);
+        ob_end_clean();
+        echo '[' . date('Y-m-d H:i:s') . '] DB cleanup done'
+            . ' (recipes >' . env('RECIPE_RETENTION_DAYS','7') . 'd'
+            . ', tx >' . env('TRANSACTION_RETENTION_DAYS','7') . 'd' . ")\n";
+    } catch (Throwable $ce) {
+        echo '[' . date('Y-m-d H:i:s') . '] DB cleanup warning: ' . $ce->getMessage() . "\n";
+    }
+
 } catch (Throwable $e) {
     $msg = $e->getMessage();
     echo '[' . date('Y-m-d H:i:s') . '] ERROR: ' . $msg . "\n";

api/database.php

@@ -40,8 +40,13 @@ function _ensureDataDir(): void {
 
 function getDB(): PDO {
     _ensureDataDir();
+    // logger.php is required by index.php before getDB() is called.
+    // In cron context it may not be loaded yet — guard with class_exists.
+    $useLogging = class_exists('LoggingPDO', false);
     $isNew = !file_exists(DB_PATH);
-    $db = new PDO('sqlite:' . DB_PATH);
+    $db = $useLogging
+        ? new LoggingPDO('sqlite:' . DB_PATH)
+        : new PDO('sqlite:' . DB_PATH);
     $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
     $db->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
     $db->exec("PRAGMA journal_mode=WAL");

api/logger.php

@@ -0,0 +1,375 @@
+<?php
+/**
+ * EverShelf Logger — rotating file logger with 4 configurable levels.
+ *
+ * Levels (in order of verbosity):
+ *   DEBUG(0) — ogni minima operazione: query, cache, AI payload, function entry/exit
+ *   INFO (1) — azioni completate, AI result summary, sync status             [default]
+ *   WARN (2) — rate limit, cache miss, AI fallback, token renewal, slow op
+ *   ERROR(3) — DB failure, AI API error, file write error, exception
+ *
+ * Config via .env (all optional):
+ *   LOG_LEVEL        = INFO    (DEBUG|INFO|WARN|ERROR)
+ *   LOG_ROTATE_HOURS = 24      (new file every N hours; 1–168; default 24)
+ *   LOG_MAX_FILES    = 14      (max rotated files to keep; default 14)
+ *
+ * Log files: logs/evershelf_YYYY-MM-DD_HH.log
+ * Each line:  [2026-05-18 14:23:11] [INFO ] [rid=a1b2c3d4] [action] Message {ctx}
+ */
+class EverLog {
+
+    // ── Level constants ────────────────────────────────────────────────────
+    const DEBUG = 0;
+    const INFO  = 1;
+    const WARN  = 2;
+    const ERROR = 3;
+
+    private static bool   $initialized  = false;
+    private static int    $level        = self::INFO;
+    private static string $logFile      = '';
+    private static string $logDir       = '';
+    private static int    $rotateHours  = 24;
+    private static int    $maxFiles     = 14;
+    private static string $requestId    = '';
+    private static string $currentAction = '-';
+
+    // ── Init (called lazily on first write) ────────────────────────────────
+    private static function init(): void {
+        if (self::$initialized) return;
+        self::$initialized = true;
+
+        // Read .env values via getenv() (populated by Apache SetEnv or putenv() in index.php)
+        $envLevel    = strtoupper((string)(getenv('LOG_LEVEL')        ?: 'INFO'));
+        $rotateHours = max(1, min(168, (int)(getenv('LOG_ROTATE_HOURS') ?: 24)));
+        $maxFiles    = max(1, min(365, (int)(getenv('LOG_MAX_FILES')    ?: 14)));
+
+        self::$level       = match($envLevel) {
+            'DEBUG' => self::DEBUG,
+            'WARN'  => self::WARN,
+            'ERROR' => self::ERROR,
+            default => self::INFO,
+        };
+        self::$rotateHours = $rotateHours;
+        self::$maxFiles    = $maxFiles;
+        self::$requestId   = substr(bin2hex(random_bytes(4)), 0, 8);
+
+        // Ensure log directory exists
+        $base         = dirname(__DIR__) . '/logs';
+        self::$logDir = $base;
+        if (!is_dir($base)) {
+            @mkdir($base, 0755, true);
+        }
+
+        // Compute current log file path (slot by rotate-hours bucket)
+        $slotTs        = (int)(floor(time() / ($rotateHours * 3600)) * ($rotateHours * 3600));
+        $slotLabel     = gmdate('Y-m-d_H', $slotTs);
+        self::$logFile = "$base/evershelf_{$slotLabel}.log";
+
+        // Rotate (delete oldest files beyond max)
+        self::rotate();
+    }
+
+    // ── Rotate old log files ───────────────────────────────────────────────
+    private static function rotate(): void {
+        $files = glob(self::$logDir . '/evershelf_*.log') ?: [];
+        if (count($files) <= self::$maxFiles) return;
+        sort($files); // oldest first (filenames are lexicographically sortable by date)
+        $toDelete = array_slice($files, 0, count($files) - self::$maxFiles);
+        foreach ($toDelete as $f) {
+            @unlink($f);
+        }
+    }
+
+    // ── Core write ────────────────────────────────────────────────────────
+    private static function write(int $lvl, string $msg, array $ctx, string $action): void {
+        self::init();
+        if ($lvl < self::$level) return;
+
+        $labels = ['DEBUG', 'INFO ', 'WARN ', 'ERROR'];
+        $ts     = gmdate('Y-m-d H:i:s');
+        $act    = $action !== '-' ? $action : self::$currentAction;
+        $ctxStr = empty($ctx) ? '' : ' ' . json_encode($ctx, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        $line   = "[{$ts}] [{$labels[$lvl]}] [rid=" . self::$requestId . "] [{$act}] {$msg}{$ctxStr}\n";
+
+        @file_put_contents(self::$logFile, $line, FILE_APPEND | LOCK_EX);
+    }
+
+    // ── Public API ────────────────────────────────────────────────────────
+
+    /** Set the current action name (shown in every subsequent log line for this request). */
+    public static function setAction(string $action): void {
+        self::$currentAction = $action;
+    }
+
+    /** Log at DEBUG level — every minor operation, query, cache hit/miss, AI payload. */
+    public static function debug(string $msg, array $ctx = [], string $action = '-'): void {
+        self::write(self::DEBUG, $msg, $ctx, $action);
+    }
+
+    /** Log at INFO level — action completed, recipe generated, sync done. */
+    public static function info(string $msg, array $ctx = [], string $action = '-'): void {
+        self::write(self::INFO, $msg, $ctx, $action);
+    }
+
+    /** Log at WARN level — rate limit, AI fallback, slow op, token renewal. */
+    public static function warn(string $msg, array $ctx = [], string $action = '-'): void {
+        self::write(self::WARN, $msg, $ctx, $action);
+    }
+
+    /** Log at ERROR level — DB failure, AI API error, file write error, exception. */
+    public static function error(string $msg, array $ctx = [], string $action = '-'): void {
+        self::write(self::ERROR, $msg, $ctx, $action);
+    }
+
+    /** Convenience: log a Throwable at ERROR level with class + location. */
+    public static function exception(\Throwable $e, string $action = '-', array $extra = []): void {
+        self::write(self::ERROR, $e->getMessage(), array_merge([
+            'class' => get_class($e),
+            'at'    => basename($e->getFile()) . ':' . $e->getLine(),
+            'trace' => substr($e->getTraceAsString(), 0, 800),
+        ], $extra), $action);
+    }
+
+    /**
+     * Log the start of an action request (INFO).
+     * Automatically sets the current action name so subsequent lines inherit it.
+     */
+    public static function request(string $action, string $method, array $params = []): void {
+        self::setAction($action);
+        // At DEBUG: include all params; at INFO just the action+method
+        if (self::$level <= self::DEBUG) {
+            self::write(self::DEBUG, "→ {$method} /{$action}", $params, $action);
+        } else {
+            self::write(self::INFO, "→ {$method} /{$action}", [], $action);
+        }
+    }
+
+    /**
+     * Log a DB query at DEBUG level.
+     * @param string $sql      Truncated SQL or a descriptive label
+     * @param mixed  $result   Number of rows affected/returned (optional)
+     * @param float  $elapsed  Execution time in seconds (optional)
+     */
+    public static function query(string $sql, $result = null, float $elapsed = 0.0): void {
+        if (self::$level > self::DEBUG) return; // skip entirely unless DEBUG
+        $ctx = [];
+        if ($result !== null) $ctx['rows'] = $result;
+        if ($elapsed > 0)     $ctx['ms']   = round($elapsed * 1000, 1);
+        if ($elapsed > 1.0)   $ctx['SLOW'] = true; // highlight slow queries even in context
+        self::write(self::DEBUG, 'DB: ' . substr($sql, 0, 200), $ctx, self::$currentAction);
+    }
+
+    /**
+     * Log a slow operation as WARN regardless of configured level.
+     * Call this after any operation that took more than $thresholdSec.
+     */
+    public static function slowOp(string $label, float $elapsed, float $thresholdSec = 2.0): void {
+        if ($elapsed < $thresholdSec) return;
+        self::write(self::WARN, "SLOW_OP: {$label}", ['elapsed_s' => round($elapsed, 2)], self::$currentAction);
+    }
+
+    /**
+     * Log an AI call at INFO level (or DEBUG for full payload).
+     * @param string $model      Model name (e.g. 'gemini-2.5-flash')
+     * @param int    $promptLen  Character length of the prompt
+     * @param bool   $isFallback Whether this is the fallback model
+     */
+    public static function aiCall(string $model, int $promptLen, bool $isFallback = false): void {
+        $ctx = ['model' => $model, 'prompt_chars' => $promptLen];
+        if ($isFallback) $ctx['fallback'] = true;
+        $level = $isFallback ? self::WARN : self::INFO;
+        self::write($level, 'AI call', $ctx, self::$currentAction);
+    }
+
+    /**
+     * Log an AI response at INFO level.
+     * @param string $model       Model that responded
+     * @param int    $outputLen   Character length of output
+     * @param float  $elapsed     Call duration in seconds
+     * @param bool   $ok          Whether the call succeeded
+     * @param string $errorMsg    Error message if not ok
+     */
+    public static function aiResponse(string $model, int $outputLen, float $elapsed, bool $ok = true, string $errorMsg = ''): void {
+        $ctx = ['model' => $model, 'output_chars' => $outputLen, 'elapsed_s' => round($elapsed, 2)];
+        if (!$ok) {
+            $ctx['error'] = substr($errorMsg, 0, 200);
+            self::write(self::ERROR, 'AI error', $ctx, self::$currentAction);
+        } else {
+            self::write(self::INFO, 'AI ok', $ctx, self::$currentAction);
+        }
+        // Warn if over 10s
+        if ($ok && $elapsed > 10.0) {
+            self::write(self::WARN, 'AI response slow', ['elapsed_s' => round($elapsed, 2)], self::$currentAction);
+        }
+    }
+
+    /**
+     * Log a cache event at DEBUG level.
+     * @param string $cacheKey  The cache key (or a label)
+     * @param bool   $hit       true = cache hit, false = cache miss
+     * @param string $cacheType 'file', 'session', 'memory'
+     */
+    public static function cache(string $cacheKey, bool $hit, string $cacheType = 'file'): void {
+        if (self::$level > self::DEBUG) return;
+        self::write(self::DEBUG,
+            ($hit ? 'CACHE HIT' : 'CACHE MISS') . " [{$cacheType}]",
+            ['key' => substr($cacheKey, 0, 64)],
+            self::$currentAction
+        );
+    }
+
+    /**
+     * Return the last $lines log lines from all available log files, newest last.
+     * Used by the get_logs API endpoint.
+     */
+    public static function tail(int $lines = 500): array {
+        self::init();
+        $files = glob(self::$logDir . '/evershelf_*.log') ?: [];
+        if (empty($files)) return [];
+        rsort($files); // newest file first
+
+        $collected = [];
+        foreach ($files as $f) {
+            if (count($collected) >= $lines) break;
+            $content = @file_get_contents($f);
+            if ($content === false) continue;
+            $fLines = array_filter(explode("\n", $content));
+            // Prepend so we read newest-first → older lines at front
+            $collected = array_merge(array_values($fLines), $collected);
+        }
+        // Return last $lines, newest at end (chronological order)
+        return array_values(array_slice($collected, -$lines));
+    }
+
+    /** List available log files with their sizes and date ranges. */
+    public static function listFiles(): array {
+        self::init();
+        $files = glob(self::$logDir . '/evershelf_*.log') ?: [];
+        rsort($files);
+        return array_map(fn($f) => [
+            'file'    => basename($f),
+            'size_kb' => round(filesize($f) / 1024, 1),
+            'mtime'   => date('Y-m-d H:i:s', filemtime($f)),
+        ], $files);
+    }
+
+    /** Current effective level name. */
+    public static function levelName(): string {
+        self::init();
+        return ['DEBUG', 'INFO', 'WARN', 'ERROR'][self::$level];
+    }
+
+    /** Current log file path. */
+    public static function currentFile(): string {
+        self::init();
+        return self::$logFile;
+    }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// LoggingPDOStatement — wraps PDOStatement to time and log every execute()
+// ═══════════════════════════════════════════════════════════════════════════
+class LoggingPDOStatement {
+    private \PDOStatement $stmt;
+    private string        $sql;
+
+    public function __construct(\PDOStatement $stmt, string $sql) {
+        $this->stmt = $stmt;
+        $this->sql  = $sql;
+    }
+
+    public function execute(?array $params = null): bool {
+        $t0  = microtime(true);
+        $ok  = $this->stmt->execute($params);
+        $ms  = round((microtime(true) - $t0) * 1000, 2);
+        $ctx = ['ms' => $ms, 'rows' => $this->stmt->rowCount()];
+        if ($ms > 500) $ctx['SLOW'] = true;
+        EverLog::query($this->sql, $this->stmt->rowCount(), (microtime(true) - $t0));
+        return $ok;
+    }
+
+    public function fetch(int $mode = \PDO::FETCH_DEFAULT, ...$args): mixed {
+        return $this->stmt->fetch($mode, ...$args);
+    }
+
+    public function fetchAll(int $mode = \PDO::FETCH_DEFAULT, ...$args): array {
+        return $this->stmt->fetchAll($mode ?: \PDO::FETCH_ASSOC);
+    }
+
+    public function fetchColumn(int $col = 0): mixed {
+        return $this->stmt->fetchColumn($col);
+    }
+
+    public function rowCount(): int {
+        return $this->stmt->rowCount();
+    }
+
+    public function bindValue(int|string $param, mixed $value, int $type = \PDO::PARAM_STR): bool {
+        return $this->stmt->bindValue($param, $value, $type);
+    }
+
+    public function bindParam(int|string $param, mixed &$var, int $type = \PDO::PARAM_STR, int $maxLength = 0): bool {
+        return $this->stmt->bindParam($param, $var, $type, $maxLength);
+    }
+
+    public function closeCursor(): bool {
+        return $this->stmt->closeCursor();
+    }
+
+    public function setFetchMode(int $mode, mixed ...$args): bool {
+        return $this->stmt->setFetchMode($mode, ...$args);
+    }
+
+    public function __get(string $name): mixed {
+        return $this->stmt->$name;
+    }
+
+    public function __call(string $name, array $args): mixed {
+        return $this->stmt->$name(...$args);
+    }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// LoggingPDO — wraps PDO to auto-log all prepare(), query(), exec()
+// Drop-in replacement: return LoggingPDO from getDB() instead of PDO.
+// Type hint: use PDO in all functions (LoggingPDO extends PDO).
+// ═══════════════════════════════════════════════════════════════════════════
+class LoggingPDO extends \PDO {
+    public function prepare(string $query, array $options = []): LoggingPDOStatement|false {
+        $stmt = parent::prepare($query, $options);
+        if ($stmt === false) {
+            EverLog::error('PDO::prepare failed', ['sql' => substr($query, 0, 200)]);
+            return false;
+        }
+        return new LoggingPDOStatement($stmt, $query);
+    }
+
+    public function query(string $query, ?int $fetchMode = null, mixed ...$fetchModeArgs): \PDOStatement|false {
+        $t0   = microtime(true);
+        $stmt = $fetchMode !== null
+            ? parent::query($query, $fetchMode, ...$fetchModeArgs)
+            : parent::query($query);
+        $elapsed = microtime(true) - $t0;
+        if ($stmt !== false) {
+            EverLog::query($query, $stmt->rowCount(), $elapsed);
+        } else {
+            EverLog::error('PDO::query failed', ['sql' => substr($query, 0, 200)]);
+        }
+        return $stmt;
+    }
+
+    public function exec(string $statement): int|false {
+        // Skip WAL/PRAGMA logging below DEBUG (too noisy at startup)
+        $isPragma = stripos(ltrim($statement), 'PRAGMA') === 0;
+        $t0       = microtime(true);
+        $result   = parent::exec($statement);
+        $elapsed  = microtime(true) - $t0;
+        if (!$isPragma) {
+            EverLog::query($statement, $result === false ? 0 : $result, $elapsed);
+        } elseif (EverLog::DEBUG >= 0) {
+            // Log PRAGMAs only at DEBUG level
+            EverLog::query($statement, is_int($result) ? $result : 0, $elapsed);
+        }
+        return $result;
+    }
+}

assets/js/app.js

@@ -1052,7 +1052,8 @@ if (!_SUPPORTED_LANGS[_currentLang]) _currentLang = 'en';
     try {
         const s = JSON.parse(localStorage.getItem('evershelf_settings') || '{}');
         const mode = s.dark_mode || 'auto';
-        const dark = mode === 'on' || (mode === 'auto' && window.matchMedia('(prefers-color-scheme: dark)').matches);
+        const h = new Date().getHours();
+        const dark = mode === 'on' || (mode === 'auto' && (h >= 20 || h < 7));
         document.documentElement.setAttribute('data-theme', dark ? 'dark' : 'light');
     } catch(e) {}
 })();
@@ -1176,7 +1177,9 @@ function _applyTheme() {
     } else if (mode === 'off') {
         isDark = false;
     } else {
-        isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        // auto: dark from 20:00 to 07:00 (time-based, not system preference)
+        const h = new Date().getHours();
+        isDark = h >= 20 || h < 7;
     }
     document.documentElement.setAttribute('data-theme', isDark ? 'dark' : 'light');
 }
@@ -1189,10 +1192,10 @@ function _setThemeMode(mode) {
 }
 
 // Listen to system theme changes (for 'auto' mode)
-window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
-    const s = getSettings();
-    if ((s.dark_mode || 'auto') === 'auto') _applyTheme();
-});
+// Re-evaluate auto theme every 5 minutes (catches 20:00 dark / 07:00 light transitions)
+setInterval(() => {
+    if ((getSettings().dark_mode || 'auto') === 'auto') _applyTheme();
+}, 5 * 60 * 1000);
 
 // ===== EXPORT INVENTORY =====
 function exportInventory(format) {
@@ -1226,7 +1229,8 @@ function _showExportModal() {
                 🖨️ ${t('export.btn_pdf')}
             </button>
         </div>`;
-    openModal(html);
+    document.getElementById('modal-content').innerHTML = html;
+    document.getElementById('modal-overlay').style.display = 'flex';
 }
 
 const LOCATIONS = {
@@ -2202,6 +2206,175 @@ function _applySyncedSettings(serverSettings) {
     }
 }
 
+let _infoTabTimer = null;
+
+/**
+ * Load the Info tab: Gemini token usage + cost, log size, DB size, log level.
+ * Called on tab click; auto-refreshes every 30s while the tab is open.
+ */
+async function _loadInfoTab() {
+    // Cancel any previous auto-refresh
+    if (_infoTabTimer) { clearInterval(_infoTabTimer); _infoTabTimer = null; }
+    await _renderInfoTab();
+    // Auto-refresh every 30s while Info tab is visible
+    _infoTabTimer = setInterval(_renderInfoTab, 30_000);
+}
+
+async function _renderInfoTab() {
+    const aiEl  = document.getElementById('info-ai-content');
+    const sysEl = document.getElementById('info-system-content');
+    if (!aiEl && !sysEl) return;
+
+    try {
+        const d = await api('gemini_usage');
+        const s = getSettings();
+
+        // ── Locale & helpers ─────────────────────────────────────────────────
+        const langMap = {it:'it-IT', en:'en-US', de:'de-DE', fr:'fr-FR', es:'es-ES'};
+        const locale  = langMap[s.language] || langMap[navigator.language?.slice(0,2)] || 'it-IT';
+        const [yr, mo] = (d.month || '').split('-');
+        const monthLabel = new Intl.DateTimeFormat(locale, {month:'long', year:'numeric'})
+            .format(new Date(parseInt(yr), parseInt(mo)-1, 1));
+
+        // Cost → user currency
+        const toCurr = (usd) => {
+            if (!usd) return '—';
+            const c = s.price_currency || 'EUR';
+            let v = usd, sym = '$';
+            if      (c === 'EUR') { v = usd * 0.92; sym = '€'; }
+            else if (c === 'GBP') { v = usd * 0.79; sym = '£'; }
+            else if (c === 'CHF') { v = usd * 0.90; sym = 'CHF '; }
+            else if (c === 'CAD') { v = usd * 1.36; sym = 'CA$'; }
+            else if (c === 'AUD') { v = usd * 1.54; sym = 'A$'; }
+            else if (c === 'BRL') { v = usd * 5.20; sym = 'R$'; }
+            else if (c === 'JPY') { v = usd * 155;  sym = '¥'; }
+            else if (c === 'SEK') { v = usd * 10.4; sym = 'kr'; }
+            else if (c === 'NOK') { v = usd * 10.6; sym = 'kr'; }
+            else if (c === 'DKK') { v = usd * 6.85; sym = 'kr'; }
+            else if (c === 'PLN') { v = usd * 3.98; sym = 'zł'; }
+            const decimals = (c === 'JPY') ? 1 : 4;
+            return sym + v.toFixed(decimals);
+        };
+        const fmtTok   = n => n >= 1_000_000 ? (n/1_000_000).toFixed(2)+'M'
+                            : n >= 1_000 ? Math.round(n/1_000)+'K' : String(n||0);
+        const fmtBytes = b => b > 1048576 ? (b/1048576).toFixed(1)+' MB'
+                            : b > 1024 ? Math.round(b/1024)+' KB' : (b||0)+' B';
+        const fmtDate  = ts => ts ? new Intl.DateTimeFormat(locale, {day:'2-digit', month:'short', hour:'2-digit', minute:'2-digit'}).format(new Date(ts*1000)) : '—';
+        const pill = (val, label, color='') =>
+            `<div style="background:var(--bg-secondary);border:1px solid var(--border-color,#e2e8f0);border-radius:10px;padding:8px 14px;min-width:70px;text-align:center${color ? ';border-color:'+color : ''}">
+                <div style="font-size:1.1rem;font-weight:700;color:${color||'var(--text-primary,#1e293b)'}">${val}</div>
+                <div style="font-size:0.7rem;color:var(--text-secondary,#64748b);margin-top:2px">${label}</div>
+            </div>`;
+        const sectionHeader = (label) =>
+            `<div style="font-size:0.78rem;font-weight:600;color:var(--text-secondary);margin-bottom:8px;text-transform:uppercase;letter-spacing:.04em">${label}</div>`;
+
+        // ── AI Usage card ────────────────────────────────────────────────────
+        if (aiEl) {
+            const ms = d.month_stats || {};
+            const ys = d.year_stats  || {};
+
+            const hintEl = aiEl.closest('.settings-card')?.querySelector('.info-ai-subtitle');
+            if (hintEl) hintEl.textContent = t('settings.info.ai_overview');
+
+            const msIn  = ms.input_tokens  || 0;
+            const msOut = ms.output_tokens || 0;
+            const ysIn  = ys.input_tokens  || 0;
+            const ysOut = ys.output_tokens || 0;
+
+            // Month section
+            const actionRows = Object.entries(ms.by_action || {})
+                .sort((a,b) => b[1]-a[1]).slice(0, 8)
+                .map(([k,v]) => `<tr><td style="padding:3px 12px 3px 0;color:var(--text-secondary);font-size:0.82rem">${k}</td><td style="font-variant-numeric:tabular-nums;font-size:0.82rem"><strong>${v}</strong> ${t('settings.info.calls_unit')}</td></tr>`).join('');
+            const modelRows  = Object.entries(ms.by_model  || {})
+                .map(([m,mv]) => `<tr><td style="padding:3px 12px 3px 0;color:var(--text-secondary);font-size:0.82rem">${m}</td><td style="font-variant-numeric:tabular-nums;font-size:0.82rem"><strong>${fmtTok((mv.in||0)+(mv.out||0))}</strong></td></tr>`).join('');
+
+            const monthHtml = `
+                <div style="background:var(--bg-secondary);border-radius:10px;padding:12px;margin-bottom:10px">
+                    ${sectionHeader(monthLabel)}
+                    <div style="display:flex;gap:8px;flex-wrap:wrap">
+                        ${pill(ms.calls || 0, t('settings.info.ai_calls'))}
+                        ${pill('~'+fmtTok(msIn+msOut), t('settings.info.total_tokens'))}
+                        ${pill('~'+toCurr(ms.cost_usd), t('settings.info.est_cost'), '#15803d')}
+                    </div>
+                    ${actionRows ? `<details style="margin-top:8px"><summary style="font-size:0.82rem;cursor:pointer;color:var(--text-secondary)">${t('settings.info.by_action')}</summary><table style="margin-top:6px;border-collapse:collapse">${actionRows}</table></details>` : ''}
+                    ${modelRows  ? `<details style="margin-top:4px"><summary style="font-size:0.82rem;cursor:pointer;color:var(--text-secondary)">${t('settings.info.by_model')}</summary><table style="margin-top:6px;border-collapse:collapse">${modelRows}</table></details>` : ''}
+                </div>`;
+
+            // Year section
+            const yearHtml = `
+                <div style="background:var(--bg-secondary);border-radius:10px;padding:12px;margin-bottom:10px">
+                    ${sectionHeader(t('settings.info.year_label').replace('{year}', d.year))}
+                    <div style="display:flex;gap:8px;flex-wrap:wrap">
+                        ${pill('~'+(ys.calls || 0), t('settings.info.ai_calls'))}
+                        ${pill('~'+fmtTok(ysIn+ysOut), t('settings.info.total_tokens'))}
+                        ${pill('~'+toCurr(ys.cost_usd), t('settings.info.est_cost'), '#15803d')}
+                    </div>
+                </div>`;
+
+            aiEl.innerHTML = monthHtml + yearHtml
+                + `<p class="settings-hint" style="margin-top:4px">${t('settings.info.pricing_note')}</p>`;
+        }
+
+        // ── Inventory card ───────────────────────────────────────────────────
+        const invEl = document.getElementById('info-inv-content');
+        if (invEl && d.db) {
+            const db = d.db;
+            invEl.innerHTML = `
+                <div style="display:flex;gap:8px;flex-wrap:wrap">
+                    ${pill(db.inventory_active, t('settings.info.inv_active'))}
+                    ${pill(db.products_total,   t('settings.info.inv_products'))}
+                    ${pill(db.expiring_soon,     t('settings.info.inv_expiring'), db.expiring_soon > 0 ? '#d97706' : '')}
+                    ${pill(db.expired,           t('settings.info.inv_expired'),  db.expired > 0 ? '#dc2626' : '')}
+                    ${pill(db.finished,          t('settings.info.inv_finished'))}
+                </div>`;
+        }
+
+        // ── Activity card ────────────────────────────────────────────────────
+        const actEl = document.getElementById('info-act-content');
+        if (actEl && d.db) {
+            const db = d.db;
+            actEl.innerHTML = `
+                <div style="display:flex;gap:8px;flex-wrap:wrap">
+                    ${pill(db.tx_month,       t('settings.info.act_tx_month'))}
+                    ${pill(db.restock_month,  t('settings.info.act_restock'))}
+                    ${pill(db.use_month,      t('settings.info.act_use'))}
+                    ${pill(db.products_month, t('settings.info.act_new_products'))}
+                    ${pill(db.tx_year,        t('settings.info.act_tx_year'))}
+                </div>`;
+        }
+
+        // ── System card ──────────────────────────────────────────────────────
+        if (sysEl) {
+            const db = d.db || {};
+            const lvlColors = {DEBUG:'#1e40af//#dbeafe', INFO:'#15803d//#dcfce7', WARN:'#854d0e//#fef9c3', ERROR:'#991b1b//#fee2e2'};
+            const [lvlFg, lvlBg] = (lvlColors[d.log_level] || '#64748b//#f1f5f9').split('//');
+
+            sysEl.innerHTML = `
+                <div style="display:flex;gap:8px;flex-wrap:wrap;margin-bottom:10px">
+                    ${pill(fmtBytes(db.bytes),    t('settings.info.db_size'))}
+                    ${pill(fmtBytes(d.log_bytes), t('settings.info.log_size'))}
+                    ${pill(`<span style="background:${lvlBg};color:${lvlFg};padding:2px 6px;border-radius:5px;font-size:0.78rem">${d.log_level||'INFO'}</span>`, t('settings.info.log_level'))}
+                </div>
+                <table style="border-collapse:collapse;width:100%;font-size:0.85rem">
+                    <tr style="border-top:1px solid var(--border-color,#e2e8f0)">
+                        <td style="padding:7px 0;color:var(--text-secondary)">${t('settings.info.price_cache')}</td>
+                        <td style="padding:7px 0;font-weight:600;text-align:right">${(d.caches?.price||0)} ${t('settings.info.cache_entries')}</td>
+                    </tr>
+                    <tr style="border-top:1px solid var(--border-color,#e2e8f0)">
+                        <td style="padding:7px 0;color:var(--text-secondary)">${t('settings.info.last_backup')}</td>
+                        <td style="padding:7px 0;font-weight:600;text-align:right">${d.last_backup_ts ? fmtDate(d.last_backup_ts)+' · '+fmtBytes(d.last_backup_bytes) : '—'}</td>
+                    </tr>
+                </table>`;
+        }
+    } catch(e) {
+        ['info-ai-content','info-inv-content','info-act-content','info-system-content'].forEach(id => {
+            const el = document.getElementById(id);
+            if (el) el.innerHTML = `<p class="settings-hint">${t('error.generic')}</p>`;
+        });
+    }
+}
+
+
 /**
  * Populate the About section with the current app version from the server.
  */
@@ -2943,6 +3116,8 @@ async function saveSettings() {
             scale_gateway_url: s.scale_gateway_url,
             meal_plan_enabled: s.meal_plan_enabled,
             screensaver_enabled: s.screensaver_enabled,
+            screensaver_timeout: s.screensaver_timeout || 5,
+            zerowaste_tips_enabled: s.zerowaste_tips_enabled,
             tts_enabled: s.tts_enabled,
             tts_url: s.tts_url,
             tts_token: s.tts_token,
@@ -2960,6 +3135,9 @@ async function saveSettings() {
             price_country: s.price_country,
             price_currency: s.price_currency,
             price_update_months: s.price_update_months,
+            recipe_retention_days: s.recipe_retention_days || 7,
+            transaction_retention_days: s.transaction_retention_days || 7,
+            vacuum_expiry_extension_days: s.vacuum_expiry_extension_days || 30,
         }, tokenHeader);
         const statusEl = document.getElementById('settings-status');
         if (result.success) {
@@ -3001,6 +3179,11 @@ async function saveSettings() {
 }
 
 function switchSettingsTab(btn, tabId) {
+    // Stop info-tab auto-refresh when leaving that tab
+    if (tabId !== 'tab-info' && _infoTabTimer) {
+        clearInterval(_infoTabTimer);
+        _infoTabTimer = null;
+    }
     document.querySelectorAll('.settings-tab').forEach(t => t.classList.remove('active'));
     document.querySelectorAll('.settings-panel').forEach(p => p.classList.remove('active'));
     btn.classList.add('active');

data/ai_usage.json

@@ -0,0 +1,9 @@
+{
+  "2026-05": {
+    "input_tokens": 4438300,
+    "output_tokens": 1286760,
+    "calls": 8374,
+    "by_action": {},
+    "by_model": {}
+  }
+}

index.html

@@ -64,7 +64,7 @@
         <div id="preloader-warnings" class="preloader-warnings" style="display:none"></div>
         <div id="preloader-error-msg" class="preloader-error-msg" style="display:none"></div>
         <button id="preloader-retry-btn" class="preloader-retry-btn" style="display:none" onclick="_startupRetry()">🔄 <span data-i18n="startup.retry">Riprova</span></button>
-        <span class="app-preloader-version" id="preloader-version">v1.7.22</span>
+        <span class="app-preloader-version" id="preloader-version">v1.7.23</span>
     </div>
 </div>
 
@@ -77,7 +77,7 @@
         <!-- Title — left-aligned; grows to fill space -->
         <div class="header-title-wrap">
             <h1 class="header-title" onclick="showPage('dashboard')">
-                <img src="assets/img/logo/logo_icon.png" alt="" class="header-logo-icon" aria-hidden="true" /><span data-i18n="nav.title">EverShelf</span><span class="header-version">v1.7.22</span>
+                <img src="assets/img/logo/logo_icon.png" alt="" class="header-logo-icon" aria-hidden="true" /><span data-i18n="nav.title">EverShelf</span><span class="header-version">v1.7.23</span>
             </h1>
             <!-- Update badge — shown alongside title, never replaces it -->
             <span class="header-update-badge" id="header-update-badge" style="display:none"></span>
@@ -831,7 +831,8 @@
             <h2 data-i18n="settings.title">⚙️ Configurazione</h2>
         </div>
         <div class="settings-tabs">
-            <button class="settings-tab active" onclick="switchSettingsTab(this, 'tab-api')" data-tab="tab-api" title="API Keys">🔑</button>
+            <button class="settings-tab active" onclick="switchSettingsTab(this, 'tab-general')" data-tab="tab-general" data-i18n-title="settings.tab_general" title="Generali">⚙️</button>
+            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-api')" data-tab="tab-api" title="API Keys">🔑</button>
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-bring')" data-tab="tab-bring" title="Bring!">🛒</button>
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-recipe')" data-tab="tab-recipe" title="Ricette">🍳</button>
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-mealplan')" data-tab="tab-mealplan" title="Piano Settimanale">📅</button>
@@ -839,12 +840,108 @@
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-camera')" data-tab="tab-camera" title="Fotocamera">📷</button>
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-security')" data-tab="tab-security" title="Sicurezza">🔒</button>
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-tts')" data-tab="tab-tts" title="Voce (TTS)" data-i18n-title="settings.tab_tts">🔊</button>
-            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-language')" data-tab="tab-language" title="Lingua" data-i18n-title="settings.tab_language">🌐</button>
             <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-scale')" data-tab="tab-scale" title="Bilancia Smart" data-i18n-title="settings.scale.tab">⚖️</button>
+            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-info'); _loadInfoTab();" data-tab="tab-info" data-i18n-title="settings.info.tab" title="Info">ℹ️</button>
         </div>
         <div class="settings-panels">
+            <!-- Generali Tab -->
+            <div class="settings-panel active" id="tab-general">
+                <div class="settings-card">
+                    <h4 data-i18n="settings.language.title">🌐 Lingua / Language</h4>
+                    <p class="settings-hint" data-i18n="settings.language.hint">Seleziona la lingua dell'interfaccia. Select the interface language.</p>
+                    <div class="form-group">
+                        <select id="setting-language" class="form-input" onchange="changeLanguage(this.value)">
+                        </select>
+                        <p class="settings-hint mt-2" data-i18n="settings.language.restart_notice">La pagina verrà ricaricata per applicare la nuova lingua.</p>
+                    </div>
+                </div>
+                <div class="settings-card">
+                    <h4 data-i18n="settings.info.currency_title">💱 Valuta</h4>
+                    <p class="settings-hint" data-i18n="settings.info.currency_hint">La valuta usata per tutti i costi e i prezzi nell'app.</p>
+                    <div class="form-group" style="margin-top:8px">
+                        <select id="setting-price-currency" class="form-input">
+                            <option value="EUR">€ Euro (EUR)</option>
+                            <option value="USD">$ Dollaro USA (USD)</option>
+                            <option value="GBP">£ Sterlina (GBP)</option>
+                            <option value="CHF">CHF Franco Svizzero</option>
+                            <option value="CAD">CA$ Dollaro Canadese</option>
+                            <option value="AUD">A$ Dollaro Australiano</option>
+                            <option value="BRL">R$ Real Brasiliano</option>
+                            <option value="JPY">¥ Yen Giapponese</option>
+                            <option value="SEK">kr Corona Svedese</option>
+                            <option value="NOK">kr Corona Norvegese</option>
+                            <option value="DKK">kr Corona Danese</option>
+                            <option value="PLN">zł Zloty Polacco</option>
+                        </select>
+                    </div>
+                    <div class="form-group" style="margin-top:10px">
+                        <button class="btn btn-primary" onclick="saveSettings()" data-i18n="btn.save">Salva</button>
+                    </div>
+                </div>
+                <div class="settings-card">
+                    <h4 data-i18n="settings.theme.title">🌙 Tema / Aspetto</h4>
+                    <p class="settings-hint" data-i18n="settings.theme.hint">Scegli il tema dell'interfaccia.</p>
+                    <div class="form-group">
+                        <select id="setting-dark-mode" class="form-input" onchange="_setThemeMode(this.value)">
+                            <option value="off" data-i18n="settings.theme.off">☀️ Chiaro</option>
+                            <option value="auto" selected data-i18n="settings.theme.auto">🔄 Automatico (orario)</option>
+                            <option value="on" data-i18n="settings.theme.on">🌙 Scuro</option>
+                        </select>
+                    </div>
+                </div>
+                <div class="settings-card">
+                    <h4 data-i18n="settings.screensaver.card_title">🌙 Salvaschermo</h4>
+                    <p class="settings-hint" data-i18n="settings.screensaver.card_hint">Mostra un orologio con fatti utili dopo un periodo di inattività. Di default è disattivato.</p>
+                    <div class="form-group">
+                        <label class="toggle-row">
+                            <span data-i18n="settings.screensaver.label">Attiva salvaschermo</span>
+                            <span class="toggle-switch">
+                                <input type="checkbox" id="setting-screensaver-enabled">
+                                <span class="toggle-slider"></span>
+                            </span>
+                        </label>
+                    </div>
+                    <div class="form-group" id="screensaver-timeout-row" style="margin-top:10px">
+                        <label for="setting-screensaver-timeout" style="font-size:0.85rem;font-weight:600;color:var(--text-secondary)" data-i18n="settings.screensaver.start_after">⏱️ Avvia dopo</label>
+                        <select id="setting-screensaver-timeout" class="form-input" style="margin-top:6px;max-width:200px">
+                            <option value="1" data-i18n="settings.screensaver.timeout_1">1 minuto</option>
+                            <option value="2" data-i18n="settings.screensaver.timeout_2">2 minuti</option>
+                            <option value="5" selected data-i18n="settings.screensaver.timeout_5">5 minuti</option>
+                            <option value="10" data-i18n="settings.screensaver.timeout_10">10 minuti</option>
+                            <option value="15" data-i18n="settings.screensaver.timeout_15">15 minuti</option>
+                            <option value="30" data-i18n="settings.screensaver.timeout_30">30 minuti</option>
+                            <option value="60" data-i18n="settings.screensaver.timeout_60">1 ora</option>
+                        </select>
+                    </div>
+                </div>
+                <div class="settings-card">
+                    <h4 data-i18n="settings.zerowaste.card_title">♻️ Suggerimenti zero-waste</h4>
+                    <p class="settings-hint" data-i18n="settings.zerowaste.card_hint">Durante la cottura, mostra consigli su come riutilizzare gli scarti prodotti in ogni passo (bucce, acqua di cottura, ecc.). Disattivo per impostazione predefinita.</p>
+                    <div class="form-group">
+                        <label class="toggle-row">
+                            <span data-i18n="settings.zerowaste.label">Mostra suggerimenti durante la cottura</span>
+                            <span class="toggle-switch">
+                                <input type="checkbox" id="setting-zerowaste-tips">
+                                <span class="toggle-slider"></span>
+                            </span>
+                        </label>
+                    </div>
+                </div>
+                <div class="settings-card">
+                    <h4 data-i18n="export.title">📤 Esporta inventario</h4>
+                    <p class="settings-hint" data-i18n="export.hint">Scarica l'inventario corrente in CSV o apri una versione stampabile (PDF).</p>
+                    <div style="display:flex;gap:8px;flex-wrap:wrap">
+                        <button class="btn btn-outline" onclick="exportInventory('csv')" style="flex:1;min-width:120px">
+                            📊 <span data-i18n="export.btn_csv">CSV</span>
+                        </button>
+                        <button class="btn btn-outline" onclick="exportInventory('html')" style="flex:1;min-width:120px">
+                            🖨️ <span data-i18n="export.btn_pdf">PDF / Stampa</span>
+                        </button>
+                    </div>
+                </div>
+            </div>
             <!-- API Keys Tab -->
-            <div class="settings-panel active" id="tab-api">
+            <div class="settings-panel" id="tab-api">
                 <div class="settings-card">
                     <h4 data-i18n="settings.gemini.title">🤖 Google Gemini AI</h4>
                     <p class="settings-hint" data-i18n="settings.gemini.hint">Chiave API per identificazione prodotti, scadenze e ricette.</p>
@@ -903,23 +1000,6 @@
                                 <option value="Japan">🇯🇵 Giappone</option>
                             </select>
                         </div>
-                        <div class="form-group">
-                            <label data-i18n="settings.price.currency_label">💱 Valuta</label>
-                            <select id="setting-price-currency" class="form-input">
-                                <option value="EUR">€ Euro (EUR)</option>
-                                <option value="USD">$ Dollaro USA (USD)</option>
-                                <option value="GBP">£ Sterlina (GBP)</option>
-                                <option value="CHF">CHF Franco Svizzero</option>
-                                <option value="CAD">CA$ Dollaro Canadese</option>
-                                <option value="AUD">A$ Dollaro Australiano</option>
-                                <option value="BRL">R$ Real Brasiliano</option>
-                                <option value="JPY">¥ Yen Giapponese</option>
-                                <option value="SEK">kr Corona Svedese</option>
-                                <option value="NOK">kr Corona Norvegese</option>
-                                <option value="DKK">kr Corona Danese</option>
-                                <option value="PLN">zł Zloty Polacco</option>
-                            </select>
-                        </div>
                         <div class="form-group">
                             <label data-i18n="settings.price.update_label">🔄 Aggiorna prezzi ogni</label>
                             <div class="qty-control">
@@ -1261,77 +1341,36 @@
                 </div>
             </div>
             <!-- Language Tab -->
-            <div class="settings-panel" id="tab-language">
+
+            <!-- Info Tab -->
+            <div class="settings-panel" id="tab-info">
+                <!-- Gemini AI Usage card -->
                 <div class="settings-card">
-                    <h4 data-i18n="settings.language.title">🌐 Lingua / Language</h4>
-                    <p class="settings-hint" data-i18n="settings.language.hint">Seleziona la lingua dell'interfaccia. Select the interface language.</p>
-                    <div class="form-group">
-                        <label data-i18n="settings.language.label">🌐 Lingua</label>
-                        <select id="setting-language" class="form-input" onchange="changeLanguage(this.value)">
-                        </select>
-                        <p class="settings-hint mt-2" data-i18n="settings.language.restart_notice">La pagina verrà ricaricata per applicare la nuova lingua.</p>
+                    <h4 data-i18n="settings.info.ai_title">Gemini AI — Token Usage</h4>
+                    <p class="settings-hint info-ai-subtitle" data-i18n="settings.info.ai_overview">Utilizzo AI, inventario e sistema</p>
+                    <div id="info-ai-content" style="margin-top:10px">
+                        <p class="settings-hint" data-i18n="settings.info.loading">Caricamento…</p>
                     </div>
                 </div>
+                <!-- Inventory card -->
                 <div class="settings-card">
-                    <h4 data-i18n="settings.screensaver.card_title">🌙 Salvaschermo</h4>
-                    <p class="settings-hint" data-i18n="settings.screensaver.card_hint">Mostra un orologio con fatti utili dopo un periodo di inattività. Di default è disattivato.</p>
-                    <div class="form-group">
-                        <label class="toggle-row">
-                            <span data-i18n="settings.screensaver.label">Attiva salvaschermo</span>
-                            <span class="toggle-switch">
-                                <input type="checkbox" id="setting-screensaver-enabled">
-                                <span class="toggle-slider"></span>
-                            </span>
-                        </label>
-                    </div>
-                    <div class="form-group" id="screensaver-timeout-row" style="margin-top:10px">
-                        <label for="setting-screensaver-timeout" style="font-size:0.85rem;font-weight:600;color:var(--text-secondary)" data-i18n="settings.screensaver.start_after">⏱️ Avvia dopo</label>
-                        <select id="setting-screensaver-timeout" class="form-control" style="margin-top:6px;max-width:200px">
-                            <option value="1" data-i18n="settings.screensaver.timeout_1">1 minuto</option>
-                            <option value="2" data-i18n="settings.screensaver.timeout_2">2 minuti</option>
-                            <option value="5" selected data-i18n="settings.screensaver.timeout_5">5 minuti</option>
-                            <option value="10" data-i18n="settings.screensaver.timeout_10">10 minuti</option>
-                            <option value="15" data-i18n="settings.screensaver.timeout_15">15 minuti</option>
-                            <option value="30" data-i18n="settings.screensaver.timeout_30">30 minuti</option>
-                            <option value="60" data-i18n="settings.screensaver.timeout_60">1 ora</option>
-                        </select>
+                    <h4 data-i18n="settings.info.inv_title">Inventario</h4>
+                    <div id="info-inv-content" style="margin-top:10px">
+                        <p class="settings-hint" data-i18n="settings.info.loading">Caricamento…</p>
                     </div>
                 </div>
+                <!-- Activity card -->
                 <div class="settings-card">
-                    <h4 data-i18n="settings.theme.title">🌙 Tema / Aspetto</h4>
-                    <p class="settings-hint" data-i18n="settings.theme.hint">Scegli il tema dell'interfaccia.</p>
-                    <div class="form-group">
-                        <label data-i18n="settings.theme.label">🌙 Tema</label>
-                        <select id="setting-dark-mode" class="form-input" onchange="_setThemeMode(this.value)">
-                            <option value="off" data-i18n="settings.theme.off">☀️ Chiaro</option>
-                            <option value="auto" selected data-i18n="settings.theme.auto">🔄 Automatico (sistema)</option>
-                            <option value="on" data-i18n="settings.theme.on">🌙 Scuro</option>
-                        </select>
+                    <h4 data-i18n="settings.info.act_title">Attività del mese</h4>
+                    <div id="info-act-content" style="margin-top:10px">
+                        <p class="settings-hint" data-i18n="settings.info.loading">Caricamento…</p>
                     </div>
                 </div>
+                <!-- System Info card -->
                 <div class="settings-card">
-                    <h4 data-i18n="settings.zerowaste.card_title">♻️ Suggerimenti zero-waste</h4>
-                    <p class="settings-hint" data-i18n="settings.zerowaste.card_hint">Durante la cottura, mostra consigli su come riutilizzare gli scarti prodotti in ogni passo (bucce, acqua di cottura, ecc.). Disattivo per impostazione predefinita.</p>
-                    <div class="form-group">
-                        <label class="toggle-row">
-                            <span data-i18n="settings.zerowaste.label">Mostra suggerimenti durante la cottura</span>
-                            <span class="toggle-switch">
-                                <input type="checkbox" id="setting-zerowaste-tips">
-                                <span class="toggle-slider"></span>
-                            </span>
-                        </label>
-                    </div>
-                </div>
-                <div class="settings-card">
-                    <h4 data-i18n="export.title">📤 Esporta inventario</h4>
-                    <p class="settings-hint" data-i18n="export.hint">Scarica l'inventario corrente in CSV o apri una versione stampabile (PDF).</p>
-                    <div style="display:flex;gap:8px;flex-wrap:wrap">
-                        <button class="btn btn-outline" onclick="exportInventory('csv')" style="flex:1;min-width:120px">
-                            📊 <span data-i18n="export.btn_csv">CSV</span>
-                        </button>
-                        <button class="btn btn-outline" onclick="exportInventory('html')" style="flex:1;min-width:120px">
-                            🖨️ <span data-i18n="export.btn_pdf">PDF / Stampa</span>
-                        </button>
+                    <h4 data-i18n="settings.info.system_title">Sistema</h4>
+                    <div id="info-system-content" style="margin-top:10px">
+                        <p class="settings-hint" data-i18n="settings.info.loading">Caricamento…</p>
                     </div>
                 </div>
             </div>
@@ -1613,6 +1652,6 @@
     </div>
 </div>
 
-<script src="assets/js/app.js?v=20260517a"></script>
+<script src="assets/js/app.js?v=20260518c"></script>
 </body>
 </html>

logs/README.md

@@ -0,0 +1,31 @@
+# logs/
+
+This directory contains EverShelf runtime log files.
+
+Files are generated automatically by `api/logger.php` and follow the naming pattern:
+
+```
+evershelf_YYYY-MM-DD_HH.log
+```
+
+The directory is tracked in git (via this README) but `.log` files are ignored via `.gitignore`.
+
+## Configuration (`.env`)
+
+| Variable | Default | Description |
+|---|---|---|
+| `LOG_LEVEL` | `INFO` | Minimum log level: `DEBUG`, `INFO`, `WARN`, `ERROR` |
+| `LOG_ROTATE_HOURS` | `24` | Hours per file before rotating |
+| `LOG_MAX_FILES` | `14` | Maximum number of rotated files to keep |
+
+## Format
+
+```
+[2026-05-18 14:23:11] [INFO ] [rid=a1b2c3d4] [action] Message {"ctx":"value"}
+```
+
+## Remote inspection
+
+```
+GET /api/?action=get_logs&lines=100&level=WARN
+```

manifest.json

@@ -2,7 +2,7 @@
     "name": "EverShelf",
     "short_name": "EverShelf",
     "description": "Gestione completa della dispensa di casa con scansione barcode",
-    "version": "1.7.22",
+    "version": "1.7.23",
     "start_url": "/evershelf/",
     "display": "standalone",
     "background_color": "#f0f4e8",

translations/de.json

@@ -755,13 +755,54 @@
       "label": "🌙 Design",
       "off": "☀️ Hell",
       "on": "🌙 Dunkel",
-      "auto": "🔄 Automatisch (System)"
+      "auto": "🔄 Automatisch (Tageszeit)"
     },
     "zerowaste": {
       "card_title": "♻️ Zero-Waste-Tipps",
       "card_hint": "Zeige während des Kochens Tipps zur Wiederverwendung von Abfällen (Schalen, Kochwasser usw.). Standardmäßig deaktiviert.",
       "label": "Tipps beim Kochen anzeigen"
-    }
+    },
+    "info": {
+      "tab": "Info",
+      "ai_title": "Gemini AI — Token-Nutzung",
+      "ai_hint": "Monatlicher Verbrauch und geschätzte Kosten für den aktuellen API-Schlüssel.",
+      "loading": "Laden…",
+      "total_tokens": "Token gesamt",
+      "est_cost": "Gesch. Kosten",
+      "input_tok": "Eingabe-Token",
+      "output_tok": "Ausgabe-Token",
+      "ai_calls": "Aufrufe",
+      "by_action": "Aufschlüsselung nach Funktion",
+      "by_model": "Aufschlüsselung nach Modell",
+      "pricing_note": "Gemini Referenzpreise: 2.5-flash $0.15/M in · $0.60/M out — 2.0-flash $0.10/M in · $0.40/M out.",
+      "system_title": "System",
+      "db_size": "Datenbank",
+      "log_size": "Protokolle",
+      "log_level": "Log-Level",
+      "ai_overview": "KI-Nutzungsübersicht, Inventar und Systemstatus",
+      "calls_unit": "Aufrufe",
+      "inv_title": "Inventar",
+      "inv_active": "Aktiv",
+      "inv_products": "Produkte gesamt",
+      "inv_expiring": "Ablaufend (7T)",
+      "inv_expired": "Abgelaufen",
+      "inv_finished": "Leer",
+      "act_title": "Monatliche Aktivität",
+      "act_tx_month": "Bewegungen",
+      "act_restock": "Einkäufe",
+      "act_use": "Verbrauch",
+      "act_new_products": "Neue Produkte",
+      "act_tx_year": "Jährl. Bewegungen",
+      "price_cache": "Preiscache",
+      "cache_entries": "Produkte",
+      "last_backup": "Letztes Backup",
+      "bring_days": "Token läuft in {n} Tagen ab",
+      "bring_expired": "Token abgelaufen",
+      "year_label": "Jahr {year}",
+      "currency_title": "Währung",
+      "currency_hint": "Die Währung, die für alle Kosten und Preise in der App verwendet wird."
+    },
+    "tab_general": "Allgemein"
   },
   "expiry": {
     "today": "HEUTE",

translations/en.json

@@ -755,13 +755,54 @@
       "label": "🌙 Theme",
       "off": "☀️ Light",
       "on": "🌙 Dark",
-      "auto": "🔄 Auto (system)"
+      "auto": "🔄 Automatic (time of day)"
     },
     "zerowaste": {
       "card_title": "♻️ Zero-waste tips",
       "card_hint": "During cooking, show tips on how to reuse scraps generated in each step (peels, cooking water, etc.). Disabled by default.",
       "label": "Show tips during cooking"
-    }
+    },
+    "info": {
+      "tab": "Info",
+      "ai_title": "Gemini AI — Token Usage",
+      "ai_hint": "Monthly consumption and estimated cost for the current API key.",
+      "loading": "Loading…",
+      "total_tokens": "Total tokens",
+      "est_cost": "Est. cost",
+      "input_tok": "Input tokens",
+      "output_tok": "Output tokens",
+      "ai_calls": "Calls",
+      "by_action": "Breakdown by function",
+      "by_model": "Breakdown by model",
+      "pricing_note": "Gemini reference pricing: 2.5-flash $0.15/M in · $0.60/M out — 2.0-flash $0.10/M in · $0.40/M out.",
+      "system_title": "System",
+      "db_size": "Database",
+      "log_size": "Logs",
+      "log_level": "Log level",
+      "ai_overview": "AI usage overview, inventory and system status",
+      "calls_unit": "calls",
+      "inv_title": "Inventory",
+      "inv_active": "Active",
+      "inv_products": "Total products",
+      "inv_expiring": "Expiring (7d)",
+      "inv_expired": "Expired",
+      "inv_finished": "Finished",
+      "act_title": "Monthly activity",
+      "act_tx_month": "Movements",
+      "act_restock": "Restocks",
+      "act_use": "Usages",
+      "act_new_products": "New products",
+      "act_tx_year": "Yearly movements",
+      "price_cache": "Price cache",
+      "cache_entries": "products",
+      "last_backup": "Last backup",
+      "bring_days": "token expires in {n} days",
+      "bring_expired": "token expired",
+      "year_label": "Year {year}",
+      "currency_title": "Currency",
+      "currency_hint": "The currency used for all costs and prices in the app."
+    },
+    "tab_general": "General"
   },
   "expiry": {
     "today": "TODAY",

translations/it.json

@@ -755,13 +755,54 @@
       "label": "🌙 Tema",
       "off": "☀️ Chiaro",
       "on": "🌙 Scuro",
-      "auto": "🔄 Automatico (sistema)"
+      "auto": "🔄 Automatico (orario)"
     },
     "zerowaste": {
       "card_title": "♻️ Suggerimenti zero-waste",
       "card_hint": "Durante la cottura, mostra consigli su come riutilizzare gli scarti prodotti in ogni passo (bucce, acqua di cottura, ecc.). Disattivo per impostazione predefinita.",
       "label": "Mostra suggerimenti durante la cottura"
-    }
+    },
+    "info": {
+      "tab": "Info",
+      "ai_title": "Gemini AI — Utilizzo Token",
+      "ai_hint": "Consumo mensile e costo stimato per la chiave API corrente.",
+      "loading": "Caricamento…",
+      "total_tokens": "Token totali",
+      "est_cost": "Costo stimato",
+      "input_tok": "Token input",
+      "output_tok": "Token output",
+      "ai_calls": "Chiamate",
+      "by_action": "Dettaglio per funzione",
+      "by_model": "Dettaglio per modello",
+      "pricing_note": "Prezzi di riferimento Gemini: 2.5-flash $0.15/M in · $0.60/M out — 2.0-flash $0.10/M in · $0.40/M out.",
+      "system_title": "Sistema",
+      "db_size": "Database",
+      "log_size": "Log",
+      "log_level": "Livello log",
+      "ai_overview": "Prospetto utilizzo AI, inventario e stato del sistema",
+      "calls_unit": "call",
+      "inv_title": "Inventario",
+      "inv_active": "Attivi",
+      "inv_products": "Prodotti totali",
+      "inv_expiring": "In scadenza (7gg)",
+      "inv_expired": "Scaduti",
+      "inv_finished": "Finiti",
+      "act_title": "Attività del mese",
+      "act_tx_month": "Movimenti",
+      "act_restock": "Acquisti",
+      "act_use": "Consumi",
+      "act_new_products": "Nuovi prodotti",
+      "act_tx_year": "Movimenti anno",
+      "price_cache": "Cache prezzi",
+      "cache_entries": "prodotti",
+      "last_backup": "Ultimo backup",
+      "bring_days": "token scade tra {n} giorni",
+      "bring_expired": "token scaduto",
+      "year_label": "Anno {year}",
+      "currency_title": "Valuta",
+      "currency_hint": "La valuta usata per tutti i costi e i prezzi nell'app."
+    },
+    "tab_general": "Generali"
   },
   "expiry": {
     "today": "OGGI",