F3 · Ambienti, capitale affidato e contabilità: registro, lotti, patrimonio, rendimento corretto #29

Closed
opened 2026-11-09 11:55:20 +01:00 by Alby96 · 1 comment
Owner

Fase 3 — Conti, ordini, contabilità · Specifica: docs/SPEC.md §7.1, 7.5, 16

Obiettivo

Il patrimonio del bot si ricostruisce per intero dai movimenti registrati.

Passi

  • Registro separato per ogni coppia strategia-ambiente; capitale affidato per broker e quote
  • Proprietà delle posizioni: solo ciò che il bot ha aperto
  • Registro di sola aggiunta con storni; lotti con prezzo medio e LIFO configurabile per il fisco
  • Operazione da zero a zero; patrimonio fotografato ogni 5 minuti e a ogni esecuzione
  • Rendimento time-weighted corretto per versamenti, cambi di quota e di stadio; dividendi; effetto cambio
  • Test di proprietà (generatore a seme fisso): liquidità + posizioni = patrimonio, nessuna quantità negativa

Criteri di accettazione della fase a cui contribuisce

  • I test di proprietà contabili passano

Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di docs/SVILUPPO.md.

**Fase 3 — Conti, ordini, contabilità** · Specifica: `docs/SPEC.md` §7.1, 7.5, 16 ### Obiettivo Il patrimonio del bot si ricostruisce per intero dai movimenti registrati. ### Passi - [ ] Registro separato per ogni coppia strategia-ambiente; capitale affidato per broker e quote - [ ] Proprietà delle posizioni: solo ciò che il bot ha aperto - [ ] Registro di sola aggiunta con storni; lotti con prezzo medio e LIFO configurabile per il fisco - [ ] Operazione da zero a zero; patrimonio fotografato ogni 5 minuti e a ogni esecuzione - [ ] Rendimento time-weighted corretto per versamenti, cambi di quota e di stadio; dividendi; effetto cambio - [ ] Test di proprietà (generatore a seme fisso): liquidità + posizioni = patrimonio, nessuna quantità negativa ### Criteri di accettazione della fase a cui contribuisce - I test di proprietà contabili passano --- Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di `docs/SVILUPPO.md`.
Alby96 added this to the Fase 3 — Conti, ordini, contabilità milestone 2026-11-09 11:55:20 +01:00
Alby96 added the Kind/Feature
Priority
Critical
1
Area/Broker e ordini
labels 2026-11-09 11:55:20 +01:00
Author
Owner

Fatto (commit 1419457, 4c4f848, 1a0912e).

  • C'è un registro per ogni strategia e ambiente. Il capitale si affida in euro per broker e si divide secondo le quote. Alpaca lo converte al cambio BCE del giorno.
  • Il bot considera sue solo le posizioni nate dai suoi ordini.
  • Il registro è di sola aggiunta, con storni. Un test cerca UPDATE e DELETE su fills, lots e cash_ledger in tutto il codice.
  • I lotti hanno il prezzo medio; il metodo fiscale è LIFO di base ed è configurabile.
  • Un'operazione va da zero a zero (BuyAndSellMakeATradeFromZeroToZeroWithFeesAndResult).
  • Il patrimonio si fotografa ogni 5 minuti e dopo ogni gruppo di esecuzioni, separato per mondo (EquityPhotographsSeparateWorldsAndCorrectForCapitalChanges). Prima di ogni fotografia le posizioni prendono il prezzo di mercato.
  • Per Alpaca, cambiando il capitale si converte solo la differenza in euro: un movimento del cambio non diventa un versamento.
  • Il rendimento è ponderato nel tempo e tiene conto di versamenti e cambi di quota (TimeWeightedReturnIgnoresDepositsAndWithdrawals). Ci sono anche i dividendi e l'effetto cambio a parte.
  • Test di proprietà a seme fisso: RandomFillsNeverBreakTheBooks. Liquidità più posizioni fa sempre il patrimonio e nessuna quantità diventa negativa.
Fatto (commit 1419457, 4c4f848, 1a0912e). - C'è un registro per ogni strategia e ambiente. Il capitale si affida in euro per broker e si divide secondo le quote. Alpaca lo converte al cambio BCE del giorno. - Il bot considera sue solo le posizioni nate dai suoi ordini. - Il registro è di sola aggiunta, con storni. Un test cerca `UPDATE` e `DELETE` su `fills`, `lots` e `cash_ledger` in tutto il codice. - I lotti hanno il prezzo medio; il metodo fiscale è LIFO di base ed è configurabile. - Un'operazione va da zero a zero (`BuyAndSellMakeATradeFromZeroToZeroWithFeesAndResult`). - Il patrimonio si fotografa ogni 5 minuti e dopo ogni gruppo di esecuzioni, separato per mondo (`EquityPhotographsSeparateWorldsAndCorrectForCapitalChanges`). Prima di ogni fotografia le posizioni prendono il prezzo di mercato. - Per Alpaca, cambiando il capitale si converte solo la differenza in euro: un movimento del cambio non diventa un versamento. - Il rendimento è ponderato nel tempo e tiene conto di versamenti e cambi di quota (`TimeWeightedReturnIgnoresDepositsAndWithdrawals`). Ci sono anche i dividendi e l'effetto cambio a parte. - Test di proprietà a seme fisso: `RandomFillsNeverBreakTheBooks`. Liquidità più posizioni fa sempre il patrimonio e nessuna quantità diventa negativa.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#29