micheleandCursor
6087bb5297
Introduces a new SwiftUI app with HTTP REST device control, mock mode for UI development, BLE-based discovery, and documented architecture aligned with the firmware API. Co-authored-by: Cursor <cursoragent@cursor.com>
36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# APP_ARCHITECTURE — igiRadio
|
||
|
||
## Stack
|
||
|
||
```
|
||
SwiftUI Views
|
||
↓ @Observable ViewModels
|
||
DigiRadioService (protocol)
|
||
↓
|
||
RealDigiRadioService ──→ HTTPDigiRadioClient (URLSession)
|
||
MockDigiRadioService ──→ dati in-memory
|
||
|
||
BLEProvisioningService (solo setup Wi‑Fi)
|
||
↓ CoreBluetooth + protocomm (ESP Security1)
|
||
```
|
||
|
||
## Principi
|
||
|
||
1. Le View **non** chiamano URLSession o CoreBluetooth direttamente.
|
||
2. Un solo `DigiRadioState` osservabile aggiornato dal service.
|
||
3. Errori tipizzati (`DigiRadioError`).
|
||
4. Dependency injection via `AppEnvironment` in `igiRadioApp`.
|
||
|
||
## Connessione
|
||
|
||
| Fase | Meccanismo |
|
||
|------|------------|
|
||
| Prima configurazione | BLE provisioning **oppure** join SoftAP + POST /api/wifi |
|
||
| Uso normale | mDNS `digiradio-xxxxxx.local` o IP manuale |
|
||
| Base URL | `http://{host}/api/...` |
|
||
|
||
## Polling vs push
|
||
|
||
- Nessuna notifica BLE documentata per stato tuner.
|
||
- `TunerViewModel` può pollare `GET /api/tuner/status` a intervallo configurabile quando la schermata radio è attiva.
|