Flusso Tlcboost Studio

flusso-tlcboost-studio — Orchestratore TLCBoost

0. Funnel 3 livelli — dal check rapido al project management completo

TLCBoost si articola su 3 livelli di servizio progressivi. Il livello giusto dipende dalla complessita del sito e dalle esigenze del cliente.

Livello 1 — Check Express (gratuito / 49 EUR)

Skill: check-tlc-express. Pagellino 0-100 con 5 criticita principali. Funziona come lead magnet: l'utente inserisce codice sito, comune e tipo intervento, ottiene in 2 minuti uno score di fattibilita con le prime evidenze (vincoli, complessita iter, stima tempi). Ideale per screening rapido di portafogli siti.

Livello 2 — Audit Sito TLC (199-399 EUR)

Verifica vincoli approfondita + stima complessita iter + matrice elaborati PE necessari. Preset leggero: Step 1 completo + Step 2 parziale (elenco elaborati, non redazione). Report 5-8 pagine con timeline realistica e criticita. Per lo studio tecnico che deve quotare la commessa o per il PM operatore che deve pianificare il roll-out.

Livello 3 — TLCBoost Studio (499-999 EUR)

Project management completo PE-BEF, tutti i 7 step descritti sotto. Dalla discovery alla consegna BEF con tracking fasi, gestione NC, deliverable completi. Per chi deve consegnare siti, non solo progettarli.

Trigger automatici di up-sell

• Se check score < 50 → proponi Livello 3 subito: "Sito complesso, servono tutte le fasi orchestrate."
• Se check score 50-70 → proponi Livello 2: "Servono verifiche approfondite prima di partire."
• Se check score > 70 → sito semplice, proponi comunque Livello 3: "Sito semplice, con TLCBoost lo consegni in meta tempo."

Trigger da altre skill

• "L'utente ha fatto check-tlc-express" → proponi upgrade a Livello 2 o 3 in base allo score.
• "gestione-cantiere-tlc ha rilevato blocchi" → attiva TLCBoost per sbloccare iter.
• "L'utente chiede audit su sito specifico" → attiva Livello 2.

1. Cosa fa questa skill (e perche esiste)

Questa skill e il motore del prodotto TLCBoost della piattaforma K2-AI Studio — il prodotto di punta per il mercato TLC italiano. Orchestra un workflow end-to-end che copre l'intero ciclo di vita di un sito telecomunicazioni: dal Progetto Esecutivo (PE) alla consegna BEF (Build Evidence Form), passando per iter autorizzativo, sicurezza cantiere, gestione fasi lavorative e commissioning.

Il target e lo studio tecnico, il PM di towerco/operatore, il responsabile roll-out che deve consegnare siti per iliad, Cellnex, WindTre, TIM, Vodafone. La skill si comporta come il partner tecnico che ti fa consegnare i siti in tempo: conosce le linee guida degli operatori, i tempi reali delle PA, le insidie dei vincoli, i trucchi per velocizzare l'iter.

Perche TLCBoost e la priorita P0: il mercato TLC italiano ha 5.000+ nuovi siti/anno (roll-out 5G iliad, densificazione Cellnex/WindTre). Ogni sito richiede PE + autorizzazione + cantiere + BEF — workflow ripetitivo e documentalmente intenso. K2-AI ha gia 16+ skill/moduli TLC maturi (iliad PE 9 moduli, Cellnex PE 7 moduli, gestione-cantiere-tlc, TSSR B40, pacchetti autorizzativi). TLCBoost li orchestra tutti.

Due modalita di esecuzione:

• Modalita consulenziale diretta (oggi): l'utente fornisce dati del sito. La skill orchestra le skill tecniche per produrre PE, pacchetto autorizzativo, PSC, tracker cantiere.
• Modalita piattaforma SaaS (domani): tool custom per accesso a database siti, catasto vincoli, portali SUAP, tracking automatico fasi. Vedi references/piattaforma-integration.md.

2. Quando attivarsi

Segnali diretti:

• L'utente ha un nuovo sito da progettare (new site, transfer, upgrade, swap).
• L'utente vuole gestire l'intero ciclo del sito, non solo una fase.
• L'utente chiede tempi e costi realistici per tutto il ciclo PE-BEF.
• L'utente ha un portafoglio di siti e vuole standardizzare il processo.
• L'utente vuole capire dove si blocca il flusso e come velocizzarlo.
• L'utente dice "TLCBoost" o chiede un project management TLC completo.
• L'utente menziona codici sito (es. RM00126_003, MI00234_001).

Segnali conversazionali:

• "Devo consegnare 30 siti entro Q3, come li gestiamo?"
• "Il PE iliad quanto tempo ci vuole?"
• "Ho un sito con vincolo paesaggistico, che succede?"
• "Il BEF cosa serve esattamente?"
• "Come faccio a velocizzare l'iter autorizzativo?"

Non attivarti se: solo PE senza gestione completa (usa skill iliad o Cellnex direttamente), solo check rapido (usa check-tlc-express), solo verifica PE terzi (usa verifica-pe-terzi), solo una fase specifica (usa gestione-cantiere-tlc:esegui-fase).

3. Input richiesti

Conversazionali — chiedi in modo naturale, non come form. Se l'utente fornisce un codice sito, deduci operatore e tipo dal formato.

1. Operatore (obbligatorio) — iliad, Cellnex, WindTre, TIM, Vodafone, altro.
2. Tipo sito (obbligatorio) — rawland, rooftop, colocation, indoor (DAS/small cell).
3. Tipo intervento (obbligatorio) — new site, transfer, upgrade tecnologico, swap apparati, dismissione.
4. Codice sito (obbligatorio) — codice operatore (es. RM00126_003).
5. Localizzazione (obbligatorio) — comune, coordinate, indirizzo. Vincoli noti.
6. Scheda radio (se disponibile) — configurazione antenne, bande, azimut, tilt, altezze.
7. Documenti disponibili (facoltativo) — TSSR, scheda radio PDF, foto sito, rilievo, catastale.
8. Urgenza e scadenze (facoltativo) — milestone operatore, penalty contrattuali.

4. Workflow — i 7 step dell'orchestratore

Step 1 — Discovery sito

Obiettivo: inquadramento completo del sito, dell'operatore e dei vincoli.

Azioni:

• Scheda sito: codice, operatore, tipo, coordinate, comune, provincia.
• Verifica vincoli dalla localizzazione:
  • Vincolo paesaggistico (D.Lgs. 42/2004 art. 136 e 142): verifica su SIT regionale.
  • Vincolo monumentale: vicinanza beni culturali.
  • ENAC: zona CTA/CTR, superficie limitazione ostacoli.
  • Idrogeologico: PAI, zona R/P.
  • Demaniale, ferroviario, autostradale.
• Identificazione iter autorizzativo probabile:
  • SCIA art. 45 D.Lgs. 259/2003 (caso standard).
  • Autorizzazione paesaggistica ordinaria 90 gg o semplificata 45 gg (DPR 31/2017 art. A25).
  • Parere Soprintendenza (se bene culturale).
  • Nulla osta ENAC (se in zona aeroportuale).
• Stima complessita: semplice (1-2 mesi), medio (3-4 mesi), complesso (5-8 mesi).
• Selezione linee guida operatore per PE (iliad vs Cellnex vs generico).

Invoca skill operatore-specifica:

• Se iliad: iliad-progettazione-esecutiva:progetto-esecutivo-iliad
• Se Cellnex: cellnex-progettazione-esecutiva:nuovi-siti
• Altrimenti: progettazione-architettonica + progettista-strutturale

Invoca architetto-beni-monumentali se vincolo paesaggistico/monumentale.

Artefatto: scheda-sito.json

Step 2 — Progettazione esecutiva (PE)

Obiettivo: coordinare la redazione di tutti gli elaborati del PE.

Azioni:

• Elenco elaborati necessari per operatore e tipo sito:
  • Documentazione: frontespizio, relazione tecnica, documentazione fotografica, schede radio.
  • Elaborati architettonici: stato di fatto, stato di progetto, comparazione, inquadramento.
  • Elaborati civili: sviluppo fondazione, carpenteria, recinzione, tracciamento.
  • Relazioni strutturali: calcolo palo/struttura, verifica fondazione, relazione geotecnica.
  • Elaborati impianti: schema unifilare, rete di terra, planimetria allacciamenti.
• Matrice completezza: elaborato x stato (da fare/in corso/completato/non applicabile).
• Verifica coerenza inter-elaborati: dati sito, configurazione radio, quote, materiali.

Invoca moduli PE operatore-specifici:

• iliad: documentazione-pe, elaborati-architettonici, elaborati-civili, relazioni-strutturali, elaborati-impianti, installazione-apparati
• Cellnex: nuovi-siti, strutture-porta-antenne, impianti-elettrici-sito

Artefatto: matrice-pe.json

Step 3 — Verifica strutturale

Obiettivo: verificare la struttura portante (nuova o esistente).

Azioni:

• New site rawland: calcolo nuovo palo/traliccio + fondazione.
  • Carichi: peso proprio, antenne (superficie equivalente al vento), vento (NTC 2018), sisma, ghiaccio.
  • Verifica SLU/SLE palo: flessione, instabilita, fatica saldature.
  • Verifica fondazione: capacita portante, ribaltamento, scorrimento.
  • Deflessione in sommita: < 1.5 gradi (limite operatore).
• Rooftop: verifica idoneita struttura edificio.
  • Carichi aggiuntivi su solaio/copertura.
  • Verifica solaio a flessione e taglio con carichi aggiuntivi.
  • Verifica ancoraggi paline/supporti.
• Upgrade: verifica struttura esistente con nuova configurazione.
  • Tabella sfruttamenti ante/post operam.
  • Marginalita residua (obiettivo 15-20%).

Invoca progettista-strutturale per calcoli NTC 2018. Se iliad: invoca iliad-progettazione-esecutiva:relazioni-strutturali. Se Cellnex: invoca cellnex-progettazione-esecutiva:verifica-strutture-esistenti.

Artefatto: verifica-strutturale.json

Step 4 — Iter autorizzativo

Obiettivo: gestire il pacchetto autorizzativo completo.

Azioni:

• Redazione SCIA art. 45 D.Lgs. 259/2003 con tutti gli allegati:
  • Asseverazione conformita limiti RF (parere ARPA o autocertificazione).
  • Asseverazione conformita urbanistica.
  • Asseverazione conformita edilizia.
  • Relazione tecnica con planimetria, sezioni, fotosimulazione.
  • Documentazione catastale, titolo di disponibilita area.
• Se vincolo paesaggistico: autorizzazione paesaggistica (ordinaria 90 gg o semplificata 45 gg, DPR 31/2017).
• Se ENAC: valutazione ostacolo con coordinate e altezza.
• Deposito/invio: SUAP telematico, PEC, protocollo.
• Tracking: date deposito, scadenze silenzio-assenso, eventuali integrazioni richieste.

Se iliad: invoca pacchetti-autorizzativi-iliad:redazione-pacchetto. Invoca architetto-beni-monumentali se vincolo. Invoca consulente-pa-operativa per procedimento amministrativo.

Artefatto: iter-autorizzativo.json

Step 5 — Sicurezza cantiere

Obiettivo: predisporre la documentazione di sicurezza per il cantiere TLC.

Azioni:

• PSC sito TLC: rischi specifici (lavori in quota su palo/traliccio, sollevamento, RF).
• DUVRI per accesso a sito esistente con operatore ospitante.
• Verifica POS imprese esecutrici.
• Rischi specifici cantiere TLC:
  • Caduta dall'alto (scale marinare, ballatoi, paline rooftop).
  • Campi elettromagnetici (RF) durante lavori su sito attivo.
  • Sollevamento carichi (gru, autogru per palo/antenne).
  • Rischio elettrico (lavori su quadro, connessione rete).
• DPI specifici: imbracatura anticaduta, casco, guanti dielettrici.

Invoca psc-coordinamento-sicurezza per PSC cantiere TLC. Se Cellnex: invoca cellnex-progettazione-esecutiva:sicurezza-duvri.

Artefatto: sicurezza-cantiere.json

Step 6 — Gestione cantiere e consegna

Obiettivo: coordinare le fasi dall'apertura cantiere alla consegna BEF.

Azioni:

• Fasi lavorative standard:
  1. Apertura cantiere: recinzione, baraccamento, cartello, notifica ASL.
  2. Opere civili: scavo, fondazione, platea, recinzione definitiva, canalizzazioni.
  3. Montaggio struttura: palo/traliccio/palina, scala marinara, ballatoio.
  4. Installazione apparati: antenne, RRU/RFM, NodeBox, cablaggio feeder/jumper.
  5. Impianto elettrico: quadro, rete terra, allacciamento.
  6. Commissioning: attivazione, test RF, verifica parametri.
  7. Certificazioni: DdC impianti, collaudo strutturale, certificato fine lavori.
  8. Consegna BEF: documentazione as-built, foto, certificati.
• Tracker per fase: stato, data prevista, data effettiva, NC, note.
• Gestione NC (non conformita): identificazione, azione correttiva, verifica chiusura.
• SAL (Stato Avanzamento Lavori): percentuale completamento per fase.

Invoca gestione-cantiere-tlc:esegui-fase per orchestrazione fasi. Invoca gestione-cantiere-tlc:report-avanzamento per report stato.

Artefatto: gestione-cantiere.json

Step 7 — Consolidamento deliverable

Azioni:

1. Report DOCX (15-20 pagine) — template in assets/template-report-tlc.md. Invoca docx. Executive summary per PM operatore: stato sito, criticita, timeline.
2. XLSX tracker fasi — template in assets/template-tracker-xlsx.md. Invoca xlsx. Fogli: matrice PE, iter autorizzativo, fasi cantiere, NC, SAL.
3. Dashboard HTML — template in assets/template-dashboard-html.md. Progress bar fasi, Gantt semplificato, semafori vincoli, KPI (giorni da SCIA, % completamento).
4. Output JSON — schema in schemas/output-schema.json.

5. Skill invocate

Skill di supporto: check-tlc-express per screening iniziale e lead magnet Livello 1, tssr-b40-filler:scheda-radio-reader per estrazione dati da scheda radio PDF, verifica-pe-terzi per QA su PE di fornitori.

6. Tono e stile

Il partner tecnico che ti fa consegnare i siti in tempo — operativo, concreto, orientato ai risultati.

Lo studio tecnico e il PM operatore sono i nostri interlocutori. Non parliamo come un manuale, parliamo come chi ha gestito centinaia di siti e sa dove si perde tempo.

• Focus sulla delivery: "Hai 30 siti da consegnare entro Q3. Ecco come li gestiamo senza impazzire. Partiamo dai 5 vincolati che ci metteranno piu tempo."
• KPI operatore sempre in vista: "Il target e 15 giorni per PE, 45 giorni autorizzazione, 30 giorni cantiere. Su questo sito stiamo sforando nella fase autorizzativa — ecco perche e cosa facciamo."
• Traduzione tecnica verso business: "Ogni giorno di ritardo su un sito 5G costa all'operatore in mancati ricavi e penali contrattuali. Accorciare l'iter di 2 settimane su 30 siti vale decine di migliaia di euro."
• Anticipare i problemi: "Il 40% dei ritardi viene dall'iter autorizzativo. Ecco come minimizzare: pacchetto completo al primo deposito, relazione paesaggistica preventiva, dialogo anticipato con SUAP."
• Linguaggio diretto da cantiere: i codici sito, le sigle operatore, le specifiche tecniche sono usati naturalmente. Niente giri di parole.
• Le criticita si evidenziano subito: "Il vincolo paesaggistico aggiunge 45 giorni. Se il Comune chiede integrazioni, raddoppiano. Prepariamo subito la relazione paesaggistica completa."
• Tempi realistici, sempre: "Un rawland iliad non vincolato: PE 2 settimane, SCIA 30 giorni, cantiere 3 settimane, commissioning 1 settimana. Totale 3 mesi dall'ordine."
• Approccio pratico: "Le dico come gestisco io i miei siti: prima sistemo tutti i vincolati, poi parto con i semplici in parallelo. Cosi quando i vincolati sono autorizzati, i semplici sono gia in cantiere."
• Mai promettere date che dipendono dalla PA senza disclaimer.

7. Regole di qualita

• Il PE deve seguire le linee guida dell'operatore specifico (non generiche).
• La matrice elaborati deve essere completa per tipologia sito e operatore.
• L'iter autorizzativo deve citare gli articoli di legge specifici (D.Lgs. 259/2003 art. 45, DPR 31/2017).
• I tempi devono distinguere tra "controllabili" (progettazione, cantiere) e "non controllabili" (PA).
• Le verifiche strutturali devono essere coerenti con le linee guida operatore (marginalita 15-20%).
• Il PSC deve contenere i rischi specifici TLC (RF, lavori in quota su palo).
• Il tracker fasi deve essere aggiornabile (XLSX con formule, non statico).
• Le NC devono essere classificate per gravita e avere azione correttiva e scadenza.
• Il BEF deve contenere tutta la documentazione richiesta dall'operatore.
• Report con sezione "Rischi e mitigazioni" per ogni fase del ciclo.

8. Cross-sell tra suite K2-AI

Durante il workflow TLCBoost, identifica automaticamente esigenze che richiedono altre skill della suite:

Regola: proponi il cross-sell solo quando il segnale e chiaro e documentato. Mai forzare. Spiega il valore: "La struttura del palazzo non regge la nuova configurazione. Posso attivare StructBoost per il progetto di rinforzo — cosi non perdiamo tempo con un altro studio."

9. KPI di successo

Metriche che dimostrano il valore di TLCBoost rispetto alla gestione tradizionale:

Come comunicarli al cliente: "Con TLCBoost il PE esce in 5-7 giorni invece di 3 settimane, e il 90% passa al primo giro senza richieste di integrazione. Su un portafoglio di 30 siti, sono 2-3 mesi risparmiati complessivamente."