1092 lines
24 KiB
Markdown
1092 lines
24 KiB
Markdown
# 习正陪伴业务流程完整分析
|
||
|
||
> 创建时间：2026-01-27
|
||
> 文档类型：系统架构与业务流程分析
|
||
> 适用范围：全体开发人员、产品经理、运营人员
|
||
|
||
---
|
||
|
||
## 📋 目录
|
||
|
||
1. [核心业务流程](#核心业务流程)
|
||
2. [支撑业务流程](#支撑业务流程)
|
||
3. [管理业务流程](#管理业务流程)
|
||
4. [数据模型](#数据模型)
|
||
5. [状态流转规则](#状态流转规则)
|
||
|
||
---
|
||
|
||
## 🎯 一、核心业务流程
|
||
|
||
### 1.1 订单创建流程
|
||
|
||
**参与角色：** 家长（用户）
|
||
|
||
**流程步骤：**
|
||
|
||
```
|
||
家长端 → 选择服务 → 填写订单信息 → 创建订单
|
||
```
|
||
|
||
**关键代码位置：**
|
||
- Controller: `OrderController.createOrder()`
|
||
- Service: `OrderServiceImpl.createOrder()`
|
||
- Entity: `Order.java`
|
||
|
||
**业务逻辑：**
|
||
|
||
1. **服务验证**
|
||
- 检查服务是否存在（serviceId）
|
||
- 特殊处理：家长学院课程不在service表中，跳过检查
|
||
|
||
2. **订单初始化**
|
||
- 生成订单号：`PD + yyyyMMddHHmmss + 4位随机数`
|
||
- 生成核销码：12位随机数字
|
||
- 设置初始状态：`status=0`（待支付）
|
||
- 设置支付状态：`payStatus=0`（未支付）
|
||
|
||
3. **数据保存**
|
||
- 保存订单到数据库
|
||
- 发送订单创建通知给家长
|
||
|
||
**订单字段说明：**
|
||
|
||
| 字段 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| orderNo | 订单号 | PD20260127143025001 |
|
||
| verificationCode | 核销码（12位） | 123456789012 |
|
||
| status | 订单状态 | 0=待支付 |
|
||
| payStatus | 支付状态 | 0=未支付 |
|
||
| userId | 家长ID | 1 |
|
||
| studentId | 学生ID | 可为null |
|
||
| serviceId | 服务ID | 1 |
|
||
| serviceName | 服务名称 | 陪伴服务 |
|
||
| serviceType | 服务类型 | basic/package/parent_academy |
|
||
| price | 服务价格 | 100.00 |
|
||
| payAmount | 实付金额 | 90.00 |
|
||
|
||
---
|
||
|
||
### 1.2 支付流程
|
||
|
||
**参与角色：** 家长（用户）
|
||
|
||
**流程步骤：**
|
||
|
||
```
|
||
家长端 → 选择支付方式 → 发起支付 → 支付成功 → 订单状态更新
|
||
```
|
||
|
||
**关键代码位置：**
|
||
- Controller: `OrderController.payOrder()`
|
||
- Service: `OrderServiceImpl.payOrder()`
|
||
|
||
**支付方式：**
|
||
|
||
1. **微信支付** (`paymentMethod = "wechat"`)
|
||
- 调用微信支付接口
|
||
- 等待支付回调
|
||
|
||
2. **钱包支付** (`paymentMethod = "wallet"`)
|
||
- 检查钱包余额
|
||
- 调用 `walletService.consume()` 扣款
|
||
- 立即完成支付
|
||
|
||
3. **其他支付方式**
|
||
- 支付宝、银行卡等
|
||
|
||
**支付成功后的处理：**
|
||
|
||
|
||
1. **更新订单状态**
|
||
- `payStatus = 1`（已支付）
|
||
- `status = 0`（待派单）
|
||
- 记录支付时间和支付方式
|
||
|
||
2. **创建购买记录**（针对特定服务类型）
|
||
- 家长学院订单：创建 `parent_academy_purchase` 记录
|
||
- 套餐订单：创建 `user_package` 记录
|
||
|
||
3. **创建分销订单**
|
||
- 自动调用 `distributorService.createDistributorOrderFromOrder()`
|
||
- 记录分销关系和佣金信息
|
||
|
||
4. **发送通知**
|
||
- 通知家长支付成功
|
||
- 通知管理师有新订单待派单
|
||
|
||
**状态流转：**
|
||
```
|
||
status: 0(待支付) → 0(待派单)
|
||
payStatus: 0(未支付) → 1(已支付)
|
||
```
|
||
|
||
---
|
||
|
||
### 1.3 派单流程
|
||
|
||
**参与角色：** 管理师
|
||
|
||
**流程步骤：**
|
||
|
||
```
|
||
管理师端 → 查看待派单列表 → 选择订单 → 选择陪伴员 → 确认派单
|
||
```
|
||
|
||
**关键代码位置：**
|
||
- 前端页面: `manager-package/pages/manager/work-order-detail.vue`
|
||
- 前端页面: `manager-package/pages/manager/assign.vue`
|
||
- Controller: `WorkOrderController.createWorkOrder()`
|
||
|
||
**派单逻辑：**
|
||
|
||
1. **查看订单详情**
|
||
- 显示家长信息（姓名、电话）
|
||
- 显示学生信息（姓名、年级、年龄）
|
||
- 显示订单信息（服务名称、金额、时间、地址）
|
||
|
||
2. **选择陪伴员**
|
||
- 查看陪伴员列表
|
||
- 筛选条件：等级、状态、距离等
|
||
- 查看陪伴员详情（评分、服务次数等）
|
||
|
||
3. **确认派单**
|
||
- 更新订单的 `teacherId` 字段
|
||
- 订单状态保持为 `status = 0`（待派单）
|
||
- 等待陪伴员接单
|
||
|
||
4. **发送通知**
|
||
- 通知陪伴员有新订单待接单
|
||
- 通知家长订单已派单
|
||
|
||
**状态流转：**
|
||
```
|
||
status: 0(待派单) → 0(待派单，但已分配陪伴员)
|
||
teacherId: null → 具体陪伴员ID
|
||
```
|
||
|
||
|
||
---
|
||
|
||
### 1.4 接单流程
|
||
|
||
**参与角色：** 陪伴员
|
||
|
||
**流程步骤：**
|
||
|
||
```
|
||
陪伴员端 → 查看待接单列表 → 查看订单详情 → 接单/拒单
|
||
```
|
||
|
||
**关键代码位置：**
|
||
- Controller: `OrderController.acceptOrder()` / `rejectOrder()`
|
||
- Service: `OrderServiceImpl.acceptOrder()` / `rejectOrder()`
|
||
|
||
**接单逻辑：**
|
||
|
||
1. **查看订单详情**
|
||
- 服务时间、地址
|
||
- 学生信息
|
||
- 服务要求
|
||
|
||
2. **接单**
|
||
- 前置条件：订单状态为 `status = 1`（待接单）且已分配陪伴员
|
||
- 更新订单状态为 `status = 2`（待服务）
|
||
- 发送通知给家长
|
||
|
||
3. **拒单**
|
||
- 前置条件：订单状态为 `status = 1`（待接单）
|
||
- 订单状态回退为 `status = 0`（待派单）
|
||
- 清除 `teacherId`，让管理师重新分配
|
||
- 记录拒单原因
|
||
- 发送通知给家长和管理师
|
||
|
||
**状态流转：**
|
||
|
||
接单：
|
||
```
|
||
status: 1(待接单) → 2(待服务)
|
||
```
|
||
|
||
拒单：
|
||
```
|
||
status: 1(待接单) → 0(待派单)
|
||
teacherId: 具体陪伴员ID → null
|
||
```
|
||
|
||
---
|
||
|
||
### 1.5 服务流程
|
||
|
||
**参与角色：** 陪伴员、家长
|
||
|
||
**流程步骤：**
|
||
|
||
```
|
||
陪伴员端 → 签到（开始服务）→ 服务中 → 签退（完成服务）
|
||
```
|
||
|
||
**关键代码位置：**
|
||
- Controller: `OrderController.startService()` / `completeService()`
|
||
- Service: `OrderServiceImpl.startServiceWithCheckIn()` / `completeService()`
|
||
- Entity: `CheckInRecord.java`
|
||
|
||
**签到（开始服务）：**
|
||
|
||
1. **前置条件**
|
||
- 订单状态为 `status = 2`（待服务）
|
||
- 陪伴员已到达服务地点
|
||
|
||
2. **签到信息**
|
||
- 拍照上传
|
||
- 获取GPS位置
|
||
- 填写备注
|
||
|
||
3. **系统处理**
|
||
- 更新订单状态为 `status = 3`（服务中）
|
||
- 设置 `isVerified = 1`（已核销）
|
||
- 记录 `verifyTime`（核销时间）
|
||
- 记录 `serviceStartTime`（服务开始时间）
|
||
- 创建签到记录到 `check_in_record` 表
|
||
|
||
4. **发送通知**
|
||
- 通知家长：陪伴员已到达，服务开始
|
||
- 通知管理师：订单已核销
|
||
|
||
|
||
**签退（完成服务）：**
|
||
|
||
1. **前置条件**
|
||
- 订单状态为 `status = 3`（服务中）
|
||
- 服务已完成
|
||
|
||
2. **签退信息**
|
||
- 拍照上传
|
||
- 获取GPS位置
|
||
- 填写服务总结
|
||
|
||
3. **系统处理**
|
||
- 更新订单状态为 `status = 4`（已完成）
|
||
- 记录 `completeTime`（完成时间）
|
||
- 创建签退记录到 `check_in_record` 表
|
||
- 计算实际服务时长
|
||
|
||
4. **时卡/套餐扣减**
|
||
- 如果订单关联时卡：扣减时卡时长
|
||
- 如果订单关联套餐：扣减套餐时长
|
||
- 记录使用明细
|
||
|
||
5. **收益结算**
|
||
- 创建陪伴员收益记录（`teacher_salary`）
|
||
- 陪伴员分成比例：70%
|
||
- 钱包收益入账
|
||
|
||
6. **分销佣金**
|
||
- 触发分销佣金状态更新
|
||
- 佣金状态：待结算 → 可提现
|
||
|
||
7. **更新统计**
|
||
- 更新课程销量
|
||
- 更新陪伴员服务次数
|
||
|
||
**状态流转：**
|
||
|
||
签到：
|
||
```
|
||
status: 2(待服务) → 3(服务中)
|
||
isVerified: 0 → 1
|
||
```
|
||
|
||
签退：
|
||
```
|
||
status: 3(服务中) → 4(已完成)
|
||
```
|
||
|
||
---
|
||
|
||
### 1.6 评价流程
|
||
|
||
**参与角色：** 家长
|
||
|
||
**流程步骤：**
|
||
|
||
```
|
||
家长端 → 查看已完成订单 → 提交评价 → 评价成功
|
||
```
|
||
|
||
**关键代码位置：**
|
||
- Controller: `ReviewController.submitReview()`
|
||
- Service: `ReviewService.submitReview()`
|
||
- Entity: `Review.java`
|
||
|
||
**评价内容：**
|
||
|
||
1. **评分**
|
||
- 1-5星评分
|
||
- 必填项
|
||
|
||
2. **评价内容**
|
||
- 文字评价
|
||
- 可选项
|
||
|
||
3. **评价标签**
|
||
- 预设标签（如：耐心、专业、准时等）
|
||
- 多选
|
||
|
||
4. **系统处理**
|
||
- 保存评价到 `review` 表
|
||
- 更新订单的 `reviewed` 字段为 `true`
|
||
- 更新陪伴员的平均评分
|
||
- 发送通知给陪伴员
|
||
|
||
**陪伴员回复：**
|
||
- 陪伴员可以回复评价
|
||
- 回复内容保存到 `review` 表的 `reply_content` 字段
|
||
|
||
|
||
---
|
||
|
||
## 🔧 二、支撑业务流程
|
||
|
||
### 2.1 支付系统
|
||
|
||
**核心功能：** 处理订单支付、退款、支付记录
|
||
|
||
**涉及实体：**
|
||
- `PaymentRecord`：支付记录
|
||
- `Order`：订单支付状态
|
||
|
||
**支付方式：**
|
||
|
||
1. **微信支付**
|
||
- 调用微信支付API
|
||
- 处理支付回调
|
||
- 更新订单状态
|
||
|
||
2. **钱包支付**
|
||
- 检查余额
|
||
- 扣减余额
|
||
- 记录交易流水
|
||
|
||
3. **支付宝支付**
|
||
- 调用支付宝API
|
||
- 处理支付回调
|
||
|
||
**退款流程：**
|
||
```
|
||
用户申请退款 → 审核 → 原路退回 → 更新订单状态
|
||
```
|
||
|
||
---
|
||
|
||
### 2.2 钱包系统
|
||
|
||
**核心功能：** 管理用户钱包余额、充值、消费、提现
|
||
|
||
**涉及实体：**
|
||
- `Wallet`：钱包账户
|
||
- `WalletTransaction`：钱包交易记录
|
||
|
||
**关键代码位置：**
|
||
- Controller: `WalletController`
|
||
- Service: `WalletServiceImpl`
|
||
|
||
**钱包功能：**
|
||
|
||
1. **充值**
|
||
- 选择充值金额
|
||
- 选择支付方式
|
||
- 充值成功后增加余额
|
||
- 记录交易流水
|
||
|
||
2. **消费**
|
||
- 订单支付时扣减余额
|
||
- 检查余额是否足够
|
||
- 记录交易流水
|
||
|
||
3. **提现**（陪伴员）
|
||
- 申请提现
|
||
- 审核
|
||
- 转账到银行卡
|
||
- 扣减余额
|
||
|
||
4. **收益入账**（陪伴员）
|
||
- 订单完成后自动入账
|
||
- 收益 = 订单金额 × 70%
|
||
- 记录交易流水
|
||
|
||
**钱包余额计算：**
|
||
```
|
||
当前余额 = 初始余额 + 充值金额 + 收益金额 - 消费金额 - 提现金额
|
||
```
|
||
|
||
---
|
||
|
||
### 2.3 优惠券系统
|
||
|
||
**核心功能：** 发放优惠券、使用优惠券、优惠券统计
|
||
|
||
**涉及实体：**
|
||
- `Coupon`：优惠券模板
|
||
- `UserCoupon`：用户优惠券
|
||
|
||
**关键代码位置：**
|
||
- Controller: `CouponController`, `UserCouponController`
|
||
- Service: `CouponServiceImpl`, `UserCouponServiceImpl`
|
||
|
||
**优惠券类型：**
|
||
|
||
1. **满减券**
|
||
- 满X元减Y元
|
||
- 例：满100减20
|
||
|
||
2. **折扣券**
|
||
- X折优惠
|
||
- 例：8折券
|
||
|
||
3. **代金券**
|
||
- 直接抵扣金额
|
||
- 例：10元代金券
|
||
|
||
|
||
**优惠券流程：**
|
||
|
||
1. **发放**
|
||
- 管理员创建优惠券模板
|
||
- 系统自动发放或手动发放给用户
|
||
- 用户领取优惠券
|
||
|
||
2. **使用**
|
||
- 下单时选择可用优惠券
|
||
- 系统计算优惠金额
|
||
- 支付时扣减优惠金额
|
||
- 标记优惠券为已使用
|
||
|
||
3. **过期**
|
||
- 定时任务检查过期优惠券
|
||
- 标记为已过期
|
||
|
||
**优惠券字段：**
|
||
- `couponName`：优惠券名称
|
||
- `couponType`：类型（满减/折扣/代金）
|
||
- `discountAmount`：优惠金额
|
||
- `minAmount`：最低消费金额
|
||
- `validFrom`：有效期开始
|
||
- `validTo`：有效期结束
|
||
- `status`：状态（未使用/已使用/已过期）
|
||
|
||
---
|
||
|
||
### 2.4 成长记录系统
|
||
|
||
**核心功能：** 记录学生成长轨迹、陪伴员反馈
|
||
|
||
**涉及实体：**
|
||
- `GrowthRecord`：成长记录
|
||
|
||
**关键代码位置：**
|
||
- Controller: `GrowthRecordController`
|
||
- Service: `GrowthRecordServiceImpl`
|
||
|
||
**成长记录内容：**
|
||
|
||
1. **陪伴员反馈**
|
||
- 服务完成后填写
|
||
- 记录学生表现
|
||
- 上传照片/视频
|
||
|
||
2. **管理师补充**
|
||
- 管理师可以补充反馈内容
|
||
- 字段：`supplement`
|
||
|
||
3. **家长查看**
|
||
- 家长端查看学生成长记录
|
||
- 按时间倒序展示
|
||
|
||
**成长记录字段：**
|
||
- `orderId`：关联订单
|
||
- `studentId`：学生ID
|
||
- `teacherId`：陪伴员ID
|
||
- `content`：反馈内容
|
||
- `photos`：照片URL（多张，逗号分隔）
|
||
- `videos`：视频URL
|
||
- `supplement`：管理师补充内容
|
||
- `recordDate`：记录日期
|
||
|
||
---
|
||
|
||
### 2.5 时卡/套餐系统
|
||
|
||
**核心功能：** 管理用户购买的时卡和套餐
|
||
|
||
**涉及实体：**
|
||
- `Package`：套餐模板
|
||
- `UserPackage`：用户套餐
|
||
- `TimeCard`：时卡
|
||
- `PackageUsage`：套餐使用记录
|
||
|
||
**关键代码位置：**
|
||
- Service: `PackageService`, `TimeCardService`, `PackageUsageService`
|
||
|
||
**套餐类型：**
|
||
|
||
1. **时卡套餐**
|
||
- 按小时计费
|
||
- 例：100小时套餐
|
||
|
||
2. **次卡套餐**
|
||
- 按次数计费
|
||
- 例：10次套餐
|
||
|
||
**套餐流程：**
|
||
|
||
1. **购买套餐**
|
||
- 用户下单购买套餐
|
||
- 支付成功后创建 `user_package` 记录
|
||
- 初始化总时长和剩余时长
|
||
|
||
2. **使用套餐**
|
||
- 预约服务时选择套餐
|
||
- 订单关联 `userPackageId`
|
||
- 服务完成后扣减套餐时长
|
||
|
||
3. **套餐扣减**
|
||
- 计算实际服务时长
|
||
- 扣减剩余时长
|
||
- 记录使用明细到 `package_usage`
|
||
|
||
4. **套餐过期**
|
||
- 检查有效期
|
||
- 过期后不可使用
|
||
|
||
|
||
---
|
||
|
||
## 👥 三、管理业务流程
|
||
|
||
### 3.1 分销系统
|
||
|
||
**核心功能：** 管理分销员、分销订单、佣金结算
|
||
|
||
**涉及实体：**
|
||
- `Distributor`：分销员
|
||
- `DistributorOrder`：分销订单
|
||
- `DistributorCustomer`：分销客户关系
|
||
- `DistributorWithdraw`：分销员提现记录
|
||
|
||
**关键代码位置：**
|
||
- Controller: `DistributorController`
|
||
- Service: `DistributorServiceImpl`
|
||
- Listener: `OrderStatusListener`
|
||
|
||
**分销流程：**
|
||
|
||
1. **分销员注册**
|
||
- 用户申请成为分销员
|
||
- 审核通过后开通分销权限
|
||
- 生成专属邀请码
|
||
|
||
2. **客户绑定**
|
||
- 新用户通过邀请码注册
|
||
- 建立分销关系（`distributor_customer`）
|
||
- 关系永久绑定
|
||
|
||
3. **订单分佣**
|
||
- 客户下单支付成功
|
||
- 自动创建分销订单记录
|
||
- 计算佣金金额（订单金额 × 佣金比例）
|
||
- 佣金状态：待结算
|
||
|
||
4. **佣金结算**
|
||
- 订单完成后，佣金状态变为可提现
|
||
- 分销员申请提现
|
||
- 审核通过后转账
|
||
|
||
5. **佣金取消**
|
||
- 订单取消或退款
|
||
- 扣减对应佣金
|
||
- 更新分销订单状态
|
||
|
||
**佣金计算规则：**
|
||
```
|
||
佣金金额 = 订单实付金额 × 佣金比例
|
||
佣金比例 = 10%（可配置）
|
||
```
|
||
|
||
**分销员等级：**
|
||
- 普通分销员：10%佣金
|
||
- 高级分销员：15%佣金
|
||
- 金牌分销员：20%佣金
|
||
|
||
---
|
||
|
||
### 3.2 培训系统
|
||
|
||
**核心功能：** 陪伴员培训、考试、证书管理
|
||
|
||
**涉及实体：**
|
||
- `TrainingCourse`：培训课程
|
||
- `TrainingLearningRecord`：学习记录
|
||
- `TrainingExam`：考试
|
||
- `TrainingExamRecord`：考试记录
|
||
- `TrainingCertificate`：证书
|
||
|
||
**关键代码位置：**
|
||
- Controller: `TrainingController`
|
||
- Service: `TrainingServiceImpl`
|
||
|
||
**培训流程：**
|
||
|
||
1. **课程学习**
|
||
- 陪伴员选择培训课程
|
||
- 观看视频、阅读文档
|
||
- 记录学习进度
|
||
|
||
2. **考试**
|
||
- 完成课程后参加考试
|
||
- 题型：单选、多选、判断
|
||
- 及格分数：60分
|
||
|
||
3. **获得证书**
|
||
- 考试通过后颁发证书
|
||
- 证书包含：课程名称、成绩、颁发时间
|
||
|
||
4. **等级提升**
|
||
- 完成指定培训课程
|
||
- 考试成绩达标
|
||
- 服务次数达标
|
||
- 评分达标
|
||
- 自动提升陪伴员等级
|
||
|
||
**培训课程类型：**
|
||
- 基础培训：新人必修
|
||
- 进阶培训：提升技能
|
||
- 专项培训：特殊服务
|
||
|
||
|
||
---
|
||
|
||
### 3.3 权限管理系统
|
||
|
||
**核心功能：** 管理用户角色、权限、操作日志
|
||
|
||
**涉及实体：**
|
||
- `User`：用户（包含角色信息）
|
||
- `Permission`：权限
|
||
- `OperationLog`：操作日志
|
||
|
||
**关键代码位置：**
|
||
- Controller: `PermissionController`
|
||
- Service: `PermissionService`
|
||
|
||
**角色类型：**
|
||
|
||
1. **家长（user）**
|
||
- 下单、支付
|
||
- 查看订单
|
||
- 评价服务
|
||
- 查看成长记录
|
||
|
||
2. **陪伴员（teacher）**
|
||
- 接单、拒单
|
||
- 签到、签退
|
||
- 提交反馈
|
||
- 查看收益
|
||
|
||
3. **管理师（manager）**
|
||
- 派单
|
||
- 查看所有订单
|
||
- 补充反馈
|
||
- 处理投诉
|
||
|
||
4. **分销员（distributor）**
|
||
- 推广邀请
|
||
- 查看客户
|
||
- 查看佣金
|
||
- 申请提现
|
||
|
||
5. **管理员（admin）**
|
||
- 系统配置
|
||
- 用户管理
|
||
- 数据统计
|
||
- 权限管理
|
||
|
||
**权限控制：**
|
||
- 基于角色的访问控制（RBAC）
|
||
- API接口权限验证
|
||
- 前端路由权限控制
|
||
|
||
---
|
||
|
||
## 📊 四、数据模型
|
||
|
||
### 4.1 核心实体关系
|
||
|
||
```
|
||
User（用户）
|
||
├─ 1:N → Order（订单）
|
||
├─ 1:N → Student（学生）
|
||
├─ 1:1 → Wallet（钱包）
|
||
└─ 1:N → UserCoupon（用户优惠券）
|
||
|
||
Order（订单）
|
||
├─ N:1 → User（家长）
|
||
├─ N:1 → Student（学生）
|
||
├─ N:1 → Teacher（陪伴员）
|
||
├─ N:1 → Service（服务）
|
||
├─ 1:N → CheckInRecord（签到记录）
|
||
├─ 1:N → GrowthRecord（成长记录）
|
||
├─ 1:1 → Review（评价）
|
||
└─ 1:1 → DistributorOrder（分销订单）
|
||
|
||
Teacher（陪伴员）
|
||
├─ 1:N → Order（订单）
|
||
├─ 1:N → TeacherSalary（收益记录）
|
||
└─ 1:1 → Wallet（钱包）
|
||
|
||
Distributor（分销员）
|
||
├─ 1:N → DistributorCustomer（客户关系）
|
||
└─ 1:N → DistributorOrder（分销订单）
|
||
```
|
||
|
||
---
|
||
|
||
### 4.2 订单状态定义
|
||
|
||
**订单状态（status）：**
|
||
|
||
| 状态值 | 状态名称 | 说明 |
|
||
|--------|----------|------|
|
||
| 0 | 待派单 | 已支付，等待管理师派单 |
|
||
| 1 | 待接单 | 已派单，等待陪伴员接单 |
|
||
| 2 | 待服务 | 已接单，等待签到开始服务 |
|
||
| 3 | 服务中 | 已签到，正在服务 |
|
||
| 4 | 已完成 | 已签退，服务完成 |
|
||
| -1 | 已取消 | 用户取消或超时取消 |
|
||
| -2 | 已退款 | 退款成功 |
|
||
|
||
**支付状态（payStatus）：**
|
||
|
||
| 状态值 | 状态名称 | 说明 |
|
||
|--------|----------|------|
|
||
| 0 | 未支付 | 订单已创建，等待支付 |
|
||
| 1 | 已支付 | 支付成功 |
|
||
| 2 | 支付失败 | 支付失败 |
|
||
| 3 | 已退款 | 已退款 |
|
||
|
||
|
||
---
|
||
|
||
## 🔄 五、状态流转规则
|
||
|
||
### 5.1 订单状态流转图
|
||
|
||
```mermaid
|
||
graph LR
|
||
A[0-待支付] -->|支付成功| B[0-待派单]
|
||
A -->|取消订单| F[-1-已取消]
|
||
B -->|管理师派单| C[1-待接单]
|
||
C -->|陪伴员接单| D[2-待服务]
|
||
C -->|陪伴员拒单| B
|
||
C -->|取消/退款| F
|
||
D -->|签到| E[3-服务中]
|
||
D -->|取消/退款| F
|
||
E -->|签退| G[4-已完成]
|
||
E -->|退款| H[-2-已退款]
|
||
```
|
||
|
||
### 5.2 状态流转规则
|
||
|
||
**代码位置：** `OrderServiceImpl.isValidStatusTransition()`
|
||
|
||
**合法的状态流转：**
|
||
|
||
| 当前状态 | 允许流转到 | 触发条件 |
|
||
|---------|-----------|---------|
|
||
| 0-待支付 | 0-待派单 | 支付成功 |
|
||
| 0-待支付 | -1-已取消 | 取消订单 |
|
||
| 0-待派单 | 1-待接单 | 管理师派单 |
|
||
| 1-待接单 | 2-待服务 | 陪伴员接单 |
|
||
| 1-待接单 | 0-待派单 | 陪伴员拒单 |
|
||
| 1-待接单 | -1-已取消 | 取消订单 |
|
||
| 1-待接单 | -2-已退款 | 申请退款 |
|
||
| 2-待服务 | 3-服务中 | 签到 |
|
||
| 2-待服务 | -1-已取消 | 取消订单 |
|
||
| 2-待服务 | -2-已退款 | 申请退款 |
|
||
| 3-服务中 | 4-已完成 | 签退 |
|
||
| 3-服务中 | -2-已退款 | 申请退款 |
|
||
|
||
**终态（不允许再流转）：**
|
||
- 4-已完成
|
||
- -1-已取消
|
||
- -2-已退款
|
||
|
||
---
|
||
|
||
## 📱 六、前端页面结构
|
||
|
||
### 6.1 家长端（user-package）
|
||
|
||
```
|
||
pages/
|
||
├── index/ # 首页
|
||
├── order/ # 订单管理
|
||
│ ├── list.vue # 订单列表
|
||
│ ├── detail.vue # 订单详情
|
||
│ └── create.vue # 创建订单
|
||
├── service/ # 服务相关
|
||
│ ├── list.vue # 服务列表
|
||
│ └── detail.vue # 服务详情
|
||
├── growth/ # 成长记录
|
||
│ └── list.vue # 成长记录列表
|
||
├── review/ # 评价
|
||
│ └── create.vue # 提交评价
|
||
└── wallet/ # 钱包
|
||
├── index.vue # 钱包首页
|
||
└── recharge.vue # 充值
|
||
```
|
||
|
||
### 6.2 陪伴员端（teacher-package）
|
||
|
||
```
|
||
pages/
|
||
├── index/ # 首页
|
||
├── order/ # 订单管理
|
||
│ ├── list.vue # 订单列表（待接单/服务中/已完成）
|
||
│ └── detail.vue # 订单详情
|
||
├── checkin/ # 签到签退
|
||
│ ├── checkin.vue # 签到
|
||
│ └── checkout.vue # 签退
|
||
├── feedback/ # 反馈
|
||
│ └── create.vue # 提交反馈
|
||
├── salary/ # 收益
|
||
│ └── list.vue # 收益列表
|
||
└── training/ # 培训
|
||
├── list.vue # 培训课程列表
|
||
└── exam.vue # 考试
|
||
```
|
||
|
||
### 6.3 管理师端（manager-package）
|
||
|
||
```
|
||
pages/
|
||
├── index/ # 首页（待派单数量统计）
|
||
├── work-order/ # 工单管理
|
||
│ ├── list.vue # 工单列表
|
||
│ └── detail.vue # 工单详情
|
||
├── assign/ # 派单
|
||
│ └── index.vue # 选择陪伴员派单
|
||
└── statistics/ # 统计
|
||
└── index.vue # 数据统计
|
||
```
|
||
|
||
### 6.4 分销员端（distributor-package）
|
||
|
||
```
|
||
pages/
|
||
├── index/ # 首页
|
||
├── customer/ # 客户管理
|
||
│ └── list.vue # 客户列表
|
||
├── order/ # 分销订单
|
||
│ └── list.vue # 订单列表
|
||
├── commission/ # 佣金
|
||
│ └── list.vue # 佣金列表
|
||
└── withdraw/ # 提现
|
||
└── apply.vue # 申请提现
|
||
```
|
||
|
||
---
|
||
|
||
## 🔔 七、通知系统
|
||
|
||
### 7.1 通知类型
|
||
|
||
**关键代码位置：** `NotificationService`
|
||
|
||
**通知场景：**
|
||
|
||
1. **订单相关**
|
||
- 订单创建成功
|
||
- 支付成功
|
||
- 派单成功
|
||
- 陪伴员接单
|
||
- 陪伴员拒单
|
||
- 签到通知
|
||
- 服务完成
|
||
- 订单取消
|
||
- 退款成功
|
||
|
||
2. **评价相关**
|
||
- 收到新评价
|
||
- 评价被回复
|
||
|
||
3. **钱包相关**
|
||
- 充值成功
|
||
- 消费成功
|
||
- 收益入账
|
||
- 提现成功
|
||
|
||
4. **分销相关**
|
||
- 新客户绑定
|
||
- 佣金到账
|
||
- 提现审核通过
|
||
|
||
### 7.2 通知方式
|
||
|
||
1. **站内消息**
|
||
- 保存到 `notification` 表
|
||
- 前端轮询或WebSocket推送
|
||
|
||
2. **微信模板消息**
|
||
- 调用微信API发送
|
||
|
||
3. **短信通知**
|
||
- 调用短信API发送
|
||
|
||
---
|
||
|
||
## 📊 八、数据统计
|
||
|
||
### 8.1 管理师端统计
|
||
|
||
1. **订单统计**
|
||
- 待派单数量
|
||
- 服务中订单数量
|
||
- 已完成订单数量
|
||
- 今日订单数量
|
||
|
||
2. **陪伴员统计**
|
||
- 在线陪伴员数量
|
||
- 服务中陪伴员数量
|
||
- 空闲陪伴员数量
|
||
|
||
3. **收入统计**
|
||
- 今日收入
|
||
- 本月收入
|
||
- 总收入
|
||
|
||
### 8.2 陪伴员端统计
|
||
|
||
1. **服务统计**
|
||
- 服务次数
|
||
- 服务时长
|
||
- 平均评分
|
||
|
||
2. **收益统计**
|
||
- 今日收益
|
||
- 本月收益
|
||
- 总收益
|
||
- 可提现金额
|
||
|
||
### 8.3 分销员端统计
|
||
|
||
1. **客户统计**
|
||
- 客户总数
|
||
- 本月新增客户
|
||
|
||
2. **佣金统计**
|
||
- 待结算佣金
|
||
- 可提现佣金
|
||
- 已提现佣金
|
||
- 总佣金
|
||
|
||
---
|
||
|
||
## 🎯 九、关键业务规则
|
||
|
||
### 9.1 派单规则
|
||
|
||
1. **陪伴员筛选条件**
|
||
- 状态：在线且空闲
|
||
- 等级：满足服务要求
|
||
- 距离：优先推荐距离近的
|
||
- 评分：优先推荐评分高的
|
||
|
||
2. **派单限制**
|
||
- 同一时间段不能重复派单
|
||
- 陪伴员服务中不能接新单
|
||
|
||
### 9.2 收益分成规则
|
||
|
||
1. **陪伴员收益**
|
||
- 分成比例：70%
|
||
- 结算时机：订单完成后
|
||
- 入账方式：自动入账到钱包
|
||
|
||
2. **平台收益**
|
||
- 分成比例：30%
|
||
|
||
3. **分销佣金**
|
||
- 佣金比例：10%-20%（根据等级）
|
||
- 结算时机：订单完成后
|
||
- 提现条件：满100元可提现
|
||
|
||
### 9.3 时卡扣减规则
|
||
|
||
1. **扣减时机**
|
||
- 订单完成（签退）后自动扣减
|
||
|
||
2. **扣减规则**
|
||
- 按实际服务时长扣减
|
||
- 不足1小时按1小时计算
|
||
|
||
3. **余额不足**
|
||
- 提示用户充值或购买套餐
|
||
|
||
---
|
||
|
||
## 📝 十、总结
|
||
|
||
### 10.1 核心流程总结
|
||
|
||
**完整的订单生命周期：**
|
||
|
||
```
|
||
1. 家长创建订单（status=0，待支付）
|
||
2. 家长支付订单（status=0，待派单，payStatus=1）
|
||
3. 管理师派单（分配teacherId，status保持0）
|
||
4. 陪伴员接单（status=2，待服务）
|
||
5. 陪伴员签到（status=3，服务中）
|
||
6. 陪伴员签退（status=4，已完成）
|
||
7. 家长评价（reviewed=true）
|
||
```
|
||
|
||
### 10.2 关键技术点
|
||
|
||
1. **状态机管理**
|
||
- 严格的状态流转规则
|
||
- 防止非法状态跳转
|
||
|
||
2. **事务管理**
|
||
- 支付、扣减、收益结算使用事务
|
||
- 保证数据一致性
|
||
|
||
3. **异步处理**
|
||
- 通知发送异步处理
|
||
- 不影响主流程
|
||
|
||
4. **分布式锁**
|
||
- 钱包扣减使用乐观锁
|
||
- 防止并发问题
|
||
|
||
### 10.3 扩展性设计
|
||
|
||
1. **支付方式扩展**
|
||
- 支持多种支付方式
|
||
- 易于添加新支付方式
|
||
|
||
2. **服务类型扩展**
|
||
- 支持多种服务类型
|
||
- 易于添加新服务
|
||
|
||
3. **角色权限扩展**
|
||
- 基于RBAC的权限管理
|
||
- 易于添加新角色
|
||
|
||
---
|
||
|
||
**文档结束**
|
||
|
||
> 本文档详细描述了习正陪伴系统的完整业务流程，包括核心流程、支撑流程和管理流程。
|
||
> 建议开发人员在开发新功能或修复问题时，先参考本文档理解业务逻辑。
|