Aggiungi gestione note spese

[sajotrei]

Motivazione

Risolve #1461 introducendo un registro semplice delle spese/costi senza fattura, integrato con le logiche native di OpenSTAManager.

Funzionalità

• inserimento manuale delle spese;
• tipologie configurabili e traducibili;
• stati Da verificare, Confermata, Esclusa;
• associazione opzionale a operatore/tecnico;
• allegati tramite il sistema nativo OSM;
• duplicazione singola e massiva;
• modifica rapida di data, descrizione, controparte e importo;
• ritorno automatico a Da verificare dopo modifiche sostanziali di una spesa confermata;
• import selettivo dei rifornimenti da Automezzi;
• import delle scadenze generiche a debito da Scadenzario;
• import rapido da dati incollati da foglio elettronico;
• controllo dei possibili duplicati;
• widget per confermate, da verificare e senza allegati;
• notifica delle spese ancora disponibili per l'importazione;
• stampa PDF e CSV basati sul periodo globale selezionato in OSM.

Solo le spese Confermate entrano nella stampa, nel CSV e nei totali di controllo.

Scelte tecniche

• il modulo è un registro extra-contabile: non genera automaticamente movimenti di Prima nota o altre scritture contabili;
• le nuove tabelle e la registrazione dei moduli sono inserite nella migration MINOR update/2_12.sql;
• le nuove tabelle sono registrate anche in update/tables.php;
• tutte le foreign key hanno nomi espliciti secondo le convenzioni del progetto;
• l'integrazione con Automezzi e Scadenzario rispetta i permessi dei moduli sorgente;
• origine + id_origine impediscono la reimportazione della stessa registrazione sorgente.

Test e verifiche

• controllo sintassi PHP eseguito sui file della versione sviluppata;
• verifiche statiche su migration, foreign key, viste, permessi, somma nativa e integrazioni sorgente;
• la versione standalone da cui deriva la proposta è stata collaudata su installazione reale OpenSTAManager 2.10.4 per inserimento/modifica, duplicazione, azioni di gruppo, operatori, allegati, import Automezzi/Scadenzario, widget, stampa, CSV e notifiche;
• prima della PR il codice è stato riallineato al master corrente e alla struttura DB attuale, incluso l'uso di co_scadenzario.

La migration 2.12 non è stata eseguita in questo ambiente contro un database completo del ramo master; la PR viene quindi aperta come Draft per consentire revisione e test d'integrazione sul ramo di sviluppo corrente.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.