Standards

S001 — Bus-Driven Architecture

ServiceBase publishes identity + heartbeat to MQTT on boot.

S001 — Bus-Driven Architecture (v2026-09-30T091947Z-5e473105f4) 2026-09-30 | ServiceBase publishes identity + heartbeat to MQTT on boot. 1 - ServiceBase Initialization - ServiceBase initializes and publishes identity ServiceBase daemon/src/service_base.py ServiceBase.__init__ initializes service Load build version daemon/src/build_version.py _build_version loads build version Load role daemon/src/service_base.py _get_role_from_config loads role Connect to MQTT broker daemon/src/service_base.py mqtt_client.connect connects to MQTT Publish identity daemon/src/service_base.py identity publishes identity Start heartbeat loop daemon/src/service_base.py _heartbeat_loop starts heartbeat build version role MQTT connection identity paylo… heartbeat inte… 1. Initialize ServiceBase 2. Load build version 3. Load role 4. Connect to MQTT 5. Publish identity 6. Start heartbeat Service identity payload { "service": "daemon", "version": "2026-05-23T074530Z-a3f8e2c", "role": "owner", "status": "starting", "environment": "dev", "commit_sha": "a3f8e2c", "timestamp": 1715813520 } Heartbeat payload { "service": "daemon", "version": "2026-05-23T074530Z-a3f8e2c", "role": "owner", "status": "healthy", "uptime_seconds": 3600, "timestamp": 1715813520 } ServiceBase handles the entire lifecycle, from initialization to heartbeat publishing. Legend actor = initiates work · process = code path · store = state on disk · bus = durable queue · dashed = separate process cyan = request flow · pink = state read/write · dashed green = pull / return path · red = refusal As of 2026-09-30 09:19 UTC, from commit 5e47310

Provenance

This drawing is generated, not drawn. It is rebuilt from the source files below, so when they change the picture changes — a diagram here cannot quietly describe a system that no longer works this way.

Owner
Standards
Slug
s001-bus-driven-architecture
Rendered
2026-09-30T091947Z
From commit
5e473105f4
Updated
30 Sep 2026, 09:19 UTC
Sources at
5e47310
Watches
3 paths
  • daemon/src/service_base.py
  • daemon/docs/standards/BUS_DRIVEN_ARCHITECTURE.md
  • daemon/docs/VERSIONING_BUS.md