discovery-cartella-sito-tlc

name: discovery-cartella-sito-tlc description: Sub-skill di VerifyBoost TLC. Mappa esaustivamente i file di una cartella di sito TLC italiano (iliad/Cellnex/INWIT/WindTre), inclusi archivi compressi annidati (.zip, .rar, .7z) e file firmati digitalmente (.p7m doppi/tripli). Si attiva quando viene avviata una verifica VerifyBoost o quando l'utente dice "mappa cartella sito", "cosa c'è nella cartella di {codice}", "estrai tutti i file dal sito". Output: lista categorizzata per tipologia documentale (PE, autorizzazioni, deposito GC, realizzato, foto) + segnalazione di archivi/firme da estrarre.

Discovery cartella sito TLC

Mappa esaustivamente la cartella di un sito TLC e categorizza i file per tipologia documentale.

Trigger di attivazione

• Avvio pipeline VerifyBoost TLC (chiamata dall'orchestratore)
• "Mappa cartella sito {codice}"
• "Cosa c'è nella cartella di {codice}"
• "Discovery sito {codice}"

Quando NON usare

• Se l'utente vuole solo leggere un file specifico già noto
• Se la verifica non è ancora stata richiesta (è una sub-skill di pipeline)

Pipeline operativa

Step 1 - Ricerca esaustiva file

Esegui ricerca completa nella cartella sito target con find:

find "<cartella_sito>" -type f 2>/dev/null | sort

Cerca sempre anche file nascosti in archivi:

find "<cartella_sito>" -type f \( -iname "*.zip" -o -iname "*.rar" -o -iname "*.7z" -o -iname "*.p7m" \) 2>/dev/null

Step 2 - Estrazione archivi annidati

Archivi .zip: estrai con Python zipfile:

import zipfile
with zipfile.ZipFile(path) as z:
    z.extractall(dest_dir)

Archivi .7z: richiede py7zr (NON usare 7z CLI che spesso non è disponibile):

pip install py7zr --break-system-packages --quiet

import py7zr
with py7zr.SevenZipFile(path, 'r') as z:
    z.extractall(dest_dir)

Archivi .rar: richiede rarfile + unrar:

pip install rarfile --break-system-packages --quiet

File .p7m (firma digitale CAdES): vedi references/estrazione-p7m-cades.md per snippet completo. ATTENZIONE: gestire wrapping doppi/tripli (.p7m.p7m.p7m) - alcuni file sono firmati più volte.

Step 3 - Categorizzazione automatica

Classifica ogni file in una delle macro-categorie:

Step 4 - Output strutturato

Produci JSON con questa struttura:

{
  "sito_codice": "FI50144_002",
  "data_discovery": "2026-05-04",
  "totale_file": 87,
  "totale_foto": 70,
  "archivi_estratti": [
    "1.zip", "Doc fine opere.zip", "Foto Belfiore.zip", "Deposito GC.7z"
  ],
  "categorie": {
    "PE_progetto_esecutivo": ["2022.10.10_PE_..."],
    "deposito_genio_civile": ["19_FI144_002_Deposito GC.7z (estratto)"],
    "...": []
  },
  "p7m_estratti": ["PDM AUTORIZZATO.p7m", "Fascicolo_A02.pdf.p7m.p7m"],
  "warning": [
    "Trovati N file p7m con doppio/triplo wrapping",
    "File X non leggibile: corrotto"
  ]
}

Lessons learned

• Mai assumere che la cartella sia piatta. I siti TLC hanno tipicamente 3-5 livelli di nesting con archivi compressi multipli.
• Mai saltare i .7z. Spesso il deposito GC è in .7z per dimensioni - se non viene estratto, si salta l'intera verifica strutturale formale.
• Verifica md5 dei file con stessa dimensione. A volte fascicoli depositati con etichette diverse sono lo stesso file (es. caso PORTOS A07/A08/A09 nel sito FI50144_002).
• Le foto sono spesso in 2-3 zip diversi. Verificare md5 per evitare di duplicare foto identiche.

Esempio applicato

Sito: FI50144_002 VIALE BELFIORE - cartella su Desktop

find "/path/FI50144_002 VIALE BELFIORE" -type f | wc -l
# 87 file totali

find ... -iname "*.7z"
# trovato: 1/01_Permessi/19_FI144_002_Deposito GC.7z

# estrazione
python3 -c "import py7zr; py7zr.SevenZipFile('19_FI144_002_Deposito GC.7z').extractall('/tmp/GC/')"

# il pacchetto contiene Avviso Vidimazione + 11 fascicoli .p7m (alcuni doppi/tripli) + 3 asseverazioni + 2 ricevute IRIS

Output finale alla skill chiamante

Restituisci:

• JSON di mappa categorizzata completa
• Lista warning (file corrotti, p7m problematici, archivi non estraibili)
• Lista priorità lettura (i 5-10 documenti più rilevanti per la baseline)