thread-master/docs/product/demand-radar/tasks/T572-conversion-report-writes-growth-outcomes.md

T572 — conversion-report-writes-growth-outcomes

Status: done
Milestone: M4
Kind: feat
Est. change: ~180 lines

Goal

完成後系統應：成交回報把階段轉 won 並寫入既有 growth_outcomes（source_type=radar_opportunity），成果彙總含這筆。

Depends on

• T568

Inputs

• Spec：../spec.md §4.6.6、§6、§9.4（CR-08）、§9.6（RG-03）
• 既有：apps/backend/internal/module/growth/**（OutcomeEvent／AttributionLink）、internal/logic/outcomes/**

Outputs

程式變更（預期路徑）

路徑	動作	說明
apps/backend/generate/api/crm.api	edit	conversion POST req／resp
apps/backend/internal/logic/crm/createContactConversionLogic.go	edit	驗證 → 轉 won → 寫 OutcomeEvent → 寫 conversion touch
apps/backend/internal/module/growth/domain/**	edit	新增 source_type=radar_opportunity 常數與 opportunity_id／contact_id 關聯欄位

行為變更

• 系統永不自動判定成交：只有此端點（人為操作）能寫成交。
• 金額選填（P0 以筆數為主），幣別預設 TWD；負數或非法幣別回明確錯誤。
• 不新增成交 collection；既有成果頁與彙總同時看到 radar 成交（RG-03）。

Out of scope

• 改／刪成交（T573）
• 金額維度統計（P1）

Acceptance

• CR-08：回報 12000 → 階段 won、growth_outcomes 有一筆 source_type=radar_opportunity、成果頁可見
• RG-03：既有歸因與成果卡行為不變
• 指令：

cd apps/backend && go test ./internal/logic/crm/... ./internal/module/growth/... -count=1