优化readme

This commit is contained in:
yml2213
2026-08-02 08:38:35 +08:00
parent 9c0d43535e
commit 043dd3c128
+28 -1
View File
@@ -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