Calls & approvals
Audit trail for buzzer calls and approve/deny decisions.
Overview
Each buzzer session materializes as a Call with nested Approval rows when residents respond.
Admin API
| Method | Path | Description |
|---|---|---|
GET | /api/admin/calls | Filterable call history |
Typical query parameters: date range, property, unit, user — see handler for authoritative filter set.
Call fields (important)
| Field | Meaning |
|---|---|
startedAt | When the voice session began (not createdAt) |
durationSec | Length in seconds (integer) |
finalState | completed, no-answer, busy, failed, timeout |
Approvals
| Field | Meaning |
|---|---|
action | approve or deny — exact literals |
Multiple approvals may exist if several residents are notified; business rules determine which action wins for door release.
The approval window is approximately 30 seconds before the request expires.
Analytics
Derived metrics surface under /api/admin/analytics/* and /api/admin/stats.
Guest pass entries
Guest pass usage creates GuestPassEntry rows linked to calls when PIN validation succeeds.
Last verified: 2026-06-21 (commit 293c4a7)