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

T102 — single-etc-config

Status: done
Milestone: M0
Kind: feat
Est. change: ~100 lines (target 100–200)

Goal

完成後系統應：僅一份 etc/gateway.yaml；secret 可用 env 覆寫

Depends on

• T100

Inputs

• 讀取 / 依賴：
  • spec A-02；決策單 etc
  • Spec：docs/product/haixun-backend/spec.md（§9：A-02）
  • 對照：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/etc/gateway.yaml	add/edit	唯一主設定
apps/backend/README.md	edit	env 覆寫說明；禁止多份 dev/prod yaml 常態

行為變更

• etc 目錄無碎檔常態

API / 契約（若有）

• 平台 AI/Exa key 鍵位可先占位

測試交付（強制）

• 文件註明 env 覆寫

Out of scope

• 業務邏輯

Acceptance

• Spec／UI MUST 覆蓋：A-02
• 每個相關 §9 ID 有可 grep 的 case 名（TestXX_01_… 或完整覆蓋在里程碑 test task）
• 未實作不回 102000+空 data
• 指令：

test -f apps/backend/etc/gateway.yaml
ls apps/backend/etc | wc -l  # 應精簡

Notes

—