# Feature Spec 标题

| 项 | 内容 |
| --- | --- |
| 状态 | Draft / Approved / Implemented / Superseded / Archived |
| 日期 | YYYY-MM-DD |
| 负责人 | 按实际填写 |
| 需求来源 | 用户 / 客户 / 业务方 / 内部发现 |
| 关联 Change Request | 可为空 |

## 1. 背景

说明为什么要做这个功能。

## 2. 目标

- 目标 1：
- 目标 2：

## 3. 非目标

- 不做事项 1：
- 不做事项 2：

## 4. 第一版范围与后续加固

- 第一版必须完成的功能闭环：
- 第一版必须保留的基础安全底线：Secret 管理 / 基础权限边界 / 输入校验 / 敏感日志控制 / 数据隔离 / 错误响应脱敏
- 本阶段后置的高级安全、高并发、性能、完整可观测性、复杂扩展性或容灾能力：
- 为后续迭代保留的低耦合边界和扩展点：

## 5. 用户与场景

说明谁会使用这个能力，在哪些场景使用。

## 6. Definition of Ready

- 需求来源已确认：
- 目标和非目标已确认：
- 第一版范围、基础安全底线和后续加固项已确认：
- 影响范围已确认：
- 权限、安全、审计和数据边界已确认：
- 前后端 / 测试分工已确认：
- 未确认问题已列出：

## 7. 业务规则

- 规则 1：
- 规则 2：

## 8. 接口或交互契约

说明请求、响应、权限、安全、审计和兼容性要求。

## 9. 需求追踪表

| 需求项 | 后端状态 | 前端状态 | 测试状态 | 文档位置 | 当前状态 |
| --- | --- | --- | --- | --- | --- |
| 需求 1 | Pending / Done / N/A | Pending / Done / N/A | Pending / Done / Blocked |  | Draft / Approved / Implemented |

## 10. 验收标准

- Given / When / Then：
- Given / When / Then：

## 11. 测试范围

- 单元测试：
- 集成测试：
- 手工验证：
- 本阶段未覆盖的高并发、安全加固、性能或可观测性验证：

## 12. Definition of Done

- 实现满足 Spec：
- 测试已运行或说明无法运行原因：
- 需求追踪表已更新：
- Project State 已更新：
- 接口、安全、权限、审计、集成契约已同步：
- 后续加固项已记录，不被误标为已完成：
- 无 Secret、真实数据、构建产物或无关本地变更：

## 13. 文档更新

完成后检查 Domain、Architecture、Workflow、ADR、Project State 是否需要更新。