角色与业务模块需求分解
项目名称： 千乘坊（ride-loop）
文档状态： 草稿
负责人：
主要读者： 产品 | 架构 | 开发 | 测试 | 运营
上游输入： PRD | 端形态与渠道策略 | 头脑风暴记录
下游输出： 详细需求拆解 | 模块边界 | 测试用例设计
关联 ID： REQ-001 - REQ-018, MOD-001 - MOD-012
最后更新： 2026-03-29
1. 角色清单
外部业务角色
| 角色 |
说明 |
主要使用端 |
| 乘客 |
购买商品、叫车、支付、售后 |
乘客微信小程序 |
| 司机-分销商 |
分享二维码、拉新、查看收益 |
司机微信小程序 |
| 司机-履约者 |
在线接单、行程执行、异常上报 |
司机独立 App |
| 司机-消费者 |
在司机专区消费刚需服务 |
司机微信小程序 |
| 商家/供应商 |
提供商品或服务履约 |
商家 Web/H5（条件性） |
内部运营角色
| 角色 |
说明 |
主要使用端 |
| 城市运营 |
管理商品、活动、司机、城市配置 |
运营管理 Web |
| 调度运营 |
监控派单、人工干预异常订单 |
运营管理 Web |
| 客服 |
处理乘客和司机咨询、投诉、售后 |
运营管理 Web |
| 财务/结算 |
对账、查台账、核退款和异常 |
运营管理 Web |
| 风控/审计 |
审查异常订单、异常司机、规则命中 |
运营管理 Web |
| 平台管理员 |
管权限、配置、日志与系统参数 |
运营管理 Web |
2. 业务模块总览
| 模块 ID |
模块名称 |
目标 |
MOD-001 |
gateway-api |
统一接入与 API 聚合 |
MOD-002 |
identity-driver |
统一账户、司机档案、权限 |
MOD-003 |
commerce |
商品、归因、商城与专区订单 |
MOD-004 |
ride-order |
叫车、行程订单、状态机 |
MOD-005 |
finance |
支付结算、佣金、钱包、券 |
MOD-006 |
dispatch-engine |
在线态、匹配、重派、接单 |
MOD-007 |
ops-admin |
后台配置、查询和人工干预入口 |
MOD-008 |
driver-access |
司机入驻、审核、能力启停、设备绑定 |
MOD-009 |
message-center |
站内消息、微信通知、App 推送 |
MOD-010 |
support-service |
客服工单、售后、申诉 |
MOD-011 |
risk-compliance |
风控、审计、规则留痕 |
MOD-012 |
analytics-insights |
经营看板与运营分析 |
3. 角色 x 模块矩阵
| 角色 |
关键模块 |
| 乘客 |
MOD-001, MOD-003, MOD-004, MOD-005, MOD-009, MOD-010 |
| 司机-分销商 |
MOD-001, MOD-003, MOD-005, MOD-008, MOD-009, MOD-010 |
| 司机-履约者 |
MOD-001, MOD-004, MOD-006, MOD-008, MOD-009, MOD-010 |
| 司机-消费者 |
MOD-001, MOD-003, MOD-005, MOD-009, MOD-010 |
| 商家/供应商 |
MOD-003, MOD-005, MOD-010, MOD-012 |
| 城市运营 |
MOD-003, MOD-005, MOD-007, MOD-008, MOD-011, MOD-012 |
| 调度运营 |
MOD-004, MOD-006, MOD-007, MOD-009 |
| 客服 |
MOD-003, MOD-004, MOD-005, MOD-007, MOD-009, MOD-010 |
| 财务/结算 |
MOD-005, MOD-007, MOD-010, MOD-011, MOD-012 |
| 风控/审计 |
MOD-006, MOD-007, MOD-008, MOD-011, MOD-012 |
4. 详细需求目录
REQ-001 统一账户与角色模型
- 支持乘客、司机、运营使用统一身份底座。
- 一个司机账户同时具备分销、履约、消费三类能力。
- 司机角色可按能力维度启停，不要求整体冻结。
- 后台可查看账户与司机档案映射关系。
REQ-002 司机入驻与审核
- 司机提交基础资料、车辆资料、营运/资质证明。
- 后台审核通过后，开放接单与分销能力。
- 审核动作需保留历史、备注和操作人。
- 司机被暂停接单时，可按规则保留分销和消费能力。
REQ-003 二维码归因与渠道管理
- 生成商品二维码、活动二维码、默认拉新二维码。
- 记录司机、渠道、城市、二维码来源和有效期。
- 乘客扫码后建立归因会话。
- 支持归因覆盖规则、失效规则和例外规则。
REQ-004 商城商品与商品履约
- 管理普通商城商品与司机专区商品两类目录。
- 支持城市维度商品上下架、库存和价格。
- 支持商品标签和活动关联。
- 支持履约状态追踪。
REQ-005 商城下单、支付与营销
- 乘客完成购物流程和支付。
- 支持优惠券、满减、活动价等基础营销。
- 支付成功后触发返佣结算。
- 退款时回收权益或生成逆向台账。
REQ-006 司机专区与站内复购
- 司机专区只对司机角色开放。
- 展示余额、返现券和即将过期权益。
- 下单时优先用券、再用余额。
- 专区订单可反查台账和券。
REQ-007 出行叫车、计价与订单创建
- 乘客在武汉发起叫车。
- 平台返回预估价格和等待时长。
- 行程订单记录城市、渠道和归因司机。
- 非服务区或无运力时返回明确原因。
REQ-008 派单调度与司机在线态
- 司机重端支持在线/离线切换。
- 系统实时记录司机位置和接单状态。
- 调度服务筛选候选司机并支持重派。
- 派单过程保留批次和响应记录。
REQ-009 行程履约与状态推进
- 司机完成接单、到达、开始、结束行程。
- 乘客查看司机、车辆和订单状态。
- 支持异常上报和取消判责。
- 行程结束后进入支付结算。
REQ-010 支付、退款与回调幂等
- 商城订单与行程订单均可支付。
- 支付回调和退款回调必须幂等。
- 支持支付流水查询与审计。
- 支持退款后回写订单和账务状态。
REQ-011 佣金、履约收益与站内钱包
- 分销佣金只在支付成功后入账。
- 出行订单支持履约司机与引流司机分开记账。
- 钱包只保存站内可消费权益，不支持提现。
- 余额通过台账聚合，支持负余额冲抵。
REQ-012 返现券与优惠权益
- 支持发券、核销、失效和过期提醒。
- 支持按订单、活动或运营策略发放。
- 券必须可追溯来源订单和规则。
- 支持区分使用范围。
REQ-018 司机返现券转赠
- 仅模板允许转赠且已过冻结期的返现券可发起转赠。
- 支持通过微信分享领取链接或手机号定向转赠给其他司机。
- 接收方必须是平台内已开通司机能力的账户。
- 转赠发起后需要锁券；取消、超时、领取、拒绝都必须留痕并可审计。
REQ-013 消息与触达
- 乘客接收商城和出行状态通知。
- 司机接收收益、券过期、拉新成交提醒。
- 履约司机接收派单、超时和异常处理提醒。
- 消息能力分为站内消息、微信通知、App 推送/语音播报。
REQ-014 客服、售后与申诉
- 乘客发起商城售后和出行投诉。
- 司机发起订单申诉、收益申诉和封禁申诉。
- 客服创建工单并关联订单、台账、司机、乘客。
- 处理过程保留状态和责任人。
REQ-015 调度运营与人工干预
- 查看在线司机、派单失败订单、重派情况。
- 支持人工指派、人工取消和临时停运。
- 支持查看司机在线活跃度和接单表现。
- 干预动作必须可审计。
REQ-016 风控、审计与合规
- 记录异常拒单、异常取消、虚假定位等风险线索。
- 记录异常退款、异常下单和规则变更。
- 对支付、台账、审核和人工干预保留审计日志。
- 支持按司机、订单、操作人追查链路。
REQ-017 数据分析与运营看板
- 拉新分析：扫码、归因、成交人数与金额。
- 出行分析：下单、接单、完单、取消。
- 资金分析：返佣、专区消费、负余额人数。
- 司机分析：活跃司机、接单司机、分销司机、复购司机。
5. 端与需求映射结论
- 只做微信小程序无法稳妥覆盖
REQ-008、REQ-009、REQ-013 的高可靠实时履约要求。
- 司机独立 App 是出行业务正式运营的关键端。
- 商家端是否单独建设，取决于第一版是否引入外部履约商家。
- 客服、财务、风控、调度运营第一版可以共用统一的运营管理 Web。
6. 对后续设计的要求
- 设计文档要把“司机轻端”和“司机重端”分开建模。
- 模块边界文档需补充商家履约、客服工单、调度人工干预和风控审计。
- API 设计需要增加司机 App 接口、后台人工干预接口、消息中心接口和券转赠接口。
7. 变更记录
| 日期 |
变更内容 |
变更人 |
| 2026-03-29 |
初始版本 |
|
| 2026-03-29 |
补充 REQ-018 司机返现券转赠需求 |
|