bindbox-game/docs/任务中心/CONSENSUS_任务中心.md
邹方成 45815bfb7d chore: 清理无用文件与优化代码结构
refactor(utils): 修复密码哈希比较逻辑错误
feat(user): 新增按状态筛选优惠券接口
docs: 添加虚拟发货与任务中心相关文档
fix(wechat): 修正Code2Session上下文传递问题
test: 补充订单折扣与积分转换测试用例
build: 更新配置文件与构建脚本
style: 清理多余的空行与注释
2025-12-18 17:35:55 +08:00

1.1 KiB

共识文档:任务中心

明确的需求与验收

  • 三类任务均可正确识别达标并发奖;阶梯档位一次性触发。
  • 奖励入账:积分/券/卡/称号正确入账且库存扣减原子。
  • 幂等:同一档位同一事件不重复发放;日志可追溯。
  • 调度:能补偿漏发;生成进度快照与对账报表。

技术实现方案

  • 事件处理器:订阅OrderPaidInviteSuccess,更新UserTaskProgress并触发发奖。
  • 规则判定:TaskTiers定义阈值与窗口;或Tasks.conditions_schema存DSL。
  • 发奖:复用internal/service/user/reward_grant.go;按TaskRewards映射类型派发。
  • 日志:写入TaskEventLogs,包含idempotency_key与结果。

集成方案

  • 路由:新增/api/admin/task-center/api/app/task-center分组。
  • 与抽奖域互不耦合;奖励系统统一调用发奖服务。

边界与限制

  • 退款回滚进度但不回收奖励(可配置)。
  • 邀请有效性:注册且首单完成才计数;风控拦截异常。

验收标准

  • 性能指标达标;功能与日志完整;风控有效;调度可补漏。