Docs-first step for the move to Django per TODO.md: framework and areas (ADR-54, WEB-01..07), SQLite WAL with separate web/worker processes (ADR-55), individual staff accounts with MFA deferred to phase C (ADR-56), distinct pause commands (ADR-57), regtest alpha with a network profile (ADR-58), framework-free PLM engine with a simulated ledger in phase A (ADR-59), Italian-only pilot (ADR-60). The site must be browsable on localhost before a domain exists (WEB-07). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
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 per le sessioni, ADR-50, ADR-46
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 (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
APIe 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
localhostprima che esista il dominio ([WEB-07]). - Requisiti che la attuano:
WEB-01…WEB-07(sito-e-app.md).
Codice: da implementare · Test: da implementare