---
type: concept
tags: [parking, domain, business, reporting]
sources: []
updated: 2026-06-15
status: open
---

# Reporting & Analytics

Turning the signed event log into the numbers an owner runs the business on. All reports are
**projections over the [[append-only-event-chain]]** — the chain is the single source, reports are
derived and rebuildable, never a separate ledger.

## Reports (driven by the events already designed)

- **Revenue** — by day/week/shift, by tender (cash vs. card), gross vs. discounts vs. net. Source:
  `payment` events + [[validation-discounts|discount]] events + `shift_z_report` ([[shift]]).
- **Occupancy** — current ([[capacity-occupancy]]) and historical curve; peak times; turnover.
- **Stay analytics** — average/median duration, distribution; transient vs. [[subscription]] split.
- **Permit usage** — active permits, utilisation, concurrency vs. `maxConcurrent`.
- **Anomalies** — out-of-band opens, never-exited sessions, occupancy drift, over-validation —
  the `anomaly` events + reconciliation findings ([[reconciliation]]).

## Plate / entry search (admin lookup) — user-requested 2026-06-15

The admin can **search for an entry/session by licence plate** — *if the plate was captured* (by
the [[opencv-anpr-service|vision service]] or an LPR read; a pure-ticket transient has no plate).
Returns the matching session(s): entry/exit times, fee, payment, snapshot image. Useful for
disputes ("I was charged for a car that left earlier"), lost-ticket lookup, and incident review.

- Search keys: plate (when captured), ticket id, session id, time range.
- Read-only over the chain; surfaces the linked snapshot ([[lpr-camera]] `imageRef`) as evidence.
- Honest limit: **no plate → no plate-search hit.** The UI must say "not captured", not "no such
  car", so the absence isn't mistaken for a missing record.

## Properties

- **Offline** ([[offline-first]]): all computed locally from the local DB; no cloud BI dependency.
- **Reproducible**: a report run twice over the same chain gives the same answer; figures trace to
  signed events.
- **Export** for [[reconciliation]] / accounting (CSV/PDF) — the periodic external-authority path
  ([[open-questions]] #4).

## Open

- Which reports matter at launch vs. later; the export format/cadence.
- Dashboard (live) vs. on-demand reports.