Architecture Decision Records

ADRs capture why we chose one option over others for a decision we expect to live with for years. Keep them short. Date them. When superseding, link back and mark the old one deprecated.

#	Title	Status	Date
0001	Stack choice: NestJS + Next.js + Postgres + Prisma	Accepted	2026-04-17
0002	OSS/Community + commercial Enterprise split	Accepted	2026-04-17
0003	Multi-tenancy model: row-level with tenant-scoped queries	Accepted	2026-04-17
0004	Product name: Panorama	Proposed	2026-04-17
0005	Licensing: AGPL-3.0-or-later for Community	Accepted	2026-04-17
0006	Plugin / extension SDK boundary	Draft	2026-04-17
0007	Tenant Owner role (designated admin)	Accepted	2026-04-18
0008	Invitation flow (email-token, TTL, one-time-use, audit)	Accepted	2026-04-18
0009	Reservation domain (two-axis state, conflicts, blackouts, approval)	Accepted	2026-04-18
0010	Snipe-IT compat shim — auth model (per-user PATs)	Accepted	2026-04-18
0011	Notification event bus — architecture	Accepted	2026-04-18
0012	Inspection checklists + photo evidence pipeline	Accepted	2026-04-18
0013	Staging deploy architecture (internal only)	Accepted	2026-04-19
0014	Public hosted instance (Community deployed, free preview)	Accepted	2026-05-16
0015	BYPASSRLS removal refactor (SECURITY DEFINER bypass function)	Accepted	2026-04-19
0016	Asset maintenance flow (Snipe-IT-compatible)	Accepted (v3 2026-04-26)	2026-04-19
0017	AI/LLM integration principles	Accepted	2026-04-23
0018	Observability stack (pino + Sentry + request-id ALS)	Accepted	2026-05-16
0019	Worker process boundary (photo pipeline defer-with-trigger)	Accepted	2026-05-16
0020	Self-serve OIDC signup (Wave 0.5)	Proposed	2026-05-16
0021	Web frontend architecture (features/ + RSC + role-aware /)	Accepted	2026-05-18
0022	Driver native mobile architecture (Expo / React Native)	Accepted	2026-05-18

Template

# ADR-NNNN: <short title>

- Status: Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
- Date: YYYY-MM-DD
- Deciders: @alice, @bob

## Context
What is the problem? What constraints are we working under? What did we try before?

## Decision
What did we pick? State it as a sentence; avoid hedging.

## Alternatives considered
Brief list with why each was rejected.

## Consequences
Positive, negative, and neutral outcomes. What this locks us into. What this frees us up for.