thread-master/docs/product/brand-product-radar/tasks/T700-radar-product-api-contract-goctl.md

T700 — radar product api contract goctl

Status: done（2026-08-10）
Milestone: M0 · Phase A
Kind: feat · Est. change: ~180 lines

Goal

用 goctl 契約定義產品型 watch、ProductMatch、產品篩選、補綁與主推產品操作，所有新增 logic 在未實作前回明確 not-ready。

Depends on

• —

Inputs

• ../spec.md §5.1–§5.3
• apps/backend/generate/api/radar.api、m5.api、gateway.api
• 既有 ErrNotReady 回應語意與 AGENTS goctl 規則

Outputs

路徑	動作	說明
apps/backend/generate/api/radar.api	edit	新增 context、ProductMatch、filters、assign-product、primary-product、counters
apps/backend/internal/handler/**、internal/types/types.go	generated	只由 make gen-api 更新
apps/backend/internal/logic/radar/**	edit/add	新能力先回 not-ready，禁止空成功

Behavior

• Brand／Product 欄位必須成對；時間為 unix ns；列表使用 page/pageSize。
• 既有 response 欄位保持相容，matched_service 不移除。
• 所有路由只接受會員 JWT；provider token 不進 request 契約。

Out of scope

• watch／match 業務與 Mongo 寫入（T730 起）
• 前端型別（T702）

Acceptance

• goctl 後 backend 可 build，新增能力非 102000 空資料。
• 沒有手寫 handler 或 routes。

cd apps/backend && make gen-api && make build && go test ./internal/logic/radar/ -count=1

實作結果

• 新增 product context／ProductMatch／產品篩選契約與 assign-product、primary-product 路由。
• 新增 logic 目前回 radar capability not ready，由既有 response mapping 轉 HTTP 501／非 102000。
• 驗證：make gen-api、make build、go test ./... -count=1 全部通過。