Architecture

System, backend, and device architecture — components, data ownership, trust boundaries.

Concepts

Identity, ownership, authorization, mosque binding, playback entitlement — kept deliberately separate.

Modules

Device management, transmitter, stream player, azaan broadcast, prayer timing, and more.

API Reference

Generated from the live FastAPI OpenAPI spec — every endpoint, request and response schema.

MQTT Protocol

The wire contract every transmitter and stream player speaks — topics, payloads, lifecycle.

Database

Schema ownership, entity relationships, and the Alembic migration model.

Design Decisions

Why the system is shaped this way — recorded trade-offs, not just current behavior.

Developer Guide

Run the whole platform locally, configure it, and test it.

Deployment & Operations

Release process, migrations, broker setup, monitoring, and troubleshooting.

Roadmaps

What's planned but not yet built — kept separate from architecture.