---
title: <Area title>
description: <One sentence describing the reader's outcome.>
documentation:
  kind: overview
  readerQuestion: <The area-level reader question.>
  status: draft
  scope: <Precise coverage and depth; state exclusions.>
  codeReference: <Full reviewed repository commit>
  sources:
    - <Existing repository-relative owning source>
---

<!-- Area-level completeness checklist. Use the article-type templates for individual pages. -->

## Purpose and boundaries

Explain the user/business need, owning terms and adjacent responsibilities.

## Actors and authority

Show allow/deny decisions, capabilities, tenant/resource/relationship scope and
audience visibility. A hidden control is not an authorization policy.

## Lifecycle and rules

Explain state meaning, transitions, prerequisites, invariants, immutable evidence
and separate facts that must not be conflated. Include a readable diagram where
it reduces ambiguity.

## Normal and exceptional flows

Follow the trigger through UI, hooks, API/services, database/RLS/functions and
external effects. Cover conflicts, retries, cancellation and unknown outcomes.

## Records and information ownership

Map canonical records, relationships, projections, source identifiers, snapshots
and publication. Link detailed schema/API sources rather than copying catalogues.

## Implementation map

Name representative entry points and the policy/transaction boundary at each
layer. Explain why the work takes the direct-client or privileged path.

## Operation and recovery

Describe relevant background work, receipts, observability and safe recovery.
Link owning runbooks for commands. Mark inapplicable concerns with a reason.

## Verification and known limits

Separate inspected source/tests, actual executed commands, named scenario
evidence and live observations. Record concrete gaps and decisions. Never infer
deployed or business-verified status from the documentation build.

## Related areas

Link stable handbook routes and list dependencies on unwritten areas explicitly.
