业主报修接口文档

提交报修
查询报修单
查询待办单
办理报修

一、接口名称

业主报修接口，提交保修单

二、接口描述

该接口用于业主提交报修信息，包括报修内容、预约时间、联系方式等，并支持上传报修图片。

三、接口路径

http://{ip}:{port}/app/ownerRepair.saveOwnerRepair

四、请求方法

POST

五、请求头

六、请求参数

6.1 请求体参数（JSON格式）

七、返回值

7.1 返回数据（JSON格式）

八、示例请求

{
  "repairName": "张三",
  "repairType": "102022081592760001",
  "appointmentTime": "2022-11-26 15:18:00",
  "tel": "15239726115",
  "roomId": "752022090312040033",
  "photos": ["image1.jpg", "image2.jpg"],
  "context": "水管漏水",
  "communityId": "2022032267510001",
  "repairObjType": "004",
  "repairChannel": "Z",
  "repairObjId": "752022090312040033",
  "repairObjName": "1号楼1单元202室"
}

九、示例响应

{
  "code": 0,
  "msg": "成功",
  "page": 0,
  "records": 0,
  "rows": 0,
  "total": 0
}

十、业务逻辑说明

1. 参数校验：

   • 校验必填参数（repairType、repairName、tel、repairObjType、repairObjId、repairObjName、appointmentTime、context、communityId）。
   • 检查用户是否存在。
   • 检查该房屋是否存在未处理的报修费用（超过限制则不允许报修）。

2. 报修信息存储：

   • 生成报修单号（repairId）。
   • 设置报修状态为“待处理”（STATE_WAIT）。
   • 计算超时时间（timeout）。
   • 保存报修记录（repairPool）。

3. 报修流程记录：

   • 记录报修流程（repairUser），状态为“提交”（STATE_SUBMIT）。

4. 图片存储：

   • 如果图片是Base64编码，则存储到文件服务器并返回URL。
   • 关联图片与报修单（fileRel）。

5. 关联业主反馈（可选）：

   • 如果存在noteId，则关联报修单与业主反馈记录。

十一、错误码