# 共识文档:任务中心 ## 明确的需求与验收 - 三类任务均可正确识别达标并发奖;阶梯档位一次性触发。 - 奖励入账:积分/券/卡/称号正确入账且库存扣减原子。 - 幂等:同一档位同一事件不重复发放;日志可追溯。 - 调度:能补偿漏发;生成进度快照与对账报表。 ## 技术实现方案 - 事件处理器:订阅`OrderPaid`、`InviteSuccess`,更新`UserTaskProgress`并触发发奖。 - 规则判定:`TaskTiers`定义阈值与窗口;或`Tasks.conditions_schema`存DSL。 - 发奖:复用`internal/service/user/reward_grant.go`;按`TaskRewards`映射类型派发。 - 日志:写入`TaskEventLogs`,包含`idempotency_key`与结果。 ## 集成方案 - 路由:新增`/api/admin/task-center`与`/api/app/task-center`分组。 - 与抽奖域互不耦合;奖励系统统一调用发奖服务。 ## 边界与限制 - 退款回滚进度但不回收奖励(可配置)。 - 邀请有效性:注册且首单完成才计数;风控拦截异常。 ## 验收标准 - 性能指标达标;功能与日志完整;风控有效;调度可补漏。