You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

23 KiB

Raw Blame History Unescape Escape

在线报修

模块编码：repair 端侧：Web + 小程序（双端）关联文档：01-模块划分 §3.1 / 02-功能清单-物业公司 §1 / 03-业务流转逻辑-物业公司 §1 / 05-接口规范 §9.2 / 06-项目技术要求 §4.4

功能概览

项目	说明
菜单名称	在线报修
子菜单	工单列表、工单详情、报修类型管理、数据补录
功能编号	PR-R-01 ~ PR-R-11
权限编码前缀	repair:list:* / repair:detail:* / repair:type:* / repair:supplement:*

页面1：工单列表页

页面编号：PR-R-01-P01 端侧归属：Web专属（小程序端对应"我的工单"，见 MP-R-03） 页面路径：/repair/orders

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 在线报修 > 工单列表                                       │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 工单号[____] 状态[▼多选] 报修类型[▼] 紧急程度[▼]                  │
│ 提交日期[起始]~[结束]  所属班组[▼]  所属区域[▼]                    │
│                                              [查询] [重置]        │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增工单] [批量分配] [批量关闭] [导出Excel]              │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ ☐ | 工单号 | 报修类型 | 紧急程度 | 状态 | 报修人 | 班组 | ...      │
│ ☐ | WX001  | 水电     | 紧急     | 待分配| 张三  | 水电班| ...     │
│ ☐ | WX002  | 木工     | 普通     | 处理中| 李四  | 木工班| ...     │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共156条  每页[20▼]  < 1 2 3 ... 8 >                       │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
工单号	文本输入	否	—	模糊匹配
状态	下拉多选	否	全部	待分配/处理中/延期中/待验收/已完成/已关闭
报修类型	下拉单选	否	全部	数据来源：字典管理-报修类型
紧急程度	下拉单选	否	全部	紧急/普通/低优先
提交日期	日期范围	否	—	起始~结束
所属班组	下拉单选	否	全部	数据来源：组织架构-班组
所属区域	级联选择	否	全部	项目→区域→楼栋→楼层

列表字段

序号	字段名	列宽	支持排序	说明
1	☐勾选	40px	—	批量操作用
2	工单号	140px	是	点击跳转详情页
3	报修类型	80px	是	标签样式
4	紧急程度	80px	是	紧急=红色/普通=蓝色/低=灰色
5	状态	90px	是	彩色标签区分状态
6	报修人	80px	否	—
7	负责班组	90px	是	—
8	维修人员	80px	否	未分配时显示"—"
9	提交时间	150px	是	默认倒序
10	预约时间	150px	否	—
11	补录标记	70px	否	补录数据显示"补录"橙色标签
12	操作	160px	—	查看/分配/关闭

操作按钮

按钮	权限编码	位置	显示条件	说明
新增工单	repair:list:create	操作栏	始终	弹窗/跳转新增页
批量分配	repair:list:assign	操作栏	勾选≥1条且状态=待分配	批量分配弹窗
批量关闭	repair:list:update	操作栏	勾选≥1条且状态=待分配	二次确认弹窗
导出Excel	repair:list:export	操作栏	始终	导出当前筛选结果
行内-分配	repair:list:assign	操作列	状态=待分配	—
行内-关闭	repair:list:update	操作列	状态=待分配	二次确认
行内-查看	repair:list:view	操作列	始终	跳转详情页

角色差异化视图

角色	可见按钮	数据范围	备注
物业管理员	全部按钮	本公司绑定医院全部数据	—
主管	查看、分配、导出	本班组数据	无新增按钮
维修人员	仅查看	仅本人负责的工单	操作列仅"查看"

通知触发

触发操作	通知对象	通知方式	消息模板	文档来源
工单分配	被分配的维修人员	小程序推送	新工单通知	01 §7.1
工单关闭	报修人	小程序推送	工单关闭通知	01 §7.1

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/repair-orders	GET	分页查询，支持筛选参数
批量分配	/api/v1/repair-orders/batch-assign	POST	批量分配到班组/人员
批量关闭	/api/v1/repair-orders/batch-close	POST	需填关闭原因
导出	/api/v1/repair-orders/export	GET	导出Excel

页面2：工单详情页

页面编号：PR-R-02-P01 端侧归属：Web专属 页面路径：/repair/orders/:id

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 在线报修 > 工单列表 > 工单详情                             │
├──────────────────────────────────────────────────────────────────┤
│ [状态栏]  工单号：WX20260416001   当前状态：待分配                  │
├──────────────────────────────────────────────────────────────────┤
│ [标签页]  基本信息 | 流转记录 | 照片附件 | 评价信息                   │
├──────────────────────────────────────────────────────────────────┤
│ ── 基本信息（默认展示）──                                          │
│ 报修类型：水电          紧急程度：紧急                               │
│ 报修人：张三            联系电话：138****1234                        │
│ 报修区域：主院区/门诊楼/3层                                         │
│ 报修描述：3楼走廊灯管不亮，影响夜间通行                              │
│ 预约时间：2026-04-16 14:00                                        │
│ 补录标记：否                                                      │
├──────────────────────────────────────────────────────────────────┤
│ [底部操作栏]                                                      │
│ [分配工单] [关闭工单]                          状态=待分配时显示      │
│ [验收通过] [验收不通过(退回)]                  状态=待验收时显示      │
└──────────────────────────────────────────────────────────────────┘

标签页内容

标签页	内容	说明
基本信息	报修类型、紧急程度、报修人、区域、描述、预约时间、补录标记	补录数据额外显示补录原因和审核状态
流转记录	时间轴展示工单状态变更历史	每条记录含：操作人、时间、操作类型、备注
照片附件	报修照片（缩略图+点击预览）	照片含水印信息：时间+位置+蓝牙连接标记
评价信息	工单完成后的评价内容	评分+留言+图片，未评价时显示"暂无评价"

操作按钮

按钮	权限编码	位置	显示条件	说明
分配工单	repair:list:assign	底部操作栏	状态=待分配	弹窗选择班组/人员
关闭工单	repair:list:update	底部操作栏	状态=待分配	填写关闭原因
审批延期	repair:detail:approve	底部操作栏	状态=延期中	通过/驳回
验收通过	repair:detail:approve	底部操作栏	状态=待验收	—
验收不通过	repair:detail:approve	底部操作栏	状态=待验收	填写不通过原因，退回返修

角色差异化视图

角色	可见操作	数据范围	备注
物业管理员	全部操作	全部工单	—
主管	分配、审批、验收	本班组工单	—
维修人员	仅查看	仅本人负责的工单	底部操作栏隐藏

通知触发

触发操作	通知对象	通知方式	消息模板	文档来源
分配工单	维修人员	小程序推送	新工单通知	01 §7.1
延期审批结果	维修人员	小程序推送	延期审批结果通知	01 §7.1
验收不通过	维修人员	小程序推送	验收退回通知	01 §7.1
验收通过	报修人	小程序推送	工单完成通知，触发评价	01 §7.1

API端点

页面操作	API路径	方法	说明
详情查询	/api/v1/repair-orders/{id}	GET	含基本信息+流转记录+照片
分配工单	/api/v1/repair-orders/{id}/assign	POST	分配到班组/人员
关闭工单	/api/v1/repair-orders/{id}/close	POST	填写关闭原因
延期审批	/api/v1/repair-orders/{id}/delay-approve	POST	通过/驳回
验收	/api/v1/repair-orders/{id}/accept	POST	通过/不通过

页面3：新增工单弹窗

页面编号：PR-R-01-P02 端侧归属：Web专属 页面路径：弹窗形式

界面布局

┌──────────────────────────────────────┐
│ 新增工单                        [×]  │
├──────────────────────────────────────┤
│ 报修类型：[▼必选]       紧急程度：[▼] │
│ 报修区域：[级联选择▼]                  │
│ 报修人：  [____]      联系电话：[____] │
│ 预约时间：[日期时间选择]               │
│ 报修描述：                            │
│ ┌────────────────────────────────┐   │
│ │                                │   │
│ └────────────────────────────────┘   │
│ 照片上传：[+点击上传]  (≤9张)         │
│  📷1  📷2  📷3                       │
├──────────────────────────────────────┤
│              [取消]  [提交]           │
└──────────────────────────────────────┘

表单字段

字段名	控件类型	必填	默认值	数据来源	校验规则
报修类型	下拉单选	是	—	字典管理-报修类型	—
紧急程度	下拉单选	是	普通	固定选项	紧急/普通/低优先
报修区域	级联选择	是	—	区域五级架构	至少选到楼层
报修人	文本输入	是	—	自填	最大20字
联系电话	文本输入	是	—	自填	手机号格式校验
预约时间	日期时间	否	—	自填	不早于当前时间
报修描述	多行文本	是	—	自填	最大500字
照片	图片上传	否	—	拍照/相册	≤9张，单张≤20MB，自动加水印

页面4：报修类型管理页

页面编号：PR-R-07-P01 端侧归属：Web专属 页面路径：/repair/types

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 在线报修 > 报修类型管理                                    │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增类型]                                               │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 类型名称 | 关联班组 | 工单数量 | 状态 | 操作                │
│ 1    | 水电     | 水电班   | 23      | 启用 | 编辑 停用            │
│ 2    | 木工     | 木工班   | 8       | 启用 | 编辑 停用            │
│ 3    | 空调     | 暖通班   | 15      | 停用 | 编辑 启用            │
└──────────────────────────────────────────────────────────────────┘

表单字段（新增/编辑弹窗）

字段名	控件类型	必填	默认值	数据来源	校验规则
类型名称	文本输入	是	—	自填	最大20字，同租户内唯一
关联班组	下拉多选	是	—	组织架构-班组	至少选一个
描述	多行文本	否	—	自填	最大200字

操作按钮

按钮	权限编码	位置	显示条件	说明
新增类型	repair:type:create	操作栏	始终	弹窗
编辑	repair:type:update	行操作	始终	弹窗
启用/停用	repair:type:update	行操作	始终	有工单关联时不可停用，提示先迁移

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/repair-types	GET	—
新增	/api/v1/repair-types	POST	—
编辑	/api/v1/repair-types/{id}	PUT	—
启用/停用	/api/v1/repair-types/{id}/toggle-status	PUT	—

页面5：数据补录页

页面编号：PR-R-10-P01 端侧归属：Web专属 页面路径：/repair/supplement

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 在线报修 > 数据补录                                       │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 补录状态[▼] 补录人[____] 补录时间[起始]~[结束]    [查询] [重置]    │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号 | 工单号 | 补录人 | 补录原因 | 补录时间 | 审核状态 | 操作     │
│ 1    | WX001  | 张三   | 系统异常 | 10:30   | 待审核   | 审核 详情│
│ 2    | WX002  | 李四   | 蓝牙故障 | 09:15   | 已通过   | 详情     │
└──────────────────────────────────────────────────────────────────┘

查询条件

字段名	控件类型	必填	默认值	说明
补录状态	下拉单选	否	全部	待审核/已通过/已驳回
补录人	文本输入	否	—	模糊匹配
补录时间	日期范围	否	—	—

补录数据标记规范

标记项	说明
列表标签	补录行在工单列表中显示"补录"橙色标签
补录原因	蓝牙故障/系统异常/定位失败/其他（枚举）
审核状态列	待审核(黄色)/已通过(绿色)/已驳回(红色)
详情展示	补录原因+详细说明+审核人+审核时间
统计排除	补录数据在统计报表中单独标记，默认包含，可筛选排除

操作按钮

按钮	权限编码	位置	显示条件	说明
审核	repair:supplement:approve	行操作	审核状态=待审核	通过/驳回弹窗
详情	repair:supplement:view	行操作	始终	查看补录详情

API端点

页面操作	API路径	方法	说明
列表查询	/api/v1/repair-orders/supplements	GET	分页查询
审核	/api/v1/repair-orders/supplements/{id}/approve	POST	通过/驳回

需求追溯

功能点编号	功能名称	文档来源	后续服务	关联功能
PR-R-01	工单列表	02-物业公司 §1 / 03-物业公司 §1.2	—	巡检异常上报→自动生成工单
PR-R-02	工单详情	02-物业公司 §1 / 03-物业公司 §1.2	流转记录、照片查看	评价管理→工单评价展示
PR-R-03	工单分配	02-物业公司 §1 / 03-物业公司 §1.2	触发通知服务→推送维修人员	组织架构→班组/人员选择
PR-R-04	工单流转	02-物业公司 §1 / 03-物业公司 §1.2	状态变更→触发通知	—
PR-R-05	延期审批	02-物业公司 §1 / 03-物业公司 §1.2	审批结果→通知维修人员	小程序端延期申请(MP-R-07)
PR-R-06	协助维修管理	02-物业公司 §1 / 03-物业公司 §1.2	生成协助子工单→通知协助班组	小程序端协助申请(MP-R-09)
PR-R-07	报修类型管理	02-物业公司 §1	类型变更→刷新字典缓存	字典管理→报修类型字典
PR-R-08	工单验收	02-物业公司 §1 / 03-物业公司 §1.2	验收通过→触发评价	小程序端验收(MP-R-11) / 评价管理
PR-R-09	退单/返修处理	02-物业公司 §1 / 03-物业公司 §1.2	退回→通知维修人员	—
PR-R-10	数据补录	02-物业公司 §1 / 03-物业公司 §2.2	补录审核→通知补录人	操作日志→补录日志
PR-R-11	工单导出	02-物业公司 §1	记录导出操作日志	—

业务规则

工单号规则：WX + 年月日 + 3位序号，如 WX20260416001（来源：03-物业公司 §1）
状态流转规则：待分配→处理中→待验收→已完成/已关闭，详见状态流转图（来源：03-物业公司 §1.2）
分配规则：支持手动分配和自动分配（按报修类型→关联班组→班组内轮询）（来源：02-物业公司 PR-R-03）
照片水印：上传照片自动添加水印（时间+位置+蓝牙连接标记），来源：05-接口规范 §3.2
补录审核：补录数据需主管审核，审核通过后生效；审核驳回需通知补录人（来源：03-物业公司 §2.2）
验收触发评价：工单验收通过后自动触发评价流程（来源：03-物业公司 §1.2，事件：ORDER_COMPLETED）
退单返修：验收不通过时工单退回处理中状态，维修人员需重新处理（来源：03-物业公司 §1.2）
数据权限：主管仅看本班组数据，员工仅看本人数据（来源：01 §1.3）
操作日志：所有工单操作自动记录审计日志（来源：06 §4.5）

状态流转

                    ┌─── 关闭工单 ──▶ 已关闭
                    │
报修提交 ──▶ 待分配 ──▶ 分配工单 ──▶ 处理中 ──▶ 提交完工 ──▶ 待验收 ──▶ 验收通过 ──▶ 已完成
                                              │                  │
                                         申请延期▶ 延期中       验收不通过
                                         申请协助▶ 生成子工单     │
                                              │                  ▼
                                         延期审批              退回处理中
                                         通过/驳回             (返修)

当前状态	操作	目标状态	执行角色	端侧
—	提交报修	待分配	报修人	小程序
待分配	分配工单	处理中	主管/系统	Web+小程序
待分配	关闭工单	已关闭	主管	Web+小程序
处理中	提交完工	待验收	维修人员	小程序
处理中	申请延期	延期中	维修人员	小程序
处理中	申请协助	处理中	维修人员	小程序
延期中	审批通过	处理中	主管	Web+小程序
延期中	审批驳回	处理中	主管	Web+小程序
待验收	验收通过	已完成	主管/报修人	Web+小程序
待验收	验收不通过	处理中	主管/报修人	Web+小程序
已完成	评价	已完成	报修人	小程序

23 KiB Raw Blame History Unescape Escape

在线报修

功能概览

页面1：工单列表页

界面布局

查询条件

列表字段

操作按钮

角色差异化视图

通知触发

API端点

页面2：工单详情页

界面布局

标签页内容

操作按钮

角色差异化视图

通知触发

API端点

页面3：新增工单弹窗

界面布局

表单字段

页面4：报修类型管理页

界面布局

表单字段（新增/编辑弹窗）

操作按钮

API端点

页面5：数据补录页

界面布局

查询条件

补录数据标记规范

操作按钮

API端点

需求追溯

业务规则

状态流转

23 KiB

Raw Blame History Unescape Escape