Files
plm-lottery/docs/adr/ADR-54-django-unico-framework-web-tre-aree.md
T
davideandClaude Sonnet 5.5 6441733160 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>
2026-11-16 11:46:05 +01:00

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 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).

Codice: da implementare · Test: da implementare