Design: overlays, notification placement, DSH-1 in the MVP

D25: dashboard tabs and world overlays; premultiplied-alpha flag.
D26: one world overlay for all notifications. D27: MVP placement
"spawn in front, then stay". D28: DSH-1 (web UI out-of-the-box test)
joins the MVP, full dashboard becomes DSH-2. Add the research on
notification UI in VR (DESIGN.md, Appendix A).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-05 21:26:38 +02:00
co-authored by Claude Opus 5.5
parent 3ec3029af6
commit 06de5cf184
3 changed files with 125 additions and 7 deletions
+10 -3
View File
@@ -10,15 +10,17 @@ CLAUDE.md ("Working rules").
## Next steps
Phase 2: first the high-level architecture, then the details for the MVP (D8). High-level
Phase 2: first the high-level architecture, then the details for the MVP (D8, plus DSH-1 by
D28). High-level
questions, in this order:
1. ~~Process model~~: one process, several threads (D16).
2. ~~Layers~~: presentation, business logic, I/O (D17).
3. ~~How features plug in~~: object classes (D18), configuration injection (D19), one class
per HA entity type with native types preferred (D23).
4. HA channels: MQTT only, or prepare for a second one for the dashboard (Q2/Q3)?
5. Overlay kinds: dashboard tabs and world overlays (platform extension).
4. ~~HA channels~~: MQTT for the device, own channel for the dashboard later (D24).
5. Overlay kinds: dashboard tabs and world overlays (D25), one notification overlay (D26),
MVP placement (D27); DSH-1 web UI test in the MVP (D28).
6. Runtime model: which work runs in which thread (D16: several threads).
7. Test strategy at a high level.
@@ -40,6 +42,11 @@ configuration, packaging of libmosquitto.
present (relevant for Q2/Q3).
- libmosquitto ABI check: Debian's 2.0.21 needs at most `OPENSSL_3.0.0`/`GLIBC_2.34`; the
Frame has OpenSSL 3.2.1 and glibc 2.39. No libcjson dependency. D14 holds.
- DSH-1 split: web UI out-of-the-box test in the MVP, full dashboard as DSH-2 (D28).
- Overlays: two kinds (D25), one overlay for all notifications (D26), MVP placement "spawn in
front, then stay" (D27). Researched notification UI in VR (DESIGN.md, Appendix A). Found:
premultiplied-alpha flag missing in the platform.
- HA channels: MQTT for everything device-related; dashboard channel decided with Q2/Q3 (D24).
- Entities: one class per HA entity type, native types preferred, own service only as fallback
(D23). Found: MQTT `notify` drops the title.
- Start-up hook `prepare()` in the platform (D21); modes, `--desktop-novr` and `--config`