64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# T117 — settings-ai-placement-api
|
||
|
||
> Status: `done`
|
||
> Milestone: `M1`
|
||
> Kind: `feat`
|
||
> Est. change: `~160 lines` (target 100–200)
|
||
|
||
## Goal
|
||
|
||
完成後系統應：get/save Ai、Placement、listModels；configured 無明文；platform_key_available
|
||
|
||
## Depends on
|
||
|
||
- T111
|
||
- T102
|
||
|
||
## Inputs
|
||
|
||
- 讀取 / 依賴：
|
||
- UI Settings；ST-01～04 ST-14～15
|
||
- Spec：`docs/product/haixun-backend/spec.md`（§9：ST-01～ST-04 ST-14 ST-15）
|
||
- 對照：`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/internal/**/settings/**` | add | Ai/Placement；etc 平台 key 注入 |
|
||
|
||
### 行為變更
|
||
|
||
- key 永不回明文
|
||
|
||
### API / 契約（若有）
|
||
|
||
- —
|
||
|
||
### 測試交付（強制）
|
||
|
||
- `TestST_01_NoRawKey`
|
||
|
||
## Out of scope
|
||
|
||
- 真 AI 呼叫（T152）
|
||
|
||
## Acceptance
|
||
|
||
- [ ] Spec／UI MUST 覆蓋：`ST-01～ST-04 ST-14 ST-15`
|
||
- [ ] 每個相關 §9 ID 有可 grep 的 case 名（`TestXX_01_…` 或完整覆蓋在里程碑 test task）
|
||
- [ ] 未實作不回 102000+空 data
|
||
- [ ] 指令：
|
||
|
||
```bash
|
||
cd apps/backend && go test ./internal/.../settings/... -count=1
|
||
```
|
||
|
||
## Notes
|
||
|
||
—
|