homeos

Commit Graph

Author	SHA1	Message	Date
HomeOS Bootstrap	ea9e35883b	Phase 3: MQTT ingest — Mosquitto bus, Shelly driver, live device state Real bidirectional MQTT so devices are live, not mock (handoff §13.3): - Mosquitto 2 broker (auth + per-client ACLs for laravel/shelly/sidecar from day one); passwd generated by docker/mosquitto/gen-passwd.sh (gitignored). - mqtt-listener daemon: subscribes `+/status/#`, parse + dispatch only (H2), exponential reconnect backoff, graceful SIGTERM. php-mqtt/laravel-client. - Ingest path (H4): IngestShellyMessage resolves device by mqtt_prefix, upserts device_states, refreshes last_seen, broadcasts DeviceStateChanged (ShouldBroadcastNow) on the private `home` channel. - Control path (H1): DeviceDriver contract + ShellyMqttDriver (command topic + Shelly.Reboot RPC) behind DeviceCommandService, which audits every command to the new `commands` table. Device detail toggles + restart route through it; flash reflects the real result. - Live UI: dashboard + device pages listen via Echo (#[On('echo-private:home, .DeviceStateChanged')]) and re-render instantly. - Vendor specifics isolated in Support/Mqtt + Support/Drivers (H3). Verified end-to-end in a real browser: publishing an MQTT status turned a light "An" on the dashboard in 3.0s with no reload, 0 console errors. R12 30/30; 15 feature tests green (incl. ingest + command audit). README/bootstrap document the broker passwd step. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-17 22:51:14 +02:00
HomeOS Bootstrap	beac04ec51	Phase 1: bootstrap — Docker stack, Laravel 13, design system, auth Foundation for HomeOS (handoff §13.1). Verified in a real browser (R12): HTTP 200, zero console errors, zero failed requests, breakpoints 1280/768/375, no leaked template/lang literals. Feature test suite green (7 passing). Stack (locked, handoff §12): Laravel 13, Livewire v3 (class-based, no Volt), Tailwind v4 (@theme, no config), PostgreSQL 17 + TimescaleDB, Redis + Horizon, Reverb (private channels, proxied same-origin via nginx), Vite. Everything runs in containers (R8); one app image shared by app/horizon/scheduler/reverb. - docker: app (php-fpm 8.4 + nginx + supervisor), db (timescale pg17), redis, reverb, horizon, scheduler; env-driven ports; HOST_UID/GID from id nexxo - design system ported verbatim from design-mockup.html into @theme (§8); self-hosted Plus Jakarta Sans + IBM Plex Mono woff2 (R14) - Blade component kit: icon, panel, kpi, status-dot/pill, badge, toggle, room-card, device-chip, sidebar, topbar; app + guest layouts (mobile drawer) - auth: class-based Livewire Login (throttled) + Dashboard; English routes, German UI; full DE/EN localization (R16) - rules.md + CLAUDE.md; admin user seeded from gitignored .env Deferred by design: php-mqtt/laravel-client (Phase 3), mosquitto/mqtt-listener (Phase 3), discovery sidecar (Phase 4). R15 (Codex review) pending user `codex login`. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-17 21:06:20 +02:00

Author

SHA1

Message

Date

HomeOS Bootstrap

ea9e35883b

Phase 3: MQTT ingest — Mosquitto bus, Shelly driver, live device state

Real bidirectional MQTT so devices are live, not mock (handoff §13.3):
- Mosquitto 2 broker (auth + per-client ACLs for laravel/shelly/sidecar from day
  one); passwd generated by docker/mosquitto/gen-passwd.sh (gitignored).
- mqtt-listener daemon: subscribes `+/status/#`, parse + dispatch only (H2),
  exponential reconnect backoff, graceful SIGTERM. php-mqtt/laravel-client.
- Ingest path (H4): IngestShellyMessage resolves device by mqtt_prefix, upserts
  device_states, refreshes last_seen, broadcasts DeviceStateChanged
  (ShouldBroadcastNow) on the private `home` channel.
- Control path (H1): DeviceDriver contract + ShellyMqttDriver (command topic +
  Shelly.Reboot RPC) behind DeviceCommandService, which audits every command to
  the new `commands` table. Device detail toggles + restart route through it;
  flash reflects the real result.
- Live UI: dashboard + device pages listen via Echo (#[On('echo-private:home,
  .DeviceStateChanged')]) and re-render instantly.
- Vendor specifics isolated in Support/Mqtt + Support/Drivers (H3).

Verified end-to-end in a real browser: publishing an MQTT status turned a light
"An" on the dashboard in 3.0s with no reload, 0 console errors. R12 30/30;
15 feature tests green (incl. ingest + command audit). README/bootstrap document
the broker passwd step.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-17 22:51:14 +02:00

HomeOS Bootstrap

beac04ec51

Phase 1: bootstrap — Docker stack, Laravel 13, design system, auth

Foundation for HomeOS (handoff §13.1). Verified in a real browser (R12):
HTTP 200, zero console errors, zero failed requests, breakpoints 1280/768/375,
no leaked template/lang literals. Feature test suite green (7 passing).

Stack (locked, handoff §12): Laravel 13, Livewire v3 (class-based, no Volt),
Tailwind v4 (@theme, no config), PostgreSQL 17 + TimescaleDB, Redis + Horizon,
Reverb (private channels, proxied same-origin via nginx), Vite. Everything runs
in containers (R8); one app image shared by app/horizon/scheduler/reverb.

- docker: app (php-fpm 8.4 + nginx + supervisor), db (timescale pg17), redis,
  reverb, horizon, scheduler; env-driven ports; HOST_UID/GID from id nexxo
- design system ported verbatim from design-mockup.html into @theme (§8);
  self-hosted Plus Jakarta Sans + IBM Plex Mono woff2 (R14)
- Blade component kit: icon, panel, kpi, status-dot/pill, badge, toggle,
  room-card, device-chip, sidebar, topbar; app + guest layouts (mobile drawer)
- auth: class-based Livewire Login (throttled) + Dashboard; English routes,
  German UI; full DE/EN localization (R16)
- rules.md + CLAUDE.md; admin user seeded from gitignored .env

Deferred by design: php-mqtt/laravel-client (Phase 3), mosquitto/mqtt-listener
(Phase 3), discovery sidecar (Phase 4).

R15 (Codex review) pending user `codex login`.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-17 21:06:20 +02:00

2 Commits (23ef993cb27930552cf8604c50c72a77159b84ce)