Terminology
Azan360's device-management design deliberately keeps five concepts separate
and never conflates them (docs/device-management-architecture-summary.md).
This page is the quick-reference; each term links to its full concept page.
| Term | Means | Does NOT mean |
|---|---|---|
| Identity | Which physical unit this is (serial number, device_uid, credential) | Who owns it, or whether it may act |
| Ownership | Which mosque/user paid for and possesses the unit | That it's authorized to operate |
| Authorization | Whether this specific unit is currently allowed to connect/publish/stream | Ownership or mosque binding |
| Mosque binding | Which mosque a unit is currently configured to serve | Ownership (a unit can be reassigned) |
| Playback entitlement | Whether a bound, authorized unit may play a given stream right now (membership-derived, leased) | A permanent grant — it expires |
Device types
| Term | Meaning |
|---|---|
| Transmitter | Physical ESP32 device that captures live audio at a mosque and/or plays broadcasts through a PA amplifier. Sold, inventory-tracked, Super Admin approval required. |
| Stream Player | Physical ESP32 speaker device that plays broadcasts; usable as a plain Bluetooth speaker outside of any mosque gating. Sold, inventory-tracked, Super Admin approval required. |
App install (app_installs) | A mobile app installation. Free, not inventory-tracked, gated only by mosque membership — explicitly not a device in the inventory/approval sense. |
Broadcast terms
| Term | Meaning |
|---|---|
| Live broadcast | Audio streamed in real time from an admin's microphone or a transmitter's line-in, through FFmpeg, to an Icecast mount. |
| Azaan / azan broadcast | A live or offline broadcast of the call to prayer specifically (room_id = "azaan"); triggers device MQTT commands and mobile VoIP/call-style push. |
| Offline azan (auto azan) | The scheduler-fired fallback that plays a pre-recorded azan file when nobody broadcasts live within the grace period. |
| Room | An Icecast mount / broadcast channel (azaan, taraweeh, waaz, announcement, ...). |
| Trigger | A row in the triggers table recording that a broadcast (manual or auto) happened, used both as history and as dedupe state. |
Roles
| Term | Meaning |
|---|---|
| Super Admin | Platform operator — approves devices, manages all mosques, via the Super Admin Panel. |
| Mosque Admin | Manages one mosque — broadcasts, prayer times, events, devices, memberships — via the Admin Panel. |
| Member | A user with an approved membership at a mosque; receives push notifications and playback entitlement for that mosque. |
See Authentication and Authorization for how these roles are enforced.