LAVORO AUTONOMO OCCASIONALE - versione web (PHP + SQLite)
=========================================================

VERSIONE: vedi Licenza e versione (numero in inc/versione.php, comunicato al server licenze)

REQUISITI
- Certificato SSL attivo sul sito (HTTPS obbligatorio)
- PHP 8.1 o superiore con estensioni pdo_sqlite, openssl, mbstring, sodium (GD consigliata per le firme, cURL consigliata)
- Hosting Apache (Aruba Linux va bene): i file .htaccess proteggono le cartelle data/, inc/, lib/

INSTALLAZIONE
1. Carica la cartella "prestazioneoccasionale" nella root del sito (es. www.tuosito.it/prestazioneoccasionale/).
2. La cartella data/ deve essere scrivibile da PHP (su Aruba lo è già).
3. Apri l'indirizzo nel browser: alla prima apertura crei l'utente amministratore (e-mail + password).
4. Impostazioni -> E-mail: scegli il provider (Aruba, Yahoo, Gmail...), inserisci utente e password
   e premi "Salva e invia prova". Per Yahoo e Gmail serve una "password per le app".
5. Backup e dati -> "Importa dal programma desktop": carica il file sqlite.db del vecchio
   LavoroAutonomoOccasionale.exe. Le firme erano file sul PC: ricaricale nella scheda di ogni mittente.

FUNZIONI
- Ricevute con numerazione per anno, calcolo netto/lordo/ritenuta (scrivi il netto o il lordo)
- Ricevuta in PDF con grafica moderna (colore del tema scelto, firma del mittente, spazio per la marca da bollo
  quando l'importo supera 77,47 €), PDF della nota interna
- Elenco con filtri, totali e indicatori dei limiti (compensi annui, per destinatario, giorni)
- Esportazione dell'elenco in Excel .xlsx (elenco + riepiloghi per prestatore, committente e mese, totali con formule), CSV e PDF
- Invio della ricevuta per e-mail con PDF allegato (storico degli invii)
- Riepilogo ritenute / dati F24 del percipiente
- Testi in fondo alla ricevuta (dichiarazione, ritenuta, bollo) modificabili da Impostazioni
- Link esterni (normativa, F24, sito) modificabili da Impostazioni -> Link esterni:
  titolo, indirizzo, posizione (menu, scheda ricevuta, fondo del menu), ordine, aggiunta/eliminazione
- Anagrafiche destinatari e mittenti, con Importa / Esporta in Excel (.xlsx) e CSV:
  importazione guidata con abbinamento colonne, anteprima, controlli, gestione doppioni e backup automatico, importazione destinatari da CSV
- Registro attività (menu Registro attività, solo amministratore): cronologia di accessi, ricevute (con modifiche
  prima/dopo), anagrafiche, invii, impostazioni, utenti, backup e licenza; filtri, stampa, Excel/CSV. Dati cifrati,
  conservazione impostabile (predefinito 1 anno). Cronologia anche nella scheda di ricevute e anagrafiche.
- Informativa privacy (Impostazioni -> Informativa privacy): pagina del gestionale con testo modificabile
  (modello GDPR precompilato da far verificare al proprio consulente), stampabile o salvabile in PDF,
  oppure link alla pagina privacy già pubblicata sul sito. Il link compare nell'accesso, nel menu e nelle e-mail.
- Ricerca e scelta tra le descrizioni già usate (prima quelle del prestatore scelto)
- Utenti con ruoli (amministratore, utente, sola lettura), accesso in due passaggi via e-mail,
  recupero password, blocco dopo troppi tentativi
- Backup automatico giornaliero sul server (ultimi 30), download, ripristino, esportazione CSV

LICENZA D'USO (menu Preferenze > Licenza e versione)
- Stesso sistema degli altri gestionali Soloservizi: server licenze su www.soloservizi.info,
  prodotto "prestazioneoccasionale" (i codici generati dal pannello iniziano con PRES-).
- Al primo avvio partono 30 giorni di prova, registrati automaticamente sul server per dominio.
- Attivazione: dal pannello licenze crei la licenza annuale con prodotto "prestazioneoccasionale".
  Puoi collegarla al dominio dal pannello (poi basta "Verifica ora") oppure dare al cliente il
  codice da inserire nella pagina Licenza e versione. Un codice vale per un solo dominio.
- Verifica automatica ogni 12 ore. Avvisi all'amministratore: giorni di prova rimasti e scadenza
  nei 30 giorni precedenti, con il pulsante per chiedere attivazione o rinnovo via e-mail.
- Alla scadenza: 7 giorni di tolleranza, poi SOLA LETTURA (si consulta, stampa, esporta e fa il
  backup, ma non si salva nulla). Nessun dato è perso: dopo il rinnovo basta "Verifica ora".
- Server licenze non raggiungibile: avviso dopo 7 giorni, sola lettura dopo 30 giorni senza contatto.
- Le risposte del server sono firmate (Ed25519): modifiche manuali al database non attivano nulla.
- In config.php si possono indicare LICENZA_SERVER e LICENZA_CHIAVE (facoltativi).

AGGIORNAMENTI
- Carica i nuovi file sovrascrivendo i vecchi, senza toccare la cartella data/.
- Il numero di versione è in inc/versione.php, con l'elenco delle novità mostrato nel gestionale.
- Il pannello licenze mostra la versione usata da ogni installazione.

SICUREZZA E DATI PERSONALI
- Dati cifrati nel database e nei backup (AES-256-GCM): dei prestatori codice fiscale, IBAN, data,
  luogo e provincia di nascita, indirizzo, telefono, cellulare, e-mail; dei committenti CF/P. IVA,
  telefono, cellulare, e-mail e PEC. Nomi, città e importi restano in chiaro per ricerche e ordinamenti.
  Alla prima apertura della 6.4 i dati già presenti vengono cifrati in automatico.
- La chiave è in data/.chiave.php (file PHP: anche se la cartella fosse esposta non si legge).
  Per la massima sicurezza spostala fuori dalla cartella del sito: config.php -> CHIAVE_FILE.
  IMPORTANTE: scaricala da Backup e dati -> "Scarica la chiave" (serve la tua password) e conservala
  separata dai backup. Senza chiave i backup non si possono ripristinare su un'altra installazione.
- Password degli utenti salvate come impronta (bcrypt); password della posta cifrata; codici di
  accesso e link di recupero salvati come impronta.
- HTTPS OBBLIGATORIO: ogni richiesta in http viene portata su https (PHP e .htaccess) e il browser riceve
  HSTS (1 anno). Il sito deve avere il certificato SSL attivo. Solo su localhost/127.0.0.1 si può provare in http.
- Pagine con dati personali non salvate nella cache del browser; Content-Security-Policy; Esci protetto.
- Cartelle data/, inc/, lib/ bloccate dal web con .htaccess (Apache) e web.config (hosting Windows/IIS).
- Impostazioni -> Controllo sicurezza verifica tutto, compreso un test reale dal browser che la
  cartella data/ non sia scaricabile.
- Protezione CSRF su tutti i moduli, sessioni con cookie HttpOnly/SameSite, blocco dopo troppi tentativi.

