From 48092b7f758f4760f10f57fc053e0768476fd148 Mon Sep 17 00:00:00 2001
From: Vichingo455 <vichingo455@gmail.com>
Date: Thu, 30 Oct 2025 08:28:55 +0100
Subject: [PATCH] Readme

---
 README.md | 49 ++++++++++++++++++++++++++-----------------------
 1 file changed, 26 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index c827382..de20e6b 100644
--- a/README.md
+++ b/README.md
@@ -59,54 +59,57 @@ VALUES ('admin', '$2y$10$IS9v8CJNJnRXslV1NWDSquAjJ0GgU1sm6spBmGp6mjTLiNApfGcQi')
 <?php
 // Impostazioni Database
 if (!defined('DB_HOST')) {
-    define('DB_HOST', 'db');
+    define('DB_HOST', 'db'); // Host del database (ad esempio localhost)
 }
 if (!defined('DB_USER')) {
-    define('DB_USER', 'orario');
+    define('DB_USER', 'orario'); // Utente del database (ad esempio orario)
 }
 if (!defined('DB_PASS')) {
-    define('DB_PASS', 'orario');
+    define('DB_PASS', 'orario'); // Password dell'utente specificato prima (ad esempio password123)
 }
 if (!defined('DB_NAME')) {
-    define('DB_NAME', 'school_timetable');
+    define('DB_NAME', 'school_timetable'); // Nome del database, non modificare se non sai cosa stai facendo.
 }
 // Impostazioni sito generali
 if (!defined('APP_NAME')) {
-    define('APP_NAME', 'Orario Scuola');
+    define('APP_NAME', 'Orario Scuola'); // Nome del sito
 }
 if (!defined('YEAR')) {
-    define('YEAR', '2025/26');
+    define('YEAR', '2025/26'); // Anno Scolastico Corrente
 }
 if (!defined('DEV_MODE')) {
-    define('DEV_MODE', false); // Modalita' di sviluppo
+    define('DEV_MODE', false); // Modalita' di sviluppo: abilita messaggi di debug aggiuntivi. Imposta su false se sei in produzione
 }
 // Impostazioni autenticazione dashboard amministrativa
 if (!defined('AUTH_TYPE')) {
-    define('AUTH_TYPE','local'); // Può essere keycloak o local (integrata)
-}
-if (!defined('KEYCLOAK_DOMAIN')) {
-    define('KEYCLOAK_DOMAIN','');
-}
-if (!defined('KEYCLOAK_REALM')) {
-    define('KEYCLOAK_REALM','');
-}
-if (!defined('KEYCLOAK_CLIENT_ID')) {
-    define('KEYCLOAK_CLIENT_ID','');
-}
-if (!defined('KEYCLOAK_CLIENT_SECRET')) {
-    define('KEYCLOAK_CLIENT_SECRET','');
+    define('AUTH_TYPE','local'); // Può essere local (integrata), keycloak
 }
 if (!defined('APP_DOMAIN')) {
-    define('APP_DOMAIN','');
+    define('APP_DOMAIN',''); // Dominio del sito (ad esempio orario.yourdomain.com), richiesto per autenticazioni non local
+}
+// Impostazioni autenticazione via Keycloak (richiesto solo se AUTH_TYPE sta impostato su keycloak)
+if (AUTH_TYPE === 'keycloak') {
+    if (!defined('KEYCLOAK_DOMAIN')) {
+        define('KEYCLOAK_DOMAIN',''); // Dominio di Keycloak (ad esempio auth.yourdomain.com)
+    }
+    if (!defined('KEYCLOAK_REALM')) {
+        define('KEYCLOAK_REALM',''); // Realm di Keycloak (ad esempio master)
+    }
+    if (!defined('KEYCLOAK_CLIENT_ID')) {
+        define('KEYCLOAK_CLIENT_ID',''); // Client ID per Keycloak (ad esempio orario)
+    }
+    if (!defined('KEYCLOAK_CLIENT_SECRET')) {
+        define('KEYCLOAK_CLIENT_SECRET',''); // Client Secret per Keycloak (ad esempio abcdefghijklm)
+    }
 }
 ?>
 ```
 7. **Apri ``http://localhost`` e goditi il sito**
 
 ## Installazione con Docker
-NOTA: L'installazione con Docker è in fase di sviluppo attivo, quindi potrebbe non funzionare.
-1. Installa Docker
+1. Installa Curl, Git e Docker
 ```bash
+apt install curl git
 curl -fsSL https://get.docker.com | bash
 ```
 2. Compila e crea il container: