86 lines
1.6 KiB
Markdown
86 lines
1.6 KiB
Markdown
# Spec: <名稱>
|
||
|
||
> Status: `draft` | `approved`
|
||
> Source: `docs/product/<slug>/requirements.md`
|
||
> Last updated: `YYYY-MM-DD`
|
||
|
||
## 1. 摘要
|
||
|
||
<2–4 句，對齊需求 P0>
|
||
|
||
## 2. 名詞與實體
|
||
|
||
| 名詞 | 定義 |
|
||
|------|------|
|
||
| | |
|
||
|
||
## 3. 狀態機（若有）
|
||
|
||
```text
|
||
stateA --> stateB : 觸發條件
|
||
```
|
||
|
||
## 4. 使用者流程（行為）
|
||
|
||
### 流程 A：…
|
||
|
||
1. 使用者…
|
||
2. 系統…
|
||
3. 失敗時…
|
||
|
||
## 5. 介面契約
|
||
|
||
### 5.1 HTTP / API（若適用）
|
||
|
||
- Auth：
|
||
- Envelope：`code/message/data/error`
|
||
- 列表：`page` / `pageSize` → `pagination` + `list`
|
||
- 時間：unix nanoseconds UTC
|
||
|
||
| Method | Path | 用途 | 主要 request/response 欄位 |
|
||
|--------|------|------|---------------------------|
|
||
| | | | |
|
||
|
||
### 5.2 前端頁面 / 導覽（若適用）
|
||
|
||
| 路由 / hash | 目的 | 主要操作 |
|
||
|-------------|------|----------|
|
||
| | | |
|
||
|
||
### 5.3 Job / 背景任務（若適用）
|
||
|
||
| Template type | Worker | 觸發 | 成功結果 |
|
||
|---------------|--------|------|----------|
|
||
| | | | |
|
||
|
||
## 6. 與現況對照
|
||
|
||
| 能力 | Retain | Replace | Remove | 備註 |
|
||
|------|--------|---------|--------|------|
|
||
| | | | | |
|
||
|
||
## 7. 非功能
|
||
|
||
- 安全 / 權限：
|
||
- 錯誤碼 scope：
|
||
- 可觀測性（job 進度、錯誤訊息）：
|
||
- 效能邊界（可接受延遲 / 筆數上限）：
|
||
|
||
## 8. 資料保存（邏輯層，非 Mongo 細節亦可）
|
||
|
||
| 實體 | 關鍵欄位 | 生命週期 |
|
||
|------|----------|----------|
|
||
| | | |
|
||
|
||
## 9. 驗收場景（Given / When / Then）
|
||
|
||
1. **Given** … **When** … **Then** …
|
||
|
||
## 10. 開放規格問題
|
||
|
||
1.
|
||
|
||
## 11. 批准
|
||
|
||
- [ ] Spec 已批准：
|