chore: auto-merge develop → main

Triggered by: 30f4bf4 chore: sposta cartella log in logs/ alla root del progetto

.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

api/logger.php

@@ -13,7 +13,7 @@
  *   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: data/logs/evershelf_YYYY-MM-DD_HH.log
+ * 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 {
@@ -54,7 +54,7 @@ class EverLog {
         self::$requestId   = substr(bin2hex(random_bytes(4)), 0, 8);
 
         // Ensure log directory exists
-        $base         = dirname(__DIR__) . '/data/logs';
+        $base         = dirname(__DIR__) . '/logs';
         self::$logDir = $base;
         if (!is_dir($base)) {
             @mkdir($base, 0755, true);

logs/README.md

@@ -0,0 +1,31 @@
+# logs/
+
+Questa cartella contiene i log di runtime di EverShelf.
+
+I file vengono generati automaticamente da `api/logger.php` e hanno la forma:
+
+```
+evershelf_YYYY-MM-DD_HH.log
+```
+
+La cartella è inclusa in git (tramite questo README) ma i file `.log` sono ignorati via `.gitignore`.
+
+## Configurazione (`.env`)
+
+| Variabile | Default | Descrizione |
+|---|---|---|
+| `LOG_LEVEL` | `INFO` | Livello minimo: `DEBUG`, `INFO`, `WARN`, `ERROR` |
+| `LOG_ROTATE_HOURS` | `24` | Ore per file prima di ruotare |
+| `LOG_MAX_FILES` | `14` | Numero massimo di file da conservare |
+
+## Formato
+
+```
+[2026-05-18 14:23:11] [INFO ] [rid=a1b2c3d4] [action] Messaggio {"ctx":"value"}
+```
+
+## Inspection remota
+
+```
+GET /api/?action=get_logs&lines=100&level=WARN
+```