# Architecture: [system or feature]

**View:** Current (verified) / Proposed / Illustrative

## Purpose and boundaries

- What this system/module is responsible for:
- What it deliberately does not own:
- Entry points and consumers:
- Source of current-state evidence (only if verified):

## System context

```mermaid
flowchart LR
    actor[Client] -->|request| system[System]
    system -->|external integration| external[External Dependency]
```

> Replace illustrative names before declaring this diagram current.

## Components and ownership

| Component | Responsibility | Data owner | Interface / contract |
|---|---|---|---|
| [name] | [single purpose] | [system/store] | [link] |

## Important flows and failure paths

- Normal flow:
- Timeout/failure behavior:
- Retries and idempotency:

## Security and tenancy

- Authentication and authorization:
- Trust boundaries and sensitive data:
- Tenant boundary and enforcement (if applicable):

## Data and consistency

- Authoritative storage and schema:
- Consistency and migration constraints:

## Operations

- Environments and deployment topology:
- Health, telemetry, backup and rollback:

## Decisions, tradeoffs and unknowns

- Accepted choices (link ADR):
- Proposed changes:
- Assumptions requiring validation:

## Verification

- [Code paths, tests, commands or design review evidence]