# Feature Name

## Status

Proposed | Active | Deprecated

## Goal

One short paragraph describing the outcome this feature must produce.

## Actors

- Actor 1
- Actor 2

## Preconditions

- precondition 1
- precondition 2

## Trigger

What starts this flow.

## Main Flow

1. User or system does something.
2. System validates.
3. System stores or updates state.
4. System emits responses, events, or notifications.

## Alternate Flows

- validation failure
- unauthorized actor
- missing dependency

## Business Rules

- rule 1
- rule 2

## Data / Entities

- entity 1
- entity 2

## API / UI Surface

- frontend routes
- backend endpoints
- roles or permissions

## Acceptance Criteria

- [ ] criterion 1
- [ ] criterion 2

## Open Questions

- question 1