F1 · Scheletro delle API REST e del WebSocket #12

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

Fase 1 — Fondamenta · Specifica: docs/SPEC.md §3, 13.4

Obiettivo

Le API che l'interfaccia userà, con aggiornamenti dal vivo.

Passi

  • API REST (minimal API) con autenticazione e validazione dei dati in ingresso; le regole stanno nei servizi usati anche dalle pagine Blazor
  • Canale WebSocket per gli aggiornamenti; avviso di dati fermi quando il collegamento cade
  • Endpoint di stato per la barra superiore (bot, ambiente, valuta)

Criteri di accettazione della fase a cui contribuisce

  • Accesso funzionante

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 1 — Fondamenta** · Specifica: `docs/SPEC.md` §3, 13.4 ### Obiettivo Le API che l'interfaccia userà, con aggiornamenti dal vivo. ### Passi - [ ] API REST (minimal API) con autenticazione e validazione dei dati in ingresso; le regole stanno nei servizi usati anche dalle pagine Blazor - [ ] Canale WebSocket per gli aggiornamenti; avviso di dati fermi quando il collegamento cade - [ ] Endpoint di stato per la barra superiore (bot, ambiente, valuta) ### Criteri di accettazione della fase a cui contribuisce - Accesso funzionante --- 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 1 — Fondamenta milestone 2026-11-09 11:53:07 +01:00
Alby96 added the Kind/Feature
Priority
Medium
3
Area/Fondamenta
labels 2026-11-09 11:53:07 +01:00
Author
Owner

Fatto (commit f9d7155).

API REST sotto /api, tutte con accesso; le scritture vogliono l'intestazione X-Anubis-Csrf:

  • GET /api/antiforgery, /api/status, /api/me, /api/jobs;
  • GET /api/settings e PUT /api/settings/{chiave} (lo stato del bot non si cambia da qui), /api/settings/history;
  • GET /api/secrets/{nome}: solo se è impostato, mai il valore;
  • POST /api/bot/{pause|resume|stop|restart}, con 409 quando il passaggio non è ammesso ("riprendi" non annulla "Ferma tutto").

WebSocket su /ws:

  • controllo dell'origine;
  • un messaggio di stato all'apertura, a ogni cambio di impostazione o di modo, e ogni 5 secondi.

/health controlla il database e il pianificatore: risponde 200 o 503.

Prove — SignInFirstAccessAndApi, DemoModeNeverTouchesTheConfiguredDatabase (riceve lo stato dal WebSocket), HealthChecksDatabaseAndScheduler, su entrambi i motori.

**Fatto** (commit f9d7155). API REST sotto `/api`, tutte con accesso; le scritture vogliono l'intestazione `X-Anubis-Csrf`: - `GET /api/antiforgery`, `/api/status`, `/api/me`, `/api/jobs`; - `GET /api/settings` e `PUT /api/settings/{chiave}` (lo stato del bot non si cambia da qui), `/api/settings/history`; - `GET /api/secrets/{nome}`: solo se è impostato, mai il valore; - `POST /api/bot/{pause|resume|stop|restart}`, con 409 quando il passaggio non è ammesso ("riprendi" non annulla "Ferma tutto"). WebSocket su `/ws`: - controllo dell'origine; - un messaggio di stato all'apertura, a ogni cambio di impostazione o di modo, e ogni 5 secondi. `/health` controlla il database e il pianificatore: risponde 200 o 503. **Prove** — `SignInFirstAccessAndApi`, `DemoModeNeverTouchesTheConfiguredDatabase` (riceve lo stato dal WebSocket), `HealthChecksDatabaseAndScheduler`, su entrambi i motori.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#12