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

165 lines
6.2 KiB
Markdown
Raw Permalink 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: 6 aprile 2026
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.0 Area fornitore/manutentore 2026
- Unificare la rubrica operativa usando la stessa maschera principale condivisa tra amministratore, fornitore e moduli collegati; differenziare accesso e persistenza per ruolo, non l impianto della view.
- Aggiungere una pagina ad hoc per i ticket interni del fornitore con elenco unico di lavorazioni: ticket passati dall amministratore + lavorazioni interne + storico operativo.
- Estendere `fornitore/collaboratori` con gestione orari di lavoro, disponibilita e futura assegnazione lavori ricorrenti.
- Introdurre il dominio lavori ricorrenti/programmati distinto dal ticket occasionale, con contratti durevoli, clienti serviti, frequenze e calendario interventi.
- Separare nella scheda fornitore i blocchi TecnoRepair / seriali e catalogo operativo interno in pagine/tab dedicate.
- Portare avanti catalogo prodotti unificato con vari fornitori, listini acquisto/vendita multipli, seriali, varianti modello/colore, foto, allegati e riferimenti esterni tipo ICECAT.
### 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.