# ADR-54 — Django è l'unico framework web, con tre aree distinte sullo stesso dominio - **Stato:** Accettata — implementazione da completare - **Area:** Interfacce e lingue - **Funzionalità:** WEB - **Sostituisce (quando implementata):** [ADR-36](ADR-36-password-argon2-sessioni-jwt-hs256-24.md) per le sessioni, [ADR-50](ADR-50-frontend-statici-senza-framework-ne-build.md), [ADR-46](ADR-46-canale-sse-aggiunta-polling-sostituto.md) ## Contesto Oggi `index.html` serve insieme home, login e dashboard, con un backend FastAPI e un pannello admin a token condiviso. Il sito deve avere una parte pubblica, una web app per il giocatore e una console per l'operatore, con stile condiviso e permessi separati. ## Decisione **Un solo progetto Django 5.2 LTS** serve le tre aree con template lato server, autenticazione e sessioni Django, protezione CSRF e un solo foglio di stile. Aree e percorsi sono in [sito-e-app.md](../sito-e-app.md) (`WEB-01`). Il modello utente è definito prima della prima migrazione. I dati in tempo reale si aggiornano con richieste periodiche mirate (polling) e con il recupero dello stato al rientro; SSE si rivaluta solo se serve una latenza inferiore. ## Alternative scartate - Restare su FastAPI e aggiungere pagine — richiede di riscrivere a mano sessioni, CSRF, permessi e amministrazione che Django fornisce. - SPA con API JSON separata — build e doppio stato in più, senza beneficio per un sito di poche schermate. - Convivenza FastAPI + Django — la piattaforma non è ancora in uso, quindi non c'è nulla da proteggere con una migrazione graduale: si lavora su un branch e si rimuove FastAPI quando Django copre gli stessi requisiti. ## Conseguenze - I vecchi requisiti `API` e i frontend statici restano in vigore finché non sono sostituiti; ogni requisito rimosso lo è con la regola `~~ID~~`. - Il pilota si prova in locale su `localhost` prima che esista il dominio ([WEB-07]). - Requisiti che la attuano: `WEB-01` … `WEB-07` ([sito-e-app.md](../sito-e-app.md)). *Codice:* da implementare · *Test:* da implementare