thread-master/docs/product/haixun-backend/tasks/T102-single-etc-config.md

65 lines
1.4 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.

# T102 — single-etc-config
> Status: `done`
> Milestone: `M0`
> Kind: `feat`
> Est. change: `~100 lines` (target 100200)
## Goal
完成後系統應:僅一份 etc/gateway.yamlsecret 可用 env 覆寫
## Depends on
- T100
## Inputs
- 讀取 / 依賴:
- spec A-02決策單 etc
- Spec`docs/product/haixun-backend/spec.md`§9A-02
- 對照:`docs/product/haixun-backend/fe-spec-alignment.md`**UI MUST**
- 後端根:**`apps/backend`**
- **Remove本 task 禁止實作):** 舊靈感 list/viral/bookmark/spark/searchTrendsgenerateFromFormulaScoutTopic CRUDlive 以 simulatecreateMock 當完成Insights 真管線P2
## Outputs
### 程式變更(預期路徑)
| 路徑 | 動作 | 說明 |
|------|------|------|
| `apps/backend/etc/gateway.yaml` | add/edit | 唯一主設定 |
| `apps/backend/README.md` | edit | env 覆寫說明;禁止多份 dev/prod yaml 常態 |
### 行為變更
- etc 目錄無碎檔常態
### API / 契約(若有)
- 平台 AI/Exa key 鍵位可先占位
### 測試交付(強制)
- 文件註明 env 覆寫
## Out of scope
- 業務邏輯
## Acceptance
- [ ] SpecUI MUST 覆蓋:`A-02`
- [ ] 每個相關 §9 ID 有可 grep 的 case 名(`TestXX_01_…` 或完整覆蓋在里程碑 test task
- [ ] 未實作不回 102000+空 data
- [ ] 指令:
```bash
test -f apps/backend/etc/gateway.yaml
ls apps/backend/etc | wc -l # 應精簡
```
## Notes