netgescon-master/docs/02-architettura-laravel/specifiche/Gestione REVISIONE CONTABILE.txt

REVISIONE CONTABILE Vorrei poter gestire i passaggi delle consegne sia in entrata che in uscita perciò vorrei avere la possibilità di poter mettere dentro ii dati della vecchia gestione e poter controllare le registrazioni della vecchia gestione con i dati bancari e con le fatture provenienti dal cassetto fiscale ed integrare le scritture con dell enote e delle scritture particolari per capire se il bilancio è stato fatto in maniera corretta e se le voci e le registrazioni sono state imputate in maniera corretta dalla vecchia amministrazione in questo caso dovrei poter caricare vati tipi di dati provenienti dalla vecchia gestione possono essere in formato excel, txt, pdf se possibile vorrei avere una API per connettermi ad una AI per gestire un primo controllo, le scritture contaabili sempre in partita doppia con la possibilità di gestire sia le entrate degli utenti (rate emesse) che il pagamento e ka gestione delle fatture dei vari soggetti che danno una mano al condominio. sempre il tutto collegato con le altre procedure già sviluppate, dammi una gestione da passare al team di sviluppo in maniera completa in modo da far realizzare le varie procedure 


Modulo Revisione Contabile e Passaggio Consegne
Obiettivi
Consentire l’inserimento e la verifica dei dati della vecchia gestione (entrata/uscita amministratore)
Caricare e integrare dati bancari, fatture (anche da cassetto fiscale), scritture contabili, note e allegati
Gestire la contabilità in partita doppia (entrate/uscite, rate, fatture, pagamenti)
Collegare tutto alle altre procedure (unità, soggetti, fornitori, ticket, ecc.)
Fornire strumenti di controllo, audit e (opzionale) API/AI per verifica automatica

Funzionalità richieste
1. Gestione Dati Vecchia Gestione
Maschera per inserimento dati di partenza (saldo banca, rate emesse/non pagate, crediti/debiti, fondo cassa, ecc.)
Possibilità di caricare file provenienti dalla vecchia gestione:
Excel, TXT, PDF (estratti conto, bilanci, elenco movimenti, ecc.)
Fatture elettroniche XML dal cassetto fiscale
Collegamento automatico/manuale delle voci caricate con le entità del gestionale (unità, soggetti, fornitori, conti)

2. Controllo e Revisione Scritture
Visualizzazione e confronto tra scritture della vecchia gestione e dati caricati (banca, fatture, movimenti)
Possibilità di aggiungere note di revisione e scritture di rettifica (es. errori, voci mancanti, rettifiche di bilancio)
Evidenziazione automatica di incongruenze (es. saldo banca non corrispondente, rate non pagate, fatture non registrate)
Audit log di tutte le modifiche e revisioni

3. Contabilità in partita doppia
Tutte le scritture devono essere gestite in partita doppia (conto dare/avere, importo, data, descrizione, riferimento entità)
Gestione di:
Entrate utenti (rate emesse, pagamenti ricevuti)
Uscite (fatture fornitori, pagamenti, rimborsi)
Scritture di apertura/chiusura gestione
Scritture di rettifica e storicizzazione

4. Integrazione con altri moduli
Collegamento delle scritture a:
Unità immobiliari e soggetti (proprietari/inquilini)
Fornitori e manutentori
Ticket e lavori straordinari
Gestione rate e preventivi
Possibilità di vedere, per ogni entità, la situazione aggiornata anche rispetto ai dati della vecchia gestione

5. Importazione e API/AI
Importazione guidata di dati da Excel, TXT, PDF, XML (mapping colonne, preview, validazione)
API per invio dati a un servizio AI esterno per controllo automatico (es. verifica quadrature, anomalie, suggerimenti)
Visualizzazione dei risultati del controllo AI e possibilità di accettare/rifiutare suggerimenti

6. Allegati e documentazione
Possibilità di allegare documenti di supporto (PDF, Excel, immagini) a ogni scrittura o nota di revisione
Archivio storico di tutti i documenti caricati

7. Report e stampa
Report di revisione (riepilogo scritture, incongruenze, note, allegati)
Stampa/storico del passaggio consegne (con firma digitale opzionale)

Struttura tecnica da implementare
Database
Tabella revisioni_contabili (id, stabile_id, data, amministratore_entrante, amministratore_uscente, stato, note, ecc.)
Tabella scritture_revisione (id, revisione_id, tipo, conto_dare, conto_avere, importo, data, descrizione, riferimento_entita, ecc.)
Tabella allegati_revisione (id, scrittura_id, file_path, tipo, descrizione)
Tabella note_revisione (id, scrittura_id, testo, utente_id, data)
Tabella importazioni_revisione (id, revisione_id, tipo_file, stato, log, ecc.)
Tabella audit_log_revisione (id, revisione_id, azione, utente_id, data, dettaglio)

Backend
Model Eloquent per RevisioneContabile, ScritturaRevisione, AllegatoRevisione, NotaRevisione, ImportazioneRevisione, AuditLogRevisione
CRUD completo per tutte le entità sopra
Servizi per importazione dati (Excel, TXT, PDF, XML)
Servizio per invio dati a API/AI esterna e ricezione risultati
Logica di controllo quadrature e incongruenze

Frontend
Maschera creazione/modifica revisione (dati generali, amministratori, stato)
Maschera gestione scritture (tabella, filtri, ricerca, inserimento/collegamento manuale)
Maschera importazione dati (wizard di mapping colonne, preview, validazione)
Maschera allegati e note
Maschera report revisione e stampa
Visualizzazione risultati AI (se attivata)
Extra
Permessi: solo amministratore/revisore può accedere/modificare
Audit log dettagliato
Collegamento diretto con moduli già esistenti (unità, soggetti, fornitori, ticket, preventivi, rate)
Notifiche per completamento revisione o incongruenze rilevate
Workflow suggerito
Crea revisione (dati generali, amministratori, stabile)
Importa dati (banca, fatture, scritture, allegati)
Collega/valida scritture (manuale o automatica)
Aggiungi note e allegati
(Opzionale) Invia dati a AI per controllo
Visualizza incongruenze e suggerimenti
Completa revisione e genera report/stampa
Archivia revisione e collega alla gestione attiva

Note operative
Prevedere la possibilità di ripetere la revisione in caso di errori/importazioni errate
Tutti i dati devono essere storicizzati e non modificabili dopo la chiusura della revisione
Prevedere la possibilità di esportare tutti i dati e i report in PDF/Excel