thread-master/docs/product/haixun-backend/tasks/T154-usage-plan-purchase-admin.md

T154 — usage-plan-purchase-admin

Status: todo
Milestone: M3
Kind: feat
Est. change: ~160 lines (target 100–200)

Goal

完成後系統應：purchasePlan、listMyPurchases、setMemberPrefs、tenant analytics 分序列

Depends on

• T150
• T115

Inputs

• 讀取 / 依賴：
  • UI Usage/Plans/Checkout/Admin；USG-10～14
  • Spec：docs/product/haixun-backend/spec.md（§9：USG-10 USG-11 USG-12 USG-13 USG-14 USG-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/**/usage/**	edit	plan purchase admin analytics

行為變更

• 假付款成功改 plan；analytics 分 platform/byok

API / 契約（若有）

• —

測試交付（強制）

• TestUSG_11_PurchasePlan

Out of scope

• 真金流 P2

Acceptance

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

cd apps/backend && go test ./internal/.../usage/... -run Plan|Purchase|Analytics -count=1

Notes

USG-15=listMyPurchases。