F3 · Conti e ordini nell'interfaccia BrokerAdapter e simulatore interno (PaperBroker) #26

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

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

Obiettivo

L'interfaccia comune e il simulatore prudente sempre disponibile.

Passi

  • Metodi di conto, posizioni, ordini, esecuzioni, movimenti di cassa, azioni societarie di BrokerAdapter
  • PaperBroker su prezzi dal vivo: scostamento per fascia di liquidità, limite eseguito solo se attraversato, ritardo 300–1.000 ms, commissioni di listino e in natura, dividendi
  • Ripercorso delle barre a 1 minuto dopo un'assenza; acquisti in attesa annullati
  • Rifiuto di un ambiente reale senza ANUBIS_ALLOW_LIVE=1 / allow_live = true, con test per Docker e desktop

Criteri di accettazione della fase a cui contribuisce

  • Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop

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` §5.3, 7.1, 7.3 ### Obiettivo L'interfaccia comune e il simulatore prudente sempre disponibile. ### Passi - [ ] Metodi di conto, posizioni, ordini, esecuzioni, movimenti di cassa, azioni societarie di `BrokerAdapter` - [ ] `PaperBroker` su prezzi dal vivo: scostamento per fascia di liquidità, limite eseguito solo se attraversato, ritardo 300–1.000 ms, commissioni di listino e in natura, dividendi - [ ] Ripercorso delle barre a 1 minuto dopo un'assenza; acquisti in attesa annullati - [ ] Rifiuto di un ambiente reale senza `ANUBIS_ALLOW_LIVE=1` / `allow_live = true`, con test per Docker e desktop ### Criteri di accettazione della fase a cui contribuisce - Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop --- 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:54:50 +01:00
Alby96 added the Kind/Feature
Priority
Critical
1
Area/Broker e ordini
labels 2026-11-09 11:54:50 +01:00
Author
Owner

Fatto (commit 1419457, d2441df; correzioni della revisione in 1a0912e).

  • IBrokerAccount copre conto, posizioni, ordini, esecuzioni, movimenti di cassa e permessi della chiave. Le azioni societarie arrivano dai dati della Fase 2 e il registro le applica (DividendsAndSplitsReachTheLedgersOnce). Scelta nell'ADR 0009, punto 1.
  • PaperBroker lavora sui prezzi dal vivo e fa queste cose:
    • scostamento per fascia di liquidità;
    • un limite si esegue solo se il prezzo lo attraversa;
    • ritardo tra 300 e 1.000 ms;
    • commissioni di listino, trattenute nella moneta comprata come fa OKX;
    • dividendi.
  • Dopo un'assenza ripercorre le barre a 1 minuto per stop e vendite e annulla gli acquisti in attesa. Test in PaperBrokerTests.
  • Dopo la revisione, frazionamenti e dividendi toccano il libro del simulatore una volta sola e solo per le azioni tenute prima della data di stacco.
  • Senza il consenso della configurazione d'avvio l'ambiente reale è rifiutato, in Docker e su desktop:
    • RealAccountsAreRefusedWithoutTheStartupConsent;
    • BrokerAdaptersRefuseARealAccountBeforeAnyRequest, che verifica anche che non parta nessuna richiesta.
  • La stessa batteria di conformità passa sul simulatore (PaperBrokerConformance).
Fatto (commit 1419457, d2441df; correzioni della revisione in 1a0912e). - `IBrokerAccount` copre conto, posizioni, ordini, esecuzioni, movimenti di cassa e permessi della chiave. Le azioni societarie arrivano dai dati della Fase 2 e il registro le applica (`DividendsAndSplitsReachTheLedgersOnce`). Scelta nell'ADR 0009, punto 1. - `PaperBroker` lavora sui prezzi dal vivo e fa queste cose: - scostamento per fascia di liquidità; - un limite si esegue solo se il prezzo lo attraversa; - ritardo tra 300 e 1.000 ms; - commissioni di listino, trattenute nella moneta comprata come fa OKX; - dividendi. - Dopo un'assenza ripercorre le barre a 1 minuto per stop e vendite e annulla gli acquisti in attesa. Test in `PaperBrokerTests`. - Dopo la revisione, frazionamenti e dividendi toccano il libro del simulatore una volta sola e solo per le azioni tenute prima della data di stacco. - Senza il consenso della configurazione d'avvio l'ambiente reale è rifiutato, in Docker e su desktop: - `RealAccountsAreRefusedWithoutTheStartupConsent`; - `BrokerAdaptersRefuseARealAccountBeforeAnyRequest`, che verifica anche che non parta nessuna richiesta. - La stessa batteria di conformità passa sul simulatore (`PaperBrokerConformance`).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#26