Skip to content

Milestone v0.2.0 — Service Infrastructure

Target: v0.2.0 — Service Infrastructure

Status: ✅ Done

References: ADR-0019: Unified Service Infrastructure, VISION.md, ROADMAP.md

User Stories: US-C05

Phase 1: Setup Redis Container

Goal: Provide the central status bus (Redis) as part of the Tier 1 infrastructure.

Tasks

  • [x] Add redis service to compose.yml
  • Image: redis:7-alpine
  • Command: redis-server --save "" (in-memory only, no persistence needed for status bus)
  • Port: 6379 (internal to silvasonic-net)
  • [x] Add redis_data named volume for bind-mount consistency (ADR-0006)
  • [x] Add redis to depends_on for relevant services (Web-Mock).

Phase 2: Core Service Infrastructure

Goal: Implement the SilvaService base class and shared modules for the unified lifecycle.

Tasks

  • [x] Implement silvasonic.core.service.SilvaService module
  • Handles canonical lifecycle: Logging config, Health Server startup, Redis connection, Heartbeat start, graceful shutdown logic.
  • [x] Implement silvasonic.core.heartbeat.HeartbeatPublisher
  • Async fire-and-forget Redis heartbeats to silvasonic:status:<instance_id> (SET + TTL) and silvasonic:status (PUBLISH).
  • [x] Implement silvasonic.core.redis.get_redis_connection
  • Best-effort connection with auto-reconnect fallback mechanism.
  • [x] Update silvasonic.core.settings to include Redis connection string.

Phase 3: Migrate Existing Services

Goal: Migrate previously implemented Python services to use SilvaService.

Tasks

  • [x] Update controller/__main__.py to use SilvaService
  • [x] Update recorder/__main__.py to use SilvaService
  • [x] Remove duplicate/custom health/shutdown logic from both services, relying on the base class.
  • [x] Verify both services publish status heartbeats correctly (via log output or Redis CLI).
  • [x] Ensure integration tests and smoke tests (just check-all) pass with the new infrastructure.

Phase 4: Web-Mock Dev UI

Goal: Provide a functional UI shell for iterating on the Web-Interface design without requiring database or full service stack.

Tasks

  • [x] Create services/web-mock with FastAPI + Uvicorn + Jinja2 + HTMX + Alpine.js
  • [x] Build Tailwind CSS v4 + DaisyUI v5 static assets (no CDN at runtime)
  • [x] Implement all pages: Dashboard, Recorders, Processor, Uploaders, Birds, Bats, Weather, Settings, About
  • [x] Use ServiceContext lifespan (same pattern as SilvaService)
  • [x] SSE console log stream with mock data
  • [x] Add to compose.yml with healthcheck
  • [x] Smoke test for web-mock container health

Out of Scope (Deferred)

Item Target Version
Tier 2 container management (Controller) v0.3.0
Audio recording (Recorder) v0.4.0
Production Web-Interface (replaces Web-Mock) v0.9.0
Dashboard live metrics display v0.9.0