Spec the Django migration: ADR-54..60 and docs/sito-e-app.md (WEB-01..WEB-44)
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>
This commit is contained in:
1 parent
9b8a331bba
commit
6441733160
11 files changed
+489
-1
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user