Plancia — Documentazione¶
Piattaforma Guidoncini Verdi · AGESCI Campania
Plancia è la piattaforma web per la gestione del concorso Guidoncini Verdi della Branca E/G di AGESCI Campania. Permette alle squadriglie di compilare il Diario di Bordo, ai Capi Reparto di integrarlo con la Relazione finale, alla Pattuglia GV di valutarlo e alla Segreteria di amministrare l'intera edizione.
Manuale d'uso¶
La documentazione operativa è organizzata per ruolo:
| Ruolo | Cosa fa su Plancia |
|---|---|
| Capo Squadriglia | Compila i sei moduli del Diario di Bordo |
| Capo Reparto | Distribuisce i link ai Capi Squadriglia, compila la Relazione finale |
| Pattuglia Guidoncini Verdi | Valuta i diari assegnati |
| Incaricato EG | Supervisiona le valutazioni e pubblica gli esiti |
| Segreteria | Gestisce utenti, edizioni, import e inviti |
| Amministratore | Configura la piattaforma, OAuth, MFA e social login |
Inizia dalla Panoramica e ruoli per una visione d'insieme.
Guide tecniche¶
Per chi installa e configura Plancia:
- Configurazione provider email — SMTP, Brevo, Mailgun, Postmark, ecc.
- Google Drive OAuth — caricamento automatico PDF/Excel su Drive
- Autenticazione social — Google, Microsoft, Apple login
Stack e deployment¶
| Componente | Tecnologia |
|---|---|
| Backend | Python ≥ 3.14, Django ≥ 6.0 |
| Database | PostgreSQL ≥ 17 |
| Task asincroni | Redis + Celery |
| Frontend | Bootstrap 5, django-agesci-campania-theme |
| Auth | django-allauth, MFA, social login |
| PDF / Excel | WeasyPrint, openpyxl |
| Gestione dipendenze | uv |
Per installazione e deployment consulta il README del repository.