thread-master/docs/product/growth-loop/tasks/T365-invite-reward-on-first-paid-plan.md

T365 — invite-reward-on-first-paid-plan

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

Goal

完成後系統應：直邀會員首次 free→starter|pro 成功時，邀請人得點（100/300）；月上限 50% 方案額度；狀態 credited|capped|skipped；僅單層、僅首次。

Depends on

• T301
• 既有 plan purchase 成功路徑（haixun-backend）

Inputs

• Spec：../spec.md §3.4、§4.5、IR-01～05
• 既有 invite parent_uid、usage plan

Outputs

路徑	動作	說明
apps/backend/internal/module/**/invite*/** 或 reward	add/edit	InviteReward
plan purchase logic	edit	hook

行為變更

• 續訂／再升級不發
• 延伸不發
• 調 parent 不回溯已發

Out of scope

• 現金／多層
• FE（T366）

Acceptance

• Spec：IR-01～IR-05
• 指令：

cd apps/backend && go test ./internal/... -run IR_0|InviteReward -count=1

Notes

—