即时配送（跑腿）小程序

完整需求 · 页面线稿 · 交互框架 · 功能清单 · 数据库 · 接口

表前缀 ot_ · 用户端 + 配送员端 + 管理后台
Phase 1-3 核心功能 | Phase 4-6 可选扩展
📌 文档快捷菜单 📐 阶段与技术·详情 📊 数据·接口·ER 详情 🤖 AI 能力完整页

📋 开发阶段与技术架构迭代（总览）

将商务阶段、工时区间与技术栈/部署演进放在同一屏对照；更细的分阶段业务架构大图、拆解说明见 phase_tech_detail.html（亦在下方「文档导航」中可点）。

Phase 1 核心跑腿+财务
用户端+骑手端+管理后台+财务管理
P0 优先级
3.95～5.90 万
Phase 2 会员营销
红包+积分+商城
P1 优先级
1.25～1.75 万
Phase 3 实时定位
骑手GPS+监控
P1 优先级
1.10～1.50 万
Phase 4 站点仓储
入库+出库+库存
P2 优先级
1.20～1.65 万
Phase 5 物流跟踪
运单+节点(可选方案)
P2 优先级
1.05～1.50 万
Phase 6 司机APP
独立APP(可选)
可选
2.00～2.75 万
当前分析范围：Phase 1 核心业务 + Phase 2 会员营销（Phase 3 已部分覆盖）
待专项讨论：站点仓储（Phase 4）/ 物流跟踪方案（Phase 5）/ 车辆定位方案选择 / 是否需要独立司机APP（Phase 6）
⏱️ 各阶段工时与费用（暂估 · 非最终报价）
计算公式：费用（万元）= 人天 × 单价（万元/人天）
当前单价参考：500 元/人天（0.05 万/人天）
下表为便于排期与沟通的参考区间，最终以需求定稿及合同为准。业务模式（租户数、站点数、代理层级）变化会导致区间浮动。
后端语言 Phase 1 全程使用 Node.js（egg/nest/fastify 按需选型）。
Phase 1 核心跑腿+财务
39,500～59,000 元
79～118 人天 × 500元
Phase 2 会员营销
11,500～16,000 元
23～32 人天 × 500元
Phase 3 实时定位
10,500～15,000 元
21～30 人天 × 500元
Phase 4 站点仓储
11,000～16,000 元
22～32 人天 × 500元
Phase 5 物流跟踪
10,000～14,500 元
20～29 人天 × 500元
Phase 6 司机APP
17,500～25,000 元
35～50 人天 × 500元
6阶段合计（参考总价）
99,500～145,500 元
200～291 人天 × 500元
阶段 模块 人天
Phase 1
核心跑腿
+财务		👤 用户端小程序（首页、寄件下单、订单列表/详情、运单查询、地址簿、登录授权）12～16
🛵 配送员端（任务大厅、任务详情、登录、钱包、提现）6～8
⚙️ 管理后台（登录、仪表盘、订单调度、骑手管理、站点管理、数据统计）12～16
💰 财务管理（账单管理、提现审核、对账报表、骑手结算管理）6～8
🖥️ 后端 API·Node.js（用户/订单/骑手/站点/支付，基础框架、权限、ORM）18～25
💳 支付模块（微信支付对接、支付回调、钱包余额、充值/提现、退款申请）8～12
🗄️ 数据库设计与初始化（exp_/ot_ 表、租户隔离、基础数据）5～7
🚀 部署·CI/CD（Docker、Nginx、GitHub Actions、测试环境）6～8
🔗 前后端联调 + 接口测试 + 埋点验收5～8
🧠 地址自动识别（输入/粘贴 string → AI/NLP 解析为省市区+门牌，自动回填寄件人/收件人表单）3～5
📦 项目 Buffer（需求变更、紧急修复、验收沟通）3～5
Phase 1 合计：79～118 人天 → 39,500～59,000 元
Phase 2
会员营销		🎟️ 优惠券系统（领券/用券/兑换码/过期回收；订单/支付页联动）6～8
💎 会员等级与权益（成长值/积分/免邮次数/折扣；会员福利展示页）6～8
🛒 积分商城（商品列表/兑换/发货）；红包体系（分享/满减/限品类）6～8
🔗 前后端联调 + 支付/订单联动测试3～5
📦 项目 Buffer2～3
Phase 2 合计：23～32 人天 → 11,500～16,000 元
Phase 3
实时定位		📍 骑手 GPS 追踪（小程序定位 SDK、静默上报、WebSocket 推送）6～9
🗺️ 配送全路线地图（用户端轨迹展示；高德/腾讯地图 JS SDK 集成）5～7
📡 管理后台骑手位置监控；调度应用（就近指派/轨迹回放）5～7
🔗 前后端联调 + 地图/定位服务联测3～4
📦 项目 Buffer2～3
Phase 3 合计：21～30 人天 → 10,500～15,000 元
Phase 4
站点仓储		📦 入库扫描 + 入库单确认（扫码枪/小程序；重量/体积记录）6～9
📤 出库扫描 + 出库单；库存盘点；库存预警（低库存/过期提醒）6～8
🏭 仓库管理（库区/库位/批次）；后台仓储统计报表5～7
🔗 前后端联调 + 扫码设备联测3～5
📦 项目 Buffer2～3
Phase 4 合计：22～32 人天 → 11,000～16,000 元
Phase 5
物流跟踪		🔗 运单生成与全链路节点推送（揽件→中转→派送→签收，事件驱动）6～9
🚚 物流信息查询（用户端/管理端；节点状态时间轴；快递公司接口对接）5～7
📊 后台物流管理（运单查询/异常登记/状态更正/统计）4～6
🔗 前后端联调 + 第三方快递接口联测3～4
📦 项目 Buffer2～3
Phase 5 合计：20～29 人天 → 10,000～14,500 元
Phase 6
司机APP		🚗 司机端小程序（独立 APP 形式；登录/任务大厅/任务详情/导航/结算）15～22
🔌 司机端与主系统接口对接（计价/结算/发票/提现）；管理后台司机管理12～16
🔗 前后端联调 + 地图导航联测 + 支付/结算流程测试5～7
📦 项目 Buffer3～5
Phase 6 合计：35～50 人天 → 17,500～25,000 元

技术架构与迭代方案（与上表阶段对照）

🚀 技术栈演进
阶段后端语言优势适用场景日订单量
Phase 1-2Node.js（egg/nest/fastify）前后端同语言/生态丰富MVP/快速验证<10,000
Phase 3-4Python + Go高并发/性能中等规模/增长期10,000-100,000
Phase 5-6Go + Java集群/高可用大规模/企业级>100,000
🔧 Node.js 扩展能力说明

Phase 1-2 全程使用 Node.js，并非只能局限在单点部署。以下是 Node.js 的扩展路径：

📌 Node.js 迭代扩展路线
阶段扩展方式说明
Phase 1 单点基础架构Nginx 负载均衡 + 多 API 节点 + MySQL 主从 + Redis
垂直扩展代码层面模块化设计、微服务雏形预留（按业务拆分模块目录）
水平扩展集群部署多节点 Node.js 无状态部署，通过 Nginx/负载均衡分发请求
RPC 集群高负载拆分使用 gRPC 将高负载业务（如：订单处理、支付回调、GPS 数据采集）拆分为独立集群，Node.js 作为轻量 API 网关统一接入
混合架构渐进演进Node.js 承担：用户端 API、订单查询、营销活动；Go/Python 承担：实时计算、地图路径规划、音视频处理
⚡ RPC 调用实现高负载业务集群
🎯 适用 RPC 拆分的场景
• 订单高并发下单（10,000+/日）
• GPS 位置实时上报（骑手轨迹）
• 支付回调与对账
• 短信/推送大批量发送
• 报表统计与数据分析
🔌 技术选型
gRPC（推荐）：高性能二进制传输、双向流、服务发现（ETCD）

Thrift：多语言支持、成熟稳定

Node.js 侧：@grpc/grpc-js 或 @nestjs/microservices
🏗️ 部署架构示意
Nginx → Node.js API 网关
↓ gRPC
订单集群(Go) / GPS集群(Node) / 支付集群(Go)
各集群独立扩缩容，按需增减节点
💡 结论：Node.js 在 Phase 1-2 完全可以支撑 MVP 快速交付；随着订单量增长，可通过无状态水平扩展和RPC 调用拆分高负载业务平滑演进到 Phase 3-4 的混合架构，无需推倒重来。
🖥️ Phase 1 单点部署
架构：负载均衡 + 多API节点 + 单DB
组件：
Nginx → API×2 → MySQL主从
                 → Redis
                 → MinIO
配置：2核4G×2 + 2核4G MySQL
⚙️ Phase 3 集群部署
架构：微服务 + RPC + K8s
新增：
gRPC + ETCD 服务发现
Kafka 消息队列
Jaeger 链路追踪
Docker + K8s 编排
服务拆分：用户/订单/骑手/支付/营销
🌐 Phase 5+ 多集群
架构：多地域/多集群
组件：
Kong/APISIX 网关
Kafka 数据总线
TiDB 分布式数据库
ES + ClickHouse 分析
部署：同城双活/两地三中心
📡 RPC 框架选择
框架语言优势适用场景
gRPC多语言高性能/二进制/双向流服务间通信（推荐）
Thrift多语言成熟/广泛跨语言调用
DubboJava生态完善/SpringJava技术栈
🛠️ 自动化 DevOps
CI/CD
GitLab CI
容器
Docker
编排
K8s
监控
Prometheus
日志
ELK/Loki
追踪
Jaeger
⚠️ 技术债务与风险
阶段风险应对措施
Phase 1→2单体架构扩展性差预留模块化设计
Phase 2→3Python GIL限制关键路径迁移Go
Phase 3→5数据库单点分库分表
高并发下单压力排队/限流/缓存
数据安全支付安全第三方支付/对账
📎 分阶段业务架构 · 详情入口
各 Phase 的领域边界、系统间调用与数据落点在总览页仅以表格呈现；更细的Mermaid 业务架构图（Phase 1～6 各一张）、迭代对照与延伸阅读在独立页维护，便于打印与单独评审。
打开 phase_tech_detail.html → 直达 Phase 1 架构图 | 技术参考 tech_reference.html

📑 文档导航

★ 快捷菜单 线 可交互线稿 ▸ 阶段与技术详情 📊 数据接口ER详情 AI 完整页
0 阶段+技术总览 0b 技术小节锚点 1 页面线稿 2 交互框架 3 功能清单 4 数据库摘要 5 接口摘要 6 流程图 7 数据·接口·ER详情 8 AI摘要

📊 核心数据统计

40+
业务表
120+
API接口
40+
页面
6
开发阶段

一、页面线稿（可交互原型）

以下嵌入 structurepages/ 目录下的实际线稿 HTML，点击页面按钮切换查看。

📱 用户端页面
1.2 首页 1.1 寄件下单 1.10 寄快递 1.3 订单列表 1.4 订单详情 1.5 会员福利 1.6 我的 1.7 优惠券 1.8 运单查询 1.9 地址簿 1.11 钱包 8.1 投诉建议
🏍️ 配送员端页面
2.0 骑手首页 2.2 订单大厅 2.1 任务详情 2.3 任务列表 2.4 骑手钱包
🖥️ 管理后台页面
3.1 订单与调度 3.3 配送员管理 3.4 会员管理 3.5 红包管理 3.1 仓储入库
📋 查看所有线稿页面 →

二、交互框架（带注解流程图）

箭头上的文字为交互注解；与线稿章节对应，便于评审与原型对照。

📱 用户端交互流程
flowchart TD U1[首页] -->|选择服务类型| U2[发单页] U2 -->|填写发件人| U3[发件人信息] U3 -->|填写收件人| U4[收件人信息] U4 -->|类型重量备注| U5[物品信息] U5 -->|系统试算| U6[费用明细] U6 -->|选择可用红包| U7[红包抵扣] U7 -->|选择优惠券| U8[优惠后应付] U8 -->|余额或微信支付| U9[支付下单] U9 -->|等待骑手接单| U10[待接单] U10 -->|推送已接单| U11[订单详情与地图] U11 -->|到货确认| U12[确认签收] U12 -->|可选| U13[评价与积分]
🏍️ 配送员端交互流程
flowchart TD R1[打开端] -->|自动上报位置| R2[订单大厅] R2 -->|浏览卡片| R3[订单详情] R3 -->|确认地址与费用| R4[抢单] R4 -->|一键导航| R5[前往取件点] R5 -->|电话联系发件人| R6[确认取件] R6 -->|持续上报| R7[配送中] R7 -->|电话联系收件人| R8[确认送达] R8 -->|结算| R9[收入到账]

→ 完整骑手端流程（phase_tech_detail.html）

🖥️ 管理后台交互流程
flowchart TD subgraph SD["调度派单链"] direction LR D1[调度中心] -->|地图与骑手列表| D2[待调度订单] D2 -->|按位置状态负载| D3[选择骑手] D3 -->|推送并更新状态| D4[派单完成] end subgraph OP["运营与财务链"] direction LR M1[订单管理] -->|筛选导出| M2[配送员管理] M2 -->|审核统计定位| M3[红包与会员] M3 -->|创建发放配置| M4[财务管理] end D4 -.->|业务并行| M1

→ 完整管理后台架构（phase_tech_detail.html）

三、功能清单

📱 用户端功能
模块功能点
首页定位城市+搜索
帮我送/买/办入口
分类图标
活动Banner
常用地址
进行中订单
发单发件人信息
收件人信息
物品信息
保价服务
红包抵扣
优惠券+支付
订单订单列表（6状态）
订单详情
地图追踪
联系骑手
催单/取消
会员等级+成长值
积分余额+明细
积分商城
红包+优惠券
我的钱包+充值
地址管理
客服+帮助
🏍️ 配送员端功能
模块功能点
首页今日收入
订单统计
待抢订单数
我的订单入口
当前位置
大厅待抢订单列表
订单卡片
地图预览
抢单
任务待取货
配送中
一键导航
确认取件
确认送达
钱包累计收益
账户余额
提现申请
提现记录
位置GPS定位
30秒上报
位置设置
🖥️ 管理后台功能
模块功能点
调度骑手状态统计
实时地图
骑手列表
待调度订单
派单/撤回
订单订单列表
订单详情
导出+取消
重新指派
配送员骑手列表
审核认证
统计
定位查看
会员用户列表
等级配置
积分规则
商城管理
红包创建红包
发放方式
发放记录
财务账单管理
提现审核
佣金统计

四、数据库设计（摘要）

表前缀 ot_。逐表字段、索引与多租户扩展以详情页为准。

🗃️ 数据资产统计
40+
业务表
（含扩展域）
9
大类
订单/配送/会员/营销/钱包/站点/车/仓/物流
9
通用字段
tenant/agent/station 审计与软删
核心主线：ot_order 聚合用户下单与状态；ot_courier* 承载运力与轨迹；会员/红包/积分与订单通过 user_id、order_id 外键关联。仓储与物流表在 Phase 4～5 启用。
打开详情：字段与表 → database_schema.html database_schema_detail.md

五、API 接口（摘要）

🔌 接口规模统计
120+
接口总量
（规划口径）
3
端维度
用户 / 骑手 / 管理
REST
JSON + JWT
幂等键/分页约定
用户侧重下单、支付回调、订单与会员；骑手侧重大厅、抢单、位置上报与钱包；管理侧重调度、审核、导出与营销配置。路径前缀可与网关统一为 /app/*、/admin/*（实施以 openapi 为准）。
打开详情：接口分层与示例 → api_list.html api_list.md

六、业务流程图

📊 端到端流程
flowchart TD A[用户下单] --> B[支付订单] B --> C[推送骑手] C --> D[骑手抢单] D --> E[确认取件] E --> F[配送中·位置上报] F --> G[确认送达] G --> H[用户确认·评价]

→ 完整端到端流程（phase_tech_detail.html）

📦 仓储物流流程
flowchart TB subgraph IN[入库流程] I1[供应商发货] --> I2[到达站点] I2 --> I3[扫描签收] --> I4[物品录入] --> I5[分拣上架] --> I6[入库完成] end subgraph OUT[出库流程] O1[出库申请] --> O2[审核] --> O3[拣货] --> O4[打包] --> O5[装车] --> O6[出库] end subgraph TRANS[物流中转] T1[始发站] --> T2[中转站] --> T3[目的站] --> T4[派送] --> T5[签收] end I6 --> O1 O6 --> T1

→ 完整仓储架构图（phase_tech_detail.html）

🔄 订单状态机
stateDiagram-v2 (( * )) --> 待支付 待支付 --> 待接单:支付 待支付 --> 已取消:取消 待接单 --> 已接单:抢单 待接单 --> 已取消:取消 已接单 --> 配送中:取件 已接单 --> 待接单:骑手取消 配送中 --> 已送达:送达 配送中 --> 待接单:异常取消 已送达 --> 已完成:确认 已送达 --> 已评价:评价 已完成 --> (( * )) 已评价 --> (( * )) 已取消 --> (( * ))

→ 完整状态机（phase_tech_detail.html）

🔄 物流运单状态机
stateDiagram-v2 (( * )) --> 已发货 已发货 --> 运输中:到达网点 运输中 --> 到达:到达目的站 运输中 --> 运输中:中转 到达 --> 派送中:开始派送 派送中 --> 已签收:客户签收 派送中 --> 拒收:客户拒收 已签收 --> (( * )) 拒收 --> (( * ))

→ 完整物流状态机（phase_tech_detail.html）

🔗 ER 关系（不在此页展开）
15+
核心实体关系
用户·订单·运力·营销
Mermaid
可维护图源
+ 扩展域关联
打开详情：ER 关系大图 → database_er.html（含静态图）

七、技术架构（索引）

技术栈演进、部署形态、RPC、DevOps、风险表已移至文档开头 #tech（与阶段工时同屏）。分阶段业务架构大图见 phase_tech_detail.html。

八、LLM / RAG 能力拓展（可选 · 摘要）

完整方案与后续迭代路线图
后续升级的 AI 能力、流程图、成本表、AI-1～AI-5 迭代路线已独立维护在 ai_capabilities.html。LLM/RAG 调取权限（JWT/API Key）、rag_plan 与配额、按用户/角色路由不同模型及多路由器降本见同页 第三节 · 权限与多路由。Markdown 详述见 requirements_v2.md 第十二章。
打开 AI 完整页面 → 权限 · 配额 · 多模型路由 →
🤖 定位与原则
AI 适合作为客服、知识问答、运营辅助；订单支付、库存事务、调度锁单仍由传统后端保证一致性与安全。
📌 可落地功能
能力说明收益工作流程架构图工时
智能客服 + RAG FAQ/政策检索 + 生成回答 降客服人力、24h 响应 查看 查看 15-25人天
订单状态自然语言查询 NL→受控 API（鉴权后查库） 用户体验提升 查看 查看 8-12人天
运营报表问答 RAG + 指标 API（禁直连写库） 站长/老板自助看数 查看 查看 10-15人天
仓储 SOP 引导 入库出库话术与步骤提示 培训成本下降 查看 查看 8-12人天
评价情感分析 批量打标与预警 舆情与体验管理 查看 查看 6-10人天
查看详细工时汇总 →
🔄 客服 RAG 简流程
flowchart LR Q[用户提问] --> A[鉴权绑定用户] A --> B[向量检索 FAQ] B --> C[LLM 生成回答] C --> D{"置信度判断"} D -->|"高"| E[返回答案] D -->|"低"| F[转人工+附片段]

→ 完整 RAG 架构（ai_capabilities.html）

成本提示：除一次性集成开发外，需预算模型 Token、向量库与知识库运维；可与 Phase 2～3 后独立迭代，不阻塞核心上线。
📈 后续迭代一览（详见完整页）
代号目标说明
AI-1客服 RAG MVPFAQ + 检索 + 转人工
AI-2会话摘要写入工单
AI-3自然语言查单受控 API
AI-4运营报表问答指标 API + RAG
AI-5仓储 SOP / 多模态（可选）依赖 Phase 4
完整表格与流程图见 ai_capabilities.html

九、支付与财务管理（独立报价）

💰 Phase 1 已含基础财务 · 以下为增强包
Phase 1 已包含：基础支付流程、钱包余额、充值/提现、退款申请、管理端账单管理、提现审核、骑手结算。
以下模块为可选增强包，可独立报价。包含详细时序图、架构设计、数据表结构、页面线稿及工时估算。
💳 支付核心设计 → 🔄 退款售后设计 → 📊 对账报表设计 → 🧾 发票管理设计 → 💰 结算分账设计 → 🔐 安全合规设计 →
📱 新增页面线稿
类型文件说明
用户端1.12-用户-退款申请.html退款原因选择、退款金额展示、退款确认弹窗
管理端admin-3.10-财务管理.html账单管理、提现审核、充值记录、对账报表、发票管理
admin-3.11-结算管理.html骑手结算报表、分润记录、打款弹窗
💰 支付与财务模块工时汇总
模块功能点工时(人天)
支付核心支付流程设计+微信支付对接+回调处理+幂等保证+超时关单8-12
退款系统退款流程+状态机+API+数据库+管理端退款审核5-8
对账报表日对账方案+财务报表+数据表+导出功能6-10
发票管理发票申请+开票流程+API+管理端+数据库5-7
骑手结算结算规则+分账方案+微信分账API+数据库8-12
安全合规支付密码+风控规则+权限控制+日志审计5-8
页面线稿财务管理+结算管理+退款申请页面+弹窗4-6
合计41-63 人天
报价说明：支付模块属于核心高安全模块，建议报价系数 ×1.3。AI能力（47-79人天）可独立报价。支付+AI 合计：88-142 人天
即时配送小程序 · 快捷菜单 · 阶段与技术 · 数据·接口·ER · AI完整页
维护：项目团队 | 更新：2026-04-01 | 详版 requirements_v2.md