rlz/docs/用户操作手册.md

# 瑞来健康 — 用户操作手册

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

---

## 目录

1. [患者/客户 — 小程序端](#1-患者客户--小程序端)
2. [陪诊师 — 小程序端 & Android App](#2-陪诊师--小程序端和-android-app)
3. [推广员 — 小程序端](#3-推广员--小程序端)
4. [调度员 — 小程序端](#4-调度员--小程序端)
5. [客服专员 — 小程序端](#5-客服专员--小程序端)
6. [运营经理 — 小程序端 & 管理后台](#6-运营经理--小程序端和管理后台)
7. [超级管理员 — 管理后台](#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), 可正常结算。