netgescon-day0/docs/00-TODO-COPILOT-TRACKER.md

136 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# NetGescon — TODO Copilot Tracker
Data aggiornamento: 15 dicembre 2025
Questo file tiene traccia di:
- cosa è stato fatto (implementato e/o corretto)
- cosa resta da fare
- priorità e dipendenze
---
## 1) Fatto (stato attuale)
### UX / Filament (navigazione “web-like”)
- Breadcrumbs compatibili Filament: wrapper view per `<x-filament.components.page-breadcrumbs>`.
- Pagine Filament con back/breadcrumb coerenti (dove già applicato).
### Anagrafica
- `Persona`: gestione multi-ruolo via JSON `persone.ruoli` + UI di editing in Filament.
### Contabilità — base
- Tabelle contabilità e migrazioni sbloccate (incl. `contabilita_regole_prima_nota`, movimenti banca).
- Import movimenti banca UniCredit `.wri` con dedup (`row_hash`).
- Azione Filament su movimenti banca per generare registrazione/movimenti contabili da regole prima nota (scaffold funzionante).
### Fatture ricevute XML (FatturaPA)
- Archivio + scheda Filament per fatture ricevute XML.
- Import multiplo XML con dedup (hash + chiave logica) e persistenza su `fatture_elettroniche`.
### Scheda Stabile (riabilitata)
- Ripristinato accesso dalla Filament “Cruscotto stabile” alla scheda stabile completa (UI classica) con:
- Dati stabile
- Banche/dati finanziari
- Palazzine
- Locali tecnici
- Gestione documentale
- Aggiunto deep-link `?tab=...` sulla scheda stabile UI classica per aprire direttamente una tab specifica.
### “Vista Excel” (riabilitata)
- Ripristinato accesso immediato dalla Filament “Cruscotto stabile” alla tab “Tabelle millesimali” (UI classica) tramite deep-link.
- Esiste anche la Filament “Tabelle millesimali · Prospetto” che è già una vista tabellare/Excel-like.
### Nuovo lavoro già avviato (base dati + UI)
- Nuove tabelle per “fatture fornitori” (testata + righe, importi `_euro`, ritenuta, tab pagamento).
- Prime pagine Filament:
- Archivio fatture fornitori
- Scheda registrazione (tabs + pannello azioni a destra)
---
## 2) In corso (priorità alta)
### A) Riallineare le “Gestioni” per la contabilità
Obiettivo: avere gestione ordinaria/riscaldamento/straordinaria *coerenti* e selezionabili per stabile, perché la contabilità deve agganciarsi a:
- anno gestione / esercizio
- tipo gestione
- conti/casse/banca
- registrazioni/movimenti
Output atteso:
- schermate Filament “Gestione ordinaria / riscaldamento / straordinaria” che leggono e usano la gestione attiva (non solo lo stabile attivo)
- link e contesti coerenti tra: Prima Nota, Casse e banche, Fatture, Movimenti banca
Dipendenze:
- definire/standardizzare “gestione attiva” (session/key, o tabella/relazione)
---
## 3) Da fare (funzionalità richieste, in ordine consigliato)
### 3.1 Contabilità — fatture fornitori “alla Gescon”
- Rendere la maschera fattura fornitore più fedele allo screenshot (nomi/ordine tab + colonna azioni).
- Aggancio/creazione fornitore (contabilità + anagrafica unica/rubrica) direttamente dalla maschera.
- Contabilizzazione:
- DARE: costi delle righe imputate (conti/voci/tabelle)
- AVERE: fornitore per netto
- RA (ritenuta) come debito separato da versare
### 3.2 Ritenute dacconto + F24
- Gestione codici tributo: 1019/1020 e 1040.
- Regole:
- RA si versa con F24 entro il 16 del mese successivo al pagamento.
- Output minimo:
- calcolo RA per fattura
- generazione scadenza/partita di versamento
- (fase successiva) aggregazione per mese/tributo e stampa/distinta
### 3.3 Import MDB (GESCON) → contabilità operativa
- Predisporre import da `singolo_stabile.MDB` e `generale_stabile.mdb`:
- operazioni/fatture/fornitori
- rispettare sempre i campi `*_euro`
- Mapping verso:
- fatture fornitori (testata+righe)
- registrazioni contabili (prima nota)
- collegamenti a tabelle millesimali/voci spesa
### 3.4 XML multiplo → passaggio in contabilità
- Oggi: import XML alimenta archivio `fatture_elettroniche`.
- Da fare:
- creazione/aggancio fornitore automatico (rubrica + fornitore)
- azione/flow “porta in contabilità” → crea fattura fornitore + righe + prima nota
---
## 4) Parti discusse ma non ancora implementate (da non perdere)
### Ticket
- Esiste base legacy (controller/CRUD e categorie ticket). Da definire:
- UI Filament per ticket (lista, scheda, stati, priorità)
- permessi/ruoli
- collegamento ticket ↔ stabile ↔ documenti
### Gestione documentale
- Esiste sistema “Documenti collegati” (con rotte e API statistiche/scadenze). Da definire:
- UI Filament per documenti del condominio
- workflow scadenze/rinnovi
- permessi e visibilità per ruolo
### Protocollo documentazione
- Da definire:
- numerazione protocolli per stabile/anno
- registrazione (data, mittente/destinatario, oggetto)
- collegamento a documenti/pec
### Consumi / acqua / contatori
- Backend (tabelle contatori/letture/algoritmi) esiste.
- UI Filament non ancora esposta: oggi la gestione è in view legacy.
---
## 5) Note operative / rischi
- Coesistenza Filament + UI classica: va mantenuta, ma i punti chiave devono essere raggiungibili dal “Cruscotto stabile”.
- “Gestione attiva” è il nodo per rendere contabilità consistente (oltre a “stabile attivo”).
- Import MDB richiede mapping rigoroso (soprattutto `_euro`) per evitare contabilità sbilanciata.