DevEnv nis2-agileandClaude Opus 4.8
4dfab2a391
Deliverable formazione-first (DESIGN_AVATAR_FORMAZIONE / product-demo-complete):
- docs/mappa-logica/01..22_*.md: tutte le viste app V2 mappate (formato canonico standard §2),
selettori VERIFICATI sul DOM reale, endpoint verificati su api.js/script, gate ruolo dai controller
- docs/mappa-logica/SELETTORI_DEMO.md: registry canonico (22 viste, 131 visualizzazione + 89 azioni)
+ worklist consolidata 132 id stabili da aggiungere (modifiche chirurgiche future)
- docs/formazione/TASSONOMIA_CORSO_NIS2.{md,json}: 10 moduli / 28 lezioni / ~7h45, prerequisiti+durate,
esame con soglia 80%, sandbox 'prova tu' org 996002
- fix kb.js: ingest scope=ORG ora invia organization_id (prima 422 KB_ORG_REQUIRED) — bug trovato da A2
Prodotto con 4 trittici di agenti (A1 esecutore -> A2 revisore -> A3 controllore avversariale):
A2: ~14 correzioni (cross-ref, gate ruolo, comportamenti); A3 PASS: 38 selettori campionati 0 rotti,
18 endpoint reali, 0 violazioni normative (Allegati 3/4, IS-4, '1 mese', PII.* interna), 9 claim verificati.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
63 lines
7.2 KiB
Markdown
63 lines
7.2 KiB
Markdown
# MAPPA-LOGICA · Audit & Report
|
|
|
|
⟦ INIZIO · U-REPORTS · Videata "Audit & Report" ⟧
|
|
File: public/reports.html · URL: /reports.html · Scopo: reportistica di compliance NIS2: report esecutivo stampabile, gestione dei controlli di compliance (framework NIS2/ISO 27001), audit log immutabile, mapping NIS2↔ISO 27001:2022, monitoraggio continuo dei controlli (evidence automation) e requisiti operativi ACN (Determina 164179/2025) · Profili: tutti gli utenti autenticati dell'organizzazione (voce sidebar "Audit & Report"); aggiornamento controlli/requisiti soggetto ai permessi backend (org_admin, compliance_manager, auditor in lettura)
|
|
|
|
• U-REPORTS.1 — Intestazione pagina e tab di navigazione (6 tab)
|
|
Mostra: titolo "Audit & Report"; pulsante "Genera Report"; 6 tab: "Report Compliance" (attivo di default), "Controlli", "Audit Log", "ISO 27001", "Monitoraggio Continuo", "Requisiti ACN"
|
|
Azioni: "Genera Report" → `generateReport()` (attiva il tab Report e genera); click tab → `switchTab()` attiva il pannello e carica i dati corrispondenti
|
|
Dati da: nessun endpoint diretto (ogni tab innesca il proprio caricamento)
|
|
Confine: `header.content-header` (righe ~352-357) e `div.tab-nav` (righe ~361-368); pulsante e bottoni tab NON hanno id stabile
|
|
|
|
• U-REPORTS.2 — Tab "Report Compliance" (report esecutivo)
|
|
Mostra: stato iniziale: "Nessun report generato — Clicca 'Genera Report'". Dopo la generazione: intestazione "Report di Compliance NIS2" con nome organizzazione e data/ora; sezione "Informazioni Organizzazione" (Nome, Settore, Tipo Entita', Paese); sezione "Riepilogo Compliance" con barra percentuale colorata (verde ≥80%, giallo ≥50%, rosso <50%) e 5 KPI: Controlli Totali, Implementati, Rischi Aperti, Incidenti, Policy Approvate; sezione "Stato Controlli" (tabella Codice, Titolo, Stato, Implementazione — barra colorata con %); pulsante "Stampa Report"
|
|
Azioni: "Genera Report" (header) → GET report e render; "Stampa Report" → `window.print()` (CSS @media print nasconde sidebar/header/tab)
|
|
Dati da: GET /api/audit/report (`api.generateComplianceReport()`)
|
|
Confine: pannello `#tab-report` (riga ~371), contenuto in `#report-container` (~372)
|
|
|
|
• U-REPORTS.3 — Tab "Controlli" (compliance controls)
|
|
Mostra: tabella controlli: Codice (monospace), Framework (NIS2/ISO27001), Titolo, Stato (badge: Non Iniziato, In Corso, Implementato, Verificato), % Implementazione (barra colorata), Responsabile, Prossima Verifica. Righe cliccabili. Stato vuoto: "Nessun controllo configurato — appariranno dopo il primo assessment"
|
|
Azioni: click riga → modale "Modifica Controllo: {codice}" con: Titolo (sola lettura), Stato (`#ctrl-status`), % Implementazione (slider `#ctrl-impl-pct` con valore live in `#ctrl-impl-pct-val`), Descrizione Evidenza (`#ctrl-evidence`), Responsabile ID utente (`#ctrl-responsible`), Prossima Verifica (`#ctrl-next-review`); "Salva" → `saveControl(id)` e ricarica
|
|
Dati da: GET /api/audit/controls (`api.listControls()`) · PUT /api/audit/controls/{id} (`api.updateControl(id, data)`)
|
|
Confine: pannello `#tab-controls` (riga ~382), contenuto in `#controls-container` (~383); campi modale `#ctrl-*` (righe ~827-846) dentro `#modal-overlay`
|
|
|
|
• U-REPORTS.4 — Tab "Audit Log" (registro attivita')
|
|
Mostra: tabella paginata (25 per pagina): Data/Ora, Utente, Azione (etichette italiane: "Accesso effettuato", "Rischio creato", "Policy approvata", "Pre-allarme inviato", "Evidenza caricata", ecc.), Entita' (tipo + #id), Dettagli (JSON appiattito in "chiave: valore", troncato con tooltip); paginazione "Precedente / Pagina N di M / Successiva". Stato vuoto: "Nessun log disponibile"
|
|
Azioni: "Precedente"/"Successiva" → `goAuditPage(n)` ricarica la pagina richiesta
|
|
Dati da: GET /api/audit/logs?page=N&per_page=25 (`api.getAuditLogs(params)`)
|
|
Confine: pannello `#tab-audit` (riga ~392), contenuto in `#audit-container` (~393); i pulsanti di paginazione (HTML dinamico) NON hanno id stabile
|
|
|
|
• U-REPORTS.5 — Tab "ISO 27001" (mapping normativo)
|
|
Mostra: card "Mapping NIS2 - ISO 27001:2022" con righe di corrispondenza: badge "Art. {nis2}" → freccia → badge dei controlli ISO 27001 corrispondenti → titolo descrittivo della misura. Stato vuoto: "Nessun mapping disponibile"
|
|
Azioni: nessuna (sola lettura)
|
|
Dati da: GET /api/audit/iso27001-mapping (`api.getIsoMapping()`)
|
|
Confine: pannello `#tab-iso` (riga ~402), contenuto in `#iso-container` (~403)
|
|
|
|
• U-REPORTS.6 — Tab "Monitoraggio Continuo" (continuous control monitoring)
|
|
Mostra: testo introduttivo: stato di freschezza dei controlli alimentato dalle evidenze automatiche dei connettori (Evidence Automation), con copertura % (monitorati/totali); 5 card di sintesi: Sano (verde), Attenzione (giallo), Evidenza scaduta (arancione), Non conforme (rosso), Non monitorato (grigio); tabella: Stato (pallino colorato), Controllo (codice), Titolo, Ultima evidenza (o "mai"), Freschezza (giorni). Stato vuoto in tabella: "Nessun controllo. Le evidenze arrivano via POST /api/services/evidence-ingest."
|
|
Azioni: nessuna (sola lettura; le evidenze sono ingerite da sistemi esterni via Services API)
|
|
Dati da: GET /api/audit/controlsMonitoring (`api.getControlsMonitoring()`)
|
|
Confine: pannello `#tab-monitoring` (riga ~412), contenuto in `#monitoring-container` (~413)
|
|
|
|
• U-REPORTS.7 — Tab "Requisiti ACN" (specifiche di base, Determina ACN 164179/2025)
|
|
Mostra: testo introduttivo: requisiti operativi "specifiche di base ACN" (Determina 164179/2025, Framework Nazionale 2025) per il tipo di soggetto dell'organizzazione (essenziale/importante), totale requisiti e "Compliance: N%" con citazione della fonte; 4 card di sintesi: Implementato (verde), In corso (giallo), Da iniziare (grigio), Non applicabile (grigio scuro); requisiti raggruppati per funzione del Framework, in tabelle con colonne: Sottocat. (codice sottocategoria con tooltip testo integrale), Requisito, Stato (pallino + select inline: Da iniziare, In corso, Implementato, Non applicabile)
|
|
Azioni: cambio select stato → `updateAcn(id, status)` salva subito e ricarica il tab
|
|
Dati da: GET /api/audit/acnRequirements (`api.getAcnRequirements()`) · PUT /api/audit/acnRequirements/{id} (`api.updateAcnRequirement(id, status, note)`)
|
|
Confine: pannello `#tab-acn` (riga ~421), contenuto in `#acn-container` (~422); le select di stato (HTML dinamico) NON hanno id stabile
|
|
|
|
⟦ FINE · U-REPORTS ⟧
|
|
|
|
## ID STABILI MANCANTI (da aggiungere)
|
|
| Elemento | Riga | Id proposto |
|
|
|---|---|---|
|
|
| Pulsante "Genera Report" (header) | 355 | `nis2-reports-btn-generate` |
|
|
| Contenitore tab bar `div.tab-nav` | 361 | `nis2-reports-tabs` |
|
|
| Bottone tab "Report Compliance" | 362 | `nis2-reports-tab-btn-report` |
|
|
| Bottone tab "Controlli" | 363 | `nis2-reports-tab-btn-controls` |
|
|
| Bottone tab "Audit Log" | 364 | `nis2-reports-tab-btn-audit` |
|
|
| Bottone tab "ISO 27001" | 365 | `nis2-reports-tab-btn-iso` |
|
|
| Bottone tab "Monitoraggio Continuo" | 366 | `nis2-reports-tab-btn-monitoring` |
|
|
| Bottone tab "Requisiti ACN" | 367 | `nis2-reports-tab-btn-acn` |
|
|
| Pulsante "Stampa Report" (HTML dinamico nel report) | 722 | `nis2-reports-btn-print` |
|
|
| Select stato requisito ACN (HTML dinamico per riga) | 543 | `nis2-reports-acn-status-{id}` |
|