🤖 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
