smart-home ▸ HOME_CONTROL_ARCHITECTURE.md
updated 2026-03-27

Home Control Architecture

Purpose

Define the simplest robust architecture for the first wave of home automations.

Design Principle

Use the most native, reliable control layer possible first.

That means: - Apple Home / HomeKit for scene orchestration where available - Sonos for room-based audio playback - Apple Music as content source - No PAM / Cambium integration yet - No unnecessary abstraction before the first automations are proven useful


Current Known Device/Service Layers

Lighting Layer

Audio Layer

Compute / Control Layer


Control Ownership

Apple Home / HomeKit should own:

Sonos should own:

Apple Music should own:

Future automation layer (optional later) should own:

For now, do not add this layer.


Scene Model

1. Morning Dining

Type: scheduled weekday routine

Intent: create a reliable family morning cue in the dining area

Actions: - start Beatles Greatest Hits in Dining Room at 7:00 - flash kitchen light at 7:36

Why this belongs in native systems: - timing is fixed - logic is simple - reliability matters more than sophistication


2. Dinner Mode

Type: manual scene

Intent: simplify and beautify dinner

Actions: - all connected lights off except kitchen + dining room - play dinner playlist in dining room only

Why manual: - dinner timing varies - manual trigger reduces false positives


3. Friday Movie Night

Type: manual scene

Intent: quick movie atmosphere

Actions: - all connected lights off - stars remain separate and manually controlled

Why manual: - avoids badly-timed schedule trigger - stars are not integrated


Naming Recommendation

Keep scene names human and obvious.

Alternative vibe names: - Beatles Breakfast - Shoes Time - Supper - Lights Down

But the safer choice is clear names first.


Reliability Rules

  1. Avoid over-automation.
  2. Prefer manual trigger where timing varies.
  3. One scene = one emotional/job outcome.
  4. Keep audio routing room-specific unless expansion is intentional.
  5. Do not add PAM/Cambium until the household scenes are stable.

Architecture Recommendation

Phase 1 (now)

Phase 2 (only if needed)

Phase 3 (much later)


High-Level Future State

If expanded later, home control should be based on modes, not raw device micromanagement.

Examples: - focus_mode - dinner_mode - movie_mode - bedtime_mode - family_transition

Then a home system translates those states into device actions.

That keeps the architecture sane.