Scheda tecnica

Caratteristiche tecniche di Django

In DA-AFAM Django e' il perimetro applicativo che governa dati, sicurezza, moduli editoriali, API e logica dei servizi. Questa pagina descrive il suo ruolo dal punto di vista architetturale e operativo.

Funzioni principali

  • Authoring autorevole di pagine, news, documenti e Libro Soci.
  • Gestione dei permessi, dei ruoli e delle visibilita' pubbliche o riservate.
  • Esposizione di API JSON protette per il delivery del sito pubblico.
  • Coordinamento di allegati e asset documentali tramite storage dedicato.
  • Evoluzione di moduli applicativi futuri senza dipendere dal CMS.

Vantaggi tecnici

  • Separazione netta tra backoffice e pubblicazione.
  • Controllo rigoroso di validazione, sanitizzazione e audit.
  • Modularita' elevata per costruire nuovi servizi nel tempo.
  • Possibilita' di integrare storage, workflow e servizi esterni.
  • Maggiore coerenza del dato rispetto a una redazione sparsa su piu' punti.

Numeri chiave della piattaforma

Indicatore Valore Lettura operativa
Template pubblici principali 2 Una home istituzionale e un template dinamico condiviso per sezioni, news e profili.
Flussi di delivery attivi 4+ Sezioni, news, dettaglio contenuti e Libro Soci sono gia' mediati dal CMS verso il dominio pubblico.
Modalita' di integrazione S2S Il bridge e' server-to-server: il sito riceve i contenuti senza esporre il backend al browser.
Ruolo nel sistema Delivery ProcessWire pubblica e orchestra la leggibilita' del sito, ma non diventa la sorgente autorevole del dato.

Elementi architetturali

Modelli datiDefiniscono la struttura editoriale e applicativa del progetto.
Form e sanitizzazioneRendono l'editing controllato e compatibile con il sito pubblico.
Service layerConcentra la logica di integrazione e distribuzione dei contenuti.
API deliveryEspongono solo i dati necessari al sito, con regole e token dedicati.

Pattern operativo adottato

Il modello seguito in DA-AFAM e' quello del backend autorevole: il contenuto nasce, viene controllato e viene autorizzato dentro Django. Il sito pubblico riceve invece solo il risultato gia' strutturato, pronto per la pubblicazione.

Questo consente di tenere in Django tutto cio' che ha valore di governance: utenti, ruoli, contenuti riservati, log, allegati, workflow e futuri moduli associativi.

Dal punto di vista tecnico, e' una scelta che riduce duplicazioni, migliora la sicurezza e rende piu' semplice l'evoluzione del progetto.

README tecnico del container Django

Questa sezione sintetizza la funzione del container applicativo Django nel progetto DA-AFAM.

Responsabilita'Gestisce il perimetro operativo dell'applicazione e il suo ruolo nel modello architetturale DA-AFAM.
InputRiceve configurazioni, contenuti o richieste operative provenienti dal livello di governance del progetto.
OutputRestituisce contenuti, pagine, API o componenti di delivery a seconda del ruolo della piattaforma.
Confine tecnicoNon sostituisce gli altri livelli dell'ecosistema: resta dentro il compito per cui e' stato definito.

Lessico tecnico essenziale

backend autorevole: il luogo in cui i dati sono governati e validati.

API delivery: endpoint usati dal sito per ricevere i contenuti pubblicabili.

service layer: livello applicativo che isola la logica operativa da view e template.

storage documentale: perimetro dedicato agli allegati, distinto dalla semplice pagina web.