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

6.2 KiB
Raw Blame History

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.