diff --git a/README.md b/README.md index ff5c3966..0efc66b5 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,9 @@ docker-compose.yml 生产 / 服务器 Compose → kuaishou-cloud / kuaishou-feifei / 人工 完成发货 后台 → 订单任务、平台配置、审计、人工复核 +接单平台(打手众包) + → 工单发布到抢单大厅,打手抢单代练 + → 提交验收 / 问题单处置 / 任务时限超时自动判定 ``` 更完整的链路说明见:`docs/履约配置/多发货平台与电子凭证整体链路.md`。 @@ -98,7 +101,7 @@ docker compose -f docker-compose.dev.yml exec -T frontend npm run build | 文件 | 含义 | | --- | --- | | `001_init.sql` | 空库基线,建立完整业务结构 | -| `002_xxx.sql` 起 | 后续结构变更的增量 SQL | +| `002_xxx.sql` ~ `009_xxx.sql` | 后续结构变更的增量 SQL(含接单平台 004~009) | 约定: @@ -206,15 +209,39 @@ bash deploy/ubuntu-deploy.sh | 路径 | 职责 | | --- | --- | | `apps/backend/src/routes` | 开放接口 / 领取 / 后台 API | +| `apps/backend/src/routes/worker` | 打手端 API(抢单大厅、我的订单、验收) | | `apps/backend/src/services/order` | 订单入库、商品匹配、任务同步 | | `apps/backend/src/services/fulfillment` | 履约路由与执行器(cloud / feifei / 人工) | +| `apps/backend/src/services/worker-platform` | 接单平台业务(工单、等级、押金结算、超时扫描) | | `apps/backend/src/services/platforms` | 外部平台对接 | | `apps/backend/src/services/admin` | 后台鉴权、读写、配置 | +| `apps/backend/src/services/scheduler` | 定时任务(云账号健康检查、工单超时扫描) | | `apps/backend/src/repositories` | 数据访问 | | `apps/backend/src/db/migrations` | 数据库迁移 | | `apps/frontend/src/pages/admin` | 管理后台页面 | +| `apps/frontend/src/pages/worker` | 打手端页面(大厅、我的订单、个人中心) | | `apps/frontend/src/pages/claim` | 用户领取页 | +## 接单平台(打手众包) + +用于将部分订单转为打手代练任务,与主履约流程解耦: + +| 能力 | 说明 | +| --- | --- | +| 抢单大厅 | 打手按分类/关键词筛选,实时刷新、冻结押金抢单;拼单工单按份参与 | +| 我的订单 | 代练中 / 待验收 / 问题单流转,提交验收支持图片粘贴与拖拽 | +| 任务时限 | 工单可配置时限,超时由定时扫描 + 接口惰性判定双重处置(退回大厅 / 取消退押金 / 取消扣押金),并统计每个打手的超时订单数 | +| 等级权限 | VIP 等级体系:免押额度、最大同时接单量、大厅可见延迟 | +| 资金 | 押金冻结 / 退还 / 扣除流水,充值申请与提现审核 | +| 物品规则 | 按商品/SKU 匹配自动生成工单,可继承默认时限与拼单配置 | +| 管理后台 | 接单工单 CRUD、打手审核、问题单处置、定时任务管理,功能标签页记忆上次选择 | + +说明: + +- 打手账号需后台审核后进入大厅;来源订单同步由物品规则驱动(`syncWorkerOrdersForSourceOrder`)。 +- 工单状态机独立于主履约任务:`pending_material → unassigned → open → in_progress → pending_acceptance → accepted / cancelled`,另有 `problem`。 +- 超时扫描定时任务默认 60 秒执行一次(配置见后台"平台配置 → 定时任务")。 + ## 提交前检查 ```bash