From f9b2c9d6d78d9927a66498019d20eb4c9d41ab88 Mon Sep 17 00:00:00 2001
From: DevEnv nis2-agile <dev@certisource.it>
Date: Sat, 20 Jun 2026 07:19:20 +0200
Subject: [PATCH] =?UTF-8?q?[KB]=20V2=5FUI=5FNAVIGAZIONE.md:=20correzione?=
 =?UTF-8?q?=20doc=20UI=20=E2=80=94=20V2=20in-place=20(no=20file=20-bi.html?=
 =?UTF-8?q?),=20BI=5FPAGES=20vestigiale,=20conversione=20completa;=20pront?=
 =?UTF-8?q?a=20per=20re-ingest=20che=20rimpiazza=20i=20chunk=20stale=20del?=
 =?UTF-8?q?=2012/6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/kb/V2_UI_NAVIGAZIONE.md | 201 +++++++++++++++--------------------
 1 file changed, 83 insertions(+), 118 deletions(-)

diff --git a/docs/kb/V2_UI_NAVIGAZIONE.md b/docs/kb/V2_UI_NAVIGAZIONE.md
index 465ddea..0efc987 100644
--- a/docs/kb/V2_UI_NAVIGAZIONE.md
+++ b/docs/kb/V2_UI_NAVIGAZIONE.md
@@ -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).
-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`
-- `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`
+### Stato della conversione
 
-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)
 
-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à.
 - **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 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.
 
-### Sezione 2 — Gestione
+### Sezione — Gestione
 - **Rischi** (`risks.html`) — registro dei rischi e relativa gestione.
 - **Incidenti** (`incidents.html`) — gestione degli incidenti.
-- **Policy** (`policies.html`) — gestione delle policy/documenti.
-- **Supply Chain** (`supply-chain.html`) — gestione fornitori e catena di fornitura.
+- **Policy** (`policies.html`) — gestione delle policy/documenti (Policy e Procedure unificate).
+- **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.
 - **Normative** (`normative.html`) — aggiornamenti normativi.
 - **AI Cross-Analysis** (`cross-analysis.html`) — analisi incrociata assistita da AI.
 - **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.
 - **Asset** (`assets.html`) — inventario degli asset.
 - **Audit & Report** (`reports.html`) — audit e reportistica.
 
-### Sezione 4 — Sistema
+### Sezione — Sistema
 - **Guida all'uso** (`guida.html`) — manuale/guida d'uso.
 - **Impostazioni** (`settings.html`) — impostazioni organizzazione/profilo/membri.
 - **Architettura** (`architecture.html`) — pagina informativa sull'architettura del sistema.
 - **Simulazione Demo** (`simulate.html`) — ambiente dimostrativo.
 - **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 |
-|---|---|---|---|
-| **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. |
-| **Gap Analysis (Assessment)** | `assessment.html` → `assessment-bi.html` | "Gap Analysis" | Questionario di valutazione della conformità e analisi degli scostamenti (gap) rispetto ai requisiti. |
-| **Gap Analysis ACN** | `acn-gap.html` (non ancora -bi) | "Gap Analysis ACN" | Valutazione di secondo livello dedicata alle misure/requisiti ACN. |
-| **Rischi** | `risks.html` → `risks-bi.html` | "Gestione Rischi" | Registro dei rischi, valutazione e trattamento dei rischi. |
-| **Incidenti** | `incidents.html` → `incidents-bi.html` | "Gestione Incidenti" | Registrazione e gestione del ciclo di vita degli incidenti. |
-| **Policy** | `policies.html` → `policies-bi.html` | "Policy" | Gestione, redazione e approvazione delle policy/documenti. |
-| **Supply Chain** | `supply-chain.html` → `supply-chain-bi.html` | "Supply Chain" | Gestione fornitori, valutazioni e panoramica del rischio della catena di fornitura. |
-| **Training (Formazione)** | `training.html` → `training-bi.html` | "Formazione" | Corsi, assegnazioni e stato della formazione. |
-| **Asset** | `assets.html` → `assets-bi.html` | "Inventario Asset" | Inventario degli asset e relative informazioni. |
-| **Reports (Audit & Report)** | `reports.html` → `reports-bi.html` | "Audit e Report" | Controlli di audit, evidenze e reportistica di conformità. |
-| **Settings (Impostazioni)** | `settings.html` → `settings-bi.html` | "Impostazioni" | Impostazioni dell'organizzazione, del profilo utente e gestione dei membri. |
-| **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` (non ancora -bi) | "Aggiornamenti Normativi" | Feed/elenco degli aggiornamenti normativi. |
-| **Whistleblowing (Segnalazioni)** | `whistleblowing.html` (non ancora -bi) | "Segnalazioni" | Gestione delle segnalazioni/whistleblowing. |
-| **Knowledge Base** | `kb.html` (non ancora -bi) | "Knowledge Base" | Base di conoscenza documentale: caricamento e consultazione documenti. |
-| **Cross-Analysis** | `cross-analysis.html` (non ancora -bi) | "AI Cross-Analysis" | Analisi incrociata dei dati di conformità assistita da AI. |
-| **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. |
+| Pagina | URL | Scopo |
+|---|---|---|
+| **Dashboard** | `dashboard.html` | Panoramica iniziale post-login: stato complessivo della conformità e accesso rapido ai moduli. È la home dell'app. |
+| **Compliance Journey** | `workflow.html` | Percorso guidato passo-passo verso la conformità. |
+| **Gap Analysis** | `assessment.html` | Questionario di valutazione della conformità e analisi degli scostamenti (gap). |
+| **Gap Analysis ACN** | `acn-gap.html` | Valutazione di secondo livello dedicata alle misure/requisiti ACN. |
+| **Modello SGSI / ISO 27001** | `isms.html` | Sistema di Gestione della Sicurezza delle Informazioni (ISO 27001), SoA pre-popolata da NIS2. |
+| **Rischi** | `risks.html` | Registro dei rischi, valutazione e trattamento. |
+| **Incidenti** | `incidents.html` | Registrazione e gestione del ciclo di vita degli incidenti (notifiche Art.23). |
+| **Policy** | `policies.html` | Gestione, redazione e approvazione di policy/procedure unificate. |
+| **Misure e Requisiti** | `misure-requisiti.html` | Misure/requisiti di conformità, collegati bidirezionalmente alle policy. |
+| **Supply Chain** | `supply-chain.html` | Gestione fornitori, campagne questionari, portale fornitore, panoramica rischio. |
+| **Segnalazioni** | `whistleblowing.html` | Gestione delle segnalazioni/whistleblowing. |
+| **Normative** | `normative.html` | Feed/elenco degli aggiornamenti normativi. |
+| **AI Cross-Analysis** | `cross-analysis.html` | Analisi incrociata dei dati di conformità assistita da AI. |
+| **Knowledge Base** | `kb.html` | 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. |
+| **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. |
+| **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.
-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"`).
+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. 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.
-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.
-5. **Selettore organizzazione (consulenti)**: per gli utenti che gestiscono più organizzazioni, sopra il menu può comparire un selettore per cambiare l'organizzazione attiva.
+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 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.
-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)
-- "Vedere lo stato di conformità / panoramica" → **Dashboard** (sezione Principale).
-- "Fare la valutazione / questionario / gap" → **Gap Analysis** (assessment); per la parte ACN → **Gap Analysis ACN**.
-- "Gestire i rischi" → **Rischi** (sezione Gestione).
-- "Segnalare o gestire un incidente" → **Incidenti** (sezione Gestione).
-- "Documenti e policy" → **Policy** (sezione Gestione).
-- "Fornitori / catena di fornitura" → **Supply Chain** (sezione Gestione).
-- "Fare una segnalazione (whistleblowing)" → **Segnalazioni** (sezione Gestione).
-- "Aggiornamenti normativi" → **Normative** (sezione Gestione).
-- "Analisi AI incrociata" → **AI Cross-Analysis** (sezione Gestione).
-- "Cercare/caricare documenti di conoscenza" → **Knowledge Base** (sezione Gestione).
-- "Corsi e formazione" → **Formazione** (sezione Operativo).
-- "Inventario asset" → **Asset** (sezione Operativo).
-- "Report, audit, evidenze, export" → **Audit & Report** (sezione Operativo).
-- "Modello SGSI / ISO 27001" → **Modello SGSI (ISO 27001)** (sezione Principale).
-- "Impostazioni, profilo, membri, organizzazione" → **Impostazioni** (sezione Sistema).
-- "Aiuto / manuale" → **Guida all'uso** (sezione Sistema).
-- "Continuità di servizio" → pagina **Service Continuity** (link contestuale, non in sidebar).
+- "Vedere lo stato di conformità / panoramica" → **Dashboard**.
+- "Fare la valutazione / questionario / gap" → **Gap Analysis**; parte ACN → **Gap Analysis ACN**.
+- "Gestire i rischi" → **Rischi**.
+- "Segnalare o gestire un incidente" → **Incidenti**.
+- "Documenti, policy e procedure" → **Policy**; collegamento a misure/requisiti → **Misure e Requisiti**.
+- "Fornitori / catena di fornitura / questionari fornitore" → **Supply Chain**.
+- "Fare una segnalazione (whistleblowing)" → **Segnalazioni**.
+- "Aggiornamenti normativi" → **Normative**.
+- "Analisi AI incrociata" → **AI Cross-Analysis**.
+- "Cercare/caricare documenti di conoscenza" → **Knowledge Base**.
+- "Ruoli, competenze, responsabilità, stakeholder" → **Organigramma / Competenze / RACI / Stakeholder**.
+- "Audit interni, riesame della direzione, controlli periodici, scadenze" → moduli omonimi + **Calendario**.
+- "Corsi e formazione" → **Formazione**.
+- "Inventario asset" → **Asset**.
+- "Report, audit, evidenze, export" → **Audit & Report**.
+- "Modello SGSI / ISO 27001" → **Modello SGSI (ISO 27001)**.
+- "Impostazioni, profilo, membri, sessioni" → **Impostazioni**.
 
 ---
 
-## Note tecniche utili (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()`.
-- 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à.
-- Le pagine non ancora `-bi` sono comunque navigabili senza link rotti.
+## Note tecniche (per coerenza, non normative)
+- 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'uno va aggiornato anche l'altro per parità.
+- 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)
+`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
-# 1) login come super_admin -> ottieni $TOKEN
-TOKEN=$(curl -s -X POST https://nis2.agile.software/api/auth/login \
-  -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.
+### Stato ingest
+- 2026-06-12: ingerita la versione **stale** (`-bi.html`), 8 chunk SYSTEM — DA RIMPIAZZARE.
+- 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).