480e7eafbd
📋 Commit iniziale con: - ✅ Documentazione unificata in docs/ - ✅ Codice Laravel in netgescon-laravel/ - ✅ Script automazione in scripts/ - ✅ Configurazione sync rsync - ✅ Struttura organizzata e pulita 🔄 Versione: 2025.07.19-1644 🎯 Sistema pronto per Git distribuito
80 lines
4.0 KiB
Plaintext
80 lines
4.0 KiB
Plaintext
Progetto: Modulo Preventivi Condominiali Automatizzati
|
||
|
||
Obiettivo
|
||
Consentire all’amministratore di:
|
||
|
||
Redigere, presentare e archiviare preventivi in formato lettera (con testo libero e dati anagrafici)
|
||
Gestire le singole voci di spesa in modo strutturato (DB), con importi, percentuali, gestione/anno, tipologia spesa
|
||
Attivare addebiti ricorrenti automatici sulle unità immobiliari in base alle voci approvate
|
||
Gestire lavori extra, rimborsi, rivalutazioni ISTAT e storicizzare tutte le variazioni
|
||
Collegare il preventivo alla gestione contabile annuale
|
||
|
||
Funzionalità richieste
|
||
1. Gestione Testo Preventivo
|
||
Editor WYSIWYG per la parte descrittiva (testo libero, formattazione, dati anagrafici amministratore e condominio)
|
||
Possibilità di inserire dati variabili (es. nome condominio, indirizzo, amministratore, data, ecc.)
|
||
|
||
2. Gestione Voci Preventivo
|
||
Tabella DB preventivi (id, condominio_id, anno, stato, testo_lettera, data_presentazione, ecc.)
|
||
Tabella DB voci_preventivo (id, preventivo_id, descrizione, importo, percentuale, gestione, tipologia, addebito_ricorrente, rivalutazione_istat, ecc.)
|
||
Interfaccia per aggiungere/modificare/eliminare voci (con importo, percentuale, gestione di riferimento, tipologia: ordinaria, riscaldamento, straordinaria, acqua, ecc.)
|
||
Possibilità di importare voci da preventivi precedenti o da template
|
||
|
||
3. Addebiti Ricorrenti e Lavori Extra
|
||
Flag per ogni voce: “addebito ricorrente” (mensile, trimestrale, annuale, personalizzato)
|
||
Gestione lavori extra: aggiunta voci straordinarie in corso d’anno, con storicizzazione e collegamento alla gestione
|
||
Calcolo automatico degli addebiti sulle unità immobiliari in base a millesimi/tabella di ripartizione
|
||
|
||
4. Rivalutazione ISTAT
|
||
Gestione percentuale di rivalutazione ISTAT per le voci che lo prevedono
|
||
Calcolo automatico degli importi aggiornati a inizio anno o su richiesta
|
||
|
||
5. Workflow e Stati
|
||
Stati preventivo: bozza, presentato, approvato, attivo, archiviato
|
||
Solo i preventivi “approvati” possono generare addebiti ricorrenti
|
||
|
||
6. Integrazione con la contabilità
|
||
Collegamento tra voci di preventivo e piano dei conti condominiale
|
||
Generazione automatica delle scritture di addebito in prima nota/contabilità (partita doppia)
|
||
Gestione storica delle variazioni e delle rivalutazioni
|
||
|
||
7. Stampa e presentazione
|
||
Generazione PDF del preventivo in formato lettera (come da esempio)
|
||
Possibilità di invio via email/PEC ai condomini
|
||
|
||
Cosa preparare
|
||
Database
|
||
Migrazione per tabelle preventivi e voci_preventivo (vedi sopra)
|
||
Eventuali tabelle di supporto: tipologie spesa, gestioni, template voci, storicizzazione variazioni
|
||
|
||
Backend
|
||
Model Eloquent per Preventivo e VocePreventivo
|
||
CRUD completo per preventivi e voci (con validazione)
|
||
Servizi per generazione addebiti ricorrenti e rivalutazione ISTAT
|
||
Logica per storicizzazione modifiche e lavori extra
|
||
|
||
Frontend
|
||
Maschera editor preventivo (testo lettera + tabella voci)
|
||
Tabella voci con aggiunta/modifica/eliminazione, importo, percentuale, gestione, tipologia, flag ricorrenza, rivalutazione
|
||
Sezione per lavori extra e storicizzazione
|
||
Pulsante per generazione PDF e invio email
|
||
|
||
Automazione
|
||
Job schedulato per generare addebiti ricorrenti sulle unità immobiliari
|
||
Funzione per applicare rivalutazione ISTAT alle voci selezionate
|
||
|
||
Extra
|
||
Permessi: solo amministratore può creare/modificare preventivi
|
||
Audit log per tutte le modifiche
|
||
Collegamento con la gestione annuale e la contabilità
|
||
Esempio struttura DB semplificata
|
||
Tabella preventivi: | id | condominio_id | anno | stato | testo_lettera | data_presentazione | ... |
|
||
|
||
Tabella voci_preventivo: | id | preventivo_id | descrizione | importo | percentuale | gestione | tipologia | addebito_ricorrente | rivalutazione_istat | ... |
|
||
|
||
Note
|
||
Il testo della lettera deve essere personalizzabile e stampabile in PDF ed esportabile in Word.
|
||
Le voci devono essere gestite in modo strutturato e collegabili a contabilità e gestioni.
|
||
Gli addebiti ricorrenti e le rivalutazioni devono essere automatizzabili.
|
||
Tutto deve essere tracciato e storicizzato.
|