Indicazioni tecniche per agenti AI: come creare e modificare i manuali operativi.
Struttura standard, convenzioni e regole da rispettare quando si crea o si modifica un manuale
Protocollo repo V2.2: per il flusso globale pull → verifica anagrafica CRM → documentazione → push → reset produzione, vedi app/index.php → Sync Git e tracciamento accessi.
manuale_tetto_legno.php e manuale_demolizioni.php. Non duplicare qui sintesi o estratti dei manuali.
Ogni manuale operativo deve seguire la stessa struttura modulare in 5 capitoli. Usala come schema obbligatorio quando crei un nuovo manuale o quando integri sezioni mancanti.
Regola per l'agente: Se un manuale esistente non rispetta questa struttura, proporre l’integrazione delle sezioni mancanti senza stravolgere il contenuto già presente. Mantenere stile e formato (titoli, liste, tabelle) coerenti con il resto del file.
I manuali risiedono in manuali_operativi/. Ogni manuale è un singolo file PHP (es. manuale_tetto_legno.php, manuale_demolizioni.php).
manuale_[argomento].php (minuscolo, underscore).manuale_tetto_legno.php, manuale_demolizioni.php.Ogni file manuale deve dichiarare breadcrumbs coerenti con la posizione:
$breadcrumbs = [
['label' => 'Home', 'url' => 'index.php'],
['label' => 'Manuali Operativi', 'url' => 'manuali_operativi/index.php'],
['label' => 'Titolo Manuale'],
];
I percorsi vanno adattati se il file è incluso da contesti diversi (es. ../index.php se necessario in base a BASE_PATH o APP_DIR).
Ogni manuale dovrebbe avere un indice navigabile in cima (anchor verso le sezioni principali), in linea con lo stile di cantieri/index.php e app/index.php. Usare id sugli heading per i link (es. id="logistica").
manuali_operativi/manuale_[argomento].php.require_once __DIR__ . '/../app/config/bootstrap.php'; (o percorso corretto).$pageTitle e $breadcrumbs.includePageHeader();, includeComponent('footer'); (o include APP_DIR . '/includes/header.php'; se il progetto usa quello). Verificare coerenza con gli altri manuali esistenti.manuali_operativi/index.php (nuova file-box con titolo e link al file).master_index.php: nel blocco "Manuali Operativi – Indice Navigazione Rapida" aggiungere un link alla nuova sezione solo se in index si aggiunge una voce di indice dedicata; altrimenti assicurarsi che il master index rimanga allineato alle voci presenti in questa pagina.class="note") degli altri manuali.amministrazione/prezzario.php e ai protocolli in cantieri/index.php invece di duplicare tabelle lunghe, salvo dove sia necessario riportare valori specifici del manuale.Il file manuale_tetto_legno.php è stato ristrutturato per riflettere un flusso di lavoro moderno:
Al momento della chiusura di un cantiere, estrarre dal diario criticità risolte, varianti tecniche e suggerimenti operativi, e inserirli come sezione Note dal campo nel manuale tecnico di riferimento (es. tetto legno). Questa sezione va aggiunta come 6° capitolo dopo "Analisi Tempi e Coefficienti Rischio", con stile class="note" e citazione della fonte (cantiere, anno). Esempio implementato in manuale_tetto_legno.php (cap. 6 – fonte: Legnano Via Milano 2026).
Per garantire coerenza tra documentazione tecnica, economica e produttività, usare la seguente mappa:
| Modulo | Domanda | File di riferimento |
|---|---|---|
| Manuale operativo | Definisce il Come (tecnica, fasi, sicurezza) | manuali_operativi/manuale_tetto_legno.php |
| Prezzario | Definisce il Quanto (economia, prezzo unitario per U.M.) | amministrazione/prezzario.php |
| Storico rese | Definisce il Quanto tempo (produttività, ore/u.m., resa media) | amministrazione/storico_rese.php, storico_rese_data.inc.php |
Agenti AI e sviluppatori: usare i codici univoci (ACC, STR, ABB, FIN, ISO, VEN, SER, SIC, EXT) per mantenere allineati manuale, prezzario e storico rese.
Nei manuali operativi:
Evitare di duplicare in un manuale intere tabelle o paragrafi già presenti in Prezzario o in Cantieri; preferire link e brevi richiami.
Se modifichi l’indice di questa pagina, aggiorna anche il blocco "Manuali Operativi" in master_index.php.