F6: finanza completa con prestiti per rating, conto economico e bancarotta #43

Merged
Alby96 merged 3 commits from claude/f6-finanza into main 2026-11-08 13:32:21 +01:00
Owner

Cosa cambia e perché

Completa la finanza della guida §6.3 (ADR 0019, che contiene anche l'analisi di cosa mancava).

Rating

  • Si calcola su 12 mesi chiusi, dal margine e dal rapporto tra debito e patrimonio netto (prima: anno corrente e debito contro attivo).
  • Il punteggio è 0,6 × margine normalizzato più 0,4 × 1/(1 + leva). Il margine resta neutro finché i ricavi non riempiono la finestra.
  • Il motore conserva le misure e il pannello spiega il rating: soglie, prossimo gradino, margine sufficiente, leva massima e debito da rimborsare, solo se la cassa lo permette.

Prestiti

  • Il tasso è fisso all'accensione (base + spread del rating), per evitare la spirale rating → rata → utile.
  • Rimborso anticipato senza penale.
  • Messaggi più chiari e percentuali con la virgola.

Conto economico e costi

  • Nuove voci: personale dei depositi pagato ogni giorno, manutenzione di stazioni e depositi, magazzino, dazi, dividendi ricevuti (ora dentro l'utile).
  • Conto economico per voce degli ultimi 12 mesi e degli ultimi 10 anni chiusi. Ogni colonna somma esattamente all'utile operativo.

Bancarotta

  • Avvisi dopo 3 giorni di cassa negativa, poi a 30, 14, 7, 3 e 1 giorno dal limite della difficoltà; un avviso anche quando la cassa torna positiva.

Protocollo, interfaccia e salvataggi

  • DetailKind.Finance (9) e FinanceReport (135); nuovo pannello delle finanze a tutto schermo.
  • Il pilota automatico salva la schermata 18_finanze.
  • Salvataggio alla versione 7 con migrazione.

Due revisori hanno trovato 11 rilievi, tutti corretti.

Closes #39

Fase

F6

Verifica

  • scripts/build.sh verde
  • scripts/test.sh --skip-slow verde (175 su 175 dopo l'allineamento con main); i lenti AiTests (4 su 4) e Acceptance (2 su 2) sono verdi
  • Client: 0 avvisi, 0 errori
  • docs/STATE.md, ARCHITECTURE.md, PROTOCOL.md aggiornati
  • ADR 0019
  • Nessun numero magico: nuovi parametri in balance.json con schema
  • Schermate e Wiki: arriveranno con il prossimo rilascio, provato con il pilota automatico

🤖 Generated with Claude Code

## Cosa cambia e perché Completa la finanza della guida §6.3 (ADR 0019, che contiene anche l'analisi di cosa mancava). **Rating** - Si calcola su 12 mesi chiusi, dal margine e dal rapporto tra debito e patrimonio netto (prima: anno corrente e debito contro attivo). - Il punteggio è 0,6 × margine normalizzato più 0,4 × 1/(1 + leva). Il margine resta neutro finché i ricavi non riempiono la finestra. - Il motore conserva le misure e il pannello spiega il rating: soglie, prossimo gradino, margine sufficiente, leva massima e debito da rimborsare, solo se la cassa lo permette. **Prestiti** - Il tasso è fisso all'accensione (base + spread del rating), per evitare la spirale rating → rata → utile. - Rimborso anticipato senza penale. - Messaggi più chiari e percentuali con la virgola. **Conto economico e costi** - Nuove voci: personale dei depositi pagato ogni giorno, manutenzione di stazioni e depositi, magazzino, dazi, dividendi ricevuti (ora dentro l'utile). - Conto economico per voce degli ultimi 12 mesi e degli ultimi 10 anni chiusi. Ogni colonna somma esattamente all'utile operativo. **Bancarotta** - Avvisi dopo 3 giorni di cassa negativa, poi a 30, 14, 7, 3 e 1 giorno dal limite della difficoltà; un avviso anche quando la cassa torna positiva. **Protocollo, interfaccia e salvataggi** - `DetailKind.Finance` (9) e `FinanceReport` (135); nuovo pannello delle finanze a tutto schermo. - Il pilota automatico salva la schermata `18_finanze`. - Salvataggio alla versione 7 con migrazione. Due revisori hanno trovato 11 rilievi, tutti corretti. Closes #39 ## Fase F6 ## Verifica - [x] `scripts/build.sh` verde - [x] `scripts/test.sh --skip-slow` verde (175 su 175 dopo l'allineamento con main); i lenti AiTests (4 su 4) e Acceptance (2 su 2) sono verdi - [x] Client: 0 avvisi, 0 errori - [x] `docs/STATE.md`, `ARCHITECTURE.md`, `PROTOCOL.md` aggiornati - [x] ADR 0019 - [x] Nessun numero magico: nuovi parametri in `balance.json` con schema - [ ] Schermate e Wiki: arriveranno con il prossimo rilascio, provato con il pilota automatico 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 added 3 commits 2026-11-08 13:26:42 +01:00
Completa la finanza della guida 6.3 partendo da un'analisi delle lacune
(ADR 0019): prestiti, fido per livello, rate e bancarotta ai giorni di
difficulty.json c'erano già; mancavano gli stipendi delle compagnie, un
rating spiegabile, il conto economico per voce e gli avvisi.

- Prestiti a tasso fisso (base della difficoltà + spread del rating
  all'accensione), per non innescare la spirale rating -> rata -> utile;
  rimborso anticipato parziale e totale con messaggi chiari in italiano.
- Rating mensile da margine (utile/ricavi sugli ultimi 12 mesi chiusi) e
  leva (debiti/patrimonio netto); il motore conserva le misure e
  FinanceOutlook spiega soglie, tassi e cosa serve per salire.
- Voci nuove del registro (stazioni e depositi, magazzini, dazi, dividendi
  incassati) e stipendi del personale presente nei depositi, così il conto
  economico per voce somma esattamente all'utile operativo del motore.
- Mesi e anni chiusi per voce nel salvataggio (versione 7, con migrazione
  e nell'hash); avvisi di cassa negativa alle scadenze fisse prima del
  limite della difficoltà, esito dell'ADR 0012 invariato.
- Protocollo: DetailKind.Finance e FinanceReport; client: pannello
  «Finanze» a tutto schermo con conto economico, rating, prestiti e barra
  della cassa negativa, schermata 18_finanze nel pilota automatico.
- Test in Economy/FinanceTests.cs, round-trip del protocollo e quadro via
  WebSocket; IA e accettazioni F4/F5 invariate.

Refs #39.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Corregge i rilievi della revisione della finanza completa (ADR 0019).

- Rating: il margine resta neutro finché la finestra non è piena e ha meno
  di finance.ratingMinRevenueMonths (3) mesi con ricavi, così il primo
  incasso piccolo dopo mesi di soli costi non fa perdere tre o quattro
  gradini (e non fissa uno spread pessimo per dieci anni); senza ricavi e
  in perdita il margine è il minimo. Corretta l'affermazione dell'ADR.
- Avvisi di cassa negativa dopo finance.negativeCashNoticeDays (3) giorni
  di fila e notizia di rientro solo dopo quel primo avviso: una cassa che
  oscilla intorno a zero non riempie le notizie.
- Spiegazione del rating: se il punteggio vale già il gradino sopra lo dice
  (NextAlreadyMet, ScoreRating) senza obiettivi negativi né leve infinite
  sul filo; il rimborso indicato è segnato come non possibile oggi se
  supera la cassa o il residuo dei prestiti (RepayAffordable).
- Nuovi concorrenti: la quota dei trasporti usa Company.TransportRevenue
  (tariffe, noli, contratti), non dividendi incassati né commercio.
- Client: barra del conto alla rovescia solo con lo scoperto, frasi intere
  con segnaposto in strings.csv, testo distinto per bancarotta e
  amministrazione controllata; ClimbOutlook.LoansAllowed allineato.
- PROTOCOL.md: tabella dei valori di LedgerEntry e campi nuovi di
  FinanceReport; ServerTests non dipende più dal cambio di mese.

Refs #39.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Merge remote-tracking branch 'origin/main' into claude/f6-finanza
CI / Build e test (pull_request) Successful in 1m37s
CI / Immagine Docker (pull_request) Successful in 32s
8b3a9bdb9c
Alby96 merged commit 7eec322202 into main 2026-11-08 13:32:21 +01:00
Alby96 deleted branch claude/f6-finanza 2026-11-08 13:32:23 +01:00
Sign in to join this conversation.