38 lines
1.9 KiB
Markdown
Executable File
38 lines
1.9 KiB
Markdown
Executable File
# Promozione documentazione storica nel KB
|
|
|
|
## Obiettivo
|
|
|
|
Rendere consultabile e operativa nel KB la documentazione storica utile a NetGescon senza promuovere in blocco materiale rumoroso, duplicato o transitorio.
|
|
|
|
## Sorgenti locali da valutare per prime
|
|
|
|
- `docs/`: base principale gia' strutturata e prioritaria per promozione nel KB.
|
|
- `_legacy-vault/docs/`: documentazione storica da filtrare e riallineare.
|
|
- `_legacy-vault/incoming/`: materiale grezzo da trattare come inbox, non come fonte autorevole.
|
|
- file top-level di runbook o incidenti ancora utili, solo se non gia' assorbiti in `docs/`.
|
|
|
|
## Regola di promozione
|
|
|
|
1. Se un documento descrive un flusso ancora valido, va normalizzato in `docs/` e poi indicizzato nel KB.
|
|
2. Se un documento e' utile solo come memoria di contesto o workaround, puo' restare fuori dal corpus canonico ma va estratto in una nota KB sintetica.
|
|
3. Dump, export, JSON ispettivi e materiale di debug vanno tenuti fuori dal corpus principale finche' non vengono riassunti.
|
|
|
|
## Primo lotto consigliato
|
|
|
|
- `docs/00-INDICE-DOCS-UNIFICATA.md`
|
|
- `docs/00-INDICE-LAVORO-DISTRIBUITO.md`
|
|
- `docs/support/INTEGRAZIONE-KB-ORCHESTRATOR-53.md`
|
|
- `docs/support/WORKFLOW-KB-ORCHESTRATOR-PRODUTTIVO.md`
|
|
- `docs/support/WABA-ETICHETTE-BACKLOG-INIZIALE.md`
|
|
- `_legacy-vault/docs/` solo dopo selezione per area: anagrafica, integrazioni API, WABA/etichette, distribuzione multi-macchina.
|
|
|
|
## Richiesta operativa verso `.53`
|
|
|
|
- predisporre una coda KB `legacy-netgescon-inbox` per il materiale storico ancora non promosso in `docs/`;
|
|
- distinguere nel KB tra `canonical-docs` e `legacy-notes`;
|
|
- fare leggere alla `.205` prima di sviluppare da zero almeno i flussi `anagrafica unica`, `api integrazioni`, `netlabel etichette`, `waba webhook`, `infrastruttura kb/orchestrator`.
|
|
|
|
## Criterio pratico
|
|
|
|
La promozione deve essere selettiva: prima consolidare documenti stabili in `docs/`, poi usare il KB come strato di recupero e correlazione, non come discarica di file storici.
|