Files
hi-server/initialize/migrate/database
shanshanzhong147 a46fb83054 新功能(#3): 抽奖 Stage 1 handler 真实业务对接 + 邀请钩子
Closes HIF-3 (阶段 PR B)

PR B:handler 真实业务对接 + 邀请钩子(迭代含 R1 修复)

- 迁移 02157_lottery_grant_ledger:external_ref UNIQUE 作为发奖幂等键
- log.CommissionTypeLottery=339(架构师批准的新常量)
- DispatchRequest.IdempotencyKey(架构师 review 建议第 2 条)
- GrantLedger + LedgerService.Reserve:INSERT ON CONFLICT DO NOTHING 幂等 upsert
- VPNDurationHandler:ResolveEffectiveUser 归位家庭 owner + UpdateSubscribe,ExpireTime 三分支对齐 grantGiftDays
- CommissionHandler:UpdateCommission + WriteCommissionLog(339),发给中奖者本人,不做家庭组归位
- Handler 从 model 层迁到 logic 层(避免 model → logic 反向依赖);noop 保留在 model 层
- InviteHook:fire-and-forget 独立 goroutine + 10s timeout,扫 running 活动的 invite_success 源
- ServiceContext 新增 LotteryChance / LotteryLedger / LotteryInviteHook
- activateOrderLogic.handleCommission 两条分支通过 invokeInviteHookIfEligible 助手触发,助手内统一 gate IsNew(架构师 R1 打回后的修复)

架构师 R1 打回:branch B 未按"首次付款激活"gate,续费也会给 referer 发抽奖机会 → 已通过助手函数集中收拢,避免 branch A/B 判断漂移。

测试覆盖率:model 76.5% / handler 73.2% / hook 91.7%;补 4 个回归测试覆盖 IsNew 门槛(含关键的 DoesNotFireOnRenewal)。

线上仍零可见变更:无对外路由,钩子仅在活动 status=running 时生效,Stage 1 全流程无活动记录时 loadRunningActivities 返回空。
2026-07-08 21:19:28 -07:00
..
2025-04-25 12:08:29 +09:00
2026-05-19 19:35:44 -07:00
2025-04-25 12:08:29 +09:00
2025-04-25 12:08:29 +09:00
2025-04-25 12:08:29 +09:00
2025-04-25 12:08:29 +09:00
2025-04-25 12:08:29 +09:00
2025-04-25 12:08:29 +09:00
2025-08-15 12:30:21 -04:00
2025-08-15 12:30:21 -04:00
2026-01-05 17:53:31 +08:00
2026-01-06 16:16:42 +08:00
2026-01-06 16:16:42 +08:00
x
2026-03-08 22:37:58 -07:00
x
2026-03-08 22:37:58 -07:00
2026-03-19 03:21:47 -07:00
2026-03-19 03:21:47 -07:00
2026-03-19 03:21:47 -07:00
x
2026-05-26 10:02:38 -07:00