patrol-app_1.0.0.api 50 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059
  1. /**
  2. * @api {post} /v1/system/user/login 01.登录
  3. * @apiName 登录
  4. * @apiGroup 用户
  5. * @apiHeader {String = application/json} Content-Type = application/json
  6. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  7. * @apiVersion 1.0.0
  8. * @apiBody { String } [ username ] 用户名
  9. * @apiBody { String } [ telephone ] 手机号码
  10. * @apiBody { String } password 用户密码(md5加密)
  11. * @apiSuccess { Object } data 数据
  12. * @apiSuccess { Long } data.id 用户id
  13. * @apiSuccess { String } data.username 用户名称
  14. * @apiSuccess { String } data.telephone 手机号
  15. * @apiSuccess { String } data.deptName 用户部门
  16. * @apiSuccess { String } data.token 授权信息
  17. * @apiSuccess { String } message 信息
  18. * @apiSuccess { Integer } code 状态码
  19. * @apiSuccessExample Response
  20. *
  21. * {"data":{"id":1, "username":"", "telephone":"", "deptName":"", "token":""}, "message":"", "code":1}
  22. */
  23. /**
  24. * @api {put} /v1/system/user/update/password 02.更新用户密码
  25. * @apiName 更新用户密码
  26. * @apiGroup 用户
  27. * @apiHeader {String = application/json} Content-Type = application/json
  28. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  29. * @apiHeader {String} Authorization 授权信息
  30. * @apiVersion 1.0.0
  31. * @apiBody { String } passwordOld 旧密码(md5加密)
  32. * @apiBody { String } password 密码(md5加密)
  33. * @apiSuccess { Boolean } data 数据
  34. * @apiSuccess { String } message 信息
  35. * @apiSuccess { Integer } code 状态码
  36. * @apiSuccessExample Response
  37. *
  38. * {"data":true, "message":"", "code":1}
  39. */
  40. /**
  41. * @api {get} /v1/system/user/list/dept/user 03.查询部门用户
  42. * @apiName 查询部门用户
  43. * @apiGroup 用户
  44. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  45. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  46. * @apiHeader {String} Authorization 授权信息
  47. * @apiVersion 1.0.0
  48. * @apiQuery { String } [ username ] 用户名
  49. * @apiSuccess { Object[] } data 数据
  50. * @apiSuccess { String } data.name 部门名称
  51. * @apiSuccess { Object[] } data.users 用户列表
  52. * @apiSuccess { Long } data.users.id 用户ID
  53. * @apiSuccess { String } data.users.username 用户名
  54. * @apiSuccess { String } data.users.telephone 手机号
  55. * @apiSuccess { String } message 信息
  56. * @apiSuccess { Integer } code 状态码
  57. * @apiSuccessExample Response
  58. *
  59. * {"data":[{"name":"", "users":[{"id":1, "username":"", "telephone":""}]}], "message":"", "code":1}
  60. */
  61. /**
  62. * @api {get} /v1/system/user/list/option 04.通过用户名或手机号查询用户选项
  63. * @apiName 通过用户名或手机号查询用户选项
  64. * @apiGroup 用户
  65. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  66. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  67. * @apiHeader {String} Authorization 授权信息
  68. * @apiVersion 1.0.0
  69. * @apiQuery { String } [ keyword ] 用户名或手机号
  70. * @apiQuery { Integer } [ page = 1 ] 页码
  71. * @apiQuery { Integer } [ size = 10 ] 页大小
  72. * @apiSuccess { Object } data 数据
  73. * @apiSuccess { Long } data.total 数据总数
  74. * @apiSuccess { Object[] } data.list 数据列表
  75. * @apiSuccess { Long } data.list.id 选项key
  76. * @apiSuccess { String } data.list.name 选项值
  77. * @apiSuccess { String } message 信息
  78. * @apiSuccess { Integer } code 状态码
  79. * @apiSuccessExample Response
  80. *
  81. * {"data":{"total":1, "list":[{"id":1, "name":""}]}, "message":"", "code":1}
  82. */
  83. /**
  84. * @api {get} /v1/device/building/list/option 01.获取所有楼栋选项列表
  85. * @apiName 获取所有楼栋选项列表
  86. * @apiGroup 楼栋
  87. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  88. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  89. * @apiHeader {String} Authorization 授权信息
  90. * @apiVersion 1.0.0
  91. * @apiSuccess { Object[] } data 数据
  92. * @apiSuccess { Long } data.id 选项key
  93. * @apiSuccess { String } data.name 选项值
  94. * @apiSuccess { String } message 信息
  95. * @apiSuccess { Integer } code 状态码
  96. * @apiSuccessExample Response
  97. *
  98. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  99. */
  100. /**
  101. * @api {get} /v1/device/floor/list/option/:buildingId 01.获取楼栋中的所有楼层选项
  102. * @apiName 获取楼栋中的所有楼层选项
  103. * @apiGroup 楼层
  104. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  105. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  106. * @apiHeader {String} Authorization 授权信息
  107. * @apiVersion 1.0.0
  108. * @apiParam { Long } buildingId 楼栋id
  109. * @apiSuccess { Object[] } data 数据
  110. * @apiSuccess { Long } data.id 选项key
  111. * @apiSuccess { String } data.name 选项值
  112. * @apiSuccess { String } message 信息
  113. * @apiSuccess { Integer } code 状态码
  114. * @apiSuccessExample Response
  115. *
  116. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  117. */
  118. /**
  119. * @api {get} /v1/device/room/list 01.获取巡检路线中的房间
  120. * @apiName 获取巡检路线中的房间
  121. * @apiGroup 房间
  122. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  123. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  124. * @apiHeader {String} Authorization 授权信息
  125. * @apiVersion 1.0.0
  126. * @apiQuery { String } [ name ] 房间名称
  127. * @apiQuery { Long } [ id ] 检查路线id
  128. * @apiQuery { Integer } [ page = 1 ] 页码
  129. * @apiQuery { Integer } [ size = 10 ] 页大小
  130. * @apiSuccess { Object } data 数据
  131. * @apiSuccess { Long } data.total 数据总数
  132. * @apiSuccess { Object[] } data.list 数据列表
  133. * @apiSuccess { Long } data.list.routeId 路线id
  134. * @apiSuccess { String } data.list.number 编号
  135. * @apiSuccess { Long } data.list.id 选项key
  136. * @apiSuccess { String } data.list.name 选项值
  137. * @apiSuccess { String } message 信息
  138. * @apiSuccess { Integer } code 状态码
  139. * @apiSuccessExample Response
  140. *
  141. * {"data":{"total":1, "list":[{"routeId":1, "number":"", "id":1, "name":""}]}, "message":"", "code":1}
  142. */
  143. /**
  144. * @api {get} /v1/device/room/query 02.查询房间详情
  145. * @apiName 查询房间详情
  146. * @apiGroup 房间
  147. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  148. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  149. * @apiHeader {String} Authorization 授权信息
  150. * @apiVersion 1.0.0
  151. * @apiQuery { Long } id 房间id
  152. * @apiQuery { Long } routeId 路线id
  153. * @apiSuccess { Object } data 数据
  154. * @apiSuccess { Long } data.id 房间id
  155. * @apiSuccess { String } data.name 房间名称
  156. * @apiSuccess { String } data.number 房间编号
  157. * @apiSuccess { String } data.floorName 楼层名称
  158. * @apiSuccess { String } data.buildingName 楼栋名称
  159. * @apiSuccess { String } data.routeName 路线名称
  160. * @apiSuccess { Object[] } data.checkItems 检查项列表
  161. * @apiSuccess { Integer } data.checkItems.itemType 检查项类别 1选择、2数字、3文本、4拍照
  162. * @apiSuccess { Long } data.checkItems.id 选项key
  163. * @apiSuccess { String } data.checkItems.name 选项值
  164. * @apiSuccess { Object[] } data.devices 设备列表
  165. * @apiSuccess { Long } data.devices.id 设备id
  166. * @apiSuccess { String } data.devices.name 设备名称
  167. * @apiSuccess { Object[] } data.devices.checkItems 检查项列表
  168. * @apiSuccess { Integer } data.devices.checkItems.itemType 检查项类别 1选择、2数字、3文本、4拍照
  169. * @apiSuccess { Long } data.devices.checkItems.id 选项key
  170. * @apiSuccess { String } data.devices.checkItems.name 选项值
  171. * @apiSuccess { String } message 信息
  172. * @apiSuccess { Integer } code 状态码
  173. * @apiSuccessExample Response
  174. *
  175. * {"data":{"id":1, "name":"", "number":"", "floorName":"", "buildingName":"", "routeName":"", "checkItems":[{"itemType":1, "id":1, "name":""}], "devices":[{"id":1, "name":"", "checkItems":[{"itemType":1, "id":1, "name":""}]}]}, "message":"", "code":1}
  176. */
  177. /**
  178. * @api {get} /v1/device/room/list/option/:floorId 03.获取楼层中的所有房间选项
  179. * @apiName 获取楼层中的所有房间选项
  180. * @apiGroup 房间
  181. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  182. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  183. * @apiHeader {String} Authorization 授权信息
  184. * @apiVersion 1.0.0
  185. * @apiParam { Long } floorId 楼层id
  186. * @apiSuccess { Object[] } data 数据
  187. * @apiSuccess { Long } data.id 选项key
  188. * @apiSuccess { String } data.name 选项值
  189. * @apiSuccess { String } message 信息
  190. * @apiSuccess { Integer } code 状态码
  191. * @apiSuccessExample Response
  192. *
  193. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  194. */
  195. /**
  196. * @api {get} /v1/device/list 01.获取房间中的设备
  197. * @apiName 获取房间中的设备
  198. * @apiGroup 设备
  199. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  200. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  201. * @apiHeader {String} Authorization 授权信息
  202. * @apiVersion 1.0.0
  203. * @apiQuery { Long } roomId 房间id
  204. * @apiQuery { Integer } [ page = 1 ] 页码
  205. * @apiQuery { Integer } [ size = 10 ] 页大小
  206. * @apiSuccess { Object } data 数据
  207. * @apiSuccess { Long } data.total 数据总数
  208. * @apiSuccess { Object[] } data.list 数据列表
  209. * @apiSuccess { Long } data.list.id 设备id
  210. * @apiSuccess { String } data.list.name 设备名称
  211. * @apiSuccess { String } data.list.number 设备编号
  212. * @apiSuccess { Integer } data.list.type 设备类型 1:机柜设备 99:其他设备
  213. * @apiSuccess { Integer } data.list.checkItemTotal 关联检查项数
  214. * @apiSuccess { String } message 信息
  215. * @apiSuccess { Integer } code 状态码
  216. * @apiSuccessExample Response
  217. *
  218. * {"data":{"total":1, "list":[{"id":1, "name":"", "number":"", "type":1, "checkItemTotal":1}]}, "message":"", "code":1}
  219. */
  220. /**
  221. * @api {get} /v1/check/route/list/option 01.巡检路线
  222. * @apiName 巡检路线
  223. * @apiGroup 检查路线
  224. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  225. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  226. * @apiHeader {String} Authorization 授权信息
  227. * @apiVersion 1.0.0
  228. * @apiQuery { String } [ name ] 路线名称
  229. * @apiSuccess { Object[] } data 数据
  230. * @apiSuccess { Long } data.id 选项key
  231. * @apiSuccess { String } data.name 选项值
  232. * @apiSuccess { String } message 信息
  233. * @apiSuccess { Integer } code 状态码
  234. * @apiSuccessExample Response
  235. *
  236. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  237. */
  238. /**
  239. * @api {get} /v1/stock/classify/list 01.分页查询物品类别
  240. * @apiName 分页查询物品类别
  241. * @apiGroup 物品类别
  242. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  243. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  244. * @apiHeader {String} Authorization 授权信息
  245. * @apiVersion 1.0.0
  246. * @apiQuery { String } [ name ] 分类名称
  247. * @apiQuery { Date } [ createTimeStart ] 添加时间 开始时间
  248. * @apiQuery { Date } [ createTimeEnd ] 添加时间 结束时间
  249. * @apiQuery { Date } [ updateTimeStart ] 更新时间 开始时间
  250. * @apiQuery { Date } [ updateTimeEnd ] 更新时间 结束时间
  251. * @apiQuery { Integer } [ page = 1 ] 页码
  252. * @apiQuery { Integer } [ size = 10 ] 页大小
  253. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  254. * @apiSuccess { Object } data 数据
  255. * @apiSuccess { Long } data.total 数据总数
  256. * @apiSuccess { Object[] } data.list 数据列表
  257. * @apiSuccess { Long } data.list.id id主键
  258. * @apiSuccess { String } data.list.name 分类名称
  259. * @apiSuccess { Date } data.list.createTime 添加时间
  260. * @apiSuccess { Date } data.list.updateTime 更新时间
  261. * @apiSuccess { String } message 信息
  262. * @apiSuccess { Integer } code 状态码
  263. * @apiSuccessExample Response
  264. *
  265. * {"data":{"total":1, "list":[{"id":1, "name":"", "createTime":1650761833746, "updateTime":1650761833746}]}, "message":"", "code":1}
  266. */
  267. /**
  268. * @api {get} /v1/stock/goods/list 01.分页查询物品
  269. * @apiName 分页查询物品
  270. * @apiGroup 物品
  271. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  272. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  273. * @apiHeader {String} Authorization 授权信息
  274. * @apiVersion 1.0.0
  275. * @apiQuery { Long } [ classifyId ] 物品分类id
  276. * @apiQuery { String } [ name ] 物品名称
  277. * @apiQuery { Integer } [ count ] 物品数量
  278. * @apiQuery { String } [ description ] 物品介绍
  279. * @apiQuery { Date } [ createTimeStart ] 物品添加时间 开始时间
  280. * @apiQuery { Date } [ createTimeEnd ] 物品添加时间 结束时间
  281. * @apiQuery { Date } [ updateTimeStart ] 物品更新时间 开始时间
  282. * @apiQuery { Date } [ updateTimeEnd ] 物品更新时间 结束时间
  283. * @apiQuery { Integer } [ page = 1 ] 页码
  284. * @apiQuery { Integer } [ size = 10 ] 页大小
  285. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  286. * @apiSuccess { Object } data 数据
  287. * @apiSuccess { Long } data.total 数据总数
  288. * @apiSuccess { Object[] } data.list 数据列表
  289. * @apiSuccess { Long } data.list.id id主键(物品编号)
  290. * @apiSuccess { Long } data.list.classifyId 物品分类id
  291. * @apiSuccess { String } data.list.name 物品名称
  292. * @apiSuccess { Integer } data.list.count 物品数量
  293. * @apiSuccess { String } data.list.description 物品介绍
  294. * @apiSuccess { Date } data.list.createTime 物品添加时间
  295. * @apiSuccess { Date } data.list.updateTime 物品更新时间
  296. * @apiSuccess { String } message 信息
  297. * @apiSuccess { Integer } code 状态码
  298. * @apiSuccessExample Response
  299. *
  300. * {"data":{"total":1, "list":[{"id":1, "classifyId":1, "name":"", "count":1, "description":"", "createTime":1650761833747, "updateTime":1650761833747}]}, "message":"", "code":1}
  301. */
  302. /**
  303. * @api {post} /v1/temporary/task/add 01.添加临时任务
  304. * @apiName 添加临时任务
  305. * @apiGroup 临时任务
  306. * @apiHeader {String = application/json} Content-Type = application/json
  307. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  308. * @apiHeader {String} Authorization 授权信息
  309. * @apiVersion 1.0.0
  310. * @apiBody { String { 0..255 } } title 任务标题
  311. * @apiBody { Integer } type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  312. * @apiBody { String { 0..255 } } content 任务内容
  313. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  314. * @apiBody { Date } finishTime 完成时间
  315. * @apiBody { String } [ images ] 任务图片
  316. * @apiSuccess { Object } data 数据
  317. * @apiSuccess { Long } data.id 任务id
  318. * @apiSuccess { String } data.title 任务标题
  319. * @apiSuccess { Integer } data.type 任务类型 1:般任务 2:较急任务 3:紧急任务
  320. * @apiSuccess { String } data.content 任务内容
  321. * @apiSuccess { Long } data.userId 任务创建用户id
  322. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  323. * @apiSuccess { Integer } data.feedbackTotal 任务反馈数量
  324. * @apiSuccess { Date } data.publishTime 任务发布时间
  325. * @apiSuccess { Date } data.finishTime 任务完成时间
  326. * @apiSuccess { String } data.images 任务图片
  327. * @apiSuccess { String } message 信息
  328. * @apiSuccess { Integer } code 状态码
  329. * @apiSuccessExample Response
  330. *
  331. * {"data":{"id":1, "title":"", "type":1, "content":"", "userId":1, "status":1, "feedbackTotal":1, "publishTime":1650761833747, "finishTime":1650761833747, "images":""}, "message":"", "code":1}
  332. */
  333. /**
  334. * @api {put} /v1/temporary/task/update 02.更新临时任务
  335. * @apiName 更新临时任务
  336. * @apiGroup 临时任务
  337. * @apiHeader {String = application/json} Content-Type = application/json
  338. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  339. * @apiHeader {String} Authorization 授权信息
  340. * @apiVersion 1.0.0
  341. * @apiBody { Long } id id 主键
  342. * @apiBody { Integer } status 任务状态 2:完成 3:取消
  343. * @apiSuccess { Object } data 数据
  344. * @apiSuccess { Long } data.id 任务id
  345. * @apiSuccess { String } data.title 任务标题
  346. * @apiSuccess { Integer } data.type 任务类型 1:般任务 2:较急任务 3:紧急任务
  347. * @apiSuccess { String } data.content 任务内容
  348. * @apiSuccess { Long } data.userId 任务创建用户id
  349. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  350. * @apiSuccess { Integer } data.feedbackTotal 任务反馈数量
  351. * @apiSuccess { Date } data.publishTime 任务发布时间
  352. * @apiSuccess { Date } data.finishTime 任务完成时间
  353. * @apiSuccess { String } data.images 任务图片
  354. * @apiSuccess { String } message 信息
  355. * @apiSuccess { Integer } code 状态码
  356. * @apiSuccessExample Response
  357. *
  358. * {"data":{"id":1, "title":"", "type":1, "content":"", "userId":1, "status":1, "feedbackTotal":1, "publishTime":1650761833747, "finishTime":1650761833747, "images":""}, "message":"", "code":1}
  359. */
  360. /**
  361. * @api {get} /v1/temporary/task/list 03.分页查询临时任务
  362. * @apiName 分页查询临时任务
  363. * @apiGroup 临时任务
  364. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  365. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  366. * @apiHeader {String} Authorization 授权信息
  367. * @apiVersion 1.0.0
  368. * @apiQuery { String } [ title ] 任务标题
  369. * @apiQuery { Integer } [ type ] 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  370. * @apiQuery { Integer } [ status ] 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  371. * @apiQuery { String } [ content ] 任务内容
  372. * @apiQuery { String } [ username ] 发起人名称
  373. * @apiQuery { String } [ executor ] 执行人名称
  374. * @apiQuery { Date } [ startTime ] 开始日期
  375. * @apiQuery { Date } [ endTime ] 结束日期
  376. * @apiQuery { Integer } [ page = 1 ] 页码
  377. * @apiQuery { Integer } [ size = 10 ] 页大小
  378. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  379. * @apiSuccess { Object } data 数据
  380. * @apiSuccess { Long } data.total 数据总数
  381. * @apiSuccess { Object[] } data.list 数据列表
  382. * @apiSuccess { Long } data.list.id 任务id
  383. * @apiSuccess { String } data.list.title 任务标题
  384. * @apiSuccess { Integer } data.list.type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  385. * @apiSuccess { String } data.list.username 发起人姓名
  386. * @apiSuccess { Integer } data.list.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  387. * @apiSuccess { String } data.list.content 任务内容
  388. * @apiSuccess { Integer } data.list.feedbackTotal 执行反馈次数
  389. * @apiSuccess { Date } data.list.publishTime 发布时间
  390. * @apiSuccess { Date } data.list.finishTime 完成时间
  391. * @apiSuccess { String } data.list.images 任务图片
  392. * @apiSuccess { String[] } data.list.executors 执行人
  393. * @apiSuccess { String } message 信息
  394. * @apiSuccess { Integer } code 状态码
  395. * @apiSuccessExample Response
  396. *
  397. * {"data":{"total":1, "list":[{"id":1, "title":"", "type":1, "username":"", "status":1, "content":"", "feedbackTotal":1, "publishTime":1650761833747, "finishTime":1650761833747, "images":"", "executors":[""]}]}, "message":"", "code":1}
  398. */
  399. /**
  400. * @api {get} /v1/temporary/task/list/receive/statistical 04.我收到的临时任务统计
  401. * @apiName 我收到的临时任务统计
  402. * @apiGroup 临时任务
  403. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  404. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  405. * @apiHeader {String} Authorization 授权信息
  406. * @apiVersion 1.0.0
  407. * @apiSuccess { Object[] } data 数据
  408. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  409. * @apiSuccess { Integer } data.count 任务总数
  410. * @apiSuccess { String } message 信息
  411. * @apiSuccess { Integer } code 状态码
  412. * @apiSuccessExample Response
  413. *
  414. * {"data":[{"status":1, "count":1}], "message":"", "code":1}
  415. */
  416. /**
  417. * @api {get} /v1/temporary/task/list/receive 05.我收到的临时任务列表
  418. * @apiName 我收到的临时任务列表
  419. * @apiGroup 临时任务
  420. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  421. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  422. * @apiHeader {String} Authorization 授权信息
  423. * @apiVersion 1.0.0
  424. * @apiQuery { Integer } status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  425. * @apiQuery { Integer } [ page = 1 ]
  426. * @apiQuery { Integer } [ size = 10 ]
  427. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ]
  428. * @apiSuccess { Object } data 数据
  429. * @apiSuccess { Long } data.total 数据总数
  430. * @apiSuccess { Object[] } data.list 数据列表
  431. * @apiSuccess { Long } data.list.id 任务id
  432. * @apiSuccess { String } data.list.title 任务标题
  433. * @apiSuccess { Integer } data.list.type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  434. * @apiSuccess { String } data.list.username 发起人姓名
  435. * @apiSuccess { Integer } data.list.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  436. * @apiSuccess { String } data.list.content 任务内容
  437. * @apiSuccess { Integer } data.list.feedbackTotal 执行反馈次数
  438. * @apiSuccess { Date } data.list.publishTime 发布时间
  439. * @apiSuccess { Date } data.list.finishTime 完成时间
  440. * @apiSuccess { String } data.list.images 任务图片
  441. * @apiSuccess { String[] } data.list.executors 执行人
  442. * @apiSuccess { String } message 信息
  443. * @apiSuccess { Integer } code 状态码
  444. * @apiSuccessExample Response
  445. *
  446. * {"data":{"total":1, "list":[{"id":1, "title":"", "type":1, "username":"", "status":1, "content":"", "feedbackTotal":1, "publishTime":1650761833748, "finishTime":1650761833748, "images":"", "executors":[""]}]}, "message":"", "code":1}
  447. */
  448. /**
  449. * @api {get} /v1/temporary/task/list/publish/statistical 06.我发出的临时任务统计
  450. * @apiName 我发出的临时任务统计
  451. * @apiGroup 临时任务
  452. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  453. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  454. * @apiHeader {String} Authorization 授权信息
  455. * @apiVersion 1.0.0
  456. * @apiSuccess { Object[] } data 数据
  457. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  458. * @apiSuccess { Integer } data.count 任务总数
  459. * @apiSuccess { String } message 信息
  460. * @apiSuccess { Integer } code 状态码
  461. * @apiSuccessExample Response
  462. *
  463. * {"data":[{"status":1, "count":1}], "message":"", "code":1}
  464. */
  465. /**
  466. * @api {get} /v1/temporary/task/list/publish 07.我发出的任务列表
  467. * @apiName 我发出的任务列表
  468. * @apiGroup 临时任务
  469. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  470. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  471. * @apiHeader {String} Authorization 授权信息
  472. * @apiVersion 1.0.0
  473. * @apiQuery { Integer } status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  474. * @apiQuery { Integer } [ page = 1 ]
  475. * @apiQuery { Integer } [ size = 10 ]
  476. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ]
  477. * @apiSuccess { Object } data 数据
  478. * @apiSuccess { Long } data.total 数据总数
  479. * @apiSuccess { Object[] } data.list 数据列表
  480. * @apiSuccess { Long } data.list.id 任务id
  481. * @apiSuccess { String } data.list.title 任务标题
  482. * @apiSuccess { Integer } data.list.type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  483. * @apiSuccess { String } data.list.username 发起人姓名
  484. * @apiSuccess { Integer } data.list.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  485. * @apiSuccess { String } data.list.content 任务内容
  486. * @apiSuccess { Integer } data.list.feedbackTotal 执行反馈次数
  487. * @apiSuccess { Date } data.list.publishTime 发布时间
  488. * @apiSuccess { Date } data.list.finishTime 完成时间
  489. * @apiSuccess { String } data.list.images 任务图片
  490. * @apiSuccess { String[] } data.list.executors 执行人
  491. * @apiSuccess { String } message 信息
  492. * @apiSuccess { Integer } code 状态码
  493. * @apiSuccessExample Response
  494. *
  495. * {"data":{"total":1, "list":[{"id":1, "title":"", "type":1, "username":"", "status":1, "content":"", "feedbackTotal":1, "publishTime":1650761833748, "finishTime":1650761833748, "images":"", "executors":[""]}]}, "message":"", "code":1}
  496. */
  497. /**
  498. * @api {get} /v1/temporary/task/query/newest 08.我收到的最新的一条任务
  499. * @apiName 我收到的最新的一条任务
  500. * @apiGroup 临时任务
  501. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  502. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  503. * @apiHeader {String} Authorization 授权信息
  504. * @apiVersion 1.0.0
  505. * @apiQuery { Integer } [ status ] 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务 不传时查询所有任务
  506. * @apiSuccess { Object } data 数据
  507. * @apiSuccess { Long } data.id 任务id
  508. * @apiSuccess { String } data.title 任务标题
  509. * @apiSuccess { Integer } data.type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  510. * @apiSuccess { String } data.username 发起人姓名
  511. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  512. * @apiSuccess { String } data.content 任务内容
  513. * @apiSuccess { Integer } data.feedbackTotal 执行反馈次数
  514. * @apiSuccess { Date } data.publishTime 发布时间
  515. * @apiSuccess { Date } data.finishTime 完成时间
  516. * @apiSuccess { String } data.images 任务图片
  517. * @apiSuccess { String[] } data.executors 执行人
  518. * @apiSuccess { String } message 信息
  519. * @apiSuccess { Integer } code 状态码
  520. * @apiSuccessExample Response
  521. *
  522. * {"data":{"id":1, "title":"", "type":1, "username":"", "status":1, "content":"", "feedbackTotal":1, "publishTime":1650761833748, "finishTime":1650761833748, "images":"", "executors":[""]}, "message":"", "code":1}
  523. */
  524. /**
  525. * @api {post} /v1/temporary/task/feedback/add 01.添加临时任务反馈
  526. * @apiName 添加临时任务反馈
  527. * @apiGroup 临时任务反馈
  528. * @apiHeader {String = application/json} Content-Type = application/json
  529. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  530. * @apiHeader {String} Authorization 授权信息
  531. * @apiVersion 1.0.0
  532. * @apiBody { Long } taskId 任务id
  533. * @apiBody { String } [ content ] 反馈内容
  534. * @apiBody { String } [ images ] 反馈图片
  535. * @apiSuccess { Object } data 数据
  536. * @apiSuccess { Long } data.id 反馈id
  537. * @apiSuccess { Long } data.taskId 任务id
  538. * @apiSuccess { Long } data.userId 反馈人id
  539. * @apiSuccess { String } data.content 反馈内容
  540. * @apiSuccess { Date } data.createTime 反馈创建时间
  541. * @apiSuccess { String } data.images 反馈图片
  542. * @apiSuccess { String } message 信息
  543. * @apiSuccess { Integer } code 状态码
  544. * @apiSuccessExample Response
  545. *
  546. * {"data":{"id":1, "taskId":1, "userId":1, "content":"", "createTime":1650761833749, "images":""}, "message":"", "code":1}
  547. */
  548. /**
  549. * @api {get} /v1/temporary/task/feedback/list 02.分页查询临时任务反馈
  550. * @apiName 分页查询临时任务反馈
  551. * @apiGroup 临时任务反馈
  552. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  553. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  554. * @apiHeader {String} Authorization 授权信息
  555. * @apiVersion 1.0.0
  556. * @apiQuery { Long } [ taskId ] 任务id
  557. * @apiQuery { Long } [ userId ] 反馈人id
  558. * @apiQuery { String } [ content ] 反馈内容
  559. * @apiQuery { Date } [ createTimeStart ] 反馈创建时间 开始时间
  560. * @apiQuery { Date } [ createTimeEnd ] 反馈创建时间 结束时间
  561. * @apiQuery { String } [ images ] 反馈图片
  562. * @apiQuery { Integer } [ page = 1 ] 页码
  563. * @apiQuery { Integer } [ size = 10 ] 页大小
  564. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  565. * @apiSuccess { Object } data 数据
  566. * @apiSuccess { Long } data.total 数据总数
  567. * @apiSuccess { Object[] } data.list 数据列表
  568. * @apiSuccess { Long } data.list.id 反馈id
  569. * @apiSuccess { Long } data.list.taskId 任务id
  570. * @apiSuccess { Long } data.list.userId 反馈人id
  571. * @apiSuccess { String } data.list.content 反馈内容
  572. * @apiSuccess { Date } data.list.createTime 反馈创建时间
  573. * @apiSuccess { String } data.list.images 反馈图片
  574. * @apiSuccess { String } message 信息
  575. * @apiSuccess { Integer } code 状态码
  576. * @apiSuccessExample Response
  577. *
  578. * {"data":{"total":1, "list":[{"id":1, "taskId":1, "userId":1, "content":"", "createTime":1650761833749, "images":""}]}, "message":"", "code":1}
  579. */
  580. /**
  581. * @api {get} /v1/patrol/task/list 01.巡检计划
  582. * @apiName 巡检计划
  583. * @apiGroup 巡检任务
  584. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  585. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  586. * @apiHeader {String} Authorization 授权信息
  587. * @apiVersion 1.0.0
  588. * @apiQuery { Integer } [ status ] 检查状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  589. * @apiQuery { Date } [ beginTimeStart ] 任务执行开始时间 开始时间
  590. * @apiQuery { Date } [ beginTimeEnd ] 任务执行开始时间 结束时间
  591. * @apiQuery { Integer } [ page = 1 ] 页码
  592. * @apiQuery { Integer } [ size = 10 ] 页大小
  593. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  594. * @apiSuccess { Object } data 数据
  595. * @apiSuccess { Long } data.total 数据总数
  596. * @apiSuccess { Object[] } data.list 数据列表
  597. * @apiSuccess { Long } data.list.id id 主键
  598. * @apiSuccess { String } data.list.name 名称
  599. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  600. * @apiSuccess { Integer } data.list.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  601. * @apiSuccess { Integer } data.list.total 计划巡检房间数
  602. * @apiSuccess { Integer } data.list.completed 已经完成房间数
  603. * @apiSuccess { Float } data.list.completionRate 完成率
  604. * @apiSuccess { String } message 信息
  605. * @apiSuccess { Integer } code 状态码
  606. * @apiSuccessExample Response
  607. *
  608. * {"data":{"total":1, "list":[{"id":1, "name":"", "beginTime":1650761833749, "status":1, "total":1, "completed":1, "completionRate":1.0}]}, "message":"", "code":1}
  609. */
  610. /**
  611. * @api {get} /v1/patrol/task/list/room 02.选择计划
  612. * @apiName 选择计划
  613. * @apiGroup 巡检任务
  614. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  615. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  616. * @apiHeader {String} Authorization 授权信息
  617. * @apiVersion 1.0.0
  618. * @apiQuery { Long } roomId 房间id
  619. * @apiSuccess { Object[] } data 数据
  620. * @apiSuccess { Long } data.id id 主键
  621. * @apiSuccess { String } data.name 名称
  622. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  623. * @apiSuccess { Integer } data.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  624. * @apiSuccess { Integer } data.total 计划巡检房间数
  625. * @apiSuccess { Integer } data.completed 已经完成房间数
  626. * @apiSuccess { Float } data.completionRate 完成率
  627. * @apiSuccess { String } message 信息
  628. * @apiSuccess { Integer } code 状态码
  629. * @apiSuccessExample Response
  630. *
  631. * {"data":[{"id":1, "name":"", "beginTime":1650761833749, "status":1, "total":1, "completed":1, "completionRate":1.0}], "message":"", "code":1}
  632. */
  633. /**
  634. * @api {get} /v1/patrol/task/query/rate/:id 03.巡检进度
  635. * @apiName 巡检进度
  636. * @apiGroup 巡检任务
  637. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  638. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  639. * @apiHeader {String} Authorization 授权信息
  640. * @apiVersion 1.0.0
  641. * @apiParam { Long } id 巡检任务id
  642. * @apiSuccess { Object } data 数据
  643. * @apiSuccess { Long } data.id id 主键
  644. * @apiSuccess { String } data.name 名称
  645. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  646. * @apiSuccess { Integer } data.total 计划巡检房间数
  647. * @apiSuccess { Integer } data.completed 已经完成房间数
  648. * @apiSuccess { Float } data.completionRate 完成率
  649. * @apiSuccess { Object[] } data.rooms 房间列表
  650. * @apiSuccess { Long } data.rooms.id 房间id
  651. * @apiSuccess { String } data.rooms.name 房间名称
  652. * @apiSuccess { String } data.rooms.number 房间编号
  653. * @apiSuccess { Boolean } data.rooms.qualified 是否合格
  654. * @apiSuccess { Boolean } data.rooms.completed 是否已巡检
  655. * @apiSuccess { String } message 信息
  656. * @apiSuccess { Integer } code 状态码
  657. * @apiSuccessExample Response
  658. *
  659. * {"data":{"id":1, "name":"", "beginTime":1650761833749, "total":1, "completed":1, "completionRate":1.0, "rooms":[{"id":1, "name":"", "number":"", "qualified":true, "completed":true}]}, "message":"", "code":1}
  660. */
  661. /**
  662. * @api {get} /v1/patrol/task/query 04.巡检_巡检
  663. * @apiName 巡检_巡检
  664. * @apiGroup 巡检任务
  665. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  666. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  667. * @apiHeader {String} Authorization 授权信息
  668. * @apiVersion 1.0.0
  669. * @apiQuery { Long } taskId 巡检任务id
  670. * @apiQuery { Long } roomId 房间id
  671. * @apiSuccess { Object } data 数据
  672. * @apiSuccess { Long } data.id 房间id
  673. * @apiSuccess { String } data.name 房间名称
  674. * @apiSuccess { String } data.roomNumber 房间编号
  675. * @apiSuccess { String } data.floorName 楼层名称
  676. * @apiSuccess { String } data.buildingName 楼栋名称
  677. * @apiSuccess { String } data.taskName 巡检任务名称
  678. * @apiSuccess { Object[] } data.checkItems 检查项列表
  679. * @apiSuccess { Integer } data.checkItems.id 检查记录id
  680. * @apiSuccess { String } data.checkItems.checkItem 检查项
  681. * @apiSuccess { Object[] } data.devices 设备列表
  682. * @apiSuccess { String } data.devices.deviceName 设备名称
  683. * @apiSuccess { Object[] } data.devices.checkItems 检查项列表
  684. * @apiSuccess { Integer } data.devices.checkItems.id 检查记录id
  685. * @apiSuccess { String } data.devices.checkItems.checkItem 检查项
  686. * @apiSuccess { String } message 信息
  687. * @apiSuccess { Integer } code 状态码
  688. * @apiSuccessExample Response
  689. *
  690. * {"data":{"id":1, "name":"", "roomNumber":"", "floorName":"", "buildingName":"", "taskName":"", "checkItems":[{"id":1, "checkItem":""}], "devices":[{"deviceName":"", "checkItems":[{"id":1, "checkItem":""}]}]}, "message":"", "code":1}
  691. */
  692. /**
  693. * @api {get} /v1/patrol/task/query/record 05.巡检详情
  694. * @apiName 巡检详情
  695. * @apiGroup 巡检任务
  696. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  697. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  698. * @apiHeader {String} Authorization 授权信息
  699. * @apiVersion 1.0.0
  700. * @apiQuery { Long } taskId 巡检任务id
  701. * @apiQuery { Long } roomId 房间id
  702. * @apiSuccess { Object } data 数据
  703. * @apiSuccess { String } data.roomName 房间名称
  704. * @apiSuccess { String } data.roomNumber 房间编号
  705. * @apiSuccess { String } data.floorName 楼层名称
  706. * @apiSuccess { String } data.buildingName 楼栋名称
  707. * @apiSuccess { String } data.name 巡检任务名称
  708. * @apiSuccess { Date } data.time 巡检时间
  709. * @apiSuccess { String } data.username 巡检人员
  710. * @apiSuccess { Integer } data.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  711. * @apiSuccess { Boolean } data.qualified 是否合格
  712. * @apiSuccess { Integer } data.score 评分
  713. * @apiSuccess { Object[] } data.checkItems 检查项列表
  714. * @apiSuccess { Integer } data.checkItems.checkItemType 检查项类别 1选择、2数字、3文本、4拍照
  715. * @apiSuccess { String } data.checkItems.checkItemName 检查项名称
  716. * @apiSuccess { String } data.checkItems.checkItem 检查项
  717. * @apiSuccess { String } data.checkItems.value 用户输入值
  718. * @apiSuccess { Object[] } data.devices 设备列表
  719. * @apiSuccess { String } data.devices.deviceName 设备名称
  720. * @apiSuccess { Object[] } data.devices.checkItems 检查项列表
  721. * @apiSuccess { Integer } data.devices.checkItems.checkItemType 检查项类别 1选择、2数字、3文本、4拍照
  722. * @apiSuccess { String } data.devices.checkItems.checkItemName 检查项名称
  723. * @apiSuccess { String } data.devices.checkItems.checkItem 检查项
  724. * @apiSuccess { String } data.devices.checkItems.value 用户输入值
  725. * @apiSuccess { String } message 信息
  726. * @apiSuccess { Integer } code 状态码
  727. * @apiSuccessExample Response
  728. *
  729. * {"data":{"roomName":"", "roomNumber":"", "floorName":"", "buildingName":"", "name":"", "time":1650761833750, "username":"", "status":1, "qualified":true, "score":1, "checkItems":[{"checkItemType":1, "checkItemName":"", "checkItem":"", "value":""}], "devices":[{"deviceName":"", "checkItems":[{"checkItemType":1, "checkItemName":"", "checkItem":"", "value":""}]}]}, "message":"", "code":1}
  730. */
  731. /**
  732. * @api {get} /v1/patrol/task/room 06.未开始任务房间详情
  733. * @apiName 未开始任务房间详情
  734. * @apiGroup 巡检任务
  735. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  736. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  737. * @apiHeader {String} Authorization 授权信息
  738. * @apiVersion 1.0.0
  739. * @apiQuery { Long } taskId 巡检任务id
  740. * @apiQuery { Long } roomId 房间id
  741. * @apiSuccess { Object } data 数据
  742. * @apiSuccess { Long } data.id 房间id
  743. * @apiSuccess { String } data.name 房间名称
  744. * @apiSuccess { String } data.number 房间编号
  745. * @apiSuccess { String } data.floorName 楼层名称
  746. * @apiSuccess { String } data.buildingName 楼栋名称
  747. * @apiSuccess { String } data.routeName 路线名称
  748. * @apiSuccess { Object[] } data.checkItems 检查项列表
  749. * @apiSuccess { Integer } data.checkItems.itemType 检查项类别 1选择、2数字、3文本、4拍照
  750. * @apiSuccess { Long } data.checkItems.id 选项key
  751. * @apiSuccess { String } data.checkItems.name 选项值
  752. * @apiSuccess { Object[] } data.devices 设备列表
  753. * @apiSuccess { Long } data.devices.id 设备id
  754. * @apiSuccess { String } data.devices.name 设备名称
  755. * @apiSuccess { Object[] } data.devices.checkItems 检查项列表
  756. * @apiSuccess { Integer } data.devices.checkItems.itemType 检查项类别 1选择、2数字、3文本、4拍照
  757. * @apiSuccess { Long } data.devices.checkItems.id 选项key
  758. * @apiSuccess { String } data.devices.checkItems.name 选项值
  759. * @apiSuccess { String } message 信息
  760. * @apiSuccess { Integer } code 状态码
  761. * @apiSuccessExample Response
  762. *
  763. * {"data":{"id":1, "name":"", "number":"", "floorName":"", "buildingName":"", "routeName":"", "checkItems":[{"itemType":1, "id":1, "name":""}], "devices":[{"id":1, "name":"", "checkItems":[{"itemType":1, "id":1, "name":""}]}]}, "message":"", "code":1}
  764. */
  765. /**
  766. * @api {put} /v1/patrol/task/update 07.巡检_完成
  767. * @apiName 巡检_完成
  768. * @apiGroup 巡检任务
  769. * @apiHeader {String = application/json} Content-Type = application/json
  770. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  771. * @apiHeader {String} Authorization 授权信息
  772. * @apiVersion 1.0.0
  773. * @apiBody { Long } taskId 任务id
  774. * @apiBody { Long } roomId 房间id
  775. * @apiBody { Object[] } items 巡检任务检查项目
  776. *
  777. * 例: [{"id": 79,"value": "480,482"}, {"id": 82,"value": 100}, {"id": 80,"value": "文本"},{"id": 81, "value": "[{\"id\": 74,\"value\": \"拍照\"}]"}]
  778. * @apiBody { Long } items.id 检查记录id
  779. * @apiBody { String } [ items.value ] 记录值
  780. * @apiSuccess { Boolean } data 数据
  781. * @apiSuccess { String } message 信息
  782. * @apiSuccess { Integer } code 状态码
  783. * @apiSuccessExample Response
  784. *
  785. * {"data":true, "message":"", "code":1}
  786. */
  787. /**
  788. * @api {get} /v1/patrol/task/list/record/room 08.巡检_记录
  789. * @apiName 巡检_记录
  790. * @apiGroup 巡检任务
  791. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  792. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  793. * @apiHeader {String} Authorization 授权信息
  794. * @apiVersion 1.0.0
  795. * @apiQuery { Long } taskId 巡检任务id
  796. * @apiQuery { Long } roomId 房间id
  797. * @apiQuery { Integer } [ page = 1 ] 页码
  798. * @apiQuery { Integer } [ size = 10 ] 页大小
  799. * @apiSuccess { Object } data 数据
  800. * @apiSuccess { Long } data.total 数据总数
  801. * @apiSuccess { Object[] } data.list 数据列表
  802. * @apiSuccess { String } data.list.id 任务id
  803. * @apiSuccess { String } data.list.roomId 房间id
  804. * @apiSuccess { String } data.list.roomName 房间名称
  805. * @apiSuccess { Date } data.list.time 巡检时间
  806. * @apiSuccess { String } data.list.username 巡检人员
  807. * @apiSuccess { Boolean } data.list.qualified 是否合格
  808. * @apiSuccess { String } message 信息
  809. * @apiSuccess { Integer } code 状态码
  810. * @apiSuccessExample Response
  811. *
  812. * {"data":{"total":1, "list":[{"id":"", "roomId":"", "roomName":"", "time":1650761833750, "username":"", "qualified":true}]}, "message":"", "code":1}
  813. */
  814. /**
  815. * @api {get} /v1/patrol/task/list/record 09.巡检记录
  816. * @apiName 巡检记录
  817. * @apiGroup 巡检任务
  818. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  819. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  820. * @apiHeader {String} Authorization 授权信息
  821. * @apiVersion 1.0.0
  822. * @apiQuery { Boolean } [ qualified ] 是否合格
  823. * @apiQuery { Date } [ beginTimeStart ] 任务执行开始时间 开始时间
  824. * @apiQuery { Date } [ beginTimeEnd ] 任务执行开始时间 结束时间
  825. * @apiQuery { Integer } [ page = 1 ] 页码
  826. * @apiQuery { Integer } [ size = 10 ] 页大小
  827. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  828. * @apiSuccess { Object } data 数据
  829. * @apiSuccess { Long } data.total 数据总数
  830. * @apiSuccess { Object[] } data.list 数据列表
  831. * @apiSuccess { String } data.list.id 任务id
  832. * @apiSuccess { String } data.list.name 任务名称
  833. * @apiSuccess { String } data.list.roomId 房间id
  834. * @apiSuccess { String } data.list.roomName 房间名称
  835. * @apiSuccess { Date } data.list.time 巡检时间
  836. * @apiSuccess { String } data.list.username 巡检人员
  837. * @apiSuccess { String } message 信息
  838. * @apiSuccess { Integer } code 状态码
  839. * @apiSuccessExample Response
  840. *
  841. * {"data":{"total":1, "list":[{"id":"", "name":"", "roomId":"", "roomName":"", "time":1650761833751, "username":""}]}, "message":"", "code":1}
  842. */
  843. /**
  844. * @api {get} /v1/wechat/login 01.登录
  845. * @apiName 登录
  846. * @apiGroup 微信小程序
  847. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  848. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  849. * @apiVersion 1.0.0
  850. * @apiQuery { String } code 用户code
  851. * @apiSuccess { String } data 数据
  852. * @apiSuccess { String } message 信息
  853. * @apiSuccess { Integer } code 状态码
  854. * @apiSuccessExample Response
  855. *
  856. * {"data":"", "message":"", "code":1}
  857. */
  858. /**
  859. * @api {post} /v1/visitor/add 01.进入登记
  860. * @apiName 进入登记
  861. * @apiGroup 访客
  862. * @apiHeader {String = application/json} Content-Type = application/json
  863. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  864. * @apiHeader {String} Authorization 授权信息
  865. * @apiVersion 1.0.0
  866. * @apiDeprecated 接口已弃用 使用(#访客审批:进入登记)
  867. * @apiBody { String } openid 用户openid
  868. * @apiBody { String } username 访客姓名
  869. * @apiBody { String } userPhone 访客手机号
  870. * @apiBody { String } company 访客公司
  871. * @apiBody { Boolean } contact 是否密接
  872. * @apiBody { Boolean } highRisk 是否高风险
  873. * @apiBody { Boolean } confirm 是否确诊
  874. * @apiBody { String } reason 事由
  875. * @apiBody { String } [ images ] 图片
  876. * @apiSuccess { Object } data 数据
  877. * @apiSuccess { Long } data.id id主键
  878. * @apiSuccess { String } data.openid 用户openid
  879. * @apiSuccess { Integer } data.number 编号,年+4位编号
  880. * @apiSuccess { String } data.username 访客姓名
  881. * @apiSuccess { String } data.userPhone 访客手机号
  882. * @apiSuccess { String } data.company 访客公司
  883. * @apiSuccess { Boolean } data.contact 是否密接
  884. * @apiSuccess { Boolean } data.highRisk 是否高风险
  885. * @apiSuccess { Boolean } data.confirm 是否确诊
  886. * @apiSuccess { Date } data.entryTime 进入时间
  887. * @apiSuccess { String } data.reason 事由
  888. * @apiSuccess { Date } data.leaveTime 离开时间
  889. * @apiSuccess { String } data.remark 出场备注
  890. * @apiSuccess { String } data.images 图片
  891. * @apiSuccess { String } message 信息
  892. * @apiSuccess { Integer } code 状态码
  893. * @apiSuccessExample Response
  894. *
  895. * {"data":{"id":1, "openid":"", "number":1, "username":"", "userPhone":"", "company":"", "contact":true, "highRisk":true, "confirm":true, "entryTime":1650761833751, "reason":"", "leaveTime":1650761833751, "remark":"", "images":""}, "message":"", "code":1}
  896. */
  897. /**
  898. * @api {get} /v1/visitor/query/:openid 02.查询进入记录
  899. * @apiName 查询进入记录
  900. * @apiGroup 访客
  901. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  902. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  903. * @apiHeader {String} Authorization 授权信息
  904. * @apiVersion 1.0.0
  905. * @apiDeprecated 接口已弃用 使用(#访客审批:查询进入记录)
  906. * @apiParam { String } openid 用户openid
  907. * @apiSuccess { Object } data 数据
  908. * @apiSuccess { Long } data.id id主键
  909. * @apiSuccess { String } data.openid 用户openid
  910. * @apiSuccess { String } data.username 访客姓名
  911. * @apiSuccess { String } data.userPhone 访客手机号
  912. * @apiSuccess { String } data.company 访客公司
  913. * @apiSuccess { Date } data.entryTime 进入时间
  914. * @apiSuccess { String } data.reason 事由
  915. * @apiSuccess { String } message 信息
  916. * @apiSuccess { Integer } code 状态码
  917. * @apiSuccessExample Response
  918. *
  919. * {"data":{"id":1, "openid":"", "username":"", "userPhone":"", "company":"", "entryTime":1650761833751, "reason":""}, "message":"", "code":1}
  920. */
  921. /**
  922. * @api {put} /v1/visitor/update 03.出场核销
  923. * @apiName 出场核销
  924. * @apiGroup 访客
  925. * @apiHeader {String = application/json} Content-Type = application/json
  926. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  927. * @apiHeader {String} Authorization 授权信息
  928. * @apiVersion 1.0.0
  929. * @apiDeprecated 接口已弃用 使用(#访客审批:出场核销)
  930. * @apiBody { Long } id 入场记录id
  931. * @apiBody { String } [ remark ] 出场备注
  932. * @apiSuccess { Object } data 数据
  933. * @apiSuccess { Long } data.id id主键
  934. * @apiSuccess { String } data.openid 用户openid
  935. * @apiSuccess { Integer } data.number 编号,年+4位编号
  936. * @apiSuccess { String } data.username 访客姓名
  937. * @apiSuccess { String } data.userPhone 访客手机号
  938. * @apiSuccess { String } data.company 访客公司
  939. * @apiSuccess { Boolean } data.contact 是否密接
  940. * @apiSuccess { Boolean } data.highRisk 是否高风险
  941. * @apiSuccess { Boolean } data.confirm 是否确诊
  942. * @apiSuccess { Date } data.entryTime 进入时间
  943. * @apiSuccess { String } data.reason 事由
  944. * @apiSuccess { Date } data.leaveTime 离开时间
  945. * @apiSuccess { String } data.remark 出场备注
  946. * @apiSuccess { String } data.images 图片
  947. * @apiSuccess { String } message 信息
  948. * @apiSuccess { Integer } code 状态码
  949. * @apiSuccessExample Response
  950. *
  951. * {"data":{"id":1, "openid":"", "number":1, "username":"", "userPhone":"", "company":"", "contact":true, "highRisk":true, "confirm":true, "entryTime":1650761833751, "reason":"", "leaveTime":1650761833751, "remark":"", "images":""}, "message":"", "code":1}
  952. */
  953. /**
  954. * @api {post} /v1/system/user/comment/add 01.添加用户评价
  955. * @apiName 添加用户评价
  956. * @apiGroup 用户评价
  957. * @apiHeader {String = application/json} Content-Type = application/json
  958. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  959. * @apiHeader {String} Authorization 授权信息
  960. * @apiVersion 1.0.0
  961. * @apiBody { Long } respondentUserId 被评价人id
  962. * @apiBody { String } respondentUsername 被评价人姓名
  963. * @apiBody { String } content 评论内容
  964. * @apiBody { Integer } score 评论分数
  965. * @apiBody { String } [ images ] 评论图片地址数组
  966. * @apiSuccess { Object } data 数据
  967. * @apiSuccess { Long } data.id id主键
  968. * @apiSuccess { Long } data.userId 评价人id
  969. * @apiSuccess { String } data.username 评价人姓名
  970. * @apiSuccess { Long } data.respondentUserId 被评价人id
  971. * @apiSuccess { String } data.respondentUsername 被评价人姓名
  972. * @apiSuccess { String } data.content 评论内容
  973. * @apiSuccess { Integer } data.score 评论分数
  974. * @apiSuccess { Date } data.createTime 评论时间
  975. * @apiSuccess { String } data.images 评论图片地址数组
  976. * @apiSuccess { String } message 信息
  977. * @apiSuccess { Integer } code 状态码
  978. * @apiSuccessExample Response
  979. *
  980. * {"data":{"id":1, "userId":1, "username":"", "respondentUserId":1, "respondentUsername":"", "content":"", "score":1, "createTime":1650761833751, "images":""}, "message":"", "code":1}
  981. */
  982. /**
  983. * @api {post} /v1/file/upload 01.文件上传
  984. * @apiName 文件上传
  985. * @apiGroup 文件
  986. * @apiHeader {String = multipart/form-data} Content-Type = multipart/form-data
  987. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  988. * @apiVersion 1.0.0
  989. * @apiBody { File } file 文件
  990. * @apiSuccess { String } data 数据
  991. * @apiSuccess { String } message 信息
  992. * @apiSuccess { Integer } code 状态码
  993. * @apiSuccessExample Response
  994. *
  995. * {"data":"", "message":"", "code":1}
  996. */
  997. /**
  998. * @api {post} /v1/file/uploads 02.多文件上传
  999. * @apiName 多文件上传
  1000. * @apiGroup 文件
  1001. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1002. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1003. * @apiVersion 1.0.0
  1004. * @apiSuccess { String[] } data 数据
  1005. * @apiSuccess { String } message 信息
  1006. * @apiSuccess { Integer } code 状态码
  1007. * @apiSuccessExample Response
  1008. *
  1009. * {"data":[""], "message":"", "code":1}
  1010. */
  1011. /**
  1012. * @api {get} /v1/file/query/:path 03.文件下载
  1013. * @apiName 文件下载
  1014. * @apiGroup 文件
  1015. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1016. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1017. * @apiVersion 1.0.0
  1018. * @apiParam { String } path 文件存储路径
  1019. */