邹方成
45815bfb7d
refactor(utils): 修复密码哈希比较逻辑错误 feat(user): 新增按状态筛选优惠券接口 docs: 添加虚拟发货与任务中心相关文档 fix(wechat): 修正Code2Session上下文传递问题 test: 补充订单折扣与积分转换测试用例 build: 更新配置文件与构建脚本 style: 清理多余的空行与注释
26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# 共识文档：任务中心
|
|
|
|
## 明确的需求与验收
|
|
- 三类任务均可正确识别达标并发奖；阶梯档位一次性触发。
|
|
- 奖励入账：积分/券/卡/称号正确入账且库存扣减原子。
|
|
- 幂等：同一档位同一事件不重复发放；日志可追溯。
|
|
- 调度：能补偿漏发；生成进度快照与对账报表。
|
|
|
|
## 技术实现方案
|
|
- 事件处理器：订阅`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`分组。
|
|
- 与抽奖域互不耦合；奖励系统统一调用发奖服务。
|
|
|
|
## 边界与限制
|
|
- 退款回滚进度但不回收奖励（可配置）。
|
|
- 邀请有效性：注册且首单完成才计数；风控拦截异常。
|
|
|
|
## 验收标准
|
|
- 性能指标达标；功能与日志完整；风控有效；调度可补漏。
|
|
|