- 后端:RlzDispatch/Profit/Promotion/Region 控制器、服务、Mapper、领域模型 - 权限:MethodSecurityConfig + PermissionInterceptor - 管理后台:派单/分润/推广/区域 页面与 API - Android 陪护端:派单/运营/退款 Fragment 及布局 - 小程序:推广员子包、派单/运营/退款/检索子包、自定义 tabBar - 文档:多角色系统方案、角色权限矩阵、用户操作手册等 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
9.0 KiB
9.0 KiB
瑞来健康 — 用户操作手册
更新日期: 2026-06-08 适用版本: v2.0 多角色系统
目录
- 患者/客户 — 小程序端
- 陪诊师 — 小程序端 & Android App
- 推广员 — 小程序端
- 调度员 — 小程序端
- 客服专员 — 小程序端
- 运营经理 — 小程序端 & 管理后台
- 超级管理员 — 管理后台
1. 患者/客户 — 小程序端
适用角色: user_type=00 (默认注册用户)
1.1 注册与登录
- 打开微信小程序 "瑞来健康"
- 点击 "我的" → "登录/注册"
- 输入手机号 → 获取验证码 → 验证通过
- 首次登录自动创建账户, user_type=00
1.2 浏览与下单
- 首页: 查看医院列表和服务项目
- 搜索医院: 按区域/名称筛选
- 选择服务: 点击服务类型(全程陪诊/取报告/代问诊等)
- 下单:
- 选择日期、时间段
- 填写就诊人信息
- 选择支付方式(微信支付)
- 确认订单
- 支付: 调用微信支付完成付款
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 (已接单)
-
开始服务:
- 到达约定地点 → 订单详情 → "开始服务" → 状态变为 2 (服务中)
-
完成服务:
- 服务结束 → 订单详情 → "完成服务" → 状态变为 3 (待确认)
-
拒绝订单:
- 无法接单 → "拒绝" → 输入原因 → 订单退回待派单
收入查看
- "我的" → "收益明细" → 查看每笔服务费
- "我的" → "余额" → 可提现到微信零钱
2.2 Android App
包名: com.ruoyi.peizhen
- 登录后根据 user_type 自动加载陪诊师界面
- 订单 Tab: 待接单 / 进行中 / 已完成 三个子 Tab
- 接单/拒单: 点击订单 → 操作按钮
- 开始/完成服务: 按状态流转操作
- 我的 Tab: 收入展示、余额、提现
3. 推广员 — 小程序端
适用角色: user_type=06
3.1 推广看板
底部 Tab "推广" → 进入 pages-promoter 子包:
- 累计数据: 邀请人数、推广订单数、佣金总额
- 今日概览: 今日新增邀请、今日佣金
3.2 我的团队
- 查看一级/二级/三级下级推广员列表
- 每人显示: 邀请人数、贡献佣金
- 点击可查看该推广员的详细数据
3.3 佣金明细
- 每笔佣金来源: 关联用户 + 订单号
- 金额: 订单金额 × 推广比例(一级5%/二级3%/三级2%)
- 状态: 待结算 / 已到账
3.4 分享邀请
- "推广" → "邀请好友"
- 系统自动生成唯一邀请码
- 分享方式:
- 生成带邀请码的海报
- 分享小程序卡片到微信群
- 复制邀请链接发送
被邀请人通过链接注册后, 自动绑定推广关系。
3.5 提现
- "我的" → "余额" → "提现"
- 可选择提现到微信零钱
- 提现记录可查看
4. 调度员 — 小程序端
适用角色: user_type=05
4.1 调度面板
底部 Tab "工作台" → 调度面板:
- 待派单订单列表(status=0)
- 按区域筛选
- 超时未派单订单标红提醒
4.2 手动派单
- 点击待派单订单 → 进入调度详情
- 点击 "指派陪诊师"
- 弹出区域内空闲陪诊师列表
- 选择陪诊师 → 确认指派
- 订单状态变为 1(已接单), dispatch_type=manual
4.3 改派操作
- 已指派订单(status=1/2) → 点击 "改派"
- 选择新陪诊师 + 填写改派原因
- 确认 → 订单更新为新的 bId
4.4 派单历史
- 查看自己经手的所有派单记录
- 包括指派时间、订单状态
5. 客服专员 — 小程序端
适用角色: user_type=04
5.1 退款审核列表
底部 Tab "工作台" → 退款审核:
- 所有 status=5 (申请退款) 的订单
- 显示: 订单号、用户、金额、申请时间、退款原因
5.2 退款处理
通过退款:
- 点击订单 → "审核通过"
- 系统自动调用微信退款接口
- 状态: 5 → 6 (退款中) → 7 (已退款)
- 退款成功后, 自动回退分润记录
驳回退款:
- 点击订单 → "驳回"
- 填写驳回原因(必填)
- 状态: 5 → 4 (已完成), 驳回原因写入 remark
- 用户可在订单详情查看驳回原因
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 登录
- 访问
http://101.43.95.130:8050 - 输入账号密码 + 验证码
- 登录后进入管理后台首页
7.2 主要功能模块
系统管理
- 用户管理: CRUD + 分配角色 + 设置 user_type
- 角色管理: 角色 CRUD + 分配菜单权限
- 菜单管理: 菜单树管理
- 医院管理: 合作医院信息维护
- 服务类型: 服务项目管理(含图标上传)
- 区域管理: 省/市/区三级区域维护 + 绑定运营经理
推广管理
- 推广员列表: 查看所有推广员及数据
- 推广关系: 查看某推广员的上下级树
- 佣金明细: 按推广员/时间/订单查看
调度管理
- 调度面板: 待派单列表 + 手动指派 + 改派
- 派单历史: 所有调度操作记录
财务管理
- 退款审核: 待审核退款列表 + 通过/驳回
- 结算管理: 待结算列表 + 单笔/批量结算
- 分润记录: 全角色分润记录 + 筛选 + 汇总
- 平台配置: 佣金比例/调度比例/运营比例/自动结算开关
- 收益明细: 各角色收入流水
运营看板
- 区域数据总览
- 订单趋势图
- 陪诊师服务排行
- 推广效果排行
7.3 常用操作流程
新增陪诊师:
- 系统管理 → 用户管理 → 新增
- 填写基本信息 → user_type 选择 "01-陪诊师"
- 角色分配 → 保存
分配运营区域:
- 系统管理 → 区域管理 → 新增/编辑区域
- 选择 manager_id(运营经理)
- 运营经理登录后可看到本区域数据
处理退款:
- 财务管理 → 退款审核
- 查看 status=5 的订单
- 通过: 系统调微信退款 → status 5→6→7
- 驳回: 填写原因 → status 5→4
查看分润:
- 财务管理 → 分润记录
- 可按角色/订单/时间筛选
- 查看每个订单的分润分配详情
附录: 常见问题
Q: 注册后为什么看不到推广入口? A: 需要在管理后台将用户的 user_type 设置为 06(推广员), 并分配 promoter 角色。
Q: 陪诊师如何接单? A: 调度员手动指派后, 订单会出现在陪诊师的待接单列表。自动派单的订单直接进入陪诊师列表。
Q: 提现多久到账? A: 提现申请后由管理员审核结算, 通过微信企业付款到零钱, 一般 1-2 个工作日。
Q: 退出订单如何恢复? A: 客服驳回退款后, 订单状态恢复到"已完成"(4), 可正常结算。