From 30f4bf4a1b86643d29d71a5de767ea12561854df Mon Sep 17 00:00:00 2001
From: dadaloop82 <evershelfproject@gmail.com>
Date: Mon, 18 May 2026 05:48:20 +0000
Subject: [PATCH] chore: sposta cartella log in logs/ alla root del progetto

- api/logger.php: path aggiornato da data/logs/ a logs/
- logs/README.md: placeholder con documentazione formato e configurazione
- .gitignore: aggiunto logs/*.log (file ignorati, cartella tracciata)
---
 .gitignore     |  1 +
 api/logger.php |  4 ++--
 logs/README.md | 31 +++++++++++++++++++++++++++++++
 3 files changed, 34 insertions(+), 2 deletions(-)
 create mode 100644 logs/README.md

diff --git a/.gitignore b/.gitignore
index 96b8b31..a8603ac 100644
--- a/.gitignore
+++ b/.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
diff --git a/api/logger.php b/api/logger.php
index 6884d55..815d344 100644
--- a/api/logger.php
+++ b/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);
diff --git a/logs/README.md b/logs/README.md
new file mode 100644
index 0000000..3a12f43
--- /dev/null
+++ b/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
+```