Files
th-hotel-simple/docs/import/reusable/ai-native-templates/SPEC.template.md
T
2026-09-09 15:47:32 +08:00

86 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 是否需要更新。