---
html:
    embed_local_images: false
    embed_svg: true
    offline: false
    toc: false

print_background: false
export_on_save:
    html: true
---

# 用户端-订单管理功能描述

## 订单创建-常规下单

### 展示字段

| 字段名       | 字段类型   | 说明                     |
| ------------ | ---------- | ------------------------ |
| 服务地址     | 选择框     | 用户已保存的地址列表选择 |
| 服务项目     | 选择框     | 支持多选服务项目         |
| 服务时间     | 日期选择器 | 可选未来 7 天内的时间    |
| 服务时长     | 选择框     | 1-8 小时可选             |
| 技师性别要求 | 单选框     | 可选值：不限/男/女       |
| 备注信息     | 文本框     | 最多 200 字              |

### 操作按钮

#### 1. 选择地址

| 操作     | 说明                                                              |
| -------- | ----------------------------------------------------------------- |
| 前置校验 | 1. 用户是否登录<br>2. 是否有保存的地址                            |
| 页面跳转 | 跳转至地址选择页面                                                |
| 业务逻辑 | 1. 支持地图选点<br>2. 校验服务区域是否可用<br>3. 返回选中地址信息 |

#### 2. 选择项目

| 操作     | 说明                                                                                   |
| -------- | -------------------------------------------------------------------------------------- |
| 前置校验 | 1. 服务地址是否已选择                                                                  |
| 页面跳转 | 跳转至项目选择页面                                                                     |
| 业务逻辑 | 1. 显示项目价格和说明<br>2. 支持多选服务项目<br>3. 自动计算总价<br>4. 返回选中项目信息 |

#### 3. 计算价格

| 操作     | 说明                                                      |
| -------- | --------------------------------------------------------- |
| 前置校验 | 1. 服务项目是否已选择<br>2. 服务时间是否已选择            |
| 计算规则 | 1. 基础价格计算<br>2. 时间段溢价计算<br>3. 节假日溢价计算 |
| 展示结果 | 显示价格明细弹窗                                          |

#### 4. 立即下单

| 操作     | 说明                                                                        |
| -------- | --------------------------------------------------------------------------- |
| 前置校验 | 1. 必填信息是否完整<br>2. 用户信用分是否满足<br>3. 用户是否有未支付订单     |
| 订单创建 | 1. 生成订单号(区域编码+日期+6 位序号)<br>2. 创建订单记录<br>3. 记录操作日志 |
| 后续流程 | 1. 跳转支付页面<br>2. 超时未支付自动取消                                    |

## 订单创建-抢单模式

### 展示字段

| 字段名       | 字段类型 | 说明                           |
| ------------ | -------- | ------------------------------ |
| 基础订单信息 | 表单组   | 同常规下单的字段               |
| 抢单有效期   | 选择框   | 可选值：15 分钟/30 分钟/1 小时 |
| 技师接单范围 | 选择框   | 可选值：3 公里/5 公里/10 公里  |
| 已抢技师列表 | 列表     | 展示已抢单技师信息             |
| 倒计时       | 文本     | 抢单剩余时间                   |

### 操作按钮

#### 1. 发布抢单

| 操作     | 说明                                                                                     |
| -------- | ---------------------------------------------------------------------------------------- |
| 前置校验 | 1. 基础订单信息是否完整<br>2. 当前区域是否支持抢单模式<br>3. 是否有足够技师在线          |
| 业务逻辑 | 1. 创建抢单订单<br>2. 推送订单给符合条件的技师<br>3. 启动 �� 单倒计时<br>4. 记录抢单日志 |
| 后续流程 | 1. 跳转抢单监控页面<br>2. 超时未选择自动分配                                             |

#### 2. 选择技师

| 操作     | 说明                                                                       |
| -------- | -------------------------------------------------------------------------- |
| 前置校验 | 1. 抢单是否在有效期内<br>2. 技师是否仍然可接单                             |
| 业务逻辑 | 1. 确认选择技师<br>2. 更新订单状态<br>3. 通知未选中技师<br>4. 记录选择日志 |
| 后续流程 | 1. 跳转支付页面<br>2. 发送订单通知给技师                                   |

#### 3. 取消发布

| 操作     | 说明                                                    |
| -------- | ------------------------------------------------------- |
| 前置校验 | 1. 是否在可取消时间内<br>2. 是否已有技师抢单            |
| 业务逻辑 | 1. 取消抢单订单<br>2. 通知已抢单技师<br>3. 记录取消原因 |
| 后续流程 | 1. 返回订单创建页面<br>2. 退还预付金(如有)              |

## 订单创建-指定技师下单

### 展示字段

| 字段名       | 字段类型 | 说明                 |
| ------------ | -------- | -------------------- |
| 基础订单信息 | 表单组   | 同常规下单的字段     |
| 技师列表     | 列表     | 展示可选技师信息     |
| 技师筛选条件 | 筛选组   | 评分/距离/性别等筛选 |
| 技师档期日历 | 日历组件 | 显示技师可约时间     |
| 技师详细信息 | 弹窗     | 技师详细资料展示     |

### 操作按钮

#### 1. 筛选技师

| 操作     | 说明                                                                         |
| -------- | ---------------------------------------------------------------------------- |
| 前置校验 | 1. 服务地址是否已选择<br>2. 服务时间 ��� 否已选择                            |
| 业务逻辑 | 1. 根据条件筛选技师<br>2. 计算技师距离<br>3. 检查技师档期<br>4. 排序技师列表 |
| 数据展示 | 1. 显示符合条件的技师<br>2. 支持多维度排序                                   |

#### 2. 查看技师详情

| 操作     | 说明                                                                                  |
| -------- | ------------------------------------------------------------------------------------- |
| 展示内容 | 1. 基本信息(头像/姓名/评分)<br>2. 服务统计(单数/好评率)<br>3. 用户评价<br>4. 技能证书 |
| 业务逻辑 | 1. 加载技师详细信息<br>2. 统计服务数据<br>3. 获取最新评价                             |

#### 3. 选择技师

| 操作     | 说明                                                            |
| -------- | --------------------------------------------------------------- |
| 前置校验 | 1. 技师是否可接单<br>2. 档期是否冲突<br>3. 距离是否超出范围     |
| 业务逻辑 | 1. 锁定技师档期<br>2. 计算订单价格(可能上浮)<br>3. 记录选择日志 |
| 后续流程 | 1. 创建指定技师订单<br>2. 跳转支付页面                          |

## 订单创建-加钟下单

### 展示字段

| 字段名     | 字段类型 | 说明                         |
| ---------- | -------- | ---------------------------- |
| 原订单信息 | 只读文本 | 展示原订单基本信息           |
| 已服务时长 | 只读文本 | 当前已服务时长               |
| 加钟时长   | 选择框   | 可选值：1 小时/2 小时/3 小时 |
| 加钟金额   | 只读文本 | 自动计算的加钟费用           |
| 支付方式   | 单选框   | 可选值：余额/微信/支付宝     |

### 操作按钮

#### 1. 加钟

-   前置校验
    1. 原订单是否存在
    2. 原订单状态是否为服务中或服务结束
-   业务逻辑
    1. 查询项目列表(加钟项目、普通项目)
-   展示结果
    1. 显示项目列表

#### 2. 选择项目

#### 3. 确认加钟

-   前置校验
    1. 检查项目是否存在
-   业务逻辑

    1. 检查原订单状态
        - 状态为服务中，则加钟订单的开始时间为订单服务结束时间，加钟订单的结束时间为开始时间+项目时长
        - 状态为服务结束，则加钟订单的开始时间为当前时间，加钟订单的结束时间为开始时间+项目时长
    2. 计算加钟费用
        - 订单价格=项目价格
        - 如果联合支付
            - 余额支付金额为，检查钱包余额足够支付加钟费用的部分
            - 微信/支付宝支付金额为，检查钱包余额不足的金额
        - 如果单独使用余额支付
            - 检查钱包余额是否足够支付加钟费用，不足则提示
        - 如果单独使用微信/支付宝支付，则不检查钱包余额
    3. 创建加钟订单
        - 关联原订单 ID
        - 项目快照：项目信息
        - 其他字段来自原订单
        - 状态为待支付
    4. 记录订单日志
    5. 使用微信/支付宝支付的金额不为 0，则返回订单状态以及支付参数
    6. 如果单独使用余额支付
        - 修改订单状态为已支付
        - 记录订单日志
        - 返回订单状态

-   展示结果

    显示订单详情或唤起支付

#### 4. 确认加钟

| 操作     | 说明                                                                            |
| -------- | ------------------------------------------------------------------------------- |
| 前置校验 | 1. 技师是否同意加钟<br>2. 技师后续档期是否冲突<br>3. 用户余额是否充足(余额支付) |
| 业务逻辑 | 1. 创建加钟子订单<br>2. 关联原订单 ID<br>3. 更新技师档期<br>4. 记录加钟日志     |
| 后续流程 | 1. 发起支付<br>2. 通知技师加钟成功                                              |

## 订单追踪-技师位置实时追踪

### 展示字段

| 字段名       | 字段类型 | 说明                   |
| ------------ | -------- | ---------------------- |
| 地图组件     | 地图     | 显示技师和目的地位置   |
| 技师信息     | 信息栏   | 技师头像/姓名/电话     |
| 预计到达时间 | 文本     | 预计还需要多久到达     |
| 当前位置描述 | 文本     | 技师当前位置的文字描述 |
| 目的地信息   | 文本     | 服务地址详细信息       |

### 操作按钮

#### 1. 刷新位置

| 操作     | 说明                                                          |
| -------- | ------------------------------------------------------------- |
| 前置校验 | 1. 订单是否在待到达状态<br>2. 技师是否开启位置共享            |
| 业务逻辑 | 1. 获取技师最新位置<br>2. 重新计算到达时间<br>3. 更新位置轨迹 |
| 异常处理 | 1. 位置异常预警<br>2. 轨迹偏离提醒                            |

#### 2. 联系技师

| 操作     | 说明                                                      |
| -------- | --------------------------------------------------------- |
| 前置校验 | 1. 是否在允许联系时间段<br>2. 技师是否在线                |
| 业务逻辑 | 1. 记录通话记录<br>2. 发起电话呼叫<br>3. 更新最近联系时间 |

## 订单追踪-订单状态实时更新

### 展示字段

| 字段名         | 字段类型 | 说明               |
| -------------- | -------- | ------------------ |
| 订单状态流程图 | 流程图   | 展示所有状态节点   |
| 当前状态       | 高亮显示 | 当前所处状态节点   |
| 状态时间线     | 列表     | 各状态变更时间记录 |
| 异常状态标记   | 图标     | 标记异常状态节点   |

### 操作按钮

#### 1. 刷新状态

| 操作     | 说明                                                                             |
| -------- | -------------------------------------------------------------------------------- |
| 业务逻辑 | 1. 获取最新订单状态<br>2. 更新状态时间线<br>3. 检查是否有异常状态                |
| 状态说明 | 1. 待支付 → 待接单 → 已接单 → 技师出发 → 技师到达 → 服务开始 → 服务结束 → 已完成 |
| 异常处理 | 1. 状态异常预警<br>2. 状态超时提醒                                               |

## 订单追踪-订单进度提醒

### 展示字段

| 字段名       | 字段类型 | 说明             |
| ------------ | -------- | ---------------- |
| 提醒消息列表 | 列表     | 所有提醒消息记录 |
| 消息状态     | 标记     | 已读/未读状态    |
| 消息时间     | 文本     | 消息产生时间     |
| 消 ����� 容  | 文本     | 提醒内容详情     |

### 操作按钮

#### 1. 标记已读

| 操作     | 说明                                                  |
| -------- | ----------------------------------------------------- |
| 业务逻辑 | 1. 更新消息状态<br>2. 记录读取时间<br>3. 更新未读数量 |

#### 2. 清除消息

| 操作     | 说明                                                      |
| -------- | --------------------------------------------------------- |
| 前置校验 | 1. 是否是已读消息<br>2. 是否超过保留期限                  |
| 业务逻辑 | 1. 标记消息删除状态<br>2. 记录清除操作<br>3. 支持批量清除 |

## 评价管理-服务评分提交

### 展示字段

| 字段名       | 字段类型 | 说明                       |
| ------------ | -------- | -------------------------- |
| 订单基本信息 | 只读文本 | 订单号/服务项目/技师姓名等 |
| 服务态度评分 | 星级评分 | 1-5 星评分                 |
| 专业技能评分 | 星级评分 | 1-5 星评分                 |
| 守时评分     | 星级评分 | 1-5 星评分                 |
| 卫生评分     | 星级评分 | 1-5 星评分                 |
| 综合评分     | 只读文本 | 自动计算的综合评分         |

### 操作按钮

#### 1. 提交评分

| 操作     | 说明                                                          |
| -------- | ------------------------------------------------------------- |
| 前置校验 | 1. 订单是否已完成<br>2. 是否在评价有效期内<br>3. 是否已评价过 |
| 业务逻辑 | 1. 计算综合评分<br>2. 更新技师评分数据<br>3. 记录评分日志     |
| 后续流程 | 1. 跳转评价内容填写<br>2. 发放评价奖励(如有)                  |

## 评价管理-评价内容填写

### 展示字段

| 字段名   | 字段类型 | 说明                    |
| -------- | -------- | ----------------------- |
| 评价标签 | 多选框   | 预设的评价标签选项      |
| 评价内容 | 文本框   | 详细评价内容，限 500 字 |
| 是否匿名 | 开关     | 是否匿名展示评价        |
| 服务亮点 | 多选框   | 技师服务亮点标签        |
| 改进建议 | 文本框   | 服务改进建议，选填      |

### 操作按钮

#### 1. 选择标签

| 操作     | 说明                                                               |
| -------- | ------------------------------------------------------------------ |
| 业务逻辑 | 1. 根据评分自动推荐标签<br>2. 最多可选 5 个标签<br>3. 记录标签选择 |

#### 2. 提交评价

| 操作     | 说明                                                      |
| -------- | --------------------------------------------------------- |
| 前置校验 | 1. 评价内容是否符合规范<br>2. 是否包含敏感词              |
| 业务逻辑 | 1. 保存评价内容<br>2. 更新技师标签数据<br>3. 记录评价日志 |
| 后续流程 | 1. 评价内容审核<br>2. 通知技师新评价                      |

## 评价管理-评价图片上传

### 展示字段

| 字段名     | 字段类型 | 说明               |
| ---------- | -------- | ------------------ |
| 图片上传区 | 上传组件 | 支持多图片上传     |
| 已上传图片 | 图片预览 | 已上传图片展示     |
| 图片说明   | 文本框   | 每张图片的说明文字 |

### 操作按钮

#### 1. 上传图片

| 操作     | 说明                                                                            |
| -------- | ------------------------------------------------------------------------------- |
| 前置校验 | 1. 图片格式是否正确<br>2. 图片大小是否超限(每张<=5M)<br>3. 数量是否超限(<=9 张) |
| 业务逻辑 | 1. 图片压缩处理<br>2. 上传至存储服务<br>3. 生成图片缩略图                       |
| 异常处理 | 1. 上传失败重试<br>2. 超时提醒                                                  |

#### 2. 删除图片

| 操作     | 说明                                                    |
| -------- | ------------------------------------------------------- |
| 业务逻辑 | 1. 删除已上传图片<br>2. 清理存储资源<br>3. 更新图片列表 |

## 评价管理-追评功能

### 展示字段

| 字段名     | 字段类型 | 说明                    |
| ---------- | -------- | ----------------------- |
| 原评价内容 | 只读文本 | 显示原评价信息          |
| 追评内容   | 文本框   | 追加评价内容，限 300 字 |
| 追评图片   | 上传组件 | 追评图片上传，最多 6 张 |
| 追评时间   | 只读文本 | 追评提交时间            |

### 操作按钮

#### 1. 提交追评

| 操作     | 说明                                                                 |
| -------- | -------------------------------------------------------------------- |
| 前置校验 | 1. 是否在追评有效期内(15 天内)<br>2. 是否已追评过<br>3. 内容是否合规 |
| 业务逻辑 | 1. 保存追评内容<br>2. 关联原评价 ID<br>3. 记录追评日志               |
| 后续流程 | 1. 追评内容审核<br>2. 通知技师新追评                                 |

#### 2. 取消追评

| 操作     | 说明                                                      |
| -------- | --------------------------------------------------------- |
| 业务逻辑 | 1. 清空已输入内容<br>2. 删除已上传图片<br>3. 返回评价详情 |