Vai al contenuto

RAS Evidence Hub Application Plan - 2026-07-10

Scopo

Definire come applicare, solo dopo approvazione esplicita, le proposte emerse dai report readonly e dal dry-run RAS Evidence Hub.

Questo piano non autorizza scritture: e' una procedura di controllo per decidere quando e come procedere.

Perimetro

Tenant coinvolti:

Tenant Stato Uso nel piano
tenant_safecondo produzione candidato a futura applicazione categorie tecniche RAS
tenant_besant produzione solo proposta manuale, nessuna applicazione automatica
tenant_echos pilota secondario validazione con seed/test sintetici

Regole tenant:

  • tenant_safecondo e' produzione: ogni modifica richiede export, approvazione e rollback pronto.
  • tenant_besant e' produzione e lavora gia' sulla formazione: nessuna modifica automatica ai documenti o alle categorie.
  • tenant_echos non deve ricevere dati Safecondo/Besant.
  • Extrabit e' solo Safecondo.

Input Approvabili

Input gia' prodotti:

  • docs/processo/report/ras_category_proposal_dry_run_2026-07-10.md;
  • docs/processo/report/ras_category_proposal_dry_run_2026-07-10.csv;
  • docs/processo/report/safecondo_uncategorized_p2_2026-07-10.csv;
  • docs/processo/report/besant_uncategorized_p1_2026-07-10.csv;
  • docs/processo/report/echos_evidence_hub_validation_plan_2026-07-10.md.

Numeri di riferimento:

Gruppo Totale Decisione
Safecondo categorie tecniche proposte 489 applicabile solo dopo approvazione
Besant DVR proposti manualmente 2 non applicare automaticamente
Safecondo esclusi/manual review/no category 29 non applicare automaticamente
Echos seed/test da preparare solo validazione

Gate Obbligatori

Gate Blocco Criterio di uscita
G0 - Conferma tassonomia nomi categorie e tenant scope approvazione scritta categorie e regole tenant
G1 - Conferma dry-run elenco documenti e azioni approvazione CSV dry-run, senza righe dubbie
G2 - Export/backup snapshot dati interessati export completato e verificato
G3 - Applicazione Safecondo solo categorie tecniche Safecondo batch applicativo tracciato
G4 - Verifica post-apply conteggi e cross-tenant report readonly post-applicazione coerente
G5 - Besant manuale conferma admin documento per documento eventuale modifica manuale separata

Nessun gate puo' essere saltato su dati produzione.

Export Minimo Prima di Scrivere

Prima di ogni futura applicazione su produzione esportare almeno:

  • righe documento coinvolte dal CSV dry-run;
  • righe documento_categoria esistenti per gli stessi documenti;
  • righe categoria interessate o candidate;
  • righe stored_files collegate agli stessi documenti;
  • CSV dry-run approvato;
  • log batch con data, utente, tenant, categoria e documento.

MinIO:

  • per l'applicazione categorie non sono previste scritture MinIO;
  • non spostare, rinominare o cancellare oggetti;
  • per i casi local:*, mapping ambiguo o file mancanti, MinIO resta solo in lettura fino a piano dedicato.

Batch Applicativo Proposto

Batch id consigliato:

ras_evidence_hub_categories_2026_07_10_safecondo_v1

Il batch deve registrare:

  • tenant;
  • documento;
  • categoria precedente, se presente;
  • categoria aggiunta;
  • sorgente decisione;
  • timestamp;
  • operatore;
  • motivo;
  • riferimento al CSV approvato.

Applicazione Ammessa Dopo Approvazione

Applicabile solo su tenant_safecondo:

Categoria Totale Scope
RAS / Legacy Dynamic 194 Safecondo
RAS / Pacchetti Extrabit 131 Safecondo only
RAS / Payload Extrabit 128 Safecondo only
RAS / Schede NC 36 Safecondo

La scrittura ammessa, se approvata, deve limitarsi al collegamento categoria-documento o alla categoria tecnica equivalente gia' prevista dal modello dati.

Esclusioni

Non applicare automaticamente:

  • Safecondo local:*;
  • Safecondo documenti 425 e 608 con mapping ambiguo;
  • Safecondo 25 PDF pdf_other;
  • Safecondo 4 documenti senza stored_files;
  • Besant documento 1126 RAS legacy;
  • Besant test clone 1159 e 1160;
  • Besant PDF 2257 e 2258, salvo conferma manuale;
  • qualunque categoria Extrabit fuori da Safecondo;
  • qualunque dato produzione su Echos.

Rollback

Rollback previsto:

  1. identificare il batch id applicato;
  2. rimuovere solo i collegamenti categoria-documento creati da quel batch;
  3. ripristinare eventuali collegamenti precedenti usando export documento_categoria;
  4. non cancellare documenti;
  5. non cancellare categorie condivise se preesistenti;
  6. non toccare MinIO.

Il rollback deve essere provato su staging o con transazione controllata prima della produzione.

Verifiche Post-Apply

Dopo eventuale applicazione:

  • rieseguire report readonly Safecondo uncategorized;
  • verificare che le 489 righe approvate non risultino piu' senza categoria tecnica;
  • verificare che i 29 esclusi restino invariati;
  • verificare che Besant resti invariato, salvo azioni manuali approvate;
  • verificare che Echos non contenga dati produzione;
  • verificare che Extrabit compaia solo Safecondo;
  • confrontare conteggi prima/dopo con CSV approvato.

Decisione Operativa

La prossima azione consigliata non e' scrivere su produzione.

Ordine consigliato:

  1. approvare o correggere la tassonomia;
  2. validare Echos con seed/test sintetici;
  3. preparare export SQL/CSV dei record coinvolti;
  4. solo dopo, decidere se generare script applicativo Safecondo in dry-run;
  5. applicare in produzione solo con comando esplicito e rollback pronto.