๐ค Agenti AI โ Leggi questo file PER PRIMO
Il Master Index รจ il punto di ingresso per trovare rapidamente dove sono le istruzioni. Consultalo all'inizio di ogni task per essere indirizzato al file corretto senza leggere l'intera applicazione.
โ ๏ธ Regola sync: Se modifichi l'Indice Navigazione Rapida di cantieri, manuali, amministrazione o app index โ aggiorna questo Master Index di conseguenza.
CMS SQLite (pagine dinamiche): Istruzioni operative per creazione contenuti, tabella contents, router page.php e protocollo ยซsolo INSERT nel DB, niente nuovi .phpยป โ app/index.php#cms-sqlite.
ATTENZIONE: Dal 02/03/2026, la gestione Marketing e Target รจ spostata ufficialmente nella macro-area CRM. Ignorare eventuali vecchi riferimenti in Amministrazione.
Progetto: Magenta Manager - Sistema Gestione Cantieri | Versione: 2.0
๐ Punti di Ingresso
| Area |
Punto di ingresso |
| Protocollo sicurezza cantieri, Divieto Ipotesi, Note Silos (tag cantiere) |
โ cantieri/index.php |
| Calcolo Prezzari, Margini (SG/UI), Storico rese, Spese generali |
โ amministrazione/index.php |
API Note, Regex, Git Sync, tracciamento accessi, Mappatura dipendenze, CMS SQLite (page.php root + config/db_config.php, dettaglio #cms-sqlite) |
โ app/index.php |
| CRM (macro-area): index, 0-anagrafica, 1-target, 2-lead, 3-prospect, 4-opportunity, piano marketing |
โ crm/index.php |
| Manuali operativi (tetto legno, demolizioni) |
โ manuali_operativi/index.php |
๐ Indici โ Navigazione Rapida
Contenuti trattati in ogni sezione. Per istruzioni operative โ vedi il file index indicato.
๐๏ธ Cantieri โ Navigazione Rapida
(Vedi cantieri/index.php per istruzioni operative)
- Protocollo Sicurezza e "No Assumptions"
- Gestione Note Silos (Tag [CANTIERE])
- Diario, Programma, Consuntivo, Rese di Posa
- Analisi Fattibilitร Consegna
- Isolamento Cantiere Demo
- Struttura Standard 8 file + cache
- Cantieri completati (spostamento da in_esecuzione)
- SOP-01, Logica Meteo, Alert Telegram
- Riferimento incrociato CMS SQLite (pagine dinamiche
page.php, non cantieri) โ app/index.php#cms-sqlite
๐ Manuali Operativi โ Navigazione Rapida
(Vedi manuali_operativi/index.php per istruzioni operative)
- Struttura Standard a 5 Capitoli
- Convenzioni File e Directory
- Creazione e Modifica Manuali
- Manuale Tetto Legno
- Manuale Demolizioni e Strip-Out
- Note dal campo (chiusura cantieri โ estrazione criticitร per manuali)
- Riferimenti Incrociati (Prezzario, Cantieri)
- Voce indice ยซCMS dinamico (SQLite)ยป โ app/index.php#cms-sqlite
๐ Amministrazione โ Navigazione Rapida
(Vedi amministrazione/index.php per istruzioni operative)
- Prezziari 2025 (struttura, cache, ricerca globale)
- Chat AI Prezziari (Protocollo RAG + Doc tecnica completa)
- Storico Rese e Costo Orario
- Storico Rese, Spese Generali e Prezzario (export PDF client-side DataTables per storico_rese e prezzario, A3 landscape, font 8/9pt)
- Margini SG/UI e Regole di Calcolo
- Protocolli Costo, Prezzario, Lavori in Economia
- Istruzioni AI: link a documentazione CMS SQLite in app/index.php#cms-sqlite
๐ค CRM โ Navigazione Rapida
(Vedi crm/index.php per istruzioni operative)
crm/index.php (dashboard CRM; nota CMS SQLite โ CRM โ app/index.php#cms-sqlite)
crm/anagrafica.php (0 - Anagrafica Aziende)
crm/piano_di_marketing.php (Piano di Marketing Strategico 2026)
crm/target.php (1 - Target)
crm/lead.php (2 - Lead)
crm/prospect.php (3 - Prospect)
crm/opportunity.php (4 - Opportunity)
app/config/crm_anagrafica.json (anagrafica centrale)
- Auto-sync da produzione: commit automatici su JSON (anagrafica, target_list, users, accessi_stats) senza modifiche PHP; dopo pull massivo verificare conteggio
aziende e ID 1 (dettaglio in crm/index.php)
- Export PDF anagrafica: client-side (DataTables pdfHtml5, A3 landscape, font 8/9pt); altre pagine: server-side app/export/*.php; export_crm_anagrafica_pdf.php non referenziato
- Schema anagrafica: piva (P.IVA), email_inviata (๐ฉ, data YYYY-MM-DD o null); colonna ๐ฉ nelle tabelle read-only (testo DD/MM/YYYY o "โ"), modifica solo via modal Modifica in anagrafica.php; localita, percorrenza_min (INT nullable), fonte; telefono rimosso (03/2026); import CSV; DataTables indici Stato Funnel 8/11, pageLength 10; Event Delegation su tbody; Elimina credenziali (target_list, non anagrafica); Bootstrap Icons per icona external-link colonna Sito Web (header.php); Template email Target: ๐ค Nome utente / ๐ Password su righe distinte, frase riscontro "breve chiamata conoscitiva", placeholder demo/z82bj7ok, regex in preparaMail; ordine bullet competenze (C.A. strutturale โ tetti legno โ strip-out); paragrafo credibilitร B2B prima del box demo (dettaglio in crm/index.php)
๐ป App โ Navigazione Rapida
(Vedi app/index.php per istruzioni operative)
- Notifiche Telegram
- Sistema Ricerca Globale
- Sistemi Export PDF: pagina Dompdf, tabellare client-side DataTables, tabellare server-side CRM; export globale homepage (Tree Explorer + 5 manuali AI: amministrazione, cantieri, manuali_operativi, app, crm)
- Groq AI e Note Silos (API, Regex, Git Sync)
- CMS dinamico SQLite:
page.php (bootstrap prima di db_config), config/db_config.php con defined() su costanti, tabella contents in db/system_data.db; cliente non in whitelist su page.php; nuove pagine via INSERT e modifica contenuti/titolo per Admin via modal WYSIWYG Trumbowyg + API app/api/cms_update_page.php (payload slug,title,content, dettaglio in app/index.php#cms-sqlite)
- Sync Git, tracciamento accessi demo; Protocollo V2.2 Full Automator (prompts.csv): pull verifica
crm_anagrafica.json (conteggio aziende, ID 1 Frigerio Legnami), Analisi e Documentazione Intelligente โ aggiornamento index.php e master_index; deploy SSH produzione (git fetch + reset --hard origin/main in ~/public_html) autonomo; cartella db/ e regole .gitignore SQLite (dettaglio in app/index.php#sync-git-accessi)
- STOP OPERATIVO (vincolo sicurezza): รจ proibito all'AI eseguire Git Add/Commit/Push/Reset e Deploy SSH verso Namecheap di propria iniziativa. Queste azioni sono consentite solo con richiesta esplicita contenente la frase
Esegui Protocollo di Allineamento Finale (dettaglio in app/index.php#regole-agenti e app/index.php#git).
- Autenticazione, Sicurezza e Ruoli
- Gestione utenti, Mappatura Dipendenze, app/temp