RateOS salva clienti, pratiche e rate su un cluster TiDB Cloud Serverless (gratuito fino a 5 GB / 50M RU al mese — ampiamente sufficiente per uno studio).

1.1 Crea l'account

1. Vai su tidbcloud.com → Sign in with Google con l'account dello studio.

1.2 Crea il cluster

1. Click "Create Cluster" dalla dashboard.
2. Tipo: Serverless.
3. Nome cluster: rateos-cluster (o quello che preferisci).
4. Cloud Provider: AWS.
5. Region: Frankfurt (eu-central-1) — la più vicina/conforme GDPR.
6. Click "Create". Attendi ~30 secondi.

1.3 Genera la password

1. Si apre il popup "Connect" (oppure click sul bottone "Connect" in alto a destra del cluster).
2. Click "Generate Password".
3. Copia subito la password — viene mostrata una volta sola.

1.4 Recupera i parametri

Sempre nel popup "Connect", scheda "General" o "MySQL CLI", vedrai una stringa tipo:

mysql -u '3F4bknhgvSAqd6p.root' -h 'gateway01.eu-central-1.prod.aws.tidbcloud.com' -P 4000 -D test --ssl-mode=VERIFY_IDENTITY ...

Annota i valori in rosso. Ti servono per la pagina Configurazione:

• TIDB_USER = la parte tra apici dopo -u
• TIDB_HOST = la parte tra apici dopo -h
• TIDB_PORT = 4000
• TIDB_PASSWORD = quella copiata al punto 1.3
• TIDB_DB_NAME = rateos_db (RateOS lo crea automaticamente)

RateOS invia ai clienti un promemoria via email 10 giorni prima della scadenza, con il modello F24 in allegato.

Caso A — Google Workspace o Gmail

1. Verifica che la verifica in 2 passaggi sia attiva: myaccount.google.com/security. Senza 2FA non puoi creare App Password.
2. Vai su myaccount.google.com/apppasswords.
3. Inserisci il nome app: RateOS e click "Crea".
4. Compare una password di 16 caratteri (es. abcd efgh ijkl mnop): copiala subito.
5. Nella Configurazione compila:
   • SMTP_SERVER = smtp.gmail.com
   • SMTP_PORT = 587
   • SMTP_USER = la tua email completa
   • SMTP_PASSWORD = i 16 caratteri (rimuovi gli spazi)

Caso B — Aruba

• SMTP_SERVER = smtps.aruba.it
• SMTP_PORT = 465
• SMTP_USER/SMTP_PASSWORD = le credenziali email Aruba

Caso C — altro provider

Recupera server SMTP, porta e credenziali dal pannello del tuo provider. RateOS supporta STARTTLS (porta 587) e SSL diretto (porta 465).

Dopo aver salvato la configurazione:

1. Apri il terminale (PowerShell) nella cartella RateOS.
2. Riavvia il server:

   .\venv\Scripts\python.exe -m uvicorn web.app:app --host 127.0.0.1 --port 8000 --reload

3. Apri il browser su http://127.0.0.1:8000.
4. (Solo prima volta) Vai su Configurazione e testa connessione DB e SMTP.
5. (Solo prima volta) Da terminale, inizializza il database:

   .\venv\Scripts\python.exe main.py --init-db

6. Inizia caricando il primo avviso bonario: Carica avviso