[KB] V2_UI_NAVIGAZIONE.md: correzione doc UI — V2 in-place (no file -bi.html), BI_PAGES vestigiale, conversione completa; pronta per re-ingest che rimpiazza i chunk stale del 12/6
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
DevEnv nis2-agile
co-authored by
Claude Opus 4.8
Claude Opus 4.8
parent
72d82d9598
commit
f9b2c9d6d7
+83
-118
@@ -1,179 +1,144 @@
|
|||||||
FONTE: Documentazione interfaccia prodotto NIS2 Agile (interfaccia V2 "Bootstrap Italia").
|
FONTE: Documentazione interfaccia prodotto NIS2 Agile (interfaccia "V2" — design system Bootstrap Italia / AGID).
|
||||||
AUTORITA: Team prodotto NIS2 Agile — descrizione UI/navigazione (NON contenuto normativo).
|
AUTORITA: Team prodotto NIS2 Agile — descrizione UI/navigazione (NON contenuto normativo).
|
||||||
SCOPO: guida operativa per l'assistente AI ARIA, così da poter indirizzare l'utente nella nuova interfaccia V2 (pagine "-bi"). Questo documento descrive SOLO la struttura e la navigazione dell'app; non contiene affermazioni normative.
|
SCOPO: guida operativa per l'assistente AI ARIA, così da indirizzare l'utente nell'interfaccia dell'app. Questo documento descrive SOLO la struttura e la navigazione; non contiene affermazioni normative.
|
||||||
|
|
||||||
# NIS2 Agile — Interfaccia V2 (Bootstrap Italia): struttura e navigazione
|
> ⚠️ AGGIORNATO 2026-06-19 — questo documento SOSTITUISCE la versione precedente (ingerita il 2026-06-12) che descriveva pagine con suffisso `-bi.html`: quell'approccio "doppio file" è stato ABBANDONATO. La V2 è ora applicata **in-place** sulle pagine esistenti. **Non esistono file `-bi.html`**: gli URL sono quelli normali (`dashboard.html`, `risks.html`, …). Re-ingerire questo file per rimpiazzare i chunk stale.
|
||||||
|
|
||||||
## Cos'è la V2 "Bootstrap Italia"
|
# NIS2 Agile — Interfaccia (Bootstrap Italia / AGID): struttura e navigazione
|
||||||
|
|
||||||
La V2 è la nuova interfaccia di NIS2 Agile costruita con il design system **Bootstrap Italia**. Tecnicamente è una variante delle pagine esistenti: ogni pagina convertita ha un file con suffisso `-bi.html` (es. `dashboard-bi.html`, `risks-bi.html`). La chrome (sidebar e barra utente) è generata da `public/js/common-bi.js`, che ridefinisce solo il rendering della sidebar riusando tutti gli helper e l'albero di navigazione della V1: gli ID DOM, le voci di menu e i collegamenti restano identici alla V1, cambia solo la resa grafica (markup e stile Bootstrap Italia, accessibilità con `<nav aria-label>`, link attivo con `aria-current`).
|
## Cos'è la "V2" Bootstrap Italia
|
||||||
|
|
||||||
Architettura: l'app è **multi-pagina** (non SPA). Ogni modulo è una pagina HTML a sé. La sidebar a sinistra è il punto di navigazione principale ed è presente in tutte le pagine applicative (quelle con il riquadro `<aside class="sidebar" id="sidebar">`). Le pagine pubbliche (login, registrazione, onboarding, landing, recupero password) NON hanno la sidebar.
|
La "V2" è l'unica interfaccia di riferimento di NIS2 Agile, costruita con il design system **Bootstrap Italia** (conforme AGID/WCAG 2.1 AA). NON è un set di pagine separate: il Bootstrap Italia è stato integrato **direttamente nelle pagine esistenti**. Ogni pagina applicativa carica il CSS di Bootstrap Italia (`/vendor/bootstrap-italia/dist/css/bootstrap-italia.min.css`) **prima** di `css/style.css` (così il design system esistente resta autorevole), più il bundle JS di Bootstrap Italia e `public/js/common-bi.js`, che ridefinisce il rendering della sidebar riusando gli stessi helper e lo stesso albero di navigazione: gli ID DOM, le voci di menu e i link restano identici, cambia solo la resa grafica (markup e stile Bootstrap Italia, accessibilità con `<nav aria-label>`, voce attiva con `aria-current="page"`).
|
||||||
|
|
||||||
### Pagine già convertite a Bootstrap Italia (mappa `BI_PAGES`)
|
**Non esistono pagine con suffisso `-bi.html`.** Nel codice resta una mappa `BI_PAGES` in `common-bi.js`, ma è vestigiale: associa ogni pagina a sé stessa (`'dashboard.html' → 'dashboard.html'`), quindi i link puntano sempre ai file normali. Nessun link rotto.
|
||||||
|
|
||||||
Per queste pagine, quando si naviga in contesto V2, i link puntano automaticamente alla variante `-bi`:
|
Architettura: l'app è **multi-pagina** (non SPA). Ogni modulo è una pagina HTML a sé. La **sidebar** a sinistra è il punto di navigazione principale ed è presente in tutte le pagine applicative (quelle con il riquadro `<aside class="sidebar" id="sidebar">`, popolato da `common-bi.js`). Le pagine **pubbliche** (login, registrazione, onboarding, landing, recupero password) NON hanno la sidebar: caricano solo il CSS Bootstrap Italia per coerenza grafica.
|
||||||
|
|
||||||
- `login.html` → `login-bi.html`
|
### Stato della conversione
|
||||||
- `dashboard.html` → `dashboard-bi.html`
|
|
||||||
- `assessment.html` → `assessment-bi.html`
|
|
||||||
- `risks.html` → `risks-bi.html`
|
|
||||||
- `incidents.html` → `incidents-bi.html`
|
|
||||||
- `policies.html` → `policies-bi.html`
|
|
||||||
- `supply-chain.html` → `supply-chain-bi.html`
|
|
||||||
- `training.html` → `training-bi.html`
|
|
||||||
- `assets.html` → `assets-bi.html`
|
|
||||||
- `reports.html` → `reports-bi.html`
|
|
||||||
- `settings.html` → `settings-bi.html`
|
|
||||||
|
|
||||||
Le pagine NON ancora convertite (es. acn-gap, isms, whistleblowing, normative, cross-analysis, kb, guida, service-continuity) restano servite dalla versione originale: i link funzionano ugualmente (parità funzionale, nessun link rotto), ma la grafica può essere ancora quella V1 finché la conversione `-bi` non è completata. L'evidenziazione della voce attiva nella sidebar funziona sia per `x.html` sia per `x-bi.html` (il suffisso `-bi` viene normalizzato).
|
La migrazione a Bootstrap Italia è **completa** su tutte le pagine applicative (quelle con sidebar) e sui documenti pubblici (es. `integrazioniext.html`, `mktg-api-doc.html`). Il funnel pubblico (`login.html`, `register.html`, `onboarding.html`) è anch'esso su Bootstrap Italia (solo CSS, niente sidebar). La vecchia pagina `setup-org.html` è stata rimossa (sostituita da `onboarding.html`).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Struttura della sidebar (menu di navigazione)
|
## Struttura della sidebar (menu di navigazione)
|
||||||
|
|
||||||
La sidebar è organizzata in **4 sezioni** con etichette. In alto c'è il brand "NIS2 Agile — Compliance Platform"; subito sotto, per gli utenti consulente, può comparire un selettore di organizzazione (org-switcher). In basso ci sono: toggle lingua **IT / EN**, il box utente (avatar, nome, ruolo), il pulsante **Esci** (logout) e la versione dell'applicazione.
|
La sidebar è organizzata in **sezioni** con etichette. In alto c'è il brand "NIS2 Agile — Compliance Platform"; sotto, per gli utenti consulente, può comparire un selettore di organizzazione (org-switcher). In basso: toggle lingua **IT / EN**, box utente (avatar, nome, ruolo), pulsante **Esci** (logout) e versione dell'app.
|
||||||
|
|
||||||
### Sezione 1 — Principale
|
### Sezione — Principale
|
||||||
- **Dashboard** (`dashboard.html`) — pagina iniziale dopo il login: panoramica generale dello stato di conformità.
|
- **Dashboard** (`dashboard.html`) — pagina iniziale dopo il login: panoramica generale dello stato di conformità.
|
||||||
- **Compliance Journey** (`workflow.html`) — percorso guidato/flusso di lavoro per la conformità.
|
- **Compliance Journey** (`workflow.html`) — percorso guidato/flusso di lavoro per la conformità.
|
||||||
- **Gap Analysis** (`assessment.html`) — questionario di valutazione e analisi degli scostamenti.
|
- **Gap Analysis** (`assessment.html`) — questionario di valutazione e analisi degli scostamenti.
|
||||||
- **Gap Analysis ACN** (`acn-gap.html`) — valutazione di secondo livello sulle misure/requisiti ACN.
|
- **Gap Analysis ACN** (`acn-gap.html`) — valutazione di secondo livello sulle misure/requisiti ACN.
|
||||||
- **Modello SGSI (ISO 27001)** (`isms.html`) — modulo Sistema di Gestione della Sicurezza delle Informazioni.
|
- **Modello SGSI (ISO 27001)** (`isms.html`) — modulo Sistema di Gestione della Sicurezza delle Informazioni.
|
||||||
|
|
||||||
### Sezione 2 — Gestione
|
### Sezione — Gestione
|
||||||
- **Rischi** (`risks.html`) — registro dei rischi e relativa gestione.
|
- **Rischi** (`risks.html`) — registro dei rischi e relativa gestione.
|
||||||
- **Incidenti** (`incidents.html`) — gestione degli incidenti.
|
- **Incidenti** (`incidents.html`) — gestione degli incidenti.
|
||||||
- **Policy** (`policies.html`) — gestione delle policy/documenti.
|
- **Policy** (`policies.html`) — gestione delle policy/documenti (Policy e Procedure unificate).
|
||||||
- **Supply Chain** (`supply-chain.html`) — gestione fornitori e catena di fornitura.
|
- **Misure e Requisiti** (`misure-requisiti.html`) — misure/requisiti di conformità collegati alle policy.
|
||||||
|
- **Supply Chain** (`supply-chain.html`) — gestione fornitori e catena di fornitura (campagne questionari + portale fornitore).
|
||||||
- **Segnalazioni** (`whistleblowing.html`) — segnalazioni/whistleblowing.
|
- **Segnalazioni** (`whistleblowing.html`) — segnalazioni/whistleblowing.
|
||||||
- **Normative** (`normative.html`) — aggiornamenti normativi.
|
- **Normative** (`normative.html`) — aggiornamenti normativi.
|
||||||
- **AI Cross-Analysis** (`cross-analysis.html`) — analisi incrociata assistita da AI.
|
- **AI Cross-Analysis** (`cross-analysis.html`) — analisi incrociata assistita da AI.
|
||||||
- **Knowledge Base** (`kb.html`) — base di conoscenza documentale.
|
- **Knowledge Base** (`kb.html`) — base di conoscenza documentale.
|
||||||
|
|
||||||
### Sezione 3 — Operativo
|
### Sezione — Organizzazione (modello relazionale / ISO-readiness)
|
||||||
|
- **Organigramma** (`organigramma.html`), **Competenze** (`competenze.html`), **Matrice RACI** (`raci.html`), **Stakeholder** (`stakeholders.html`).
|
||||||
|
- **Audit interni** (`internal-audits.html`), **Riesame Direzione** (`management-review.html`), **Controlli periodici** (`controlli-periodici.html`), **Calendario** (`calendario.html`).
|
||||||
|
|
||||||
|
### Sezione — Operativo
|
||||||
- **Formazione** (`training.html`) — corsi e formazione.
|
- **Formazione** (`training.html`) — corsi e formazione.
|
||||||
- **Asset** (`assets.html`) — inventario degli asset.
|
- **Asset** (`assets.html`) — inventario degli asset.
|
||||||
- **Audit & Report** (`reports.html`) — audit e reportistica.
|
- **Audit & Report** (`reports.html`) — audit e reportistica.
|
||||||
|
|
||||||
### Sezione 4 — Sistema
|
### Sezione — Sistema
|
||||||
- **Guida all'uso** (`guida.html`) — manuale/guida d'uso.
|
- **Guida all'uso** (`guida.html`) — manuale/guida d'uso.
|
||||||
- **Impostazioni** (`settings.html`) — impostazioni organizzazione/profilo/membri.
|
- **Impostazioni** (`settings.html`) — impostazioni organizzazione/profilo/membri.
|
||||||
- **Architettura** (`architecture.html`) — pagina informativa sull'architettura del sistema.
|
- **Architettura** (`architecture.html`) — pagina informativa sull'architettura del sistema.
|
||||||
- **Simulazione Demo** (`simulate.html`) — ambiente dimostrativo.
|
- **Simulazione Demo** (`simulate.html`) — ambiente dimostrativo.
|
||||||
- **Integrazioni Esterne** (`integrazioniext.html`) — integrazioni con sistemi esterni.
|
- **Integrazioni Esterne** (`integrazioniext.html`) — integrazioni con sistemi esterni.
|
||||||
|
|
||||||
> Nota: la pagina **Continuità di Servizio** (`service-continuity.html`) è disponibile nell'app ma NON è una voce della sidebar principale: si raggiunge tramite link/contesto da altre pagine, non dal menu laterale.
|
> Nota: l'elenco esatto e l'ordine delle voci sono definiti da `common.js`/`common-bi.js` e possono dipendere dal ruolo dell'utente. Alcune pagine (es. **Continuità di Servizio** `service-continuity.html`) sono raggiungibili via link contestuale e non dal menu laterale.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Descrizione e scopo di ogni pagina/modulo richiesto
|
## Descrizione e scopo delle pagine/moduli principali
|
||||||
|
|
||||||
| Pagina | URL (V1 → V2) | Titolo pagina | Scopo |
|
| Pagina | URL | Scopo |
|
||||||
|---|---|---|---|
|
|---|---|---|
|
||||||
| **Dashboard** | `dashboard.html` → `dashboard-bi.html` | "Dashboard" | Panoramica iniziale post-login: stato complessivo della conformità, sintesi e accesso rapido ai moduli. È la home dell'app. |
|
| **Dashboard** | `dashboard.html` | Panoramica iniziale post-login: stato complessivo della conformità e accesso rapido ai moduli. È la home dell'app. |
|
||||||
| **Gap Analysis (Assessment)** | `assessment.html` → `assessment-bi.html` | "Gap Analysis" | Questionario di valutazione della conformità e analisi degli scostamenti (gap) rispetto ai requisiti. |
|
| **Compliance Journey** | `workflow.html` | Percorso guidato passo-passo verso la conformità. |
|
||||||
| **Gap Analysis ACN** | `acn-gap.html` (non ancora -bi) | "Gap Analysis ACN" | Valutazione di secondo livello dedicata alle misure/requisiti ACN. |
|
| **Gap Analysis** | `assessment.html` | Questionario di valutazione della conformità e analisi degli scostamenti (gap). |
|
||||||
| **Rischi** | `risks.html` → `risks-bi.html` | "Gestione Rischi" | Registro dei rischi, valutazione e trattamento dei rischi. |
|
| **Gap Analysis ACN** | `acn-gap.html` | Valutazione di secondo livello dedicata alle misure/requisiti ACN. |
|
||||||
| **Incidenti** | `incidents.html` → `incidents-bi.html` | "Gestione Incidenti" | Registrazione e gestione del ciclo di vita degli incidenti. |
|
| **Modello SGSI / ISO 27001** | `isms.html` | Sistema di Gestione della Sicurezza delle Informazioni (ISO 27001), SoA pre-popolata da NIS2. |
|
||||||
| **Policy** | `policies.html` → `policies-bi.html` | "Policy" | Gestione, redazione e approvazione delle policy/documenti. |
|
| **Rischi** | `risks.html` | Registro dei rischi, valutazione e trattamento. |
|
||||||
| **Supply Chain** | `supply-chain.html` → `supply-chain-bi.html` | "Supply Chain" | Gestione fornitori, valutazioni e panoramica del rischio della catena di fornitura. |
|
| **Incidenti** | `incidents.html` | Registrazione e gestione del ciclo di vita degli incidenti (notifiche Art.23). |
|
||||||
| **Training (Formazione)** | `training.html` → `training-bi.html` | "Formazione" | Corsi, assegnazioni e stato della formazione. |
|
| **Policy** | `policies.html` | Gestione, redazione e approvazione di policy/procedure unificate. |
|
||||||
| **Asset** | `assets.html` → `assets-bi.html` | "Inventario Asset" | Inventario degli asset e relative informazioni. |
|
| **Misure e Requisiti** | `misure-requisiti.html` | Misure/requisiti di conformità, collegati bidirezionalmente alle policy. |
|
||||||
| **Reports (Audit & Report)** | `reports.html` → `reports-bi.html` | "Audit e Report" | Controlli di audit, evidenze e reportistica di conformità. |
|
| **Supply Chain** | `supply-chain.html` | Gestione fornitori, campagne questionari, portale fornitore, panoramica rischio. |
|
||||||
| **Settings (Impostazioni)** | `settings.html` → `settings-bi.html` | "Impostazioni" | Impostazioni dell'organizzazione, del profilo utente e gestione dei membri. |
|
| **Segnalazioni** | `whistleblowing.html` | Gestione delle segnalazioni/whistleblowing. |
|
||||||
| **ISMS / Modello SGSI** | `isms.html` (non ancora -bi) | "Modello Organizzativo SGSI (ISO 27001)" | Modulo Sistema di Gestione della Sicurezza delle Informazioni (ISO 27001). |
|
| **Normative** | `normative.html` | Feed/elenco degli aggiornamenti normativi. |
|
||||||
| **Normative** | `normative.html` (non ancora -bi) | "Aggiornamenti Normativi" | Feed/elenco degli aggiornamenti normativi. |
|
| **AI Cross-Analysis** | `cross-analysis.html` | Analisi incrociata dei dati di conformità assistita da AI. |
|
||||||
| **Whistleblowing (Segnalazioni)** | `whistleblowing.html` (non ancora -bi) | "Segnalazioni" | Gestione delle segnalazioni/whistleblowing. |
|
| **Knowledge Base** | `kb.html` | Base di conoscenza documentale: caricamento e consultazione documenti. |
|
||||||
| **Knowledge Base** | `kb.html` (non ancora -bi) | "Knowledge Base" | Base di conoscenza documentale: caricamento e consultazione documenti. |
|
| **Organigramma / Competenze / RACI / Stakeholder** | `organigramma.html`, `competenze.html`, `raci.html`, `stakeholders.html` | Modello organizzativo: ruoli, competenze, responsabilità RACI, mappa stakeholder. |
|
||||||
| **Cross-Analysis** | `cross-analysis.html` (non ancora -bi) | "AI Cross-Analysis" | Analisi incrociata dei dati di conformità assistita da AI. |
|
| **Audit interni / Riesame Direzione / Controlli periodici / Calendario** | `internal-audits.html`, `management-review.html`, `controlli-periodici.html`, `calendario.html` | Moduli di gestione ISO-readiness (§9.1/9.2/9.3) e scadenziario unico. |
|
||||||
| **Service Continuity** | `service-continuity.html` (non ancora -bi, fuori sidebar) | "Standard Continuità di Servizio" | Pagina dedicata alla continuità di servizio; raggiungibile via link contestuale, non dal menu. |
|
| **Formazione** | `training.html` | Corsi, assegnazioni e stato della formazione. |
|
||||||
|
| **Asset** | `assets.html` | Inventario asset e rilevanza NIS2. |
|
||||||
|
| **Audit & Report** | `reports.html` | Controlli di audit, evidenze, reportistica ed export. |
|
||||||
|
| **Impostazioni** | `settings.html` | Impostazioni organizzazione, profilo utente, gestione membri, sessioni. |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Come navigare nella V2
|
## Come navigare
|
||||||
|
|
||||||
1. **Accesso**: dopo il login (`login-bi.html`) l'utente arriva alla **Dashboard** (`dashboard-bi.html`), che è il punto di partenza.
|
1. **Accesso**: dopo il login (`login.html`) l'utente arriva alla **Dashboard** (`dashboard.html`), punto di partenza.
|
||||||
2. **Menu laterale (sidebar)**: tutte le funzioni si raggiungono dalla sidebar a sinistra, organizzata nelle 4 sezioni Principale / Gestione / Operativo / Sistema. La voce della pagina corrente è evidenziata (stato "active", `aria-current="page"`).
|
2. **Menu laterale (sidebar)**: tutte le funzioni si raggiungono dalla sidebar a sinistra. La voce della pagina corrente è evidenziata (stato "active", `aria-current="page"`).
|
||||||
3. **Cambio lingua**: in fondo alla sidebar, i pulsanti **IT** / **EN** cambiano la lingua dell'interfaccia.
|
3. **Cambio lingua**: in fondo alla sidebar, i pulsanti **IT** / **EN** cambiano la lingua dell'interfaccia.
|
||||||
4. **Box utente e Logout**: in fondo alla sidebar sono mostrati avatar, nome e ruolo dell'utente; il pulsante con l'icona di uscita esegue il logout.
|
4. **Box utente e Logout**: in fondo alla sidebar sono mostrati avatar, nome e ruolo; il pulsante con l'icona di uscita esegue il logout.
|
||||||
5. **Selettore organizzazione (consulenti)**: per gli utenti che gestiscono più organizzazioni, sopra il menu può comparire un selettore per cambiare l'organizzazione attiva.
|
5. **Selettore organizzazione (consulenti)**: per chi gestisce più organizzazioni, sopra il menu può comparire un selettore per cambiare l'organizzazione attiva.
|
||||||
6. **Versione app**: in fondo alla sidebar è indicata la versione dell'applicazione.
|
6. **Versione app**: in fondo alla sidebar è indicata la versione dell'applicazione.
|
||||||
7. **Mobile**: su schermi piccoli la sidebar diventa un drawer apribile (toggle), coerente con la conversione mobile.
|
7. **Mobile**: su schermi piccoli la sidebar diventa un drawer apribile (toggle).
|
||||||
|
8. **Aiuto contestuale**: molte pagine mostrano un pulsante **"?"** che apre l'aiuto specifico della pagina.
|
||||||
|
|
||||||
### Dove trovare le funzioni principali (mappa rapida per ARIA)
|
### Dove trovare le funzioni principali (mappa rapida per ARIA)
|
||||||
- "Vedere lo stato di conformità / panoramica" → **Dashboard** (sezione Principale).
|
- "Vedere lo stato di conformità / panoramica" → **Dashboard**.
|
||||||
- "Fare la valutazione / questionario / gap" → **Gap Analysis** (assessment); per la parte ACN → **Gap Analysis ACN**.
|
- "Fare la valutazione / questionario / gap" → **Gap Analysis**; parte ACN → **Gap Analysis ACN**.
|
||||||
- "Gestire i rischi" → **Rischi** (sezione Gestione).
|
- "Gestire i rischi" → **Rischi**.
|
||||||
- "Segnalare o gestire un incidente" → **Incidenti** (sezione Gestione).
|
- "Segnalare o gestire un incidente" → **Incidenti**.
|
||||||
- "Documenti e policy" → **Policy** (sezione Gestione).
|
- "Documenti, policy e procedure" → **Policy**; collegamento a misure/requisiti → **Misure e Requisiti**.
|
||||||
- "Fornitori / catena di fornitura" → **Supply Chain** (sezione Gestione).
|
- "Fornitori / catena di fornitura / questionari fornitore" → **Supply Chain**.
|
||||||
- "Fare una segnalazione (whistleblowing)" → **Segnalazioni** (sezione Gestione).
|
- "Fare una segnalazione (whistleblowing)" → **Segnalazioni**.
|
||||||
- "Aggiornamenti normativi" → **Normative** (sezione Gestione).
|
- "Aggiornamenti normativi" → **Normative**.
|
||||||
- "Analisi AI incrociata" → **AI Cross-Analysis** (sezione Gestione).
|
- "Analisi AI incrociata" → **AI Cross-Analysis**.
|
||||||
- "Cercare/caricare documenti di conoscenza" → **Knowledge Base** (sezione Gestione).
|
- "Cercare/caricare documenti di conoscenza" → **Knowledge Base**.
|
||||||
- "Corsi e formazione" → **Formazione** (sezione Operativo).
|
- "Ruoli, competenze, responsabilità, stakeholder" → **Organigramma / Competenze / RACI / Stakeholder**.
|
||||||
- "Inventario asset" → **Asset** (sezione Operativo).
|
- "Audit interni, riesame della direzione, controlli periodici, scadenze" → moduli omonimi + **Calendario**.
|
||||||
- "Report, audit, evidenze, export" → **Audit & Report** (sezione Operativo).
|
- "Corsi e formazione" → **Formazione**.
|
||||||
- "Modello SGSI / ISO 27001" → **Modello SGSI (ISO 27001)** (sezione Principale).
|
- "Inventario asset" → **Asset**.
|
||||||
- "Impostazioni, profilo, membri, organizzazione" → **Impostazioni** (sezione Sistema).
|
- "Report, audit, evidenze, export" → **Audit & Report**.
|
||||||
- "Aiuto / manuale" → **Guida all'uso** (sezione Sistema).
|
- "Modello SGSI / ISO 27001" → **Modello SGSI (ISO 27001)**.
|
||||||
- "Continuità di servizio" → pagina **Service Continuity** (link contestuale, non in sidebar).
|
- "Impostazioni, profilo, membri, sessioni" → **Impostazioni**.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Note tecniche utili (per coerenza, non normative)
|
## Note tecniche (per coerenza, non normative)
|
||||||
- La sidebar V2 è generata da `public/js/common-bi.js`, che deve essere caricato **dopo** `common.js` e ne ridefinisce solo `loadSidebar()`.
|
- La sidebar è generata da `public/js/common-bi.js`, caricato **dopo** `common.js`, di cui ridefinisce `loadSidebar()`.
|
||||||
- L'albero di navigazione (nomi voci, sezioni, link) è lo **stesso** della V1 (`common.js`): cambiando l'una va aggiornata anche l'altra per mantenere parità.
|
- L'albero di navigazione (nomi voci, sezioni, link) è lo **stesso** della V1 (`common.js`): cambiando l'uno va aggiornato anche l'altro per parità.
|
||||||
- Le pagine non ancora `-bi` sono comunque navigabili senza link rotti.
|
- Il CSS Bootstrap Italia è caricato **prima** di `style.css`, che resta autorevole sui widget renderizzati via JS.
|
||||||
|
- Le pagine pubbliche del funnel non caricano `common-bi.js` (non hanno sidebar): caricano solo il CSS Bootstrap Italia.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Come ingestare questo documento nella KB (collection `nis2_kb`, scope SYSTEM)
|
## Come ingerire questo documento nella KB (collection `nis2_kb`, scope SYSTEM)
|
||||||
|
|
||||||
Questo documento è pronto per essere indicizzato nella Knowledge Base RAG così che ARIA possa citarlo. L'ingest richiede accesso a Qdrant (`nis2_kb`) + Voyage, disponibile solo dall'host Hetzner / dal container `nis2-app` (NON dal devenv, che non raggiunge l'infrastruttura).
|
L'ingest richiede accesso a Qdrant (`nis2_kb`) + Voyage, disponibile solo dall'host Hetzner / dal container `nis2-app` (NON dal devenv). **Idempotenza obbligatoria**: cancellare prima i chunk SYSTEM con lo stesso `source` (per rimuovere la versione stale del 2026-06-12), poi ri-upsert.
|
||||||
|
|
||||||
### Opzione A — endpoint API (super_admin, scope SYSTEM)
|
### Opzione A — endpoint API (super_admin, scope SYSTEM)
|
||||||
|
`POST /api/knowledgebase/ingest` con JWT super_admin (lo scope SYSTEM è consentito solo ai super_admin). Body: `{title, text, entity_type:"ui_doc", source:"Documentazione prodotto NIS2 Agile — UI V2 (Bootstrap Italia)", scope:"SYSTEM"}` con `text` = contenuto di questo file.
|
||||||
|
|
||||||
`POST /api/knowledgebase/ingest` richiede un JWT di un utente `super_admin` (lo scope SYSTEM è consentito solo ai super_admin). Limite testo 50.000 char (questo doc è ben sotto).
|
### Opzione B — dal container `nis2-app`
|
||||||
|
Usare `EmbedService` + `VectorService` (`ensureCollection` → cancella chunk SYSTEM con `source` corrispondente → `upsertBatch`) con `scope=SYSTEM`. Script di riferimento idempotente: `scripts/ingest-v2-ui-doc.php` (il container monta solo `application/`+`public/`, quindi copiare temporaneamente lo script + questo `.md` sotto `application/`, eseguire via `docker exec nis2-app php`, poi rimuovere i file temporanei).
|
||||||
|
|
||||||
```bash
|
### Stato ingest
|
||||||
# 1) login come super_admin -> ottieni $TOKEN
|
- 2026-06-12: ingerita la versione **stale** (`-bi.html`), 8 chunk SYSTEM — DA RIMPIAZZARE.
|
||||||
TOKEN=$(curl -s -X POST https://nis2.agile.software/api/auth/login \
|
- 2026-06-19: documento corretto (questo file). **Re-ingest host-side ancora da eseguire** (devenv non raggiunge Qdrant/Voyage e non ha credenziali super_admin).
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{"email":"<SUPER_ADMIN_EMAIL>","password":"<PWD>"}' | python3 -c 'import sys,json;print(json.load(sys.stdin)["access_token"])')
|
|
||||||
|
|
||||||
# 2) ingest del markdown come testo (scope SYSTEM)
|
|
||||||
curl -s -X POST https://nis2.agile.software/api/knowledgebase/ingest \
|
|
||||||
-H "Authorization: Bearer $TOKEN" \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
--data @<(python3 - <<'PY'
|
|
||||||
import json
|
|
||||||
txt=open("/var/www/nis2-agile/docs/kb/V2_UI_NAVIGAZIONE.md").read()
|
|
||||||
print(json.dumps({
|
|
||||||
"title":"Interfaccia V2 (Bootstrap Italia) — struttura e navigazione UI",
|
|
||||||
"text":txt,
|
|
||||||
"entity_type":"ui_doc",
|
|
||||||
"source":"Documentazione prodotto NIS2 Agile — UI V2 (Bootstrap Italia)",
|
|
||||||
"scope":"SYSTEM"
|
|
||||||
}))
|
|
||||||
PY
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Opzione B — dal container `nis2-app` con uno script di ingest testo
|
|
||||||
|
|
||||||
Lo script di riferimento `scripts/ingest-nis2-sources.php` indicizza i **PDF normativi** del registry `nis2_sources.php` (non file markdown arbitrari). Per ingestare questo `.md` come testo SYSTEM, il modo coerente è chiamare l'endpoint `ingest` (Opzione A) oppure usare direttamente `EmbedService` + `VectorService` (`ensureCollection` → `upsertBatch`) con payload `scope=SYSTEM`, `source="Documentazione prodotto NIS2 Agile — UI V2"`, come fa lo script di riferimento per i punti SYSTEM. Esecuzione tipica dal container:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker exec -i nis2-app php /var/www/nis2-agile/scripts/ingest-nis2-sources.php # (riferimento: pipeline embed+upsert SYSTEM)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Stato ingest da questo ambiente (devenv)
|
|
||||||
|
|
||||||
L'ingest NON è stato eseguito da qui: il container/infra non è raggiungibile dal devenv.
|
|
||||||
- `docker` CLI: assente nel devenv.
|
|
||||||
- Qdrant `172.21.0.5:6333` e `nis2-qdrant:6333`: irraggiungibili (HTTP 000).
|
|
||||||
- `POST /api/knowledgebase/ingest` su produzione: risponde 401 senza JWT super_admin (nessuna credenziale disponibile in questo ambiente).
|
|
||||||
|
|
||||||
Azione richiesta: eseguire l'Opzione A (o B) dall'host Hetzner / container `nis2-app` con credenziali super_admin. Idempotenza: per re-ingest, cancellare prima i chunk SYSTEM con lo stesso `source` (filtro `scope=SYSTEM` + `source=...`) come fa lo script di riferimento, poi ri-upsert.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user