# MAPPA-LOGICA · Gestione Policy

⟦ INIZIO · U-POLICIES · Videata "Gestione Policy" ⟧
File: public/policies.html · URL: /policies.html · Scopo: gestione del ciclo di vita delle policy di sicurezza NIS2 (creazione, modifica, approvazione, generazione AI, template) richieste dall'Art. 21 NIS2 · Profili: tutti gli utenti autenticati dell'organizzazione (voce sidebar "Policy" visibile a tutti i ruoli); le azioni di scrittura/approvazione sono soggette ai permessi backend (org_admin, compliance_manager, consultant)

• U-POLICIES.1 — Intestazione pagina e azioni globali
    Mostra:  titolo "Gestione Policy"; due pulsanti in alto a destra: "Genera con AI" (icona scintille) e "+ Nuova Policy"
    Azioni:  "Genera con AI" → apre la modale di generazione AI (U-POLICIES.7); "+ Nuova Policy" → apre la modale di creazione (U-POLICIES.5)
    Dati da: nessun endpoint (elementi statici)
    Confine: `header.content-header` dentro `main.main-content` (riga ~248-257); i due pulsanti NON hanno id stabile (vedi sezione finale)

• U-POLICIES.2 — Tab di navigazione (Elenco Policy / Template)
    Mostra:  due tab: "Elenco Policy" (attivo di default) e "Template"
    Azioni:  click su tab → `switchTab('list')` mostra `#tab-list`; `switchTab('templates')` mostra `#tab-templates` e carica i template; il cambio tab nasconde la vista dettaglio
    Dati da: nessun endpoint diretto (il tab Template innesca GET /api/policies/templates ad ogni click sul tab — `loadTemplates()` non usa cache)
    Confine: `div.tabs` dentro `#page-content` (riga ~261-264); i singoli bottoni tab NON hanno id stabile

• U-POLICIES.3 — Tab "Elenco Policy": filtri e tabella
    Mostra:  barra filtri con 2 select: "Tutte le Categorie" (`#filter-category`: Sicurezza Informazioni, Controllo Accessi, Risposta Incidenti, Continuita' Operativa, Supply Chain, Crittografia, Sicurezza HR, Gestione Asset, Sicurezza Rete, Gestione Vulnerabilita') e "Tutti gli Stati" (`#filter-status`: Bozza, In Revisione, Approvata, Pubblicata, Archiviata). Tabella con colonne: Titolo (link), Categoria, Art. NIS2, Versione, Stato (badge colorato), Prossima Revisione, Azioni. Stato vuoto: "Nessuna policy trovata"
    Azioni:  cambio filtro → ricarica lista; click sul titolo o icona occhio → vista dettaglio (U-POLICIES.4); icona matita → modale modifica; icona spunta verde (solo per stato Bozza/In Revisione) → modale conferma approvazione; icona cestino → modale conferma eliminazione
    Dati da: GET /api/policies/list?category=&status= (`api.listPolicies(params)`)
    Confine: `#tab-list` (riga ~267); filtri `#filter-category` (riga ~269) e `#filter-status` (riga ~282); tabella renderizzata in `#policies-table` (riga ~293)

• U-POLICIES.4 — Vista dettaglio policy
    Mostra:  link "← Torna all'elenco"; titolo policy; badge stato + eventuale badge "AI Generata"; se policy AI in stato bozza/revisione: banner arancione "Bozza AI — Revisione obbligatoria prima dell'approvazione" (chiudibile, id dinamico `ai-draft-warning-{id}`); pulsanti "Approva" (solo bozza/revisione) e "Modifica"; card "Contenuto Policy" (testo completo); card laterale "Informazioni" con righe: Categoria, Art. NIS2, Versione, Stato, Creata il, Aggiornata il, Prossima Revisione, e se approvata: Approvata da / Approvata il
    Azioni:  "Torna all'elenco" → `backToList()`; "Approva" → modale conferma → POST approve; "Modifica" → modale modifica
    Dati da: GET /api/policies/{id} (`api.getPolicy(id)`)
    Confine: `#policy-detail-view` (riga ~318, contenuto renderizzato via JS `renderPolicyDetail`, righe ~517-618)

• U-POLICIES.5 — Modale "Nuova Policy" / "Modifica Policy"
    Mostra:  form `#policy-form` con campi: Titolo* (`#form-title`), Categoria* (`#form-category`, select 10 categorie), Articolo NIS2 (`#form-nis2-article`, es. "21.2.a"), Versione (`#form-version`, default 1.0), Prossima Revisione (`#form-review-date`, date), Contenuto (`#form-content`, textarea 12 righe con suggerimento struttura: Scopo, Ambito, Responsabilita', Procedure, Revisione)
    Azioni:  "Annulla" → chiude; "Crea Policy"/"Salva Modifiche" → `savePolicy(id)` con validazione titolo+categoria obbligatori
    Dati da: POST /api/policies/create (`api.createPolicy`) per creazione; PUT /api/policies/{id} (`api.updatePolicy`) per modifica; in modifica precaricamento via GET /api/policies/{id}
    Confine: modale generata da `showModal()` in `#modal-overlay` (id stabile creato da common.js); form `#policy-form` (riga ~654)

• U-POLICIES.6 — Modali di conferma (Approvazione / Eliminazione)
    Mostra:  "Conferma Approvazione": testo "Sei sicuro di voler approvare questa policy?" + avviso che lo stato diventa "Approvata" e l'operazione non e' annullabile. "Conferma Eliminazione": testo con titolo policy + avviso "Questa azione e' irreversibile"
    Azioni:  Approva → POST /api/policies/{id}/approve (`api.approvePolicy`); Elimina → DELETE /api/policies/{id} (`api.del`)
    Dati da: POST /api/policies/{id}/approve · DELETE /api/policies/{id}
    Confine: `#modal-overlay` (modale dinamica, funzioni `approvePolicy()` riga ~748 e `confirmDeletePolicy()` riga ~780); i pulsanti interni NON hanno id stabile

• U-POLICIES.7 — Modale "Genera Policy con AI"
    Mostra:  testo esplicativo; select "Categoria Policy" (`#ai-category`, 10 categorie); pulsante "Genera" (`#ai-generate-btn`); dopo generazione: anteprima con header "Policy Generata: {titolo}" e contenuto in `#ai-preview-container`; il footer cambia in "Salva come Bozza"
    Azioni:  "Genera" → `doAIGenerate()` (spinner durante la chiamata); "Salva come Bozza" → `saveAIGeneratedPolicy()` crea la policy con flag `ai_generated: 1`
    Dati da: POST /api/policies/ai-generate (`api.aiGeneratePolicy(category)`); salvataggio via POST /api/policies/create
    Confine: `#modal-overlay`; select `#ai-category` (riga ~824), contenitore anteprima `#ai-preview-container` (riga ~828), pulsante `#ai-generate-btn` (riga ~832)

• U-POLICIES.8 — Tab "Template": griglia template NIS2
    Mostra:  card "Template Policy NIS2" con griglia di card cliccabili; ogni card: titolo template, tag categoria, eventuale riferimento "Art. {nis2_article}". Stato vuoto: "Nessun template disponibile"
    Azioni:  click su una card → `createFromTemplate()` apre la modale Nuova Policy precompilata con titolo, categoria e articolo NIS2 del template (contenuto vuoto)
    Dati da: GET /api/policies/templates (`api.getPolicyTemplates()`)
    Confine: `#tab-templates` (riga ~303); griglia renderizzata in `#templates-grid` (riga ~308); le singole card template NON hanno id stabile

⟦ FINE · U-POLICIES ⟧

## ID STABILI MANCANTI (da aggiungere)
| Elemento | Riga | Id proposto |
|---|---|---|
| Pulsante "Genera con AI" (header) | 251 | `nis2-policies-btn-ai-generate` |
| Pulsante "+ Nuova Policy" (header) | 255 | `nis2-policies-btn-new` |
| Contenitore tab bar `div.tabs` | 261 | `nis2-policies-tabs` |
| Bottone tab "Elenco Policy" | 262 | `nis2-policies-tab-btn-list` |
| Bottone tab "Template" | 263 | `nis2-policies-tab-btn-templates` |
| Pulsante "Approva" nella vista dettaglio (HTML dinamico) | 551 | `nis2-policies-detail-btn-approve` |
| Pulsante "Modifica" nella vista dettaglio (HTML dinamico) | 555 | `nis2-policies-detail-btn-edit` |