F3 · Chiusura della fase 3: criteri di accettazione, revisione e tag #33

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

Fase 3 — Conti, ordini, contabilità · Sezioni da leggere: 4.1, 4.2, 5.3, 6, 7, 13.1–13.6 (più 2, 16, 19 e ADR 0003)

Obiettivo della fase

Ordini sicuri e ogni euro tracciato.

Criteri di accettazione

Ognuno si spunta solo con la prova mostrata (comando e risultato). Un criterio che dipende solo dall'utente si segna "in attesa dell'utente" (SPEC §2.3).

  • I test di proprietà contabili passano
  • La batteria di conformità passa sul simulatore e, se le chiavi demo ci sono, sui due conti di prova (altrimenti su risposte d'esempio, criterio in attesa dell'utente)
  • I test con guasti di questa parte passano
  • Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop
  • La schermata Conti e posizioni corrisponde al mockup

Chiusura

  • Tutte le altre issue della milestone chiuse o motivate
  • tasks check passa; build dell'immagine Docker riuscita; fotografie di Edge confrontate con i mockup dove ci sono schermate; nessun pacchetto fuori dall'ADR 0004
  • Revisione con un subagent a contesto pulito (messaggio "Revisione indipendente" dell'appendice A), difetti reali corretti
  • docs/ROADMAP.md e docs/STATE.md aggiornati
  • Commit e tag fase-3
  • Riepilogo di fine fase (formato dell'appendice B) come commento a questa issue

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à** · Sezioni da leggere: 4.1, 4.2, 5.3, 6, 7, 13.1–13.6 (più 2, 16, 19 e ADR 0003) ### Obiettivo della fase Ordini sicuri e ogni euro tracciato. ### Criteri di accettazione Ognuno si spunta solo con la prova mostrata (comando e risultato). Un criterio che dipende solo dall'utente si segna "in attesa dell'utente" (SPEC §2.3). - [ ] I test di proprietà contabili passano - [ ] La batteria di conformità passa sul simulatore e, se le chiavi demo ci sono, sui due conti di prova (altrimenti su risposte d'esempio, criterio in attesa dell'utente) - [ ] I test con guasti di questa parte passano - [ ] Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop - [ ] La schermata Conti e posizioni corrisponde al mockup ### Chiusura - [ ] Tutte le altre issue della milestone chiuse o motivate - [ ] `tasks check` passa; build dell'immagine Docker riuscita; fotografie di Edge confrontate con i mockup dove ci sono schermate; nessun pacchetto fuori dall'ADR 0004 - [ ] Revisione con un subagent a contesto pulito (messaggio "Revisione indipendente" dell'appendice A), difetti reali corretti - [ ] `docs/ROADMAP.md` e `docs/STATE.md` aggiornati - [ ] Commit e tag `fase-3` - [ ] Riepilogo di fine fase (formato dell'appendice B) come commento a questa issue --- 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:55 +01:00
Alby96 added the
Priority
High
2
Kind/Chiusura fase
labels 2026-11-09 11:55:55 +01:00
Author
Owner
Fase 3 — Conti, ordini, contabilità: COMPLETATA (un criterio in attesa dell'utente)

Criteri di accettazione

  • Test di proprietà contabili — verificato. RandomFillsNeverBreakTheBooks usa esecuzioni casuali a seme fisso. Registro, lotti e liquidità restano sempre in pari: liquidità più posizioni fa il patrimonio e nessuna quantità diventa negativa.
  • Batteria di conformità dei broker
    • Simulatore: verificato (PaperBrokerConformance).
    • Risposte d'esempio della documentazione: verificato (AlpacaDocConformance, OkxDocConformance).
    • Conti di prova Alpaca paper e OKX demo: in attesa dell'utente. Servono le chiavi. I test sono già pronti: AlpacaPaperConformance e OkxDemoConformance, categoria LiveDemo.
  • Test con guasti — verificato su SQLite e PostgreSQL (OrderManagerTests, ReconcilerTests). Coprono:
    • una risposta persa a metà ordine, mai rimandata;
    • le esecuzioni doppie;
    • un broker che non risponde;
    • uno stop scattato senza avviso;
    • le differenze non spiegate.
  • Nessun conto reale senza consenso — verificato, in Docker e su desktop:
    • RealAccountsAreRefusedWithoutTheStartupConsent;
    • BrokerAdaptersRefuseARealAccountBeforeAnyRequest, che controlla anche che non parta nessuna richiesta.
  • Schermata Conti e posizioni come il mockup — verificato. TheDemoShowsTheFiguresOfTheMockup controlla i numeri nella modalità dimostrativa. Le fotografie sono a 1440 px (chiaro e scuro) e a 390 px. Unica differenza: un centesimo su una riga di XOM, che viene dall'arrotondamento del mockup stesso.

Chiusura

  • Le issue da #26 a #33 hanno le loro prove e si chiudono con la PR #89.
  • tasks check passa e l'immagine Docker si costruisce. Le run CI 189 e 190 sono verdi su SQLite e su PostgreSQL. Nessun pacchetto è fuori dall'ADR 0004.
  • Revisione indipendente fatta: 11 difetti trovati e corretti (commit 1a0912e). I principali:
    • un frazionamento moltiplica solo le azioni tenute prima della data di stacco;
    • un dividendo non si paga due volte se qualcosa si interrompe a metà;
    • le posizioni prendono il prezzo di mercato prima di ogni fotografia del patrimonio;
    • un'esecuzione in errore non blocca più le altre né gli stop;
    • senza prezzo, una vendita aspetta con gli stop ancora sul broker;
    • una vendita rifiutata si riprova con pause crescenti;
    • su OKX solo la risposta 51603 vale "ordine sconosciuto";
    • "allinea", "escludi" e "togli le chiavi" chiedono il token antifalsificazione;
    • cambiando il capitale, per Alpaca si converte solo la differenza in euro.
  • Il passo di prezzo di Alpaca (2 decimali da 1 $ in su, 4 sotto) e i decimali del CSV sono corretti nel commit 60d5ebb.
  • Un problema di tempi visto solo sulla CI è corretto nel commit 16be51e: un test perdeva la connessione a PostgreSQL mentre creava il suo database appena partito il servizio.
  • docs/ROADMAP.md, docs/STATE.md e docs/API-NOTES.md sono aggiornati. Tag fase-3 sul commit di unione (6d3ef8e).

Decisioni prese: ADR 0009 (scelte della Fase 3).

Scostamenti dalla specifica

  • Il flusso dal vivo delle azioni (IEX) passa alla Fase 6. Senza chiavi Alpaca non ci sono posizioni azionarie da seguire, e lo stop sta comunque sul broker.
  • Chiavi e capitale non entrano nella procedura del primo avvio, che resta corta e funziona senza chiavi. Si inseriscono da Impostazioni → Conti e chiavi, e la Panoramica lo indica come primo passo.
  • Il filtro sullo spread (O7) passa alla Fase 5, con le strategie.

Le motivazioni sono nell'ADR 0009.

Serve l'utente per

  • Le chiavi del conto di prova OKX demo, senza permesso di prelievo. Anubis rifiuta una chiave che può prelevare.
  • Le chiavi del conto di prova Alpaca paper (servono anche per lo storico azionario della Fase 2).

Con le chiavi si eseguono AlpacaPaperConformance e OkxDemoConformance e il criterio della batteria va spuntato.

Prossimo passo: la Fase 4 (backtest e laboratorio), con il via dell'utente.

``` Fase 3 — Conti, ordini, contabilità: COMPLETATA (un criterio in attesa dell'utente) ``` **Criteri di accettazione** - **Test di proprietà contabili** — verificato. `RandomFillsNeverBreakTheBooks` usa esecuzioni casuali a seme fisso. Registro, lotti e liquidità restano sempre in pari: liquidità più posizioni fa il patrimonio e nessuna quantità diventa negativa. - **Batteria di conformità dei broker** - *Simulatore: verificato* (`PaperBrokerConformance`). - *Risposte d'esempio della documentazione: verificato* (`AlpacaDocConformance`, `OkxDocConformance`). - *Conti di prova Alpaca paper e OKX demo: in attesa dell'utente.* Servono le chiavi. I test sono già pronti: `AlpacaPaperConformance` e `OkxDemoConformance`, categoria `LiveDemo`. - **Test con guasti** — verificato su SQLite e PostgreSQL (`OrderManagerTests`, `ReconcilerTests`). Coprono: - una risposta persa a metà ordine, mai rimandata; - le esecuzioni doppie; - un broker che non risponde; - uno stop scattato senza avviso; - le differenze non spiegate. - **Nessun conto reale senza consenso** — verificato, in Docker e su desktop: - `RealAccountsAreRefusedWithoutTheStartupConsent`; - `BrokerAdaptersRefuseARealAccountBeforeAnyRequest`, che controlla anche che non parta nessuna richiesta. - **Schermata Conti e posizioni come il mockup** — verificato. `TheDemoShowsTheFiguresOfTheMockup` controlla i numeri nella modalità dimostrativa. Le fotografie sono a 1440 px (chiaro e scuro) e a 390 px. Unica differenza: un centesimo su una riga di XOM, che viene dall'arrotondamento del mockup stesso. **Chiusura** - Le issue da #26 a #33 hanno le loro prove e si chiudono con la PR #89. - `tasks check` passa e l'immagine Docker si costruisce. Le run CI 189 e 190 sono verdi su SQLite e su PostgreSQL. Nessun pacchetto è fuori dall'ADR 0004. - Revisione indipendente fatta: 11 difetti trovati e corretti (commit 1a0912e). I principali: - un frazionamento moltiplica solo le azioni tenute prima della data di stacco; - un dividendo non si paga due volte se qualcosa si interrompe a metà; - le posizioni prendono il prezzo di mercato prima di ogni fotografia del patrimonio; - un'esecuzione in errore non blocca più le altre né gli stop; - senza prezzo, una vendita aspetta con gli stop ancora sul broker; - una vendita rifiutata si riprova con pause crescenti; - su OKX solo la risposta 51603 vale "ordine sconosciuto"; - "allinea", "escludi" e "togli le chiavi" chiedono il token antifalsificazione; - cambiando il capitale, per Alpaca si converte solo la differenza in euro. - Il passo di prezzo di Alpaca (2 decimali da 1 $ in su, 4 sotto) e i decimali del CSV sono corretti nel commit 60d5ebb. - Un problema di tempi visto solo sulla CI è corretto nel commit 16be51e: un test perdeva la connessione a PostgreSQL mentre creava il suo database appena partito il servizio. - `docs/ROADMAP.md`, `docs/STATE.md` e `docs/API-NOTES.md` sono aggiornati. Tag `fase-3` sul commit di unione (6d3ef8e). **Decisioni prese:** ADR 0009 (scelte della Fase 3). **Scostamenti dalla specifica** - Il flusso dal vivo delle azioni (IEX) passa alla Fase 6. Senza chiavi Alpaca non ci sono posizioni azionarie da seguire, e lo stop sta comunque sul broker. - Chiavi e capitale non entrano nella procedura del primo avvio, che resta corta e funziona senza chiavi. Si inseriscono da Impostazioni → Conti e chiavi, e la Panoramica lo indica come primo passo. - Il filtro sullo spread (O7) passa alla Fase 5, con le strategie. Le motivazioni sono nell'ADR 0009. **Serve l'utente per** - Le chiavi del conto di prova OKX demo, **senza permesso di prelievo**. Anubis rifiuta una chiave che può prelevare. - Le chiavi del conto di prova Alpaca paper (servono anche per lo storico azionario della Fase 2). Con le chiavi si eseguono `AlpacaPaperConformance` e `OkxDemoConformance` e il criterio della batteria va spuntato. **Prossimo passo:** la Fase 4 (backtest e laboratorio), con il via dell'utente.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#33