patrol-web_1.0.2.api 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515
  1. /**
  2. * @api {get} /v1/patrol/task/query/:id 03.查询巡检任务
  3. * @apiName 查询巡检任务
  4. * @apiGroup 巡检计划-巡检任务
  5. * @apiVersion 1.0.2
  6. * @apiPermission 【/v1/patrol/task/query/{id}#GET】
  7. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  8. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  9. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  10. * @apiParam { Long } id 巡检任务id
  11. * @apiSuccess { Object } data 数据
  12. * @apiSuccess { Long } data.id id 主键
  13. * @apiSuccess { String } data.name 名称
  14. * @apiSuccess { Integer } data.type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  15. * @apiSuccess { Integer } data.runModel 执行模式 1:其中一人 2:每人分别
  16. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  17. * @apiSuccess { Date } data.endTime 任务执行结束时间
  18. * @apiSuccess { String } data.remark 备注
  19. * @apiSuccess { Object } data.route 检查路线
  20. * @apiSuccess { Long } data.route.id 选项key
  21. * @apiSuccess { String } data.route.name 选项值
  22. * @apiSuccess { Object[] } data.executors 执行人列表
  23. * @apiSuccess { Long } data.executors.id 选项key
  24. * @apiSuccess { String } data.executors.name 选项值
  25. * @apiSuccess { String } message 信息
  26. * @apiSuccess { Integer } code 状态码
  27. * @apiSuccessExample Response
  28. *
  29. * {"data":{"id":1, "name":"", "type":1, "runModel":1, "beginTime":1653458673949, "endTime":1653458673949, "remark":"", "route":{"id":1, "name":""}, "executors":[{"id":1, "name":""}]}, "message":"", "code":1}
  30. */
  31. /**
  32. * @api {get} /v1/patrol/task/list 04.分页查询巡检任务
  33. * @apiName 分页查询巡检任务
  34. * @apiGroup 巡检计划-巡检任务
  35. * @apiVersion 1.0.2
  36. * @apiPermission 【/v1/patrol/task/list#GET】
  37. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  38. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  39. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  40. * @apiQuery { String } [ name ] 任务名称
  41. * @apiQuery { Boolean } [ disabled ] 是否禁用
  42. * @apiQuery { Integer } [ type ] 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  43. * @apiQuery { Integer } [ status ] 状态 1:未开始 2:进行中 3:正常完成 4:超时漏检 5:超时完成
  44. * @apiQuery { Integer } [ runModel ] 执行模式 1:其中一人 2:每人分别
  45. * @apiQuery { String } [ username ] 创建人
  46. * @apiQuery { String } [ executor ]
  47. * @apiQuery { Date } [ beginTimeStart ] 创建时间 开始时间
  48. * @apiQuery { Date } [ beginTimeEnd ] 创建时间 结束时间
  49. * @apiQuery { Integer } [ page = 1 ] 页码
  50. * @apiQuery { Integer } [ size = 10 ] 页大小
  51. * @apiQuery { String { ^[-+][\w]+ } } [ order = +id ] 排序规则(默认ID正序),排序字段前加:+表示正序 -表示倒序
  52. * @apiSuccess { Object } data 数据
  53. * @apiSuccess { Long } data.total 数据总数
  54. * @apiSuccess { Object[] } data.list 数据列表
  55. * @apiSuccess { Long } data.list.id id 主键
  56. * @apiSuccess { String } data.list.routeName 检查路线
  57. * @apiSuccess { String } data.list.username 创建人
  58. * @apiSuccess { String } data.list.number 编号
  59. * @apiSuccess { String } data.list.name 名称
  60. * @apiSuccess { Integer } data.list.type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  61. * @apiSuccess { Integer } data.list.status 状态 1:未开始 2:进行中 3:正常完成 4:超时漏检 5:超时完成
  62. * @apiSuccess { Integer } data.list.runModel 执行模式 1:其中一人 2:每人分别
  63. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  64. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  65. * @apiSuccess { Date } data.list.endTime 任务执行结束时间
  66. * @apiSuccess { String[] } data.list.executors 执行人列表
  67. * @apiSuccess { String } message 信息
  68. * @apiSuccess { Integer } code 状态码
  69. * @apiSuccessExample Response
  70. *
  71. * {"data":{"total":1, "list":[{"id":1, "routeName":"", "username":"", "number":"", "name":"", "type":1, "status":1, "runModel":1, "disabled":true, "beginTime":1653458673949, "endTime":1653458673949, "executors":[""]}]}, "message":"", "code":1}
  72. */
  73. /**
  74. * @api {post} /v1/patrol/plan/add 01.添加巡检计划
  75. * @apiName 添加巡检计划
  76. * @apiGroup 巡检计划-巡检计划查询
  77. * @apiVersion 1.0.2
  78. * @apiPermission 【/v1/patrol/plan/add#POST】
  79. * @apiHeader {String = application/json} Content-Type = application/json
  80. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  81. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  82. * @apiBody { Long } routeId 检查路线id
  83. * @apiBody { String } name 名称
  84. * @apiBody { Integer } type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  85. * @apiBody { Integer } runModel 执行模式 1:其中一人 2:每人分别
  86. * @apiBody { Date } beginDate 计划执行开始日期
  87. * @apiBody { Date } [ endDate ] 计划执行结束日期,空代表永不结束
  88. * @apiBody { Date } beginTime 任务执行开始时间
  89. * @apiBody { Date } endTime 任务执行结束时间
  90. * @apiBody { String } [ days ] 计划包含的天 [1-365]
  91. * @apiBody { String } [ remark ] 备注
  92. * @apiBody { Long[] } executors 执行人列表
  93. * @apiSuccess { Object } data 数据
  94. * @apiSuccess { Long } data.id id 主键
  95. * @apiSuccess { Long } data.routeId 路线id
  96. * @apiSuccess { Long } data.userId 创建人id
  97. * @apiSuccess { String } data.number 编号
  98. * @apiSuccess { String } data.name 名称
  99. * @apiSuccess { Boolean } data.disabled 是否禁用
  100. * @apiSuccess { Integer } data.type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  101. * @apiSuccess { Integer } data.runModel 执行模式 1:其中一人 2:每人分别
  102. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  103. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  104. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  105. * @apiSuccess { Date } data.endTime 任务执行结束时间
  106. * @apiSuccess { String } data.remark 备注
  107. * @apiSuccess { String } data.days 计划包含的天 [1-365]
  108. * @apiSuccess { String } message 信息
  109. * @apiSuccess { Integer } code 状态码
  110. * @apiSuccessExample Response
  111. *
  112. * {"data":{"id":1, "routeId":1, "userId":1, "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1653458673950, "endDate":1653458673951, "beginTime":1653458673951, "endTime":1653458673951, "remark":"", "days":""}, "message":"", "code":1}
  113. */
  114. /**
  115. * @api {put} /v1/patrol/plan/update 02.更新巡检计划
  116. * @apiName 更新巡检计划
  117. * @apiGroup 巡检计划-巡检计划查询
  118. * @apiVersion 1.0.2
  119. * @apiPermission 【/v1/patrol/plan/update#PUT】
  120. * @apiHeader {String = application/json} Content-Type = application/json
  121. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  122. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  123. * @apiBody { Long } id id 主键
  124. * @apiBody { Long } routeId 检查路线id
  125. * @apiBody { String } name 名称
  126. * @apiBody { Integer } type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  127. * @apiBody { Integer } runModel 执行模式 1:其中一人 2:每人分别
  128. * @apiBody { Date } beginDate 计划执行开始日期
  129. * @apiBody { Date } [ endDate ] 计划执行结束日期,空代表永不结束
  130. * @apiBody { Date } beginTime 任务执行开始时间
  131. * @apiBody { Date } endTime 任务执行结束时间
  132. * @apiBody { String } [ days ] 计划包含的天 [1-365]
  133. * @apiBody { String } [ remark ] 备注
  134. * @apiBody { Long[] } executors 执行人列表
  135. * @apiSuccess { Object } data 数据
  136. * @apiSuccess { Long } data.id id 主键
  137. * @apiSuccess { Long } data.routeId 路线id
  138. * @apiSuccess { Long } data.userId 创建人id
  139. * @apiSuccess { String } data.number 编号
  140. * @apiSuccess { String } data.name 名称
  141. * @apiSuccess { Boolean } data.disabled 是否禁用
  142. * @apiSuccess { Integer } data.type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  143. * @apiSuccess { Integer } data.runModel 执行模式 1:其中一人 2:每人分别
  144. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  145. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  146. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  147. * @apiSuccess { Date } data.endTime 任务执行结束时间
  148. * @apiSuccess { String } data.remark 备注
  149. * @apiSuccess { String } data.days 计划包含的天 [1-365]
  150. * @apiSuccess { String } message 信息
  151. * @apiSuccess { Integer } code 状态码
  152. * @apiSuccessExample Response
  153. *
  154. * {"data":{"id":1, "routeId":1, "userId":1, "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1653458673952, "endDate":1653458673952, "beginTime":1653458673952, "endTime":1653458673952, "remark":"", "days":""}, "message":"", "code":1}
  155. */
  156. /**
  157. * @api {get} /v1/patrol/plan/query/:id 04.查询巡检计划
  158. * @apiName 查询巡检计划
  159. * @apiGroup 巡检计划-巡检计划查询
  160. * @apiVersion 1.0.2
  161. * @apiPermission 【/v1/patrol/plan/query/{id}#GET】
  162. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  163. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  164. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  165. * @apiParam { Long } id 巡检计划id
  166. * @apiSuccess { Object } data 数据
  167. * @apiSuccess { Long } data.id id 主键
  168. * @apiSuccess { String } data.name 名称
  169. * @apiSuccess { Integer } data.type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  170. * @apiSuccess { Integer } data.runModel 执行模式 1:其中一人 2:每人分别
  171. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  172. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  173. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  174. * @apiSuccess { Date } data.endTime 任务执行结束时间
  175. * @apiSuccess { String } data.days 计划包含的天 [1-365]
  176. * @apiSuccess { String } data.remark 备注
  177. * @apiSuccess { Object } data.route 检查路线
  178. * @apiSuccess { Long } data.route.id 选项key
  179. * @apiSuccess { String } data.route.name 选项值
  180. * @apiSuccess { Object[] } data.executors 执行人列表
  181. * @apiSuccess { Long } data.executors.id 选项key
  182. * @apiSuccess { String } data.executors.name 选项值
  183. * @apiSuccess { String } message 信息
  184. * @apiSuccess { Integer } code 状态码
  185. * @apiSuccessExample Response
  186. *
  187. * {"data":{"id":1, "name":"", "type":1, "runModel":1, "beginDate":1653458673953, "endDate":1653458673953, "beginTime":1653458673953, "endTime":1653458673953, "days":"", "remark":"", "route":{"id":1, "name":""}, "executors":[{"id":1, "name":""}]}, "message":"", "code":1}
  188. */
  189. /**
  190. * @api {get} /v1/patrol/plan/list 05.分页查询巡检计划
  191. * @apiName 分页查询巡检计划
  192. * @apiGroup 巡检计划-巡检计划查询
  193. * @apiVersion 1.0.2
  194. * @apiPermission 【/v1/patrol/plan/list#GET】
  195. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  196. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  197. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  198. * @apiQuery { String } [ name ] 计划名称
  199. * @apiQuery { Boolean } [ disabled ] 是否禁用
  200. * @apiQuery { Integer } [ type ] 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  201. * @apiQuery { Integer } [ runModel ] 执行模式 1:其中一人 2:每人分别
  202. * @apiQuery { String } [ username ] 创建人
  203. * @apiQuery { String } [ executor ] 执行人
  204. * @apiQuery { Integer } [ page = 1 ] 页码
  205. * @apiQuery { Integer } [ size = 10 ] 页大小
  206. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  207. * @apiSuccess { Object } data 数据
  208. * @apiSuccess { Long } data.total 数据总数
  209. * @apiSuccess { Object[] } data.list 数据列表
  210. * @apiSuccess { Long } data.list.id id 主键
  211. * @apiSuccess { String } data.list.routeName 检查路线
  212. * @apiSuccess { String } data.list.username 创建人
  213. * @apiSuccess { String } data.list.number 编号
  214. * @apiSuccess { String } data.list.name 名称
  215. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  216. * @apiSuccess { Integer } data.list.type 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  217. * @apiSuccess { Integer } data.list.runModel 执行模式 1:其中一人 2:每人分别
  218. * @apiSuccess { Date } data.list.beginDate 计划执行开始日期
  219. * @apiSuccess { Date } data.list.endDate 计划执行结束日期,空代表永不结束
  220. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  221. * @apiSuccess { Date } data.list.endTime 任务执行结束时间
  222. * @apiSuccess { String } data.list.days 计划包含的天 [1-365]
  223. * @apiSuccess { String } data.list.remark 备注
  224. * @apiSuccess { String[] } data.list.executors 执行人列表
  225. * @apiSuccess { String } message 信息
  226. * @apiSuccess { Integer } code 状态码
  227. * @apiSuccessExample Response
  228. *
  229. * {"data":{"total":1, "list":[{"id":1, "routeName":"", "username":"", "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1653458673953, "endDate":1653458673953, "beginTime":1653458673953, "endTime":1653458673953, "days":"", "remark":"", "executors":[""]}]}, "message":"", "code":1}
  230. */
  231. /**
  232. * @api {delete} /v1/patrol/plan/delete 06.删除多条巡检计划
  233. * @apiName 删除多条巡检计划
  234. * @apiGroup 巡检计划-巡检计划查询
  235. * @apiVersion 1.0.2
  236. * @apiPermission 【/v1/patrol/plan/delete#DELETE】
  237. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  238. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  239. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  240. * @apiQuery { Long[] } ids 巡检计划id数组
  241. * @apiSuccess { Boolean } data 数据
  242. * @apiSuccess { String } message 信息
  243. * @apiSuccess { Integer } code 状态码
  244. * @apiSuccessExample Response
  245. *
  246. * {"data":true, "message":"", "code":1}
  247. */
  248. /**
  249. * @api {delete} /v1/patrol/plan/delete/:id 07.删除巡检计划
  250. * @apiName 删除巡检计划
  251. * @apiGroup 巡检计划-巡检计划查询
  252. * @apiVersion 1.0.2
  253. * @apiPermission 【/v1/patrol/plan/delete/{id}#DELETE】
  254. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  255. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  256. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  257. * @apiParam { Long } id 巡检计划id
  258. * @apiSuccess { Boolean } data 数据
  259. * @apiSuccess { String } message 信息
  260. * @apiSuccess { Integer } code 状态码
  261. * @apiSuccessExample Response
  262. *
  263. * {"data":true, "message":"", "code":1}
  264. */
  265. /**
  266. * @api {get} /v1/patrol/task/record/list/room 01.分页查询房间巡检记录
  267. * @apiName 分页查询房间巡检记录
  268. * @apiGroup 巡检任务-巡检任务记录
  269. * @apiVersion 1.0.2
  270. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  271. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  272. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  273. * @apiQuery { String } [ number ] 任务编号
  274. * @apiQuery { String } [ taskName ] 任务名称
  275. * @apiQuery { Integer } [ type ] 类型 1:日计划 2:周计划 3:月计划 4:季计划 5:半年计划 6:年计划
  276. * @apiQuery { Boolean } [ oneself ] 是否是本人完成
  277. * @apiQuery { String } [ username ] 执行用户名
  278. * @apiQuery { String } [ buildingName ] 楼栋名称
  279. * @apiQuery { String } [ floorName ] 楼层名称
  280. * @apiQuery { String } [ roomName ] 房间名称
  281. * @apiQuery { String } [ roomNumber ] 房间编号
  282. * @apiQuery { Date } [ beginTimeStart ] 任务开始时间 开始时间
  283. * @apiQuery { Date } [ beginTimeEnd ] 任务开始时间 结束时间
  284. * @apiQuery { Integer } [ page = 1 ] 页码
  285. * @apiQuery { Integer } [ size = 10 ] 页大小
  286. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ]
  287. * @apiSuccess { Object } data 数据
  288. * @apiSuccess { Long } data.total 数据总数
  289. * @apiSuccess { Object[] } data.list 数据列表
  290. * @apiSuccess { Long } data.list.id 任务id
  291. * @apiSuccess { String } data.list.name 任务名称
  292. * @apiSuccess { Integer } data.list.type 任务类型
  293. * @apiSuccess { String } data.list.buildingName 楼栋名称
  294. * @apiSuccess { String } data.list.floorName 楼层名称
  295. * @apiSuccess { Long } data.list.roomId 房间id
  296. * @apiSuccess { String } data.list.roomName 房间名称
  297. * @apiSuccess { String } data.list.roomNumber 房间编号
  298. * @apiSuccess { Long } data.list.userId 执行用户id
  299. * @apiSuccess { String } data.list.username 执行用户名
  300. * @apiSuccess { Date } data.list.beginTime 巡检时间
  301. * @apiSuccess { Date } data.list.endTime 结束时间
  302. * @apiSuccess { Boolean } data.list.completed 是否完成
  303. * @apiSuccess { Boolean } data.list.oneself 是否是本人完成
  304. * @apiSuccess { Boolean } data.list.qualified 是否合格
  305. * @apiSuccess { String } message 信息
  306. * @apiSuccess { Integer } code 状态码
  307. * @apiSuccessExample Response
  308. *
  309. * {"data":{"total":1, "list":[{"id":1, "name":"", "type":1, "buildingName":"", "floorName":"", "roomId":1, "roomName":"", "roomNumber":"", "userId":1, "username":"", "beginTime":1653458673953, "endTime":1653458673953, "completed":true, "oneself":true, "qualified":true}]}, "message":"", "code":1}
  310. */
  311. /**
  312. * @api {post} /v1/temporary/task/add 01.添加临时任务
  313. * @apiName 添加临时任务
  314. * @apiGroup 临时任务-全部临时任务
  315. * @apiVersion 1.0.2
  316. * @apiPermission 【/v1/temporary/task/add#POST】
  317. * @apiHeader {String = application/json} Content-Type = application/json
  318. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  319. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  320. * @apiBody { String { 0..255 } } title 任务标题
  321. * @apiBody { Long } roomId 房间id
  322. * @apiBody { String } belongSystem 所属系统
  323. * @apiBody { Integer } type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  324. * @apiBody { String { 0..255 } } content 任务内容
  325. * @apiBody { Long[] } executors 执行人列表
  326. * @apiBody { Date } finishTime 完成时间
  327. * @apiBody { String } [ images ] 任务图片
  328. * @apiSuccess { Object } data 数据
  329. * @apiSuccess { Long } data.id 任务id
  330. * @apiSuccess { Long } data.roomId 房间id
  331. * @apiSuccess { String } data.belongSystem 所属系统
  332. * @apiSuccess { String } data.title 任务标题
  333. * @apiSuccess { Integer } data.type 任务类型 1:般任务 2:较急任务 3:紧急任务
  334. * @apiSuccess { String } data.content 任务内容
  335. * @apiSuccess { Long } data.userId 任务创建用户id
  336. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  337. * @apiSuccess { Integer } data.auditStatus 审核状态 1:未提交 2:待审核 3:不通过
  338. * @apiSuccess { String } data.remark 审核备注
  339. * @apiSuccess { Integer } data.feedbackTotal 任务反馈数量
  340. * @apiSuccess { Date } data.publishTime 任务发布时间
  341. * @apiSuccess { Date } data.finishTime 任务完成时间
  342. * @apiSuccess { String } data.images 任务图片
  343. * @apiSuccess { String } message 信息
  344. * @apiSuccess { Integer } code 状态码
  345. * @apiSuccessExample Response
  346. *
  347. * {"data":{"id":1, "roomId":1, "belongSystem":"", "title":"", "type":1, "content":"", "userId":1, "status":1, "auditStatus":1, "remark":"", "feedbackTotal":1, "publishTime":1653458673953, "finishTime":1653458673953, "images":""}, "message":"", "code":1}
  348. */
  349. /**
  350. * @api {put} /v1/temporary/task/update 02.更新临时任务
  351. * @apiName 更新临时任务
  352. * @apiGroup 临时任务-全部临时任务
  353. * @apiVersion 1.0.2
  354. * @apiPermission 【/v1/temporary/task/update#PUT】
  355. * @apiHeader {String = application/json} Content-Type = application/json
  356. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  357. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  358. * @apiBody { Long } id id 主键
  359. * @apiBody { Integer } status 任务状态 1:完成 2:取消 3:不通过
  360. * @apiBody { String } [ remake ] 审核备注
  361. * @apiSuccess { Object } data 数据
  362. * @apiSuccess { Long } data.id 任务id
  363. * @apiSuccess { Long } data.roomId 房间id
  364. * @apiSuccess { String } data.belongSystem 所属系统
  365. * @apiSuccess { String } data.title 任务标题
  366. * @apiSuccess { Integer } data.type 任务类型 1:般任务 2:较急任务 3:紧急任务
  367. * @apiSuccess { String } data.content 任务内容
  368. * @apiSuccess { Long } data.userId 任务创建用户id
  369. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  370. * @apiSuccess { Integer } data.auditStatus 审核状态 1:未提交 2:待审核 3:不通过
  371. * @apiSuccess { String } data.remark 审核备注
  372. * @apiSuccess { Integer } data.feedbackTotal 任务反馈数量
  373. * @apiSuccess { Date } data.publishTime 任务发布时间
  374. * @apiSuccess { Date } data.finishTime 任务完成时间
  375. * @apiSuccess { String } data.images 任务图片
  376. * @apiSuccess { String } message 信息
  377. * @apiSuccess { Integer } code 状态码
  378. * @apiSuccessExample Response
  379. *
  380. * {"data":{"id":1, "roomId":1, "belongSystem":"", "title":"", "type":1, "content":"", "userId":1, "status":1, "auditStatus":1, "remark":"", "feedbackTotal":1, "publishTime":1653458673954, "finishTime":1653458673954, "images":""}, "message":"", "code":1}
  381. */
  382. /**
  383. * @api {get} /v1/temporary/task/list 03.分页查询临时任务
  384. * @apiName 分页查询临时任务
  385. * @apiGroup 临时任务-全部临时任务
  386. * @apiVersion 1.0.2
  387. * @apiPermission 【/v1/temporary/task/list#GET】
  388. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  389. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  390. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  391. * @apiQuery { String } [ title ] 任务标题
  392. * @apiQuery { Integer } [ type ] 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  393. * @apiQuery { Integer } [ status ] 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  394. * @apiQuery { Integer } [ auditStatus ] 审核状态 1:未提交 2:待审核 3:不通过
  395. * @apiQuery { String } [ content ] 任务内容
  396. * @apiQuery { String } [ username ] 发起人名称
  397. * @apiQuery { String } [ executor ] 执行人名称
  398. * @apiQuery { Date } [ startTime ] 开始日期
  399. * @apiQuery { Date } [ endTime ] 结束日期
  400. * @apiQuery { Integer } [ page = 1 ] 页码
  401. * @apiQuery { Integer } [ size = 10 ] 页大小
  402. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  403. * @apiSuccess { Object } data 数据
  404. * @apiSuccess { Long } data.total 数据总数
  405. * @apiSuccess { Object[] } data.list 数据列表
  406. * @apiSuccess { Long } data.list.id 任务id
  407. * @apiSuccess { Long } data.list.roomId 房间id
  408. * @apiSuccess { String } data.list.roomName 房间名称
  409. * @apiSuccess { String } data.list.belongSystem 所属系统
  410. * @apiSuccess { String } data.list.title 任务标题
  411. * @apiSuccess { Integer } data.list.type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  412. * @apiSuccess { String } data.list.username 发起人姓名
  413. * @apiSuccess { Integer } data.list.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  414. * @apiSuccess { Integer } data.list.auditStatus 审核状态 1:未提交 2:待审核 3:不通过
  415. * @apiSuccess { String } data.list.remark 审核备注
  416. * @apiSuccess { String } data.list.content 任务内容
  417. * @apiSuccess { Integer } data.list.feedbackTotal 执行反馈次数
  418. * @apiSuccess { Date } data.list.publishTime 发布时间
  419. * @apiSuccess { Date } data.list.finishTime 完成时间
  420. * @apiSuccess { String } data.list.images 任务图片
  421. * @apiSuccess { String[] } data.list.executors 执行人
  422. * @apiSuccess { String } message 信息
  423. * @apiSuccess { Integer } code 状态码
  424. * @apiSuccessExample Response
  425. *
  426. * {"data":{"total":1, "list":[{"id":1, "roomId":1, "roomName":"", "belongSystem":"", "title":"", "type":1, "username":"", "status":1, "auditStatus":1, "remark":"", "content":"", "feedbackTotal":1, "publishTime":1653458673954, "finishTime":1653458673954, "images":"", "executors":[""]}]}, "message":"", "code":1}
  427. */
  428. /**
  429. * @api {delete} /v1/temporary/task/delete 05.删除多条临时任务
  430. * @apiName 删除多条临时任务
  431. * @apiGroup 临时任务-全部临时任务
  432. * @apiVersion 1.0.2
  433. * @apiPermission 【/v1/temporary/task/delete#DELETE】
  434. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  435. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  436. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  437. * @apiQuery { Long[] } ids 临时任务id数组
  438. * @apiSuccess { Boolean } data 数据
  439. * @apiSuccess { String } message 信息
  440. * @apiSuccess { Integer } code 状态码
  441. * @apiSuccessExample Response
  442. *
  443. * {"data":true, "message":"", "code":1}
  444. */
  445. /**
  446. * @api {delete} /v1/temporary/task/delete/:id 06.删除临时任务
  447. * @apiName 删除临时任务
  448. * @apiGroup 临时任务-全部临时任务
  449. * @apiVersion 1.0.2
  450. * @apiPermission 【/v1/temporary/task/delete/{id}#DELETE】
  451. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  452. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  453. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  454. * @apiParam { Long } id 临时任务id
  455. * @apiSuccess { Boolean } data 数据
  456. * @apiSuccess { String } message 信息
  457. * @apiSuccess { Integer } code 状态码
  458. * @apiSuccessExample Response
  459. *
  460. * {"data":true, "message":"", "code":1}
  461. */
  462. /**
  463. * @api {post} /v1/device/import 03.批量导入设备
  464. * @apiName 批量导入设备
  465. * @apiGroup 资产管理-设备管理
  466. * @apiVersion 1.0.2
  467. * @apiPermission 【/v1/device/import#POST】
  468. * @apiHeader {String = multipart/form-data} Content-Type = multipart/form-data
  469. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  470. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  471. * @apiQuery { File } file 设备数据表格
  472. * @apiSuccess { Boolean } data 数据
  473. * @apiSuccess { String } message 信息
  474. * @apiSuccess { Integer } code 状态码
  475. * @apiSuccessExample Response
  476. *
  477. * {"data":true, "message":"", "code":1}
  478. */
  479. /**
  480. * @api {get} /v1/device/import/progress/rate 04.查询批量导入设备进度
  481. * @apiName 查询批量导入设备进度
  482. * @apiGroup 资产管理-设备管理
  483. * @apiVersion 1.0.2
  484. * @apiPermission 【/v1/device/import/progress/rate#GET】
  485. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  486. * @apiHeader {String} Authorization = eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU 授权信息
  487. * @apiHeader {String = zh-CN,en-US} accept-language = zh-CN
  488. * @apiSuccess { Object } data 数据
  489. * @apiSuccess { Integer } data.total 本次导入数据数量
  490. * @apiSuccess { Integer } data.processCount 已处理数量
  491. * @apiSuccess { Boolean } data.updating 正在处理中
  492. * @apiSuccess { Date } data.createTime 任务创建时间
  493. * @apiSuccess { String } data.message 消息
  494. * @apiSuccess { String } message 信息
  495. * @apiSuccess { Integer } code 状态码
  496. * @apiSuccessExample Response
  497. *
  498. * {"data":{"total":1, "processCount":1, "updating":true, "createTime":1653458673954, "message":""}, "message":"", "code":1}
  499. */