feat: implementazione V1 - app.py, Dockerfile, docker-compose, .env.example, requirements

README.md

@@ -32,12 +32,12 @@ E' consigliato mantenere nel repository anche un file `.env.example` con le sole
 ### Esempio di `.env.example`
 
 ```env
-SUPABASE_DB_HOST=
+SUPABASE_DB_HOST=db.<project-ref>.supabase.co
 SUPABASE_DB_PORT=5432
-SUPABASE_DB_NAME=
-SUPABASE_DB_USER=
+SUPABASE_DB_NAME=postgres
+SUPABASE_DB_USER=postgres
 SUPABASE_DB_PASSWORD=
-PING_INTERVAL_MINUTES=30
+PING_INTERVAL_MINUTES=4320
 PING_QUERY=SELECT 1;
 TZ=Europe/Rome
 ```
@@ -49,7 +49,7 @@ TZ=Europe/Rome
 - `SUPABASE_DB_NAME`: nome del database.
 - `SUPABASE_DB_USER`: utente di connessione.
 - `SUPABASE_DB_PASSWORD`: password di connessione.
-- `PING_INTERVAL_MINUTES`: intervallo tra un keep-alive e il successivo.
+- `PING_INTERVAL_MINUTES`: intervallo tra un keep-alive e il successivo. Default `4320` (72 ore, circa 3 volte a settimana).
 - `PING_QUERY`: query leggera da eseguire per generare attivita'.
 - `TZ`: timezone del container per logging e scheduling coerenti.
 
@@ -105,16 +105,20 @@ Stop:
 docker compose down
 ```
 
-## Struttura minima attesa del progetto
+## Struttura del progetto
 
 ```text
 .
-|-- .env
-|-- .env.example
+|-- .env                  # credenziali locali (non versionato)
+|-- .env.example          # modello variabili senza segreti
+|-- .gitignore
+|-- app.py                # entrypoint del servizio
+|-- docker-compose.yml
 |-- Dockerfile
-|-- requirements.txt
-|-- app.py
-`-- README.md
+|-- prd.md                # product requirements document
+|-- progress.md           # piano e stato di sviluppo
+|-- README.md
+`-- requirements.txt
 ```
 
 ## Note operative