netgescon-day0/docs/support/PROMOZIONE-DOCUMENTAZIONE-STORICA-KB.md

1.9 KiB
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.