65 lines
1.5 KiB
Markdown
65 lines
1.5 KiB
Markdown
|
# T133 — worker-job-runner
|
|||
|
|
|
|||
|
|
> Status: `todo`
|
|||
|
|
> Milestone: `M2`
|
|||
|
|
> Kind: `feat`
|
|||
|
|
> Est. change: `~180 lines` (target 100–200)
|
|||
|
|
|
|||
|
|
## Goal
|
|||
|
|
|
|||
|
|
完成後系統應：worker 跑 demo job；進度單調；成功／失敗終態
|
|||
|
|
|
|||
|
|
## Depends on
|
|||
|
|
|
|||
|
|
- T106
|
|||
|
|
- T132
|
|||
|
|
|
|||
|
|
## Inputs
|
|||
|
|
|
|||
|
|
- 讀取 / 依賴：
|
|||
|
|
- JB-02～04；Redis lock=workerID
|
|||
|
|
- Spec：`docs/product/haixun-backend/spec.md`（§9：JB-02 JB-03 JB-04）
|
|||
|
|
- 對照：`docs/product/haixun-backend/fe-spec-alignment.md`（**UI MUST**）
|
|||
|
|
- 後端根：**`apps/backend`**
|
|||
|
|
- **Remove（本 task 禁止實作）：** 舊靈感 list/viral/bookmark/spark/searchTrends；generateFromFormula；ScoutTopic CRUD；live 以 simulate／createMock 當完成；Insights 真管線（P2）。
|
|||
|
|
|
|||
|
|
## Outputs
|
|||
|
|
|
|||
|
|
### 程式變更（預期路徑）
|
|||
|
|
|
|||
|
|
| 路徑 | 動作 | 說明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `apps/backend/cmd/worker/**` | edit | job runner |
|
|||
|
|
| `apps/backend/internal/**/job/**` | edit | guarded update |
|
|||
|
|
|
|||
|
|
### 行為變更
|
|||
|
|
|
|||
|
|
- worker 推進 pending→…→succeeded/failed
|
|||
|
|
|
|||
|
|
### API / 契約（若有）
|
|||
|
|
|
|||
|
|
- —
|
|||
|
|
|
|||
|
|
### 測試交付（強制）
|
|||
|
|
|
|||
|
|
- `TestJB_02_ProgressMonotonic`
|
|||
|
|
|
|||
|
|
## Out of scope
|
|||
|
|
|
|||
|
|
- outbox publish（T169）
|
|||
|
|
|
|||
|
|
## Acceptance
|
|||
|
|
|
|||
|
|
- [ ] Spec／UI MUST 覆蓋：`JB-02 JB-03 JB-04`
|
|||
|
|
- [ ] 每個相關 §9 ID 有可 grep 的 case 名（`TestXX_01_…` 或完整覆蓋在里程碑 test task）
|
|||
|
|
- [ ] 未實作不回 102000+空 data
|
|||
|
|
- [ ] 指令：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd apps/backend && go test ./internal/.../job/... -run Worker|Progress -count=1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Notes
|
|||
|
|
|
|||
|
|
—
|