Files
rlz/docs/用户操作手册.md
renjianbo 805ed0298b feat: 新增多角色系统(派单/分润/推广/区域)
- 后端:RlzDispatch/Profit/Promotion/Region 控制器、服务、Mapper、领域模型
- 权限:MethodSecurityConfig + PermissionInterceptor
- 管理后台:派单/分润/推广/区域 页面与 API
- Android 陪护端:派单/运营/退款 Fragment 及布局
- 小程序:推广员子包、派单/运营/退款/检索子包、自定义 tabBar
- 文档:多角色系统方案、角色权限矩阵、用户操作手册等

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-10-12 00:09:45 +08:00

9.0 KiB
Raw Permalink Blame History

瑞来健康 — 用户操作手册

更新日期: 2026-06-08 适用版本: v2.0 多角色系统


目录

  1. 患者/客户 — 小程序端
  2. 陪诊师 — 小程序端 & Android App
  3. 推广员 — 小程序端
  4. 调度员 — 小程序端
  5. 客服专员 — 小程序端
  6. 运营经理 — 小程序端 & 管理后台
  7. 超级管理员 — 管理后台

1. 患者/客户 — 小程序端

适用角色: user_type=00 (默认注册用户)

1.1 注册与登录

  1. 打开微信小程序 "瑞来健康"
  2. 点击 "我的" → "登录/注册"
  3. 输入手机号 → 获取验证码 → 验证通过
  4. 首次登录自动创建账户, user_type=00

1.2 浏览与下单

  1. 首页: 查看医院列表和服务项目
  2. 搜索医院: 按区域/名称筛选
  3. 选择服务: 点击服务类型(全程陪诊/取报告/代问诊等)
  4. 下单:
    • 选择日期、时间段
    • 填写就诊人信息
    • 选择支付方式(微信支付)
    • 确认订单
  5. 支付: 调用微信支付完成付款

1.3 订单管理

状态码 状态名称 说明
0 待派单 支付成功, 等待分配陪诊师
1 已接单 陪诊师已接单
2 服务中 陪诊师已开始服务
3 待确认 服务完成待确认
4 已完成 服务已完成
5 申请退款 已提交退款申请
7 已退款 退款已完成
8 已结算 已完成结算

操作:

  • 查看订单: "我的" → "我的订单"
  • 查看详情: 点击具体订单进入详情页
  • 申请退款 (status=4 或 8 可见): 订单详情 → "申请退款" → 选择原因 → 提交
  • 退款进度: 订单详情查看退款状态

1.4 我的页面

  • 个人资料修改(头像、昵称)
  • 实名认证(陪诊服务需要)
  • 余额查看与提现
  • 联系客服

2. 陪诊师 — 小程序端和 Android App

适用角色: user_type=01 前置条件: 管理员在后台设置用户为陪诊师角色

2.1 小程序端

首页(陪诊师视图)

  • 待接单列表(status=0 且已派单给本人)
  • 进行中订单
  • 今日收入概览

订单操作流程

  1. 接单:

    • 收到新订单推送 → 进入订单详情
    • 点击 "接单" → 确认弹窗 → 状态变为 1 (已接单)
  2. 开始服务:

    • 到达约定地点 → 订单详情 → "开始服务" → 状态变为 2 (服务中)
  3. 完成服务:

    • 服务结束 → 订单详情 → "完成服务" → 状态变为 3 (待确认)
  4. 拒绝订单:

    • 无法接单 → "拒绝" → 输入原因 → 订单退回待派单

收入查看

  • "我的" → "收益明细" → 查看每笔服务费
  • "我的" → "余额" → 可提现到微信零钱

2.2 Android App

包名: com.ruoyi.peizhen

  1. 登录后根据 user_type 自动加载陪诊师界面
  2. 订单 Tab: 待接单 / 进行中 / 已完成 三个子 Tab
  3. 接单/拒单: 点击订单 → 操作按钮
  4. 开始/完成服务: 按状态流转操作
  5. 我的 Tab: 收入展示、余额、提现

3. 推广员 — 小程序端

适用角色: user_type=06

3.1 推广看板

底部 Tab "推广" → 进入 pages-promoter 子包:

  • 累计数据: 邀请人数、推广订单数、佣金总额
  • 今日概览: 今日新增邀请、今日佣金

3.2 我的团队

  • 查看一级/二级/三级下级推广员列表
  • 每人显示: 邀请人数、贡献佣金
  • 点击可查看该推广员的详细数据

3.3 佣金明细

  • 每笔佣金来源: 关联用户 + 订单号
  • 金额: 订单金额 × 推广比例(一级5%/二级3%/三级2%)
  • 状态: 待结算 / 已到账

3.4 分享邀请

  1. "推广" → "邀请好友"
  2. 系统自动生成唯一邀请码
  3. 分享方式:
    • 生成带邀请码的海报
    • 分享小程序卡片到微信群
    • 复制邀请链接发送

被邀请人通过链接注册后, 自动绑定推广关系。

3.5 提现

  • "我的" → "余额" → "提现"
  • 可选择提现到微信零钱
  • 提现记录可查看

4. 调度员 — 小程序端

适用角色: user_type=05

4.1 调度面板

底部 Tab "工作台" → 调度面板:

  • 待派单订单列表(status=0)
  • 按区域筛选
  • 超时未派单订单标红提醒

4.2 手动派单

  1. 点击待派单订单 → 进入调度详情
  2. 点击 "指派陪诊师"
  3. 弹出区域内空闲陪诊师列表
  4. 选择陪诊师 → 确认指派
  5. 订单状态变为 1(已接单), dispatch_type=manual

4.3 改派操作

  1. 已指派订单(status=1/2) → 点击 "改派"
  2. 选择新陪诊师 + 填写改派原因
  3. 确认 → 订单更新为新的 bId

4.4 派单历史

  • 查看自己经手的所有派单记录
  • 包括指派时间、订单状态

5. 客服专员 — 小程序端

适用角色: user_type=04

5.1 退款审核列表

底部 Tab "工作台" → 退款审核:

  • 所有 status=5 (申请退款) 的订单
  • 显示: 订单号、用户、金额、申请时间、退款原因

5.2 退款处理

通过退款:

  1. 点击订单 → "审核通过"
  2. 系统自动调用微信退款接口
  3. 状态: 5 → 6 (退款中) → 7 (已退款)
  4. 退款成功后, 自动回退分润记录

驳回退款:

  1. 点击订单 → "驳回"
  2. 填写驳回原因(必填)
  3. 状态: 5 → 4 (已完成), 驳回原因写入 remark
  4. 用户可在订单详情查看驳回原因

5.3 工单记录

  • 每笔工单记录处理人、处理时间、处理结果
  • 可在退款审核列表查看处理历史

6. 运营经理 — 小程序端和管理后台

适用角色: user_type=03

6.1 小程序端 — 运营看板

底部 Tab "工作台" → 运营看板(WebView 加载):

  • 本区域订单量、流水、陪诊师数、推广员数
  • 订单趋势图(按日/周/月)
  • 陪诊师服务排行
  • 推广效果排行

6.2 管理后台

登录地址: http://101.43.95.130:8050

运营经理可见菜单:

  • 推广管理: 查看所有推广员、推广关系、佣金记录
  • 区域管理: 查看本区域及下级区域数据
  • 调度管理: 查看调度面板和派单历史
  • 财务管理: 退款审核、结算管理、平台配置、分润记录
  • 运营看板: 区域数据汇总

6.3 区域数据

  • 只能查看本 region_id 及子区域的数据
  • 支持按时间范围筛选
  • 支持导出报表

7. 超级管理员 — 管理后台

适用角色: admin (role_id=1)

7.1 登录

  1. 访问 http://101.43.95.130:8050
  2. 输入账号密码 + 验证码
  3. 登录后进入管理后台首页

7.2 主要功能模块

系统管理

  • 用户管理: CRUD + 分配角色 + 设置 user_type
  • 角色管理: 角色 CRUD + 分配菜单权限
  • 菜单管理: 菜单树管理
  • 医院管理: 合作医院信息维护
  • 服务类型: 服务项目管理(含图标上传)
  • 区域管理: 省/市/区三级区域维护 + 绑定运营经理

推广管理

  • 推广员列表: 查看所有推广员及数据
  • 推广关系: 查看某推广员的上下级树
  • 佣金明细: 按推广员/时间/订单查看

调度管理

  • 调度面板: 待派单列表 + 手动指派 + 改派
  • 派单历史: 所有调度操作记录

财务管理

  • 退款审核: 待审核退款列表 + 通过/驳回
  • 结算管理: 待结算列表 + 单笔/批量结算
  • 分润记录: 全角色分润记录 + 筛选 + 汇总
  • 平台配置: 佣金比例/调度比例/运营比例/自动结算开关
  • 收益明细: 各角色收入流水

运营看板

  • 区域数据总览
  • 订单趋势图
  • 陪诊师服务排行
  • 推广效果排行

7.3 常用操作流程

新增陪诊师:

  1. 系统管理 → 用户管理 → 新增
  2. 填写基本信息 → user_type 选择 "01-陪诊师"
  3. 角色分配 → 保存

分配运营区域:

  1. 系统管理 → 区域管理 → 新增/编辑区域
  2. 选择 manager_id(运营经理)
  3. 运营经理登录后可看到本区域数据

处理退款:

  1. 财务管理 → 退款审核
  2. 查看 status=5 的订单
  3. 通过: 系统调微信退款 → status 5→6→7
  4. 驳回: 填写原因 → status 5→4

查看分润:

  1. 财务管理 → 分润记录
  2. 可按角色/订单/时间筛选
  3. 查看每个订单的分润分配详情

附录: 常见问题

Q: 注册后为什么看不到推广入口? A: 需要在管理后台将用户的 user_type 设置为 06(推广员), 并分配 promoter 角色。

Q: 陪诊师如何接单? A: 调度员手动指派后, 订单会出现在陪诊师的待接单列表。自动派单的订单直接进入陪诊师列表。

Q: 提现多久到账? A: 提现申请后由管理员审核结算, 通过微信企业付款到零钱, 一般 1-2 个工作日。

Q: 退出订单如何恢复? A: 客服驳回退款后, 订单状态恢复到"已完成"(4), 可正常结算。