Finish compose and add license comments

README.md

@@ -132,9 +132,33 @@ docker compose up -d --build
 ```
 3. Il container dovrebbe diventare disponibile su ``http://localhost:8080``
 
-### Per utenti Docker avanzati
-Se sei un utente Docker avanzato e vuoi personalizzare puoi modificare la configurazione di docker nei file ``docker/php/config.php``, ``docker-compose.yml`` e ``Dockerfile`` per adattare tutto al tuo ambiente.
-Per la maggior parte degli utenti consigliamo di usare la configurazione per Docker predefinita.
+### Personalizzare l'istanza
+Per cambiare le impostazioni dell'istanza basta aprire ``docker-compose.yml`` con un editor di testo e modificare le variabili d'ambiente:
+```yaml
+    environment:
+      # --- Configuratione Database ---
+      DB_HOST: db # Host database
+      DB_USER: orario # Utente database
+      DB_PASS: orario # Password dell'utente del database
+      DB_NAME: school_timetable # Nome del database
+
+      # --- Impostazioni sito ---
+      APP_NAME: "Orario Scuola" # Nome del sito
+      YEAR: "2025/26" # Anno scolastico corrente
+      API_URL: "" # URL della API per l'importazione, lascia vuoto per disabilitare
+      DEV_MODE: "false" # Abilita modalita' di sviluppo per output dettagliato.
+
+      # --- Impostazioni Autenticazione ---
+      AUTH_TYPE: "local" # Tipo di autenticazione: può essere local o keycloak
+      APP_DOMAIN: "" # Dominio dell'app, ad esempio orario.tuosito.com
+
+      # --- Impostazioni di Keycloak (solo se il tipo di autenticazione è Keycloak) ---
+      KEYCLOAK_DOMAIN: "" # Dominio di Keycloak, ad esempio sso.tuosito.com
+      KEYCLOAK_REALM: "" # Realm di Keycloak, ad esempio master
+      KEYCLOAK_CLIENT_ID: "" # Client ID per Keycloak, ad esempio orario
+      KEYCLOAK_CLIENT_SECRET: "" # Client Secret per Keycloak, ad esempio abcde12345
+      KEYCLOAK_ALLOWED_USERS: '[]' # Nomi utente che possono accedere al pannello di controllo, lascia vuoto per consentire tutti gli utenti. Esempio: '["admin","prof","segreteria"]'
+```
 
 ## Segnalare un problema
 Per segnalare un problema puoi usare [Bugzilla](https://bugs.vichingo455.freeddns.org/describecomponents.cgi?product=Orario%20Scuola). Clicca [qui](https://bugs.vichingo455.freeddns.org/describecomponents.cgi?product=Orario%20Scuola) per andare a Bugzilla.

docker-compose.yml

@@ -15,10 +15,10 @@ services:
       DB_NAME: school_timetable # Nome del database
 
       # --- Impostazioni sito ---
-      APP_NAME: "Orario Scuola"
-      YEAR: "2025/26"
-      API_URL: ""
-      DEV_MODE: "false"
+      APP_NAME: "Orario Scuola" # Nome del sito
+      YEAR: "2025/26" # Anno scolastico corrente
+      API_URL: "" # URL della API per l'importazione, lascia vuoto per disabilitare
+      DEV_MODE: "false" # Abilita modalita' di sviluppo per output dettagliato.
 
       # --- Impostazioni Autenticazione ---
       AUTH_TYPE: "local" # Tipo di autenticazione: può essere local o keycloak
@@ -29,16 +29,16 @@ services:
       KEYCLOAK_REALM: "" # Realm di Keycloak, ad esempio master
       KEYCLOAK_CLIENT_ID: "" # Client ID per Keycloak, ad esempio orario
       KEYCLOAK_CLIENT_SECRET: "" # Client Secret per Keycloak, ad esempio abcde12345
-      KEYCLOAK_ALLOWED_USERS: '["admin","prof","segreteria"]'
+      KEYCLOAK_ALLOWED_USERS: '[]' # Nomi utente che possono accedere al pannello di controllo, lascia vuoto per consentire tutti gli utenti. Esempio: '["admin","prof","segreteria"]'
   db:
     image: mariadb:11
     container_name: orario-db
     restart: unless-stopped
     environment:
-      MYSQL_ROOT_PASSWORD: P@ssw0rd
-      MYSQL_DATABASE: school_timetable
-      MYSQL_USER: orario
-      MYSQL_PASSWORD: orario
+      MYSQL_ROOT_PASSWORD: P@ssw0rd # Password dell'utente root del database
+      MYSQL_DATABASE: school_timetable # Nome del database, da impostare in DB_NAME
+      MYSQL_USER: orario # Utente del database, da impostare in DB_USER
+      MYSQL_PASSWORD: orario # Password del database, da impostare in DB_PASS
     volumes:
       - db_data:/var/lib/mysql
       - ./schema.sql:/docker-entrypoint-initdb.d/init.sql:ro

docker/php/config.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 // Impostazioni Database
 if (!defined('DB_HOST')) {
     $val = getenv('DB_HOST');

htdocs/admin/classes.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 session_start();
 if (!isset($_SESSION['admin'])) { header("Location: login.php"); exit; }
 include("../lib/db.php");

htdocs/admin/importer.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 session_start();
 if (!isset($_SESSION['admin'])) { header("Location: login.php"); exit; }
 else if (!defined(API_URL) || API_URL == "") { header("Location: index.php"); exit; }

htdocs/admin/index.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include_once __DIR__ . '/../config/config.php';
 session_start();
 if (!isset($_SESSION['admin'])) {

htdocs/admin/login.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 use Jumbojett\OpenIDConnectClient;
 require 'vendor/autoload.php';
 session_start();

htdocs/admin/logout.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include("../config/config.php");
 session_start();
 session_destroy();

htdocs/admin/password.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 session_start();
 include("../lib/db.php");
 

htdocs/admin/style.css

@@ -1,3 +1,19 @@
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 /* ===== BASE ===== */
 body {
   font-family: Arial, sans-serif;

htdocs/admin/subjects.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 session_start();
 if (!isset($_SESSION['admin'])) { header("Location: login.php"); exit; }
 include("../lib/db.php");

htdocs/admin/timetable.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 session_start();
 if (!isset($_SESSION['admin'])) { header("Location: login.php"); exit; }
 include("../lib/db.php");

htdocs/admin/users.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 session_start();
 include("../lib/db.php");
 

htdocs/config/config.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 // Impostazioni Database
 if (!defined('DB_HOST')) {
     define('DB_HOST', '<MYSQL_HOST>'); // Host del database (ad esempio localhost)

htdocs/css/home.css

@@ -1,3 +1,19 @@
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 /* Base styles */
 body {
     font-family: Arial, sans-serif;

htdocs/css/navbar.css

@@ -1,3 +1,19 @@
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 /* Navbar */
 .navbar {
     background-color: #2c3e50;

htdocs/css/timetable.css

@@ -1,3 +1,19 @@
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 /* Base styles */
 body {
     font-family: Arial, sans-serif;

htdocs/docenti.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include("lib/db.php");
 $days = ["Lunedì","Martedì","Mercoledì","Giovedì","Venerdì","Sabato"];
 $hours = [

htdocs/index.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include("lib/db.php");
 ?>
 <!DOCTYPE html>

htdocs/laboratori.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include("lib/db.php");
 $days = ["Lunedì","Martedì","Mercoledì","Giovedì","Venerdì","Sabato"];
 $hours = [

htdocs/lib/db.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include_once __DIR__ . '/../config/config.php';
 $host = DB_HOST;
 $user = DB_USER;

htdocs/studenti.php

@@ -1,4 +1,20 @@
 <?php
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 include("lib/db.php");  // FIX: Decommentato
 $class_id = intval($_GET['class_id']);
 $class = $conn->query("SELECT * FROM classes WHERE id=$class_id")->fetch_assoc();

utils/generate_hash.php

@@ -1,9 +1,20 @@
 <?php
-// Hashed Password Generator
-// Copyright (C) 2025 EmmeV. All rights reserved.
-// Usage: php generate_hash.php password_to_hash
-// Example: php generate_hash.php admin
+/*
+Orario Scuola, Copyright (C) 2025 EmmeV.
 
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
 if ($argc > 1) {
     $primoArgomento = $argv[1];
     $password = password_hash($primoArgomento, PASSWORD_DEFAULT);