Vai al contenuto

Modulo Finance

Stato: ๐Ÿ”„ ~60% completato โ€” focus principale di sviluppo attuale

Panoramica

Gestione finanziaria personale e aziendale. Il modulo gestisce conti, transazioni, carte di credito con plafond, operazioni ricorrenti e multi-valuta.


Conti

Tipologie supportate: - Conti correnti bancari - Carte di credito (con gestione plafond) - Conti risparmio


Transazioni

Stati

PENDING โ†’ COMPLETED โ†’ RECONCILED
                    โ†’ VOID
  • PENDING โ€” transazione inserita, non ancora confermata
  • COMPLETED โ€” transazione completata
  • RECONCILED โ€” riconciliata con estratto conto
  • VOID โ€” annullata

Plafond Carte di Credito (Nexi)

Formula specifica

Questa formula รจ stata costruita sul funzionamento reale delle carte Nexi. Non modificare senza leggere manifest2026/skills/finance/PLAFOND_NEXI.md.

Disponibile = Plafond Totale
            - StatementBalance       (estratto mese precedente, se non ancora addebitato)
            - CurrentSpending        (spese dal giorno di chiusura estratto)
            - ReservedLiquidity      (somma rate residue di tutti i piani rateali attivi)

Rateizzazioni

Situazione Comportamento
Rata 1 del mese corrente Inclusa in "Spese Mese"
Rate 2-N (future) Scalano il plafond disponibile
Chiusura anticipata Plafond si libera immediatamente
Addebito Default il 15 del mese successivo (configurabile)

Multi-Valuta

Il sistema salva sempre tre valori per ogni transazione in valuta estera:

  1. Importo originale โ€” nella valuta originale
  2. Tasso storico โ€” al momento dell'inserimento
  3. Controvalore EUR โ€” calcolato al tasso storico

Fallback tassi fissi (se API esterna offline):

Valuta Tasso fisso
USD 0.95
CHF 1.06

Ref: manifest2026/skills/finance/MULTIVALUTA.md


Operazioni Ricorrenti

Template configurabili per spese e entrate che si ripetono:

  • Frequenza: giornaliera, settimanale, mensile, annuale
  • Scadenza: data fine o numero di ricorrenze
  • Modifica template โ†’ aggiorna tutte le occorrenze future (non quelle passate)

Ref: manifest2026/skills/finance/RECURRING_OPS.md


Annotazione obbligatoria

Tutti i file del modulo Finance portano:

/**
 * @ai-critical
 * @ai-read-before-modify manifest2026/skills/finance/PLAFOND_NEXI.md
 * @ai-test-required finance.service.spec.ts
 */
Prima di modificare qualsiasi file di questo modulo, leggere la documentazione di riferimento.