# Elenco annuale PDP — schema di importazione

Documento di anteprima da validare con DPO e Dirigente Scolastico.

## Colonne consigliate

Il primo foglio del file XLS/XLSX deve contenere una riga di intestazione. Le
colonne minime sono:

| Colonna | Obbligatoria | Esempio |
|---|---:|---|
| `alunno` | sì | `L. M.` |
| `classe` | sì | `4A Moda/Arredo` |
| `anno` | consigliata | `2026/27` |
| `tipo_pdp` | consigliata | `DSA`, `BES` oppure `104 / PEI` |
| `tutor` | sì | `prof. Claudio Nuzzo` |
| `email_tutor` | consigliata | `claudio.nuzzo@istitutostradivari.it` |

Sono accettate anche intestazioni equivalenti come `studente`, `nominativo`,
`tutore`, `docente tutor` e `mail tutor`. Il portale usa il primo foglio del
libro e segnala le righe senza alunno, classe o tutor.

## Formato del file allegato come esempio

Il file di prova può avere una riga titolo, ad esempio l’anno scolastico, sopra
le intestazioni. Il portale cerca automaticamente la riga che contiene almeno
`classe` e `tutor`, quindi questo formato è supportato. Se la colonna dei nomi
è la colonna C ma l’intestazione è vuota, viene riconosciuta come nominativo
solo in presenza della struttura attesa; non è una regola da usare per file
diversi senza verifica.

Nel formato di esempio:

- `Settore` può restare nel foglio ma non viene usato per creare il PDP;
- `in drive` viene ignorato: il portale non usa collegamenti a cartelle esterne;
- `PASSWORD DOCUMENTO` viene ignorata: non caricare password reali nell’XLS;
- eventuali colonne senza intestazione, come una colonna aggiuntiva non
  documentata, restano escluse finché il referente non ne chiarisce il significato;
- formule riepilogative dopo l’ultima riga dati non vengono importate; formule o
  collegamenti dentro i campi alunno/classe/tutor devono invece far fallire la
  validazione.

Nel file di prova l’importazione viene quindi mappata correttamente, ma due
righe risultano incomplete (una senza tutor e una senza classe) e vengono
bloccate. È il comportamento voluto: il sistema non crea PDP parziali. Dopo la
correzione del foglio, il caricamento può proseguire.

## Tipo 104/PEI

Se il campo tipo contiene “PEI”, “104” o “disabilità”, il portale attiva il
modello PEI e la pagina Revisioni GLO. DSA e BES attivano invece i rispettivi
modelli PDP. La mappatura delle sezioni PEI è descritta in
modello-pei-mappatura.md.

## Secondo foglio: composizione del CdC

Per associare automaticamente le materie ai docenti, aggiungere un secondo
foglio chiamato ad esempio `Docenti-Materie-Classi` oppure `CDC`. Ogni riga
contiene una assegnazione:

| Colonna | Obbligatoria | Esempio |
|---|---:|---|
| `docente` | sì | `prof.ssa Anna Rossi` |
| `materia` | sì | `Italiano` |
| `classe` | sì | `4A Moda/Arredo` |
| `ruolo` | facoltativa | `Docente CdC`, `Tutor`, `Coordinatore` |
| `email_docente` | facoltativa | `anna.rossi@istitutostradivari.it` |

Il sistema filtra il secondo foglio per la classe del PDP. Il tutor/referente
può correggere una materia, cambiare classe o aggiungere una nuova riga dalla
sezione **Docenti, materie e classi** prima di avviare il flusso. In produzione
la fonte principale sarà `anagrafica-api`; l’elenco XLS serve per il caricamento
iniziale o come correzione controllata.

## Password e sicurezza

Non inserire password reali nel file. Il file XLS è un elenco amministrativo e
può circolare o finire in copie di backup non controllate. Se il vecchio flusso
richiede una password per un fascicolo, il sistema deve generarla con un
generatore crittograficamente sicuro e conservarne solo l’impronta lato server,
mai la password in chiaro.

Per i PDF firmati il flusso preferito non usa password condivise: il portale
cifra automaticamente il documento lato client con la chiave pubblica della
segreteria. La chiave privata resta alla segreteria.

## Comportamento dopo l’importazione

- i referenti caricano l’elenco annuale;
- il sistema crea o aggiorna i fascicoli associando classe, tipo PDP e tutor;
- il sistema compone il CdC filtrando il secondo foglio per docente, materia e classe;
- i docenti autenticati vedono soltanto i fascicoli delle classi loro assegnate;
- il tutor vede la redazione principale del fascicolo;
- gli altri docenti modificano soltanto le aree disciplinari assegnate;
- diagnosi e documentazione specialistica restano in sola lettura per i docenti;
- a fine anno il pulsante `Aggiorna PDP` crea la nuova annualità e ricarica il CdC
  da `anagrafica-api`.

Nella demo l’importazione viene letta localmente dal browser. Non vengono
inviati file a servizi esterni e i dati sono esclusivamente dimostrativi. In
produzione il controllo dei ruoli, l’archiviazione e la generazione dei segreti
devono avvenire lato server, dopo la validazione del DPO.