fasas-deploy

FASAS Digitale — versione Cloud/Web

Portale web per la gestione del Fascicolo Socio Assistenziale Sanitario di una comunità. Questa repository contiene la versione destinata all’hosting cloud, accessibile da browser e smartphone.

Attenzione: il software è ancora in fase pilota. Non caricare informazioni sanitarie reali prima delle verifiche indipendenti di sicurezza, degli adempimenti privacy e della validazione clinica.

Cosa contiene questa repository

Componente Funzione
fasas/, config/, templates/, static/ Backend Django, API e interfaccia web
Dockerfile, docker/cloud.sh, docker/entrypoint.sh Avvio cloud in un container
render.yaml Configurazione del servizio Render, regione UE
supabase/migrations/ Schema PostgreSQL e protezione dei dati
.env.cloud.example Elenco delle variabili da configurare nel servizio di hosting
.github/workflows/ci.yml Test del portale, sicurezza e collaudo cloud
docs/CLOUD.md Guida completa per pubblicazione e collegamento al dominio

Non sono distribuiti qui il server locale con Docker Compose, gli script per l’installazione su PC, la configurazione di VPN/UPS/dischi USB, né i progetti nativi FASAS Signer per Android, iOS e desktop. Questi restano nella repository di sviluppo.

Architettura

Browser / smartphone
        |
     HTTPS
        |
    fasas.online
        |
Render (Django + Gunicorn + pianificatore integrato)
        |
Supabase in UE (PostgreSQL + Storage privato)

Il backend Python non può essere eseguito da GitHub Pages: GitHub conserva il codice, Render esegue il servizio web e Supabase ospita database e documenti cifrati.

Pubblicazione cloud

Seguire docs/CLOUD.md nell’ordine:

  1. Creare un progetto Supabase in una regione UE, riservato al FASAS.
  2. Applicare le migrazioni SQL e verificare la chiusura delle API di Supabase.
  3. Creare il bucket privato fasas-documenti e predisporre i backup cifrati fuori sede.
  4. In Render, creare un Blueprint collegato a questa repository e al branch main.
  5. Inserire i segreti e le credenziali solamente nelle variabili di ambiente di Render, facendo riferimento a .env.cloud.example. Non salvarli su GitHub.
  6. Associare il dominio fasas.online a Render e configurare i record DNS presso il registrar.
  7. Verificare HTTPS, pagina /salute/, login, 2FA, allegati, audit e backup usando solo dati inventati.

Il file render.yaml disabilita il deploy automatico: per ogni nuova versione, eseguire il deploy manuale dopo che i test di GitHub Actions sono passati.

Sicurezza e requisiti prima dell’uso reale

Le guide sull’installazione fisica sono consultabili soltanto nella repository fasas.

Documentazione utile