zfc/bindbox-game

邹方成 45815bfb7d chore: 清理无用文件与优化代码结构

refactor(utils): 修复密码哈希比较逻辑错误
feat(user): 新增按状态筛选优惠券接口
docs: 添加虚拟发货与任务中心相关文档
fix(wechat): 修正Code2Session上下文传递问题
test: 补充订单折扣与积分转换测试用例
build: 更新配置文件与构建脚本
style: 清理多余的空行与注释

2025-12-18 17:35:55 +08:00

1.4 KiB

Raw Blame History

接口文档：任务中心

管理端 `/api/admin/task-center`

POST /tasks 创建任务
GET /tasks 任务列表
GET /tasks/:id 任务详情
PUT /tasks/:id 修改任务
DELETE /tasks/:id 删除任务
POST /tasks/:id/tiers 批量创建/更新档位
GET /tasks/:id/tiers 档位列表
POST /tasks/:id/rewards 批量创建/更新奖励映射
GET /tasks/:id/rewards 奖励列表
GET /tasks/:id/progress 进度概览与发放统计
POST /events/order-paid 模拟订单支付事件
POST /events/invite-success 模拟邀请达成事件

APP端 `/api/app/task-center`

GET /tasks 任务列表与规则说明
GET /tasks/:id/progress 我的进度与已领奖档位
POST /tasks/:id/claim 手动领取（如启用），发奖走幂等
GET /rewards 我的奖励中心（可复用现有接口）

请求/响应示例

GET /tasks 响应：

{
  "tasks": [
    {"id":1,"name":"首日下单","status":1,"start_time":"...","end_time":"..."},
    {"id":2,"name":"完成N单阶梯","status":1}
  ]
}

GET /tasks/:id/progress 响应：

{
  "task_id":2,
  "metrics":{"order_count":3,"invite_count":0,"first_order":true},
  "claimed_tiers":[1],
  "next_tier":{"threshold":5}
}

管理端事件模拟:

POST /events/order-paid

{"user_id":1001,"order_id":90001}

POST /events/invite-success

{"inviter_id":1001,"invitee_id":2002}