patrol-web_1.0.0.api 235 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508
  1. /**
  2. * @api {get} /v1/home/permissions 01.查询当前登录用户的权限
  3. * @apiName 查询当前登录用户的权限
  4. * @apiGroup 主页
  5. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  6. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  7. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  8. * @apiVersion 1.0.0
  9. * @apiSuccess { String[] } data 数据
  10. * @apiSuccess { String } message 信息
  11. * @apiSuccess { Integer } code 状态码
  12. * @apiSuccessExample Response
  13. *
  14. * {"data":[""], "message":"", "code":1}
  15. */
  16. /**
  17. * @api {put} /v1/home/update/password 02.更新用户密码
  18. * @apiName 更新用户密码
  19. * @apiGroup 主页
  20. * @apiHeader {String = application/json} Content-Type = application/json
  21. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  22. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  23. * @apiVersion 1.0.0
  24. * @apiBody { String } password 密码(md5加密)
  25. * @apiSuccess { Boolean } data 数据
  26. * @apiSuccess { String } message 信息
  27. * @apiSuccess { Integer } code 状态码
  28. * @apiSuccessExample Response
  29. *
  30. * {"data":true, "message":"", "code":1}
  31. */
  32. /**
  33. * @api {get} /v1/home/patrol/task/rate 03.当月巡检任务完成率
  34. * @apiName 当月巡检任务完成率
  35. * @apiGroup 主页
  36. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  37. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  38. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  39. * @apiVersion 1.0.0
  40. * @apiSuccess { Object } data 数据
  41. * @apiSuccess { Long } data.completed 已完成
  42. * @apiSuccess { Long } data.total 总计
  43. * @apiSuccess { String } message 信息
  44. * @apiSuccess { Integer } code 状态码
  45. * @apiSuccessExample Response
  46. *
  47. * {"data":{"completed":1, "total":1}, "message":"", "code":1}
  48. */
  49. /**
  50. * @api {get} /v1/home/upkeep/task/rate 04.查询当月保养任务完成率
  51. * @apiName 查询当月保养任务完成率
  52. * @apiGroup 主页
  53. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  54. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  55. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  56. * @apiVersion 1.0.0
  57. * @apiSuccess { Object } data 数据
  58. * @apiSuccess { Long } data.completed 已完成
  59. * @apiSuccess { Long } data.total 总计
  60. * @apiSuccess { String } message 信息
  61. * @apiSuccess { Integer } code 状态码
  62. * @apiSuccessExample Response
  63. *
  64. * {"data":{"completed":1, "total":1}, "message":"", "code":1}
  65. */
  66. /**
  67. * @api {get} /v1/home/patrol/task/times 05.查询巡检次数
  68. * @apiName 查询巡检次数
  69. * @apiGroup 主页
  70. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  71. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  72. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  73. * @apiVersion 1.0.0
  74. * @apiSuccess { Object[] } data 数据
  75. * @apiSuccess { Date } data.time 日期
  76. * @apiSuccess { Integer } data.missed 漏检次数,完成次数=总计-漏检
  77. * @apiSuccess { Integer } data.total 总计
  78. * @apiSuccess { String } message 信息
  79. * @apiSuccess { Integer } code 状态码
  80. * @apiSuccessExample Response
  81. *
  82. * {"data":[{"time":1650761871414, "missed":1, "total":1}], "message":"", "code":1}
  83. */
  84. /**
  85. * @api {get} /v1/home/visitor 06.查询当前机房访客人员
  86. * @apiName 查询当前机房访客人员
  87. * @apiGroup 主页
  88. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  89. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  90. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  91. * @apiVersion 1.0.0
  92. * @apiQuery { Integer } [ page = 1 ] 页码
  93. * @apiQuery { Integer } [ size = 10 ] 页大小
  94. * @apiSuccess { Object } data 数据
  95. * @apiSuccess { Long } data.total 数据总数
  96. * @apiSuccess { Object[] } data.list 数据列表
  97. * @apiSuccess { Long } data.list.id id主键
  98. * @apiSuccess { String } data.list.openid 用户openid
  99. * @apiSuccess { Integer } data.list.number 编号,年+4位编号
  100. * @apiSuccess { String } data.list.username 访客姓名
  101. * @apiSuccess { String } data.list.userPhone 访客手机号
  102. * @apiSuccess { String } data.list.company 访客公司
  103. * @apiSuccess { Boolean } data.list.contact 是否密接
  104. * @apiSuccess { Boolean } data.list.highRisk 是否高风险
  105. * @apiSuccess { Boolean } data.list.confirm 是否确诊
  106. * @apiSuccess { Date } data.list.entryTime 进入时间
  107. * @apiSuccess { String } data.list.reason 事由
  108. * @apiSuccess { Date } data.list.leaveTime 离开时间
  109. * @apiSuccess { String } data.list.remark 出场备注
  110. * @apiSuccess { String } data.list.images 图片
  111. * @apiSuccess { String } message 信息
  112. * @apiSuccess { Integer } code 状态码
  113. * @apiSuccessExample Response
  114. *
  115. * {"data":{"total":1, "list":[{"id":1, "openid":"", "number":1, "username":"", "userPhone":"", "company":"", "contact":true, "highRisk":true, "confirm":true, "entryTime":1650761871414, "reason":"", "leaveTime":1650761871414, "remark":"", "images":""}]}, "message":"", "code":1}
  116. */
  117. /**
  118. * @api {get} /v1/home/attendance/statistical 07.查询月评分排行
  119. * @apiName 查询月评分排行
  120. * @apiGroup 主页
  121. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  122. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  123. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  124. * @apiVersion 1.0.0
  125. * @apiQuery { Integer } [ page = 1 ] 页码
  126. * @apiQuery { Integer } [ size = 10 ] 页大小
  127. * @apiSuccess { Object } data 数据
  128. * @apiSuccess { Long } data.total 数据总数
  129. * @apiSuccess { Object[] } data.list 数据列表
  130. * @apiSuccess { Long } data.list.userId 用户id
  131. * @apiSuccess { String } data.list.username 用户姓名
  132. * @apiSuccess { String } data.list.telephone 手机号
  133. * @apiSuccess { Integer } data.list.score 本月评分
  134. * @apiSuccess { String } data.list.month 考勤年月
  135. * @apiSuccess { String } message 信息
  136. * @apiSuccess { Integer } code 状态码
  137. * @apiSuccessExample Response
  138. *
  139. * {"data":{"total":1, "list":[{"userId":1, "username":"", "telephone":"", "score":1, "month":""}]}, "message":"", "code":1}
  140. */
  141. /**
  142. * @api {get} /v1/home/electricity/statistical 08.查询最近一年电量统计数据
  143. * @apiName 查询最近一年电量统计数据
  144. * @apiGroup 主页
  145. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  146. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  147. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  148. * @apiVersion 1.0.0
  149. * @apiSuccess { Object[] } data 数据
  150. * @apiSuccess { String } data.year 年
  151. * @apiSuccess { String } data.month 月
  152. * @apiSuccess { Float } data.electricityIt it用电量
  153. * @apiSuccess { Float } data.electricityTotal 总用电量
  154. * @apiSuccess { String } message 信息
  155. * @apiSuccess { Integer } code 状态码
  156. * @apiSuccessExample Response
  157. *
  158. * {"data":[{"year":"", "month":"", "electricityIt":1.0, "electricityTotal":1.0}], "message":"", "code":1}
  159. */
  160. /**
  161. * @api {get} /v1/home/cabinet/usage 09.查询机柜使用率
  162. * @apiName 查询机柜使用率
  163. * @apiGroup 主页
  164. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  165. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  166. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  167. * @apiVersion 1.0.0
  168. * @apiSuccess { Object } data 数据
  169. * @apiSuccess { Integer } data.used 已使用
  170. * @apiSuccess { Integer } data.total 总计
  171. * @apiSuccess { String } message 信息
  172. * @apiSuccess { Integer } code 状态码
  173. * @apiSuccessExample Response
  174. *
  175. * {"data":{"used":1, "total":1}, "message":"", "code":1}
  176. */
  177. /**
  178. * @api {get} /v1/home/room/usage 10.查询数据机房占用率
  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 = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  184. * @apiVersion 1.0.0
  185. * @apiSuccess { Object[] } data 数据
  186. * @apiSuccess { String } data.buildingName 楼栋名称
  187. * @apiSuccess { String } data.floorName 楼层名称
  188. * @apiSuccess { String } data.roomName 房间名称
  189. * @apiSuccess { Integer } data.used 已使用
  190. * @apiSuccess { Integer } data.total 总计
  191. * @apiSuccess { String } message 信息
  192. * @apiSuccess { Integer } code 状态码
  193. * @apiSuccessExample Response
  194. *
  195. * {"data":[{"buildingName":"", "floorName":"", "roomName":"", "used":1, "total":1}], "message":"", "code":1}
  196. */
  197. /**
  198. * @api {post} /v1/check/item/type/add 01.添加项目类别
  199. * @apiName 添加项目类别
  200. * @apiGroup 检查项目-项目分类
  201. * @apiHeader {String = application/json} Content-Type = application/json
  202. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  203. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  204. * @apiPermission 【/v1/check/item/type/add#POST】
  205. * @apiVersion 1.0.0
  206. * @apiBody { Long } [ id ] id 主键
  207. * @apiBody { String } [ typeName ] 类别名称
  208. * @apiBody { String } [ seq ] 类别排序
  209. * @apiBody { String } [ remark ] 备注
  210. * @apiSuccess { Object } data 数据
  211. * @apiSuccess { Long } data.id id 主键
  212. * @apiSuccess { String } data.typeName 类别名称
  213. * @apiSuccess { String } data.seq 类别排序
  214. * @apiSuccess { String } data.remark 备注
  215. * @apiSuccess { String } message 信息
  216. * @apiSuccess { Integer } code 状态码
  217. * @apiSuccessExample Response
  218. *
  219. * {"data":{"id":1, "typeName":"", "seq":"", "remark":""}, "message":"", "code":1}
  220. */
  221. /**
  222. * @api {put} /v1/check/item/type/update 02.更新项目类别
  223. * @apiName 更新项目类别
  224. * @apiGroup 检查项目-项目分类
  225. * @apiHeader {String = application/json} Content-Type = application/json
  226. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  227. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  228. * @apiPermission 【/v1/check/item/type/update#PUT】
  229. * @apiVersion 1.0.0
  230. * @apiBody { Long } [ id ] id 主键
  231. * @apiBody { String } [ typeName ] 类别名称
  232. * @apiBody { String } [ seq ] 类别排序
  233. * @apiBody { String } [ remark ] 备注
  234. * @apiSuccess { Object } data 数据
  235. * @apiSuccess { Long } data.id id 主键
  236. * @apiSuccess { String } data.typeName 类别名称
  237. * @apiSuccess { String } data.seq 类别排序
  238. * @apiSuccess { String } data.remark 备注
  239. * @apiSuccess { String } message 信息
  240. * @apiSuccess { Integer } code 状态码
  241. * @apiSuccessExample Response
  242. *
  243. * {"data":{"id":1, "typeName":"", "seq":"", "remark":""}, "message":"", "code":1}
  244. */
  245. /**
  246. * @api {get} /v1/check/item/type/query/:id 03.查询项目类别
  247. * @apiName 查询项目类别
  248. * @apiGroup 检查项目-项目分类
  249. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  250. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  251. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  252. * @apiPermission 【/v1/check/item/type/query/{id}#GET】
  253. * @apiVersion 1.0.0
  254. * @apiParam { Long } id 项目类别id
  255. * @apiSuccess { Object } data 数据
  256. * @apiSuccess { Long } data.id id 主键
  257. * @apiSuccess { String } data.typeName 类别名称
  258. * @apiSuccess { String } data.seq 类别排序
  259. * @apiSuccess { String } data.remark 备注
  260. * @apiSuccess { String } message 信息
  261. * @apiSuccess { Integer } code 状态码
  262. * @apiSuccessExample Response
  263. *
  264. * {"data":{"id":1, "typeName":"", "seq":"", "remark":""}, "message":"", "code":1}
  265. */
  266. /**
  267. * @api {get} /v1/check/item/type/list 04.分页查询项目类别
  268. * @apiName 分页查询项目类别
  269. * @apiGroup 检查项目-项目分类
  270. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  271. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  272. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  273. * @apiPermission 【/v1/check/item/type/list#GET】
  274. * @apiVersion 1.0.0
  275. * @apiQuery { String } [ typeName ] 类别名称
  276. * @apiQuery { String } [ seq ] 类别排序
  277. * @apiQuery { String } [ remark ] 备注
  278. * @apiQuery { Integer } [ page = 1 ] 页码
  279. * @apiQuery { Integer } [ size = 10 ] 页大小
  280. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  281. * @apiSuccess { Object } data 数据
  282. * @apiSuccess { Long } data.total 数据总数
  283. * @apiSuccess { Object[] } data.list 数据列表
  284. * @apiSuccess { Long } data.list.id id 主键
  285. * @apiSuccess { String } data.list.typeName 类别名称
  286. * @apiSuccess { String } data.list.seq 类别排序
  287. * @apiSuccess { String } data.list.remark 备注
  288. * @apiSuccess { String } message 信息
  289. * @apiSuccess { Integer } code 状态码
  290. * @apiSuccessExample Response
  291. *
  292. * {"data":{"total":1, "list":[{"id":1, "typeName":"", "seq":"", "remark":""}]}, "message":"", "code":1}
  293. */
  294. /**
  295. * @api {delete} /v1/check/item/type/delete 05.删除多条项目类别
  296. * @apiName 删除多条项目类别
  297. * @apiGroup 检查项目-项目分类
  298. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  299. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  300. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  301. * @apiPermission 【/v1/check/item/type/delete#DELETE】
  302. * @apiVersion 1.0.0
  303. * @apiQuery { Long[] { 1-2147483647 } } ids 项目类别id数组
  304. * @apiSuccess { Boolean } data 数据
  305. * @apiSuccess { String } message 信息
  306. * @apiSuccess { Integer } code 状态码
  307. * @apiSuccessExample Response
  308. *
  309. * {"data":true, "message":"", "code":1}
  310. */
  311. /**
  312. * @api {delete} /v1/check/item/type/delete/:id 06.删除项目类别
  313. * @apiName 删除项目类别
  314. * @apiGroup 检查项目-项目分类
  315. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  316. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  317. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  318. * @apiPermission 【/v1/check/item/type/delete/{id}#DELETE】
  319. * @apiVersion 1.0.0
  320. * @apiParam { Long } id 项目类别id
  321. * @apiSuccess { Boolean } data 数据
  322. * @apiSuccess { String } message 信息
  323. * @apiSuccess { Integer } code 状态码
  324. * @apiSuccessExample Response
  325. *
  326. * {"data":true, "message":"", "code":1}
  327. */
  328. /**
  329. * @api {delete} /v1/check/item/delete/:id 01.删除检查项
  330. * @apiName 删除检查项
  331. * @apiGroup 检查项目-项目
  332. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  333. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  334. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  335. * @apiPermission 【/v1/check/item/delete/{id}#DELETE】
  336. * @apiVersion 1.0.0
  337. * @apiParam { Long } id 检查项id
  338. * @apiSuccess { Boolean } data 数据
  339. * @apiSuccess { String } message 信息
  340. * @apiSuccess { Integer } code 状态码
  341. * @apiSuccessExample Response
  342. *
  343. * {"data":true, "message":"", "code":1}
  344. */
  345. /**
  346. * @api {delete} /v1/check/item/delete 02.删除多条检查项
  347. * @apiName 删除多条检查项
  348. * @apiGroup 检查项目-项目
  349. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  350. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  351. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  352. * @apiPermission 【/v1/check/item/delete#DELETE】
  353. * @apiVersion 1.0.0
  354. * @apiQuery { Long[] { 1-2147483647 } } ids 检查项id数组
  355. * @apiSuccess { Boolean } data 数据
  356. * @apiSuccess { String } message 信息
  357. * @apiSuccess { Integer } code 状态码
  358. * @apiSuccessExample Response
  359. *
  360. * {"data":true, "message":"", "code":1}
  361. */
  362. /**
  363. * @api {get} /v1/check/item/list 03.分页查询检查项
  364. * @apiName 分页查询检查项
  365. * @apiGroup 检查项目-项目
  366. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  367. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  368. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  369. * @apiPermission 【/v1/check/item/list#GET】
  370. * @apiVersion 1.0.0
  371. * @apiQuery { String } [ itemNo ] 检查项编号
  372. * @apiQuery { String } [ itemName ] 检查项名称
  373. * @apiQuery { Integer } [ itemType ] 检查项类别 1选择、2数字、3文本、4拍照
  374. * @apiQuery { Boolean } [ isRequired ] 是否必填
  375. * @apiQuery { String } [ defaultValue ] 默认值
  376. * @apiQuery { Boolean } [ isScore ] 是否参与评分
  377. * @apiQuery { Long } [ patrolTypeId ] 检查类别id
  378. * @apiQuery { String } [ patrolTypeName ] 检查类别名称 冗余字段
  379. * @apiQuery { Long } [ userId ] 所属人员id
  380. * @apiQuery { String } [ username ] 所属人员名称
  381. * @apiQuery { String } [ remark ] 备注说明
  382. * @apiQuery { Integer } [ page = 1 ] 页码
  383. * @apiQuery { Integer } [ size = 10 ] 页大小
  384. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  385. * @apiSuccess { Object } data 数据
  386. * @apiSuccess { Long } data.total 数据总数
  387. * @apiSuccess { Object[] } data.list 数据列表
  388. * @apiSuccess { Long } data.list.id id 主键
  389. * @apiSuccess { String } data.list.itemNo 检查项编号
  390. * @apiSuccess { String } data.list.itemName 检查项名称
  391. * @apiSuccess { Integer } data.list.itemType 检查项类别 1选择、2数字、3文本、4拍照
  392. * @apiSuccess { Boolean } data.list.isRequired 是否必填
  393. * @apiSuccess { String } data.list.defaultValue 默认值
  394. * @apiSuccess { Boolean } data.list.isScore 是否参与评分
  395. * @apiSuccess { Long } data.list.patrolTypeId 检查类别id
  396. * @apiSuccess { String } data.list.patrolTypeName 检查类别名称 冗余字段
  397. * @apiSuccess { Long } data.list.userId 所属人员id
  398. * @apiSuccess { String } data.list.username 所属人员名称
  399. * @apiSuccess { String } data.list.remark 备注说明
  400. * @apiSuccess { String } message 信息
  401. * @apiSuccess { Integer } code 状态码
  402. * @apiSuccessExample Response
  403. *
  404. * {"data":{"total":1, "list":[{"id":1, "itemNo":"", "itemName":"", "itemType":1, "isRequired":true, "defaultValue":"", "isScore":true, "patrolTypeId":1, "patrolTypeName":"", "userId":1, "username":"", "remark":""}]}, "message":"", "code":1}
  405. */
  406. /**
  407. * @api {get} /v1/check/item/query/select/:id 04.获取选择项详情
  408. * @apiName 获取选择项详情
  409. * @apiGroup 检查项目-项目
  410. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  411. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  412. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  413. * @apiPermission 【/v1/check/item/query/select/{id}#GET】
  414. * @apiVersion 1.0.0
  415. * @apiParam { Long } id 检查项id
  416. * @apiSuccess { Object } data 数据
  417. * @apiSuccess { Object } data.checkItem 检查主项
  418. * @apiSuccess { Long } data.checkItem.id id 主键
  419. * @apiSuccess { String } data.checkItem.itemNo 检查项编号
  420. * @apiSuccess { String } data.checkItem.itemName 检查项名称
  421. * @apiSuccess { Integer } data.checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  422. * @apiSuccess { Boolean } data.checkItem.isRequired 是否必填
  423. * @apiSuccess { String } data.checkItem.defaultValue 默认值
  424. * @apiSuccess { Boolean } data.checkItem.isScore 是否参与评分
  425. * @apiSuccess { Long } data.checkItem.patrolTypeId 检查类别id
  426. * @apiSuccess { String } data.checkItem.patrolTypeName 检查类别名称 冗余字段
  427. * @apiSuccess { Long } data.checkItem.userId 所属人员id
  428. * @apiSuccess { String } data.checkItem.username 所属人员名称
  429. * @apiSuccess { String } data.checkItem.remark 备注说明
  430. * @apiSuccess { Boolean } data.allowMultiple 是否允许多选
  431. * @apiSuccess { Object[] } data.options 选项列表
  432. * @apiSuccess { Long } data.options.id id 主键
  433. * @apiSuccess { Long } data.options.checkItemId 检查项id
  434. * @apiSuccess { String } data.options.optionName 选项名称
  435. * @apiSuccess { Boolean } data.options.qualifiedIfSelect 选中是否合格
  436. * @apiSuccess { Boolean } data.options.qualifiedIfNoSelect 未选中是否合格
  437. * @apiSuccess { Boolean } data.options.defaultSelect 是否默认选中
  438. * @apiSuccess { Integer } data.options.score 合格评分
  439. * @apiSuccess { Integer } data.options.seq 排序
  440. * @apiSuccess { String } message 信息
  441. * @apiSuccess { Integer } code 状态码
  442. * @apiSuccessExample Response
  443. *
  444. * {"data":{"checkItem":{"id":1, "itemNo":"", "itemName":"", "itemType":1, "isRequired":true, "defaultValue":"", "isScore":true, "patrolTypeId":1, "patrolTypeName":"", "userId":1, "username":"", "remark":""}, "allowMultiple":true, "options":[{"id":1, "checkItemId":1, "optionName":"", "qualifiedIfSelect":true, "qualifiedIfNoSelect":true, "defaultSelect":true, "score":1, "seq":1}]}, "message":"", "code":1}
  445. */
  446. /**
  447. * @api {post} /v1/check/item/add/select 05.添加选择项
  448. * @apiName 添加选择项
  449. * @apiGroup 检查项目-项目
  450. * @apiHeader {String = application/json} Content-Type = application/json
  451. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  452. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  453. * @apiPermission 【/v1/check/item/add/select#POST】
  454. * @apiVersion 1.0.0
  455. * @apiBody { Object } checkItem 检查主项
  456. * @apiBody { String } checkItem.itemName 检查项名称
  457. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  458. * @apiBody { Boolean } checkItem.isRequired 是否必填
  459. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  460. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  461. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  462. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  463. * @apiBody { String } [ checkItem.remark ] 备注说明
  464. * @apiBody { Boolean } allowMultiple 是否允许多选
  465. * @apiBody { Object[] { 1..2147483647 } } options 选择项
  466. * @apiBody { String } options.optionName 选项名称
  467. * @apiBody { Boolean } options.qualifiedIfSelect 选中是否合格
  468. * @apiBody { Boolean } options.qualifiedIfNoSelect 未选中是否合格
  469. * @apiBody { Boolean } options.defaultSelect 是否默认选中
  470. * @apiBody { Integer } options.score 合格评分
  471. * @apiBody { Integer } options.seq 排序
  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 {put} /v1/check/item/update/select 06.更新选择项
  481. * @apiName 更新选择项
  482. * @apiGroup 检查项目-项目
  483. * @apiHeader {String = application/json} Content-Type = application/json
  484. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  485. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  486. * @apiPermission 【/v1/check/item/update/select#PUT】
  487. * @apiVersion 1.0.0
  488. * @apiBody { Object } checkItem 检查主项
  489. * @apiBody { Long } checkItem.id id 主键
  490. * @apiBody { String } checkItem.itemName 检查项名称
  491. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  492. * @apiBody { Boolean } checkItem.isRequired 是否必填
  493. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  494. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  495. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  496. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  497. * @apiBody { String } [ checkItem.remark ] 备注说明
  498. * @apiBody { Boolean } allowMultiple 是否允许多选
  499. * @apiBody { Object[] { 1..2147483647 } } options 选择项
  500. * @apiBody { String } options.optionName 选项名称
  501. * @apiBody { Boolean } options.qualifiedIfSelect 选中是否合格
  502. * @apiBody { Boolean } options.qualifiedIfNoSelect 未选中是否合格
  503. * @apiBody { Boolean } options.defaultSelect 是否默认选中
  504. * @apiBody { Integer } options.score 合格评分
  505. * @apiBody { Integer } options.seq 排序
  506. * @apiSuccess { Boolean } data 数据
  507. * @apiSuccess { String } message 信息
  508. * @apiSuccess { Integer } code 状态码
  509. * @apiSuccessExample Response
  510. *
  511. * {"data":true, "message":"", "code":1}
  512. */
  513. /**
  514. * @api {get} /v1/check/item/query/num/:id 07.获取数字项详情
  515. * @apiName 获取数字项详情
  516. * @apiGroup 检查项目-项目
  517. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  518. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  519. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  520. * @apiPermission 【/v1/check/item/query/num/{id}#GET】
  521. * @apiVersion 1.0.0
  522. * @apiParam { Long } id 检查项id
  523. * @apiSuccess { Object } data 数据
  524. * @apiSuccess { Object } data.checkItem 检查项
  525. * @apiSuccess { Long } data.checkItem.id id 主键
  526. * @apiSuccess { String } data.checkItem.itemNo 检查项编号
  527. * @apiSuccess { String } data.checkItem.itemName 检查项名称
  528. * @apiSuccess { Integer } data.checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  529. * @apiSuccess { Boolean } data.checkItem.isRequired 是否必填
  530. * @apiSuccess { String } data.checkItem.defaultValue 默认值
  531. * @apiSuccess { Boolean } data.checkItem.isScore 是否参与评分
  532. * @apiSuccess { Long } data.checkItem.patrolTypeId 检查类别id
  533. * @apiSuccess { String } data.checkItem.patrolTypeName 检查类别名称 冗余字段
  534. * @apiSuccess { Long } data.checkItem.userId 所属人员id
  535. * @apiSuccess { String } data.checkItem.username 所属人员名称
  536. * @apiSuccess { String } data.checkItem.remark 备注说明
  537. * @apiSuccess { Object } data.extra 数字项额外信息
  538. * @apiSuccess { Long } data.extra.id id 主键
  539. * @apiSuccess { Long } data.extra.checkItemId 检查项id
  540. * @apiSuccess { String } data.extra.unit 单位
  541. * @apiSuccess { Integer } data.extra.decimalPlaces 小数点后位数
  542. * @apiSuccess { Integer } data.extra.qualifiedScore 合格评分
  543. * @apiSuccess { Integer } data.extra.noQualifiedScore 不合格评分
  544. * @apiSuccess { String } data.extra.validMaxValue 有效值上限
  545. * @apiSuccess { String } data.extra.validMinValue 有效值下限
  546. * @apiSuccess { String } data.extra.qualifiedMaxValue 合格值上限
  547. * @apiSuccess { String } data.extra.qualifiedMinValue 合格值下限
  548. * @apiSuccess { Boolean } data.extra.checkValidMaxValue 是否强制校验有效值上限 输入值不能大于有效值上限
  549. * @apiSuccess { Boolean } data.extra.checkValidMinValue 是否强制校验有效值下限 输入值不能大于有效值下限
  550. * @apiSuccess { Boolean } data.extra.checkQualifiedMaxValue 是否强制校验合格值上限 输入值大于合格值上限时为不合格
  551. * @apiSuccess { Boolean } data.extra.checkQualifiedMinValue 是否强制校验合格值下限 输入值小于合格值下限时为不合格
  552. * @apiSuccess { String } message 信息
  553. * @apiSuccess { Integer } code 状态码
  554. * @apiSuccessExample Response
  555. *
  556. * {"data":{"checkItem":{"id":1, "itemNo":"", "itemName":"", "itemType":1, "isRequired":true, "defaultValue":"", "isScore":true, "patrolTypeId":1, "patrolTypeName":"", "userId":1, "username":"", "remark":""}, "extra":{"id":1, "checkItemId":1, "unit":"", "decimalPlaces":1, "qualifiedScore":1, "noQualifiedScore":1, "validMaxValue":"", "validMinValue":"", "qualifiedMaxValue":"", "qualifiedMinValue":"", "checkValidMaxValue":true, "checkValidMinValue":true, "checkQualifiedMaxValue":true, "checkQualifiedMinValue":true}}, "message":"", "code":1}
  557. */
  558. /**
  559. * @api {post} /v1/check/item/add/num 08.添加数字项
  560. * @apiName 添加数字项
  561. * @apiGroup 检查项目-项目
  562. * @apiHeader {String = application/json} Content-Type = application/json
  563. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  564. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  565. * @apiPermission 【/v1/check/item/add/num#POST】
  566. * @apiVersion 1.0.0
  567. * @apiBody { Object } checkItem 检查项
  568. * @apiBody { String } checkItem.itemName 检查项名称
  569. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  570. * @apiBody { Boolean } checkItem.isRequired 是否必填
  571. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  572. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  573. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  574. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  575. * @apiBody { String } [ checkItem.remark ] 备注说明
  576. * @apiBody { Object } extra 数字项
  577. * @apiBody { String } [ extra.unit ] 单位
  578. * @apiBody { Integer } extra.decimalPlaces 小数点后位数
  579. * @apiBody { Integer } extra.qualifiedScore 合格评分
  580. * @apiBody { Integer } extra.noQualifiedScore 不合格评分
  581. * @apiBody { String } [ extra.validMaxValue ] 有效值上限
  582. * @apiBody { String } [ extra.validMinValue ] 有效值下限
  583. * @apiBody { String } [ extra.qualifiedMaxValue ] 合格值上限
  584. * @apiBody { String } [ extra.qualifiedMinValue ] 合格值下限
  585. * @apiBody { Boolean } extra.checkValidMaxValue 是否强制校验有效值上限 输入值不能大于有效值上限
  586. * @apiBody { Boolean } extra.checkValidMinValue 是否强制校验有效值下限 输入值不能大于有效值下限
  587. * @apiBody { Boolean } extra.checkQualifiedMaxValue 是否强制校验合格值上限 输入值大于合格值上限时为不合格
  588. * @apiBody { Boolean } extra.checkQualifiedMinValue 是否强制校验合格值下限 输入值小于合格值下限时为不合格
  589. * @apiSuccess { Boolean } data 数据
  590. * @apiSuccess { String } message 信息
  591. * @apiSuccess { Integer } code 状态码
  592. * @apiSuccessExample Response
  593. *
  594. * {"data":true, "message":"", "code":1}
  595. */
  596. /**
  597. * @api {put} /v1/check/item/update/num 09.更新数字项
  598. * @apiName 更新数字项
  599. * @apiGroup 检查项目-项目
  600. * @apiHeader {String = application/json} Content-Type = application/json
  601. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  602. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  603. * @apiPermission 【/v1/check/item/update/num#PUT】
  604. * @apiVersion 1.0.0
  605. * @apiBody { Object } checkItem 检查项
  606. * @apiBody { Long } checkItem.id id 主键
  607. * @apiBody { String } checkItem.itemName 检查项名称
  608. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  609. * @apiBody { Boolean } checkItem.isRequired 是否必填
  610. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  611. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  612. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  613. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  614. * @apiBody { String } [ checkItem.remark ] 备注说明
  615. * @apiBody { Object } extra 数字项
  616. * @apiBody { Long } extra.id id 主键
  617. * @apiBody { String } [ extra.unit ] 单位
  618. * @apiBody { Integer } extra.decimalPlaces 小数点后位数
  619. * @apiBody { Integer } extra.qualifiedScore 合格评分
  620. * @apiBody { Integer } extra.noQualifiedScore 不合格评分
  621. * @apiBody { String } [ extra.validMaxValue ] 有效值上限
  622. * @apiBody { String } [ extra.validMinValue ] 有效值下限
  623. * @apiBody { String } [ extra.qualifiedMaxValue ] 合格值上限
  624. * @apiBody { String } [ extra.qualifiedMinValue ] 合格值下限
  625. * @apiBody { Boolean } extra.checkValidMaxValue 是否强制校验有效值上限 输入值不能大于有效值上限
  626. * @apiBody { Boolean } extra.checkValidMinValue 是否强制校验有效值下限 输入值不能大于有效值下限
  627. * @apiBody { Boolean } extra.checkQualifiedMaxValue 是否强制校验合格值上限 输入值大于合格值上限时为不合格
  628. * @apiBody { Boolean } extra.checkQualifiedMinValue 是否强制校验合格值下限 输入值小于合格值下限时为不合格
  629. * @apiSuccess { Boolean } data 数据
  630. * @apiSuccess { String } message 信息
  631. * @apiSuccess { Integer } code 状态码
  632. * @apiSuccessExample Response
  633. *
  634. * {"data":true, "message":"", "code":1}
  635. */
  636. /**
  637. * @api {get} /v1/check/item/query/txt/:id 10.获取文本项详情
  638. * @apiName 获取文本项详情
  639. * @apiGroup 检查项目-项目
  640. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  641. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  642. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  643. * @apiPermission 【/v1/check/item/query/txt/{id}#GET】
  644. * @apiVersion 1.0.0
  645. * @apiParam { Long } id 检查项id
  646. * @apiSuccess { Object } data 数据
  647. * @apiSuccess { Object } data.checkItem 检查项
  648. * @apiSuccess { Long } data.checkItem.id id 主键
  649. * @apiSuccess { String } data.checkItem.itemNo 检查项编号
  650. * @apiSuccess { String } data.checkItem.itemName 检查项名称
  651. * @apiSuccess { Integer } data.checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  652. * @apiSuccess { Boolean } data.checkItem.isRequired 是否必填
  653. * @apiSuccess { String } data.checkItem.defaultValue 默认值
  654. * @apiSuccess { Boolean } data.checkItem.isScore 是否参与评分
  655. * @apiSuccess { Long } data.checkItem.patrolTypeId 检查类别id
  656. * @apiSuccess { String } data.checkItem.patrolTypeName 检查类别名称 冗余字段
  657. * @apiSuccess { Long } data.checkItem.userId 所属人员id
  658. * @apiSuccess { String } data.checkItem.username 所属人员名称
  659. * @apiSuccess { String } data.checkItem.remark 备注说明
  660. * @apiSuccess { Object } data.extra 文本项额外信息
  661. * @apiSuccess { Long } data.extra.id id 主键
  662. * @apiSuccess { Long } data.extra.checkItemId 检查项id
  663. * @apiSuccess { Boolean } data.extra.allowMultiple 是否允许多行
  664. * @apiSuccess { Integer } data.extra.qualifiedScore 合格评分
  665. * @apiSuccess { Integer } data.extra.noQualifiedScore 不合格评分
  666. * @apiSuccess { Integer } data.extra.qualifiedJudge 合格判定 1始终合格、2始终不合格、3无内容合格、4有内容合格
  667. * @apiSuccess { String } message 信息
  668. * @apiSuccess { Integer } code 状态码
  669. * @apiSuccessExample Response
  670. *
  671. * {"data":{"checkItem":{"id":1, "itemNo":"", "itemName":"", "itemType":1, "isRequired":true, "defaultValue":"", "isScore":true, "patrolTypeId":1, "patrolTypeName":"", "userId":1, "username":"", "remark":""}, "extra":{"id":1, "checkItemId":1, "allowMultiple":true, "qualifiedScore":1, "noQualifiedScore":1, "qualifiedJudge":1}}, "message":"", "code":1}
  672. */
  673. /**
  674. * @api {post} /v1/check/item/add/txt 11.添加文本项
  675. * @apiName 添加文本项
  676. * @apiGroup 检查项目-项目
  677. * @apiHeader {String = application/json} Content-Type = application/json
  678. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  679. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  680. * @apiPermission 【/v1/check/item/add/txt#POST】
  681. * @apiVersion 1.0.0
  682. * @apiBody { Object } checkItem 检查主项
  683. * @apiBody { String } checkItem.itemName 检查项名称
  684. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  685. * @apiBody { Boolean } checkItem.isRequired 是否必填
  686. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  687. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  688. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  689. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  690. * @apiBody { String } [ checkItem.remark ] 备注说明
  691. * @apiBody { Object } extra 文本
  692. * @apiBody { Boolean } extra.allowMultiple 是否允许多行
  693. * @apiBody { Integer } extra.qualifiedScore 合格评分
  694. * @apiBody { Integer } extra.noQualifiedScore 不合格评分
  695. * @apiBody { Integer } extra.qualifiedJudge 合格判定 1始终合格、2始终不合格、3无内容合格、4有内容合格
  696. * @apiSuccess { Boolean } data 数据
  697. * @apiSuccess { String } message 信息
  698. * @apiSuccess { Integer } code 状态码
  699. * @apiSuccessExample Response
  700. *
  701. * {"data":true, "message":"", "code":1}
  702. */
  703. /**
  704. * @api {put} /v1/check/item/update/txt 12.更新文本项
  705. * @apiName 更新文本项
  706. * @apiGroup 检查项目-项目
  707. * @apiHeader {String = application/json} Content-Type = application/json
  708. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  709. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  710. * @apiPermission 【/v1/check/item/update/txt#PUT】
  711. * @apiVersion 1.0.0
  712. * @apiBody { Object } checkItem 检查主项
  713. * @apiBody { Long } checkItem.id id 主键
  714. * @apiBody { String } checkItem.itemName 检查项名称
  715. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  716. * @apiBody { Boolean } checkItem.isRequired 是否必填
  717. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  718. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  719. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  720. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  721. * @apiBody { String } [ checkItem.remark ] 备注说明
  722. * @apiBody { Object } extra 文本项
  723. * @apiBody { Long } extra.id id 主键
  724. * @apiBody { Boolean } extra.allowMultiple 是否允许多行
  725. * @apiBody { Integer } extra.qualifiedScore 合格评分
  726. * @apiBody { Integer } extra.noQualifiedScore 不合格评分
  727. * @apiBody { Integer } extra.qualifiedJudge 合格判定 1始终合格、2始终不合格、3无内容合格、4有内容合格
  728. * @apiSuccess { Boolean } data 数据
  729. * @apiSuccess { String } message 信息
  730. * @apiSuccess { Integer } code 状态码
  731. * @apiSuccessExample Response
  732. *
  733. * {"data":true, "message":"", "code":1}
  734. */
  735. /**
  736. * @api {get} /v1/check/item/query/photo/:id 13.获取拍照项详情
  737. * @apiName 获取拍照项详情
  738. * @apiGroup 检查项目-项目
  739. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  740. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  741. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  742. * @apiPermission 【/v1/check/item/query/photo/{id}#GET】
  743. * @apiVersion 1.0.0
  744. * @apiParam { Long } id 检查项id
  745. * @apiSuccess { Object } data 数据
  746. * @apiSuccess { Object } data.checkItem 检查项
  747. * @apiSuccess { Long } data.checkItem.id id 主键
  748. * @apiSuccess { String } data.checkItem.itemNo 检查项编号
  749. * @apiSuccess { String } data.checkItem.itemName 检查项名称
  750. * @apiSuccess { Integer } data.checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  751. * @apiSuccess { Boolean } data.checkItem.isRequired 是否必填
  752. * @apiSuccess { String } data.checkItem.defaultValue 默认值
  753. * @apiSuccess { Boolean } data.checkItem.isScore 是否参与评分
  754. * @apiSuccess { Long } data.checkItem.patrolTypeId 检查类别id
  755. * @apiSuccess { String } data.checkItem.patrolTypeName 检查类别名称 冗余字段
  756. * @apiSuccess { Long } data.checkItem.userId 所属人员id
  757. * @apiSuccess { String } data.checkItem.username 所属人员名称
  758. * @apiSuccess { String } data.checkItem.remark 备注说明
  759. * @apiSuccess { Object[] } data.photoPoints 拍照点列表
  760. * @apiSuccess { Long } data.photoPoints.id id 主键
  761. * @apiSuccess { Long } data.photoPoints.checkItemId 检查项id
  762. * @apiSuccess { String } data.photoPoints.name 拍照点名称
  763. * @apiSuccess { Boolean } data.photoPoints.isRequired 是否必须拍照
  764. * @apiSuccess { Boolean } data.photoPoints.qualifiedJudge 合格判定 true:拍照合格、false:拍照不合格
  765. * @apiSuccess { Integer } data.photoPoints.qualifiedScore 合格评分
  766. * @apiSuccess { Integer } data.photoPoints.noQualifiedScore 不合格评分
  767. * @apiSuccess { Integer } data.photoPoints.seq 排序
  768. * @apiSuccess { String } message 信息
  769. * @apiSuccess { Integer } code 状态码
  770. * @apiSuccessExample Response
  771. *
  772. * {"data":{"checkItem":{"id":1, "itemNo":"", "itemName":"", "itemType":1, "isRequired":true, "defaultValue":"", "isScore":true, "patrolTypeId":1, "patrolTypeName":"", "userId":1, "username":"", "remark":""}, "photoPoints":[{"id":1, "checkItemId":1, "name":"", "isRequired":true, "qualifiedJudge":true, "qualifiedScore":1, "noQualifiedScore":1, "seq":1}]}, "message":"", "code":1}
  773. */
  774. /**
  775. * @api {post} /v1/check/item/add/photo 14.添加拍照项
  776. * @apiName 添加拍照项
  777. * @apiGroup 检查项目-项目
  778. * @apiHeader {String = application/json} Content-Type = application/json
  779. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  780. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  781. * @apiPermission 【/v1/check/item/add/photo#POST】
  782. * @apiVersion 1.0.0
  783. * @apiBody { Object } checkItem 检查项
  784. * @apiBody { String } checkItem.itemName 检查项名称
  785. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  786. * @apiBody { Boolean } checkItem.isRequired 是否必填
  787. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  788. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  789. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  790. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  791. * @apiBody { String } [ checkItem.remark ] 备注说明
  792. * @apiBody { Object[] { 1..2147483647 } } photoPoints 选择项
  793. * @apiBody { String } photoPoints.name 拍照点名称
  794. * @apiBody { Boolean } photoPoints.isRequired 是否必须拍照
  795. * @apiBody { Boolean } photoPoints.qualifiedJudge 合格判定 true:拍照合格、false:拍照不合格
  796. * @apiBody { Integer } photoPoints.qualifiedScore 合格评分
  797. * @apiBody { Integer } photoPoints.noQualifiedScore 不合格评分
  798. * @apiBody { Integer } photoPoints.seq 排序
  799. * @apiSuccess { Boolean } data 数据
  800. * @apiSuccess { String } message 信息
  801. * @apiSuccess { Integer } code 状态码
  802. * @apiSuccessExample Response
  803. *
  804. * {"data":true, "message":"", "code":1}
  805. */
  806. /**
  807. * @api {put} /v1/check/item/update/photo 15.更新拍照项
  808. * @apiName 更新拍照项
  809. * @apiGroup 检查项目-项目
  810. * @apiHeader {String = application/json} Content-Type = application/json
  811. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  812. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  813. * @apiPermission 【/v1/check/item/update/photo#PUT】
  814. * @apiVersion 1.0.0
  815. * @apiBody { Object } checkItem 检查项
  816. * @apiBody { Long } checkItem.id id 主键
  817. * @apiBody { String } checkItem.itemName 检查项名称
  818. * @apiBody { Integer } checkItem.itemType 检查项类别 1选择、2数字、3文本、4拍照
  819. * @apiBody { Boolean } checkItem.isRequired 是否必填
  820. * @apiBody { String } [ checkItem.defaultValue ] 默认值
  821. * @apiBody { Boolean } checkItem.isScore 是否参与评分
  822. * @apiBody { Long } checkItem.patrolTypeId 巡检类别id
  823. * @apiBody { String } checkItem.patrolTypeName 巡检类别名称 冗余字段
  824. * @apiBody { String } [ checkItem.remark ] 备注说明
  825. * @apiBody { Object[] { 1..2147483647 } } photoPoints 拍照项
  826. * @apiBody { String } photoPoints.name 拍照点名称
  827. * @apiBody { Boolean } photoPoints.isRequired 是否必须拍照
  828. * @apiBody { Boolean } photoPoints.qualifiedJudge 合格判定 true:拍照合格、false:拍照不合格
  829. * @apiBody { Integer } photoPoints.qualifiedScore 合格评分
  830. * @apiBody { Integer } photoPoints.noQualifiedScore 不合格评分
  831. * @apiBody { Integer } photoPoints.seq 排序
  832. * @apiSuccess { Boolean } data 数据
  833. * @apiSuccess { String } message 信息
  834. * @apiSuccess { Integer } code 状态码
  835. * @apiSuccessExample Response
  836. *
  837. * {"data":true, "message":"", "code":1}
  838. */
  839. /**
  840. * @api {get} /v1/check/item/list/option 16.获取检查项选项
  841. * @apiName 获取检查项选项
  842. * @apiGroup 检查项目-项目
  843. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  844. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  845. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  846. * @apiVersion 1.0.0
  847. * @apiQuery { Integer } itemType 检查项类别 1选择、2数字、3文本、4拍照
  848. * @apiQuery { Boolean } isScore 是否参与评分
  849. * @apiSuccess { Object[] } data 数据
  850. * @apiSuccess { Long } data.id 选项key
  851. * @apiSuccess { String } data.name 选项值
  852. * @apiSuccess { String } message 信息
  853. * @apiSuccess { Integer } code 状态码
  854. * @apiSuccessExample Response
  855. *
  856. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  857. */
  858. /**
  859. * @api {post} /v1/check/route/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 = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  865. * @apiPermission 【/v1/check/route/add#POST】
  866. * @apiVersion 1.0.0
  867. * @apiBody { String } name 路线名称
  868. * @apiBody { String } [ responsibler ] 负责人名称
  869. * @apiBody { String } [ telephone ] 联系电话
  870. * @apiBody { String } [ remark ] 备注
  871. * @apiBody { Long[] } [ roomIds ] 巡检房间id列表
  872. * @apiBody { Long[] } [ deviceIds ] 巡检设备id列表
  873. * @apiSuccess { Object } data 数据
  874. * @apiSuccess { Long } data.id id 主键
  875. * @apiSuccess { String } data.number 路线编号
  876. * @apiSuccess { String } data.name 路线名称
  877. * @apiSuccess { String } data.responsibler 负责人名称
  878. * @apiSuccess { String } data.telephone 联系电话
  879. * @apiSuccess { String } data.remark 备注
  880. * @apiSuccess { Date } data.createTime 创建时间
  881. * @apiSuccess { String } message 信息
  882. * @apiSuccess { Integer } code 状态码
  883. * @apiSuccessExample Response
  884. *
  885. * {"data":{"id":1, "number":"", "name":"", "responsibler":"", "telephone":"", "remark":"", "createTime":1650761871420}, "message":"", "code":1}
  886. */
  887. /**
  888. * @api {delete} /v1/check/route/delete/:id 02.删除检查路线
  889. * @apiName 删除检查路线
  890. * @apiGroup 检查路线-路线查询
  891. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  892. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  893. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  894. * @apiPermission 【/v1/check/route/delete/{id}#DELETE】
  895. * @apiVersion 1.0.0
  896. * @apiParam { Long } id 检查路线id
  897. * @apiSuccess { Boolean } data 数据
  898. * @apiSuccess { String } message 信息
  899. * @apiSuccess { Integer } code 状态码
  900. * @apiSuccessExample Response
  901. *
  902. * {"data":true, "message":"", "code":1}
  903. */
  904. /**
  905. * @api {delete} /v1/check/route/delete 03.删除多条检查路线
  906. * @apiName 删除多条检查路线
  907. * @apiGroup 检查路线-路线查询
  908. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  909. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  910. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  911. * @apiPermission 【/v1/check/route/delete#DELETE】
  912. * @apiVersion 1.0.0
  913. * @apiQuery { Long[] { 1-2147483647 } } ids 检查路线id数组
  914. * @apiSuccess { Boolean } data 数据
  915. * @apiSuccess { String } message 信息
  916. * @apiSuccess { Integer } code 状态码
  917. * @apiSuccessExample Response
  918. *
  919. * {"data":true, "message":"", "code":1}
  920. */
  921. /**
  922. * @api {put} /v1/check/route/update 04.更新检查路线
  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 = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  928. * @apiPermission 【/v1/check/route/update#PUT】
  929. * @apiVersion 1.0.0
  930. * @apiBody { Long } id id 主键
  931. * @apiBody { String } name 路线名称
  932. * @apiBody { String } [ responsibler ] 负责人名称
  933. * @apiBody { String } [ telephone ] 联系电话
  934. * @apiBody { String } [ remark ] 备注
  935. * @apiBody { Long[] } [ roomIds ] 巡检房间id列表
  936. * @apiBody { Long[] } [ deviceIds ] 巡检设备id列表
  937. * @apiSuccess { Object } data 数据
  938. * @apiSuccess { Long } data.id id 主键
  939. * @apiSuccess { String } data.number 路线编号
  940. * @apiSuccess { String } data.name 路线名称
  941. * @apiSuccess { String } data.responsibler 负责人名称
  942. * @apiSuccess { String } data.telephone 联系电话
  943. * @apiSuccess { String } data.remark 备注
  944. * @apiSuccess { Date } data.createTime 创建时间
  945. * @apiSuccess { String } message 信息
  946. * @apiSuccess { Integer } code 状态码
  947. * @apiSuccessExample Response
  948. *
  949. * {"data":{"id":1, "number":"", "name":"", "responsibler":"", "telephone":"", "remark":"", "createTime":1650761871420}, "message":"", "code":1}
  950. */
  951. /**
  952. * @api {get} /v1/check/route/query/:id 05.查询检查路线
  953. * @apiName 查询检查路线
  954. * @apiGroup 检查路线-路线查询
  955. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  956. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  957. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  958. * @apiPermission 【/v1/check/route/query/{id}#GET】
  959. * @apiVersion 1.0.0
  960. * @apiParam { Long } id 检查路线id
  961. * @apiSuccess { Object } data 数据
  962. * @apiSuccess { Long } data.id id 主键
  963. * @apiSuccess { String } data.number 路线编号
  964. * @apiSuccess { String } data.name 路线名称
  965. * @apiSuccess { String } data.responsibler 负责人名称
  966. * @apiSuccess { String } data.telephone 联系电话
  967. * @apiSuccess { String } data.remark 备注
  968. * @apiSuccess { Date } data.createTime 创建时间
  969. * @apiSuccess { Object[] } data.rooms 房间列表
  970. * @apiSuccess { Object[] } data.rooms.children 子选项
  971. * @apiSuccess { Object[] } data.rooms.children.children 子选项
  972. * @apiSuccess { Long } data.rooms.children.id 选项key
  973. * @apiSuccess { String } data.rooms.children.name 选项值
  974. * @apiSuccess { Long } data.rooms.id 选项key
  975. * @apiSuccess { String } data.rooms.name 选项值
  976. * @apiSuccess { Object[] } data.devices 设备列表
  977. * @apiSuccess { Object[] } data.devices.children 子选项
  978. * @apiSuccess { Object[] } data.devices.children.children 子选项
  979. * @apiSuccess { Long } data.devices.children.id 选项key
  980. * @apiSuccess { String } data.devices.children.name 选项值
  981. * @apiSuccess { Long } data.devices.id 选项key
  982. * @apiSuccess { String } data.devices.name 选项值
  983. * @apiSuccess { String } message 信息
  984. * @apiSuccess { Integer } code 状态码
  985. * @apiSuccessExample Response
  986. *
  987. * {"data":{"id":1, "number":"", "name":"", "responsibler":"", "telephone":"", "remark":"", "createTime":1650761871420, "rooms":[{"children":[{"children":[], "id":1, "name":""}], "id":1, "name":""}], "devices":[{"children":[{"children":[], "id":1, "name":""}], "id":1, "name":""}]}, "message":"", "code":1}
  988. */
  989. /**
  990. * @api {get} /v1/check/route/list 06.分页查询检查路线
  991. * @apiName 分页查询检查路线
  992. * @apiGroup 检查路线-路线查询
  993. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  994. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  995. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  996. * @apiPermission 【/v1/check/route/list#GET】
  997. * @apiVersion 1.0.0
  998. * @apiQuery { String } [ number ] 路线编号
  999. * @apiQuery { String } [ name ] 路线名称
  1000. * @apiQuery { String } [ responsibler ] 负责人名称
  1001. * @apiQuery { String } [ telephone ] 联系电话
  1002. * @apiQuery { String } [ remark ] 备注
  1003. * @apiQuery { Date } [ createTimeStart ] 创建时间 开始时间
  1004. * @apiQuery { Date } [ createTimeEnd ] 创建时间 结束时间
  1005. * @apiQuery { Integer } [ page = 1 ] 页码
  1006. * @apiQuery { Integer } [ size = 10 ] 页大小
  1007. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  1008. * @apiSuccess { Object } data 数据
  1009. * @apiSuccess { Long } data.total 数据总数
  1010. * @apiSuccess { Object[] } data.list 数据列表
  1011. * @apiSuccess { Long } data.list.id id 主键
  1012. * @apiSuccess { String } data.list.number 路线编号
  1013. * @apiSuccess { String } data.list.name 路线名称
  1014. * @apiSuccess { String } data.list.responsibler 负责人名称
  1015. * @apiSuccess { String } data.list.telephone 联系电话
  1016. * @apiSuccess { String } data.list.remark 备注
  1017. * @apiSuccess { Date } data.list.createTime 创建时间
  1018. * @apiSuccess { String } message 信息
  1019. * @apiSuccess { Integer } code 状态码
  1020. * @apiSuccessExample Response
  1021. *
  1022. * {"data":{"total":1, "list":[{"id":1, "number":"", "name":"", "responsibler":"", "telephone":"", "remark":"", "createTime":1650761871420}]}, "message":"", "code":1}
  1023. */
  1024. /**
  1025. * @api {get} /v1/check/route/list/option 07.获取检查路线选项
  1026. * @apiName 获取检查路线选项
  1027. * @apiGroup 检查路线-路线查询
  1028. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1029. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1030. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1031. * @apiVersion 1.0.0
  1032. * @apiQuery { String } name 路线名称
  1033. * @apiSuccess { Object[] } data 数据
  1034. * @apiSuccess { Long } data.id 选项key
  1035. * @apiSuccess { String } data.name 选项值
  1036. * @apiSuccess { String } message 信息
  1037. * @apiSuccess { Integer } code 状态码
  1038. * @apiSuccessExample Response
  1039. *
  1040. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  1041. */
  1042. /**
  1043. * @api {put} /v1/patrol/task/update 01.更新巡检任务
  1044. * @apiName 更新巡检任务
  1045. * @apiGroup 巡检计划-巡检任务
  1046. * @apiHeader {String = application/json} Content-Type = application/json
  1047. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1048. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1049. * @apiPermission 【/v1/patrol/task/update#PUT】
  1050. * @apiVersion 1.0.0
  1051. * @apiBody { Long } id id 主键
  1052. * @apiBody { Long } routeId 检查路线id
  1053. * @apiBody { String } name 名称
  1054. * @apiBody { Integer } runModel 执行模式 1其中一人、2每人分别
  1055. * @apiBody { Date } beginTime 任务执行开始时间
  1056. * @apiBody { Date } endTime 任务执行结束时间
  1057. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1058. * @apiSuccess { Object } data 数据
  1059. * @apiSuccess { Long } data.id id 主键
  1060. * @apiSuccess { Long } data.planId 计划id
  1061. * @apiSuccess { Long } data.routeId 路线id
  1062. * @apiSuccess { String } data.routeName 路线名称
  1063. * @apiSuccess { String } data.routeResponsibler 负责人名称
  1064. * @apiSuccess { String } data.routeTelephone 联系电话
  1065. * @apiSuccess { Long } data.userId 创建人id
  1066. * @apiSuccess { String } data.username 创建人名称
  1067. * @apiSuccess { String } data.number 编号
  1068. * @apiSuccess { String } data.name 名称
  1069. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1070. * @apiSuccess { Integer } data.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  1071. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1072. * @apiSuccess { Boolean } data.disabled 是否禁用
  1073. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  1074. * @apiSuccess { Date } data.endTime 任务执行结束时间
  1075. * @apiSuccess { Date } data.createTime 创建时间
  1076. * @apiSuccess { String } message 信息
  1077. * @apiSuccess { Integer } code 状态码
  1078. * @apiSuccessExample Response
  1079. *
  1080. * {"data":{"id":1, "planId":1, "routeId":1, "routeName":"", "routeResponsibler":"", "routeTelephone":"", "userId":1, "username":"", "number":"", "name":"", "type":1, "status":1, "runModel":1, "disabled":true, "beginTime":1650761871421, "endTime":1650761871421, "createTime":1650761871421}, "message":"", "code":1}
  1081. */
  1082. /**
  1083. * @api {put} /v1/patrol/task/update/status 02.更新巡检任务禁用状态
  1084. * @apiName 更新巡检任务禁用状态
  1085. * @apiGroup 巡检计划-巡检任务
  1086. * @apiHeader {String = application/json} Content-Type = application/json
  1087. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1088. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1089. * @apiPermission 【/v1/patrol/task/update/status#PUT】
  1090. * @apiVersion 1.0.0
  1091. * @apiBody { Long } id 数据ID
  1092. * @apiBody { Boolean } disabled 是否禁用
  1093. * @apiSuccess { Boolean } data 数据
  1094. * @apiSuccess { String } message 信息
  1095. * @apiSuccess { Integer } code 状态码
  1096. * @apiSuccessExample Response
  1097. *
  1098. * {"data":true, "message":"", "code":1}
  1099. */
  1100. /**
  1101. * @api {get} /v1/patrol/task/query/:id 03.查询巡检任务
  1102. * @apiName 查询巡检任务
  1103. * @apiGroup 巡检计划-巡检任务
  1104. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1105. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1106. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1107. * @apiPermission 【/v1/patrol/task/query/{id}#GET】
  1108. * @apiVersion 1.0.0
  1109. * @apiParam { Long } id 巡检任务id
  1110. * @apiSuccess { Object } data 数据
  1111. * @apiSuccess { Long } data.id id 主键
  1112. * @apiSuccess { String } data.name 名称
  1113. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1114. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1115. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  1116. * @apiSuccess { Date } data.endTime 任务执行结束时间
  1117. * @apiSuccess { String } data.remark 备注
  1118. * @apiSuccess { Object } data.route 检查路线
  1119. * @apiSuccess { Long } data.route.id 选项key
  1120. * @apiSuccess { String } data.route.name 选项值
  1121. * @apiSuccess { Object[] } data.executors 执行人列表
  1122. * @apiSuccess { Long } data.executors.id 选项key
  1123. * @apiSuccess { String } data.executors.name 选项值
  1124. * @apiSuccess { String } message 信息
  1125. * @apiSuccess { Integer } code 状态码
  1126. * @apiSuccessExample Response
  1127. *
  1128. * {"data":{"id":1, "name":"", "type":1, "runModel":1, "beginTime":1650761871421, "endTime":1650761871421, "remark":"", "route":{"id":1, "name":""}, "executors":[{"id":1, "name":""}]}, "message":"", "code":1}
  1129. */
  1130. /**
  1131. * @api {get} /v1/patrol/task/list 04.分页查询巡检任务
  1132. * @apiName 分页查询巡检任务
  1133. * @apiGroup 巡检计划-巡检任务
  1134. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1135. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1136. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1137. * @apiPermission 【/v1/patrol/task/list#GET】
  1138. * @apiVersion 1.0.0
  1139. * @apiQuery { String } [ name ] 任务名称
  1140. * @apiQuery { Boolean } [ disabled ] 是否禁用
  1141. * @apiQuery { Integer } [ type ] 类型 1日计划、2周计划、3月计划
  1142. * @apiQuery { Integer } [ status ] 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  1143. * @apiQuery { Integer } [ runModel ] 执行模式 1其中一人、2每人分别
  1144. * @apiQuery { String } [ username ] 创建人
  1145. * @apiQuery { String } [ executor ]
  1146. * @apiQuery { Date } [ beginTimeStart ] 创建时间 开始时间
  1147. * @apiQuery { Date } [ beginTimeEnd ] 创建时间 结束时间
  1148. * @apiQuery { Integer } [ page = 1 ] 页码
  1149. * @apiQuery { Integer } [ size = 10 ] 页大小
  1150. * @apiQuery { String { ^[-+][\w]+ } } [ order = +id ] 排序规则(默认ID正序),排序字段前加:+表示正序 -表示倒序
  1151. * @apiSuccess { Object } data 数据
  1152. * @apiSuccess { Long } data.total 数据总数
  1153. * @apiSuccess { Object[] } data.list 数据列表
  1154. * @apiSuccess { Long } data.list.id id 主键
  1155. * @apiSuccess { String } data.list.routeName 检查路线
  1156. * @apiSuccess { String } data.list.username 创建人
  1157. * @apiSuccess { String } data.list.number 编号
  1158. * @apiSuccess { String } data.list.name 名称
  1159. * @apiSuccess { Integer } data.list.type 类型 1日计划、2周计划、3月计划
  1160. * @apiSuccess { Integer } data.list.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  1161. * @apiSuccess { Integer } data.list.runModel 执行模式 1其中一人、2每人分别
  1162. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  1163. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  1164. * @apiSuccess { Date } data.list.endTime 任务执行结束时间
  1165. * @apiSuccess { String[] } data.list.executors 执行人列表
  1166. * @apiSuccess { String } message 信息
  1167. * @apiSuccess { Integer } code 状态码
  1168. * @apiSuccessExample Response
  1169. *
  1170. * {"data":{"total":1, "list":[{"id":1, "routeName":"", "username":"", "number":"", "name":"", "type":1, "status":1, "runModel":1, "disabled":true, "beginTime":1650761871421, "endTime":1650761871421, "executors":[""]}]}, "message":"", "code":1}
  1171. */
  1172. /**
  1173. * @api {get} /v1/patrol/task/generate/task 05.生成巡检任务
  1174. * @apiName 生成巡检任务
  1175. * @apiGroup 巡检计划-巡检任务
  1176. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1177. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1178. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1179. * @apiPermission 【/v1/patrol/task/generate/task#GET】
  1180. * @apiVersion 1.0.0
  1181. * @apiSuccess { Date } data 数据
  1182. * @apiSuccess { String } message 信息
  1183. * @apiSuccess { Integer } code 状态码
  1184. * @apiSuccessExample Response
  1185. *
  1186. * {"data":1650761871421, "message":"", "code":1}
  1187. */
  1188. /**
  1189. * @api {delete} /v1/patrol/task/delete 06.删除多条巡检任务
  1190. * @apiName 删除多条巡检任务
  1191. * @apiGroup 巡检计划-巡检任务
  1192. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1193. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1194. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1195. * @apiPermission 【/v1/patrol/task/delete#DELETE】
  1196. * @apiVersion 1.0.0
  1197. * @apiQuery { Long[] { 1-2147483647 } } ids 巡检任务id数组
  1198. * @apiSuccess { Boolean } data 数据
  1199. * @apiSuccess { String } message 信息
  1200. * @apiSuccess { Integer } code 状态码
  1201. * @apiSuccessExample Response
  1202. *
  1203. * {"data":true, "message":"", "code":1}
  1204. */
  1205. /**
  1206. * @api {delete} /v1/patrol/task/delete/:id 07.删除巡检任务
  1207. * @apiName 删除巡检任务
  1208. * @apiGroup 巡检计划-巡检任务
  1209. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1210. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1211. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1212. * @apiPermission 【/v1/patrol/task/delete/{id}#DELETE】
  1213. * @apiVersion 1.0.0
  1214. * @apiParam { Long } id 巡检任务id
  1215. * @apiSuccess { Boolean } data 数据
  1216. * @apiSuccess { String } message 信息
  1217. * @apiSuccess { Integer } code 状态码
  1218. * @apiSuccessExample Response
  1219. *
  1220. * {"data":true, "message":"", "code":1}
  1221. */
  1222. /**
  1223. * @api {post} /v1/patrol/plan/add 01.添加巡检计划
  1224. * @apiName 添加巡检计划
  1225. * @apiGroup 巡检计划-巡检计划查询
  1226. * @apiHeader {String = application/json} Content-Type = application/json
  1227. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1228. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1229. * @apiPermission 【/v1/patrol/plan/add#POST】
  1230. * @apiVersion 1.0.0
  1231. * @apiBody { Long } routeId 检查路线id
  1232. * @apiBody { String } name 名称
  1233. * @apiBody { Integer } type 类型 1日计划、2周计划、3月计划
  1234. * @apiBody { Integer } runModel 执行模式 1其中一人、2每人分别
  1235. * @apiBody { Date } beginDate 计划执行开始日期
  1236. * @apiBody { Date } [ endDate ] 计划执行结束日期,空代表永不结束
  1237. * @apiBody { Date } beginTime 任务执行开始时间
  1238. * @apiBody { Date } endTime 任务执行结束时间
  1239. * @apiBody { String } [ weeks ] 周计划 [1-7]
  1240. * @apiBody { String } [ months ] 月计划 [1-31]
  1241. * @apiBody { String } [ remark ] 备注
  1242. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1243. * @apiSuccess { Object } data 数据
  1244. * @apiSuccess { Long } data.id id 主键
  1245. * @apiSuccess { Long } data.routeId 路线id
  1246. * @apiSuccess { Long } data.userId 创建人id
  1247. * @apiSuccess { String } data.number 编号
  1248. * @apiSuccess { String } data.name 名称
  1249. * @apiSuccess { Boolean } data.disabled 是否禁用
  1250. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1251. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1252. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  1253. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  1254. * @apiSuccess { Object } data.beginTime 任务执行开始时间
  1255. * @apiSuccess { Byte } data.beginTime.hour
  1256. * @apiSuccess { Byte } data.beginTime.minute
  1257. * @apiSuccess { Byte } data.beginTime.second
  1258. * @apiSuccess { Integer } data.beginTime.nano
  1259. * @apiSuccess { Object } data.endTime 任务执行结束时间
  1260. * @apiSuccess { Byte } data.endTime.hour
  1261. * @apiSuccess { Byte } data.endTime.minute
  1262. * @apiSuccess { Byte } data.endTime.second
  1263. * @apiSuccess { Integer } data.endTime.nano
  1264. * @apiSuccess { String } data.weeks 周计划 [1-7]
  1265. * @apiSuccess { String } data.months 月计划 [1-31]
  1266. * @apiSuccess { String } data.remark 备注
  1267. * @apiSuccess { String } message 信息
  1268. * @apiSuccess { Integer } code 状态码
  1269. * @apiSuccessExample Response
  1270. *
  1271. * {"data":{"id":1, "routeId":1, "userId":1, "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1650761871421, "endDate":1650761871421, "beginTime":{"hour":1, "minute":1, "second":1, "nano":1}, "endTime":{"hour":1, "minute":1, "second":1, "nano":1}, "weeks":"", "months":"", "remark":""}, "message":"", "code":1}
  1272. */
  1273. /**
  1274. * @api {put} /v1/patrol/plan/update 02.更新巡检计划
  1275. * @apiName 更新巡检计划
  1276. * @apiGroup 巡检计划-巡检计划查询
  1277. * @apiHeader {String = application/json} Content-Type = application/json
  1278. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1279. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1280. * @apiPermission 【/v1/patrol/plan/update#PUT】
  1281. * @apiVersion 1.0.0
  1282. * @apiBody { Long } id id 主键
  1283. * @apiBody { Long } routeId 检查路线id
  1284. * @apiBody { String } name 名称
  1285. * @apiBody { Integer } type 类型 1日计划、2周计划、3月计划
  1286. * @apiBody { Integer } runModel 执行模式 1其中一人、2每人分别
  1287. * @apiBody { Date } beginDate 计划执行开始日期
  1288. * @apiBody { Date } [ endDate ] 计划执行结束日期,空代表永不结束
  1289. * @apiBody { Date } beginTime 任务执行开始时间
  1290. * @apiBody { Date } endTime 任务执行结束时间
  1291. * @apiBody { String } [ weeks ] 周计划 [1-7]
  1292. * @apiBody { String } [ months ] 月计划 [1-31]
  1293. * @apiBody { String } [ remark ] 备注
  1294. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1295. * @apiSuccess { Object } data 数据
  1296. * @apiSuccess { Long } data.id id 主键
  1297. * @apiSuccess { Long } data.routeId 路线id
  1298. * @apiSuccess { Long } data.userId 创建人id
  1299. * @apiSuccess { String } data.number 编号
  1300. * @apiSuccess { String } data.name 名称
  1301. * @apiSuccess { Boolean } data.disabled 是否禁用
  1302. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1303. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1304. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  1305. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  1306. * @apiSuccess { Object } data.beginTime 任务执行开始时间
  1307. * @apiSuccess { Byte } data.beginTime.hour
  1308. * @apiSuccess { Byte } data.beginTime.minute
  1309. * @apiSuccess { Byte } data.beginTime.second
  1310. * @apiSuccess { Integer } data.beginTime.nano
  1311. * @apiSuccess { Object } data.endTime 任务执行结束时间
  1312. * @apiSuccess { Byte } data.endTime.hour
  1313. * @apiSuccess { Byte } data.endTime.minute
  1314. * @apiSuccess { Byte } data.endTime.second
  1315. * @apiSuccess { Integer } data.endTime.nano
  1316. * @apiSuccess { String } data.weeks 周计划 [1-7]
  1317. * @apiSuccess { String } data.months 月计划 [1-31]
  1318. * @apiSuccess { String } data.remark 备注
  1319. * @apiSuccess { String } message 信息
  1320. * @apiSuccess { Integer } code 状态码
  1321. * @apiSuccessExample Response
  1322. *
  1323. * {"data":{"id":1, "routeId":1, "userId":1, "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1650761871422, "endDate":1650761871422, "beginTime":{"hour":1, "minute":1, "second":1, "nano":1}, "endTime":{"hour":1, "minute":1, "second":1, "nano":1}, "weeks":"", "months":"", "remark":""}, "message":"", "code":1}
  1324. */
  1325. /**
  1326. * @api {put} /v1/patrol/plan/update/status 03.更新巡检计划禁用状态
  1327. * @apiName 更新巡检计划禁用状态
  1328. * @apiGroup 巡检计划-巡检计划查询
  1329. * @apiHeader {String = application/json} Content-Type = application/json
  1330. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1331. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1332. * @apiPermission 【/v1/patrol/plan/update/status#PUT】
  1333. * @apiVersion 1.0.0
  1334. * @apiBody { Long } id 数据ID
  1335. * @apiBody { Boolean } disabled 是否禁用
  1336. * @apiSuccess { Boolean } data 数据
  1337. * @apiSuccess { String } message 信息
  1338. * @apiSuccess { Integer } code 状态码
  1339. * @apiSuccessExample Response
  1340. *
  1341. * {"data":true, "message":"", "code":1}
  1342. */
  1343. /**
  1344. * @api {get} /v1/patrol/plan/query/:id 04.查询巡检计划
  1345. * @apiName 查询巡检计划
  1346. * @apiGroup 巡检计划-巡检计划查询
  1347. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1348. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1349. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1350. * @apiPermission 【/v1/patrol/plan/query/{id}#GET】
  1351. * @apiVersion 1.0.0
  1352. * @apiParam { Long } id 巡检计划id
  1353. * @apiSuccess { Object } data 数据
  1354. * @apiSuccess { Long } data.id id 主键
  1355. * @apiSuccess { String } data.name 名称
  1356. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1357. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1358. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  1359. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  1360. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  1361. * @apiSuccess { Date } data.endTime 任务执行结束时间
  1362. * @apiSuccess { String } data.weeks 周计划 [1-7]
  1363. * @apiSuccess { String } data.months 月计划 [1-31]
  1364. * @apiSuccess { String } data.remark 备注
  1365. * @apiSuccess { Object } data.route 检查路线
  1366. * @apiSuccess { Long } data.route.id 选项key
  1367. * @apiSuccess { String } data.route.name 选项值
  1368. * @apiSuccess { Object[] } data.executors 执行人列表
  1369. * @apiSuccess { Long } data.executors.id 选项key
  1370. * @apiSuccess { String } data.executors.name 选项值
  1371. * @apiSuccess { String } message 信息
  1372. * @apiSuccess { Integer } code 状态码
  1373. * @apiSuccessExample Response
  1374. *
  1375. * {"data":{"id":1, "name":"", "type":1, "runModel":1, "beginDate":1650761871422, "endDate":1650761871422, "beginTime":1650761871422, "endTime":1650761871422, "weeks":"", "months":"", "remark":"", "route":{"id":1, "name":""}, "executors":[{"id":1, "name":""}]}, "message":"", "code":1}
  1376. */
  1377. /**
  1378. * @api {get} /v1/patrol/plan/list 05.分页查询巡检计划
  1379. * @apiName 分页查询巡检计划
  1380. * @apiGroup 巡检计划-巡检计划查询
  1381. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1382. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1383. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1384. * @apiPermission 【/v1/patrol/plan/list#GET】
  1385. * @apiVersion 1.0.0
  1386. * @apiQuery { String } [ name ] 计划名称
  1387. * @apiQuery { Boolean } [ disabled ] 是否禁用
  1388. * @apiQuery { Integer } [ type ] 类型 1日计划、2周计划、3月计划
  1389. * @apiQuery { Integer } [ runModel ] 执行模式 1其中一人、2每人分别
  1390. * @apiQuery { String } [ username ] 创建人
  1391. * @apiQuery { String } [ executor ] 执行人
  1392. * @apiQuery { Integer } [ page = 1 ] 页码
  1393. * @apiQuery { Integer } [ size = 10 ] 页大小
  1394. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  1395. * @apiSuccess { Object } data 数据
  1396. * @apiSuccess { Long } data.total 数据总数
  1397. * @apiSuccess { Object[] } data.list 数据列表
  1398. * @apiSuccess { Long } data.list.id id 主键
  1399. * @apiSuccess { String } data.list.routeName 检查路线
  1400. * @apiSuccess { String } data.list.username 创建人
  1401. * @apiSuccess { String } data.list.number 编号
  1402. * @apiSuccess { String } data.list.name 名称
  1403. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  1404. * @apiSuccess { Integer } data.list.type 类型 1日计划、2周计划、3月计划
  1405. * @apiSuccess { Integer } data.list.runModel 执行模式 1其中一人、2每人分别
  1406. * @apiSuccess { Date } data.list.beginDate 计划执行开始日期
  1407. * @apiSuccess { Date } data.list.endDate 计划执行结束日期,空代表永不结束
  1408. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  1409. * @apiSuccess { Date } data.list.endTime 任务执行结束时间
  1410. * @apiSuccess { String } data.list.weeks 周计划 [1-7]
  1411. * @apiSuccess { String } data.list.months 月计划 [1-31]
  1412. * @apiSuccess { String } data.list.remark 备注
  1413. * @apiSuccess { String[] } data.list.executors 执行人列表
  1414. * @apiSuccess { String } message 信息
  1415. * @apiSuccess { Integer } code 状态码
  1416. * @apiSuccessExample Response
  1417. *
  1418. * {"data":{"total":1, "list":[{"id":1, "routeName":"", "username":"", "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1650761871422, "endDate":1650761871422, "beginTime":1650761871422, "endTime":1650761871422, "weeks":"", "months":"", "remark":"", "executors":[""]}]}, "message":"", "code":1}
  1419. */
  1420. /**
  1421. * @api {delete} /v1/patrol/plan/delete 06.删除多条巡检计划
  1422. * @apiName 删除多条巡检计划
  1423. * @apiGroup 巡检计划-巡检计划查询
  1424. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1425. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1426. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1427. * @apiPermission 【/v1/patrol/plan/delete#DELETE】
  1428. * @apiVersion 1.0.0
  1429. * @apiQuery { Long[] { 1-2147483647 } } ids 巡检计划id数组
  1430. * @apiSuccess { Boolean } data 数据
  1431. * @apiSuccess { String } message 信息
  1432. * @apiSuccess { Integer } code 状态码
  1433. * @apiSuccessExample Response
  1434. *
  1435. * {"data":true, "message":"", "code":1}
  1436. */
  1437. /**
  1438. * @api {delete} /v1/patrol/plan/delete/:id 07.删除巡检计划
  1439. * @apiName 删除巡检计划
  1440. * @apiGroup 巡检计划-巡检计划查询
  1441. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1442. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1443. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1444. * @apiPermission 【/v1/patrol/plan/delete/{id}#DELETE】
  1445. * @apiVersion 1.0.0
  1446. * @apiParam { Long } id 巡检计划id
  1447. * @apiSuccess { Boolean } data 数据
  1448. * @apiSuccess { String } message 信息
  1449. * @apiSuccess { Integer } code 状态码
  1450. * @apiSuccessExample Response
  1451. *
  1452. * {"data":true, "message":"", "code":1}
  1453. */
  1454. /**
  1455. * @api {get} /v1/patrol/task/record/list/room 01.分页查询房间巡检记录
  1456. * @apiName 分页查询房间巡检记录
  1457. * @apiGroup 巡检任务-巡检任务记录
  1458. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1459. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1460. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1461. * @apiVersion 1.0.0
  1462. * @apiQuery { String } [ taskName ] 任务名称
  1463. * @apiQuery { String } [ username ] 执行用户名
  1464. * @apiQuery { String } [ buildingName ] 楼栋名称
  1465. * @apiQuery { String } [ floorName ] 楼层名称
  1466. * @apiQuery { String } [ roomName ] 房间名称
  1467. * @apiQuery { String } [ roomNumber ] 房间编号
  1468. * @apiQuery { Date } [ beginTimeStart ] 任务开始时间 开始时间
  1469. * @apiQuery { Date } [ beginTimeEnd ] 任务开始时间 结束时间
  1470. * @apiQuery { Integer } [ page = 1 ] 页码
  1471. * @apiQuery { Integer } [ size = 10 ] 页大小
  1472. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ]
  1473. * @apiSuccess { Object } data 数据
  1474. * @apiSuccess { Long } data.total 数据总数
  1475. * @apiSuccess { Object[] } data.list 数据列表
  1476. * @apiSuccess { Long } data.list.id 任务id
  1477. * @apiSuccess { String } data.list.name 任务名称
  1478. * @apiSuccess { String } data.list.buildingName 楼栋名称
  1479. * @apiSuccess { String } data.list.floorName 楼层名称
  1480. * @apiSuccess { Long } data.list.roomId 房间id
  1481. * @apiSuccess { String } data.list.roomName 房间名称
  1482. * @apiSuccess { String } data.list.roomNumber 房间编号
  1483. * @apiSuccess { Long } data.list.userId 执行用户id
  1484. * @apiSuccess { String } data.list.username 执行用户名
  1485. * @apiSuccess { Date } data.list.beginTime 巡检时间
  1486. * @apiSuccess { Boolean } data.list.qualified 是否合格
  1487. * @apiSuccess { String } message 信息
  1488. * @apiSuccess { Integer } code 状态码
  1489. * @apiSuccessExample Response
  1490. *
  1491. * {"data":{"total":1, "list":[{"id":1, "name":"", "buildingName":"", "floorName":"", "roomId":1, "roomName":"", "roomNumber":"", "userId":1, "username":"", "beginTime":1650761871423, "qualified":true}]}, "message":"", "code":1}
  1492. */
  1493. /**
  1494. * @api {get} /v1/patrol/task/record/query/room 02.查询房间巡检记录详情
  1495. * @apiName 查询房间巡检记录详情
  1496. * @apiGroup 巡检任务-巡检任务记录
  1497. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1498. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1499. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1500. * @apiVersion 1.0.0
  1501. * @apiQuery { Long } taskId 巡检任务id
  1502. * @apiQuery { Long } roomId 房间id
  1503. * @apiQuery { Long } userId 巡检人员id
  1504. * @apiSuccess { Object } data 数据
  1505. * @apiSuccess { String } data.taskName 任务名称
  1506. * @apiSuccess { String } data.routeName 所属路线
  1507. * @apiSuccess { String } data.roomName 房间名称
  1508. * @apiSuccess { String } data.roomNumber 房间编号
  1509. * @apiSuccess { String } data.floorName 楼层名称
  1510. * @apiSuccess { String } data.buildingName 楼栋名称
  1511. * @apiSuccess { String } data.name 巡检任务名称
  1512. * @apiSuccess { Date } data.beginTime 任务开始时间
  1513. * @apiSuccess { Date } data.endTime 任务结束时间
  1514. * @apiSuccess { Date } data.updateTime 巡检时间
  1515. * @apiSuccess { String } data.username 巡检人员
  1516. * @apiSuccess { Integer } data.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  1517. * @apiSuccess { Boolean } data.qualified 是否合格
  1518. * @apiSuccess { Integer } data.score 评分
  1519. * @apiSuccess { Object[] } data.checkItems 检查项列表
  1520. * @apiSuccess { Integer } data.checkItems.checkItemType 检查项类别 1选择、2数字、3文本、4拍照
  1521. * @apiSuccess { String } data.checkItems.checkItemName 检查项名称
  1522. * @apiSuccess { String } data.checkItems.checkItem 检查项
  1523. * @apiSuccess { Integer } data.checkItems.score 得分
  1524. * @apiSuccess { Integer } data.checkItems.scoreTotal 合格总分数
  1525. * @apiSuccess { String } data.checkItems.value 用户输入值
  1526. * @apiSuccess { Object[] } data.devices 设备列表
  1527. * @apiSuccess { String } data.devices.deviceName 设备名称
  1528. * @apiSuccess { Object[] } data.devices.checkItems 检查项列表
  1529. * @apiSuccess { Integer } data.devices.checkItems.checkItemType 检查项类别 1选择、2数字、3文本、4拍照
  1530. * @apiSuccess { String } data.devices.checkItems.checkItemName 检查项名称
  1531. * @apiSuccess { String } data.devices.checkItems.checkItem 检查项
  1532. * @apiSuccess { Integer } data.devices.checkItems.score 得分
  1533. * @apiSuccess { Integer } data.devices.checkItems.scoreTotal 合格总分数
  1534. * @apiSuccess { String } data.devices.checkItems.value 用户输入值
  1535. * @apiSuccess { String } message 信息
  1536. * @apiSuccess { Integer } code 状态码
  1537. * @apiSuccessExample Response
  1538. *
  1539. * {"data":{"taskName":"", "routeName":"", "roomName":"", "roomNumber":"", "floorName":"", "buildingName":"", "name":"", "beginTime":1650761871423, "endTime":1650761871423, "updateTime":1650761871423, "username":"", "status":1, "qualified":true, "score":1, "checkItems":[{"checkItemType":1, "checkItemName":"", "checkItem":"", "score":1, "scoreTotal":1, "value":""}], "devices":[{"deviceName":"", "checkItems":[{"checkItemType":1, "checkItemName":"", "checkItem":"", "score":1, "scoreTotal":1, "value":""}]}]}, "message":"", "code":1}
  1540. */
  1541. /**
  1542. * @api {put} /v1/upkeep/task/update 01.更新保养任务
  1543. * @apiName 更新保养任务
  1544. * @apiGroup 保养计划-保养任务
  1545. * @apiHeader {String = application/json} Content-Type = application/json
  1546. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1547. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1548. * @apiPermission 【/v1/upkeep/task/update#PUT】
  1549. * @apiVersion 1.0.0
  1550. * @apiBody { Long } id id 主键
  1551. * @apiBody { Long } routeId 检查路线id
  1552. * @apiBody { String } name 名称
  1553. * @apiBody { Integer } runModel 执行模式 1其中一人、2每人分别
  1554. * @apiBody { Date } beginTime 任务执行开始时间
  1555. * @apiBody { Date } endTime 任务执行结束时间
  1556. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1557. * @apiSuccess { Object } data 数据
  1558. * @apiSuccess { Long } data.id id 主键
  1559. * @apiSuccess { Long } data.planId 计划id
  1560. * @apiSuccess { Long } data.routeId 巡检路线id
  1561. * @apiSuccess { Long } data.userId 创建人id
  1562. * @apiSuccess { String } data.number 编号
  1563. * @apiSuccess { String } data.name 名称
  1564. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1565. * @apiSuccess { Integer } data.status 状态 1未开始、2进行中、3已结束
  1566. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1567. * @apiSuccess { Boolean } data.disabled 是否禁用
  1568. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  1569. * @apiSuccess { Date } data.endTime 任务执行结束时间
  1570. * @apiSuccess { Date } data.createTime 创建时间
  1571. * @apiSuccess { String } message 信息
  1572. * @apiSuccess { Integer } code 状态码
  1573. * @apiSuccessExample Response
  1574. *
  1575. * {"data":{"id":1, "planId":1, "routeId":1, "userId":1, "number":"", "name":"", "type":1, "status":1, "runModel":1, "disabled":true, "beginTime":1650761871423, "endTime":1650761871423, "createTime":1650761871423}, "message":"", "code":1}
  1576. */
  1577. /**
  1578. * @api {put} /v1/upkeep/task/update/status 02.更新保养任务禁用状态
  1579. * @apiName 更新保养任务禁用状态
  1580. * @apiGroup 保养计划-保养任务
  1581. * @apiHeader {String = application/json} Content-Type = application/json
  1582. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1583. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1584. * @apiPermission 【/v1/upkeep/task/update/status#PUT】
  1585. * @apiVersion 1.0.0
  1586. * @apiBody { Long } id 数据ID
  1587. * @apiBody { Boolean } disabled 是否禁用
  1588. * @apiSuccess { Boolean } data 数据
  1589. * @apiSuccess { String } message 信息
  1590. * @apiSuccess { Integer } code 状态码
  1591. * @apiSuccessExample Response
  1592. *
  1593. * {"data":true, "message":"", "code":1}
  1594. */
  1595. /**
  1596. * @api {get} /v1/upkeep/task/query/:id 03.查询保养任务
  1597. * @apiName 查询保养任务
  1598. * @apiGroup 保养计划-保养任务
  1599. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1600. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1601. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1602. * @apiPermission 【/v1/upkeep/task/query/{id}#GET】
  1603. * @apiVersion 1.0.0
  1604. * @apiParam { Long } id 保养任务id
  1605. * @apiSuccess { Object } data 数据
  1606. * @apiSuccess { Long } data.id id 主键
  1607. * @apiSuccess { String } data.name 名称
  1608. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1609. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1610. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  1611. * @apiSuccess { Date } data.endTime 任务执行结束时间
  1612. * @apiSuccess { String } data.remark 备注
  1613. * @apiSuccess { Object } data.route 检查路线
  1614. * @apiSuccess { Long } data.route.id 选项key
  1615. * @apiSuccess { String } data.route.name 选项值
  1616. * @apiSuccess { Object[] } data.executors 执行人列表
  1617. * @apiSuccess { Long } data.executors.id 选项key
  1618. * @apiSuccess { String } data.executors.name 选项值
  1619. * @apiSuccess { String } message 信息
  1620. * @apiSuccess { Integer } code 状态码
  1621. * @apiSuccessExample Response
  1622. *
  1623. * {"data":{"id":1, "name":"", "type":1, "runModel":1, "beginTime":1650761871423, "endTime":1650761871423, "remark":"", "route":{"id":1, "name":""}, "executors":[{"id":1, "name":""}]}, "message":"", "code":1}
  1624. */
  1625. /**
  1626. * @api {get} /v1/upkeep/task/list 04.分页查询保养任务
  1627. * @apiName 分页查询保养任务
  1628. * @apiGroup 保养计划-保养任务
  1629. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1630. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1631. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1632. * @apiPermission 【/v1/upkeep/task/list#GET】
  1633. * @apiVersion 1.0.0
  1634. * @apiQuery { String } [ name ] 任务名称
  1635. * @apiQuery { Boolean } [ disabled ] 是否禁用
  1636. * @apiQuery { Integer } [ type ] 类型 1日计划、2周计划、3月计划
  1637. * @apiQuery { Integer } [ status ] 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  1638. * @apiQuery { Integer } [ runModel ] 执行模式 1其中一人、2每人分别
  1639. * @apiQuery { String } [ username ] 创建人
  1640. * @apiQuery { String } [ executor ]
  1641. * @apiQuery { Date } [ beginTimeStart ] 创建时间 开始时间
  1642. * @apiQuery { Date } [ beginTimeEnd ] 创建时间 结束时间
  1643. * @apiQuery { Integer } [ page = 1 ] 页码
  1644. * @apiQuery { Integer } [ size = 10 ] 页大小
  1645. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  1646. * @apiSuccess { Object } data 数据
  1647. * @apiSuccess { Long } data.total 数据总数
  1648. * @apiSuccess { Object[] } data.list 数据列表
  1649. * @apiSuccess { Long } data.list.id id 主键
  1650. * @apiSuccess { String } data.list.routeName 检查路线
  1651. * @apiSuccess { String } data.list.username 创建人
  1652. * @apiSuccess { String } data.list.number 编号
  1653. * @apiSuccess { String } data.list.name 名称
  1654. * @apiSuccess { Integer } data.list.type 类型 1日计划、2周计划、3月计划
  1655. * @apiSuccess { Integer } data.list.status 状态 1未开始、2进行中、3正常完成、4超时漏检、5超时完成
  1656. * @apiSuccess { Integer } data.list.runModel 执行模式 1其中一人、2每人分别
  1657. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  1658. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  1659. * @apiSuccess { Date } data.list.endTime 任务执行结束时间
  1660. * @apiSuccess { String[] } data.list.executors 执行人列表
  1661. * @apiSuccess { String } message 信息
  1662. * @apiSuccess { Integer } code 状态码
  1663. * @apiSuccessExample Response
  1664. *
  1665. * {"data":{"total":1, "list":[{"id":1, "routeName":"", "username":"", "number":"", "name":"", "type":1, "status":1, "runModel":1, "disabled":true, "beginTime":1650761871424, "endTime":1650761871424, "executors":[""]}]}, "message":"", "code":1}
  1666. */
  1667. /**
  1668. * @api {get} /v1/upkeep/task/generate/task 05.生成保养任务
  1669. * @apiName 生成保养任务
  1670. * @apiGroup 保养计划-保养任务
  1671. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1672. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1673. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1674. * @apiPermission 【/v1/upkeep/task/generate/task#GET】
  1675. * @apiVersion 1.0.0
  1676. * @apiSuccess { Date } data 数据
  1677. * @apiSuccess { String } message 信息
  1678. * @apiSuccess { Integer } code 状态码
  1679. * @apiSuccessExample Response
  1680. *
  1681. * {"data":1650761871424, "message":"", "code":1}
  1682. */
  1683. /**
  1684. * @api {delete} /v1/upkeep/task/delete 06.删除多条保养任务
  1685. * @apiName 删除多条保养任务
  1686. * @apiGroup 保养计划-保养任务
  1687. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1688. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1689. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1690. * @apiPermission 【/v1/upkeep/task/delete#DELETE】
  1691. * @apiVersion 1.0.0
  1692. * @apiQuery { Long[] { 1-2147483647 } } ids 保养任务id数组
  1693. * @apiSuccess { Boolean } data 数据
  1694. * @apiSuccess { String } message 信息
  1695. * @apiSuccess { Integer } code 状态码
  1696. * @apiSuccessExample Response
  1697. *
  1698. * {"data":true, "message":"", "code":1}
  1699. */
  1700. /**
  1701. * @api {delete} /v1/upkeep/task/delete/:id 07.删除保养任务
  1702. * @apiName 删除保养任务
  1703. * @apiGroup 保养计划-保养任务
  1704. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1705. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1706. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1707. * @apiPermission 【/v1/upkeep/task/delete/{id}#DELETE】
  1708. * @apiVersion 1.0.0
  1709. * @apiParam { Long } id 保养任务id
  1710. * @apiSuccess { Boolean } data 数据
  1711. * @apiSuccess { String } message 信息
  1712. * @apiSuccess { Integer } code 状态码
  1713. * @apiSuccessExample Response
  1714. *
  1715. * {"data":true, "message":"", "code":1}
  1716. */
  1717. /**
  1718. * @api {post} /v1/upkeep/plan/add 01.添加保养计划
  1719. * @apiName 添加保养计划
  1720. * @apiGroup 保养计划-保养计划查询
  1721. * @apiHeader {String = application/json} Content-Type = application/json
  1722. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1723. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1724. * @apiPermission 【/v1/upkeep/plan/add#POST】
  1725. * @apiVersion 1.0.0
  1726. * @apiBody { Long } routeId 检查路线id
  1727. * @apiBody { String } name 名称
  1728. * @apiBody { Integer } type 类型 1日计划、2周计划、3月计划
  1729. * @apiBody { Integer } runModel 执行模式 1其中一人、2每人分别
  1730. * @apiBody { Date } beginDate 计划执行开始日期
  1731. * @apiBody { Date } [ endDate ] 计划执行结束日期,空代表永不结束
  1732. * @apiBody { Date } beginTime 任务执行开始时间
  1733. * @apiBody { Date } endTime 任务执行结束时间
  1734. * @apiBody { String } [ weeks ] 周计划 [1-7]
  1735. * @apiBody { String } [ months ] 月计划 [1-31]
  1736. * @apiBody { String } [ remark ] 备注
  1737. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1738. * @apiSuccess { Object } data 数据
  1739. * @apiSuccess { Long } data.id id 主键
  1740. * @apiSuccess { Long } data.routeId 巡检路线id
  1741. * @apiSuccess { Long } data.userId 创建人id
  1742. * @apiSuccess { String } data.number 编号
  1743. * @apiSuccess { String } data.name 名称
  1744. * @apiSuccess { Boolean } data.disabled 是否禁用
  1745. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1746. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1747. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  1748. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  1749. * @apiSuccess { Object } data.beginTime 任务执行开始时间
  1750. * @apiSuccess { Byte } data.beginTime.hour
  1751. * @apiSuccess { Byte } data.beginTime.minute
  1752. * @apiSuccess { Byte } data.beginTime.second
  1753. * @apiSuccess { Integer } data.beginTime.nano
  1754. * @apiSuccess { Object } data.endTime 任务执行结束时间
  1755. * @apiSuccess { Byte } data.endTime.hour
  1756. * @apiSuccess { Byte } data.endTime.minute
  1757. * @apiSuccess { Byte } data.endTime.second
  1758. * @apiSuccess { Integer } data.endTime.nano
  1759. * @apiSuccess { String } data.weeks 周计划 [1-7]
  1760. * @apiSuccess { String } data.months 月计划 [1-31]
  1761. * @apiSuccess { String } data.remark 备注
  1762. * @apiSuccess { String } message 信息
  1763. * @apiSuccess { Integer } code 状态码
  1764. * @apiSuccessExample Response
  1765. *
  1766. * {"data":{"id":1, "routeId":1, "userId":1, "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1650761871427, "endDate":1650761871427, "beginTime":{"hour":1, "minute":1, "second":1, "nano":1}, "endTime":{"hour":1, "minute":1, "second":1, "nano":1}, "weeks":"", "months":"", "remark":""}, "message":"", "code":1}
  1767. */
  1768. /**
  1769. * @api {put} /v1/upkeep/plan/update 02.更新保养计划
  1770. * @apiName 更新保养计划
  1771. * @apiGroup 保养计划-保养计划查询
  1772. * @apiHeader {String = application/json} Content-Type = application/json
  1773. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1774. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1775. * @apiPermission 【/v1/upkeep/plan/update#PUT】
  1776. * @apiVersion 1.0.0
  1777. * @apiBody { Long } id id 主键
  1778. * @apiBody { Long } routeId 检查路线id
  1779. * @apiBody { String } name 名称
  1780. * @apiBody { Integer } type 类型 1日计划、2周计划、3月计划
  1781. * @apiBody { Integer } runModel 执行模式 1其中一人、2每人分别
  1782. * @apiBody { Date } beginDate 计划执行开始日期
  1783. * @apiBody { Date } [ endDate ] 计划执行结束日期,空代表永不结束
  1784. * @apiBody { Date } beginTime 任务执行开始时间
  1785. * @apiBody { Date } endTime 任务执行结束时间
  1786. * @apiBody { String } [ weeks ] 周计划 [1-7]
  1787. * @apiBody { String } [ months ] 月计划 [1-31]
  1788. * @apiBody { String } [ remark ] 备注
  1789. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1790. * @apiSuccess { Object } data 数据
  1791. * @apiSuccess { Long } data.id id 主键
  1792. * @apiSuccess { Long } data.routeId 巡检路线id
  1793. * @apiSuccess { Long } data.userId 创建人id
  1794. * @apiSuccess { String } data.number 编号
  1795. * @apiSuccess { String } data.name 名称
  1796. * @apiSuccess { Boolean } data.disabled 是否禁用
  1797. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1798. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1799. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  1800. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  1801. * @apiSuccess { Object } data.beginTime 任务执行开始时间
  1802. * @apiSuccess { Byte } data.beginTime.hour
  1803. * @apiSuccess { Byte } data.beginTime.minute
  1804. * @apiSuccess { Byte } data.beginTime.second
  1805. * @apiSuccess { Integer } data.beginTime.nano
  1806. * @apiSuccess { Object } data.endTime 任务执行结束时间
  1807. * @apiSuccess { Byte } data.endTime.hour
  1808. * @apiSuccess { Byte } data.endTime.minute
  1809. * @apiSuccess { Byte } data.endTime.second
  1810. * @apiSuccess { Integer } data.endTime.nano
  1811. * @apiSuccess { String } data.weeks 周计划 [1-7]
  1812. * @apiSuccess { String } data.months 月计划 [1-31]
  1813. * @apiSuccess { String } data.remark 备注
  1814. * @apiSuccess { String } message 信息
  1815. * @apiSuccess { Integer } code 状态码
  1816. * @apiSuccessExample Response
  1817. *
  1818. * {"data":{"id":1, "routeId":1, "userId":1, "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1650761871427, "endDate":1650761871427, "beginTime":{"hour":1, "minute":1, "second":1, "nano":1}, "endTime":{"hour":1, "minute":1, "second":1, "nano":1}, "weeks":"", "months":"", "remark":""}, "message":"", "code":1}
  1819. */
  1820. /**
  1821. * @api {put} /v1/upkeep/plan/update/status 03.更新保养计划禁用状态
  1822. * @apiName 更新保养计划禁用状态
  1823. * @apiGroup 保养计划-保养计划查询
  1824. * @apiHeader {String = application/json} Content-Type = application/json
  1825. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1826. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1827. * @apiPermission 【/v1/upkeep/plan/update/status#PUT】
  1828. * @apiVersion 1.0.0
  1829. * @apiBody { Long } id 数据ID
  1830. * @apiBody { Boolean } disabled 是否禁用
  1831. * @apiSuccess { Boolean } data 数据
  1832. * @apiSuccess { String } message 信息
  1833. * @apiSuccess { Integer } code 状态码
  1834. * @apiSuccessExample Response
  1835. *
  1836. * {"data":true, "message":"", "code":1}
  1837. */
  1838. /**
  1839. * @api {get} /v1/upkeep/plan/query/:id 04.查询保养计划
  1840. * @apiName 查询保养计划
  1841. * @apiGroup 保养计划-保养计划查询
  1842. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1843. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1844. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1845. * @apiPermission 【/v1/upkeep/plan/query/{id}#GET】
  1846. * @apiVersion 1.0.0
  1847. * @apiParam { Long } id 保养计划id
  1848. * @apiSuccess { Object } data 数据
  1849. * @apiSuccess { Long } data.id id 主键
  1850. * @apiSuccess { String } data.name 名称
  1851. * @apiSuccess { Integer } data.type 类型 1日计划、2周计划、3月计划
  1852. * @apiSuccess { Integer } data.runModel 执行模式 1其中一人、2每人分别
  1853. * @apiSuccess { Date } data.beginDate 计划执行开始日期
  1854. * @apiSuccess { Date } data.endDate 计划执行结束日期,空代表永不结束
  1855. * @apiSuccess { Date } data.beginTime 任务执行开始时间
  1856. * @apiSuccess { Date } data.endTime 任务执行结束时间
  1857. * @apiSuccess { String } data.weeks 周计划 [1-7]
  1858. * @apiSuccess { String } data.months 月计划 [1-31]
  1859. * @apiSuccess { String } data.remark 备注
  1860. * @apiSuccess { Object } data.route 检查路线
  1861. * @apiSuccess { Long } data.route.id 选项key
  1862. * @apiSuccess { String } data.route.name 选项值
  1863. * @apiSuccess { Object[] } data.executors 执行人列表
  1864. * @apiSuccess { Long } data.executors.id 选项key
  1865. * @apiSuccess { String } data.executors.name 选项值
  1866. * @apiSuccess { String } message 信息
  1867. * @apiSuccess { Integer } code 状态码
  1868. * @apiSuccessExample Response
  1869. *
  1870. * {"data":{"id":1, "name":"", "type":1, "runModel":1, "beginDate":1650761871427, "endDate":1650761871427, "beginTime":1650761871427, "endTime":1650761871427, "weeks":"", "months":"", "remark":"", "route":{"id":1, "name":""}, "executors":[{"id":1, "name":""}]}, "message":"", "code":1}
  1871. */
  1872. /**
  1873. * @api {get} /v1/upkeep/plan/list 05.分页查询保养计划
  1874. * @apiName 分页查询保养计划
  1875. * @apiGroup 保养计划-保养计划查询
  1876. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1877. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1878. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1879. * @apiPermission 【/v1/upkeep/plan/list#GET】
  1880. * @apiVersion 1.0.0
  1881. * @apiQuery { String } [ name ] 计划名称
  1882. * @apiQuery { Boolean } [ disabled ] 是否禁用
  1883. * @apiQuery { Integer } [ type ] 类型 1日计划、2周计划、3月计划
  1884. * @apiQuery { Integer } [ runModel ] 执行模式 1其中一人、2每人分别
  1885. * @apiQuery { String } [ username ] 创建人
  1886. * @apiQuery { String } [ executor ] 执行人
  1887. * @apiQuery { Integer } [ page = 1 ] 页码
  1888. * @apiQuery { Integer } [ size = 10 ] 页大小
  1889. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  1890. * @apiSuccess { Object } data 数据
  1891. * @apiSuccess { Long } data.total 数据总数
  1892. * @apiSuccess { Object[] } data.list 数据列表
  1893. * @apiSuccess { Long } data.list.id id 主键
  1894. * @apiSuccess { String } data.list.routeName 检查路线
  1895. * @apiSuccess { String } data.list.username 创建人
  1896. * @apiSuccess { String } data.list.number 编号
  1897. * @apiSuccess { String } data.list.name 名称
  1898. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  1899. * @apiSuccess { Integer } data.list.type 类型 1日计划、2周计划、3月计划
  1900. * @apiSuccess { Integer } data.list.runModel 执行模式 1其中一人、2每人分别
  1901. * @apiSuccess { Date } data.list.beginDate 计划执行开始日期
  1902. * @apiSuccess { Date } data.list.endDate 计划执行结束日期,空代表永不结束
  1903. * @apiSuccess { Date } data.list.beginTime 任务执行开始时间
  1904. * @apiSuccess { Date } data.list.endTime 任务执行结束时间
  1905. * @apiSuccess { String } data.list.weeks 周计划 [1-7]
  1906. * @apiSuccess { String } data.list.months 月计划 [1-31]
  1907. * @apiSuccess { String } data.list.remark 备注
  1908. * @apiSuccess { String[] } data.list.executors 执行人列表
  1909. * @apiSuccess { String } message 信息
  1910. * @apiSuccess { Integer } code 状态码
  1911. * @apiSuccessExample Response
  1912. *
  1913. * {"data":{"total":1, "list":[{"id":1, "routeName":"", "username":"", "number":"", "name":"", "disabled":true, "type":1, "runModel":1, "beginDate":1650761871427, "endDate":1650761871427, "beginTime":1650761871427, "endTime":1650761871427, "weeks":"", "months":"", "remark":"", "executors":[""]}]}, "message":"", "code":1}
  1914. */
  1915. /**
  1916. * @api {delete} /v1/upkeep/plan/delete 06.删除多条保养计划
  1917. * @apiName 删除多条保养计划
  1918. * @apiGroup 保养计划-保养计划查询
  1919. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1920. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1921. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1922. * @apiPermission 【/v1/upkeep/plan/delete#DELETE】
  1923. * @apiVersion 1.0.0
  1924. * @apiQuery { Long[] { 1-2147483647 } } ids 保养计划id数组
  1925. * @apiSuccess { Boolean } data 数据
  1926. * @apiSuccess { String } message 信息
  1927. * @apiSuccess { Integer } code 状态码
  1928. * @apiSuccessExample Response
  1929. *
  1930. * {"data":true, "message":"", "code":1}
  1931. */
  1932. /**
  1933. * @api {delete} /v1/upkeep/plan/delete/:id 07.删除保养计划
  1934. * @apiName 删除保养计划
  1935. * @apiGroup 保养计划-保养计划查询
  1936. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  1937. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1938. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1939. * @apiPermission 【/v1/upkeep/plan/delete/{id}#DELETE】
  1940. * @apiVersion 1.0.0
  1941. * @apiParam { Long } id 保养计划id
  1942. * @apiSuccess { Boolean } data 数据
  1943. * @apiSuccess { String } message 信息
  1944. * @apiSuccess { Integer } code 状态码
  1945. * @apiSuccessExample Response
  1946. *
  1947. * {"data":true, "message":"", "code":1}
  1948. */
  1949. /**
  1950. * @api {post} /v1/temporary/task/add 01.添加临时任务
  1951. * @apiName 添加临时任务
  1952. * @apiGroup 临时任务-全部临时任务
  1953. * @apiHeader {String = application/json} Content-Type = application/json
  1954. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1955. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1956. * @apiPermission 【/v1/temporary/task/add#POST】
  1957. * @apiVersion 1.0.0
  1958. * @apiBody { String { 0..255 } } title 任务标题
  1959. * @apiBody { Integer } type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  1960. * @apiBody { String { 0..255 } } content 任务内容
  1961. * @apiBody { Long[] { 1-2147483647 } } executors 执行人列表
  1962. * @apiBody { Date } finishTime 完成时间
  1963. * @apiBody { String } [ images ] 任务图片
  1964. * @apiSuccess { Object } data 数据
  1965. * @apiSuccess { Long } data.id 任务id
  1966. * @apiSuccess { String } data.title 任务标题
  1967. * @apiSuccess { Integer } data.type 任务类型 1:般任务 2:较急任务 3:紧急任务
  1968. * @apiSuccess { String } data.content 任务内容
  1969. * @apiSuccess { Long } data.userId 任务创建用户id
  1970. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  1971. * @apiSuccess { Integer } data.feedbackTotal 任务反馈数量
  1972. * @apiSuccess { Date } data.publishTime 任务发布时间
  1973. * @apiSuccess { Date } data.finishTime 任务完成时间
  1974. * @apiSuccess { String } data.images 任务图片
  1975. * @apiSuccess { String } message 信息
  1976. * @apiSuccess { Integer } code 状态码
  1977. * @apiSuccessExample Response
  1978. *
  1979. * {"data":{"id":1, "title":"", "type":1, "content":"", "userId":1, "status":1, "feedbackTotal":1, "publishTime":1650761871428, "finishTime":1650761871428, "images":""}, "message":"", "code":1}
  1980. */
  1981. /**
  1982. * @api {put} /v1/temporary/task/update 02.更新临时任务
  1983. * @apiName 更新临时任务
  1984. * @apiGroup 临时任务-全部临时任务
  1985. * @apiHeader {String = application/json} Content-Type = application/json
  1986. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  1987. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  1988. * @apiPermission 【/v1/temporary/task/update#PUT】
  1989. * @apiVersion 1.0.0
  1990. * @apiBody { Long } id id 主键
  1991. * @apiBody { Integer } status 任务状态 2:完成 3:取消
  1992. * @apiSuccess { Object } data 数据
  1993. * @apiSuccess { Long } data.id 任务id
  1994. * @apiSuccess { String } data.title 任务标题
  1995. * @apiSuccess { Integer } data.type 任务类型 1:般任务 2:较急任务 3:紧急任务
  1996. * @apiSuccess { String } data.content 任务内容
  1997. * @apiSuccess { Long } data.userId 任务创建用户id
  1998. * @apiSuccess { Integer } data.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  1999. * @apiSuccess { Integer } data.feedbackTotal 任务反馈数量
  2000. * @apiSuccess { Date } data.publishTime 任务发布时间
  2001. * @apiSuccess { Date } data.finishTime 任务完成时间
  2002. * @apiSuccess { String } data.images 任务图片
  2003. * @apiSuccess { String } message 信息
  2004. * @apiSuccess { Integer } code 状态码
  2005. * @apiSuccessExample Response
  2006. *
  2007. * {"data":{"id":1, "title":"", "type":1, "content":"", "userId":1, "status":1, "feedbackTotal":1, "publishTime":1650761871428, "finishTime":1650761871428, "images":""}, "message":"", "code":1}
  2008. */
  2009. /**
  2010. * @api {get} /v1/temporary/task/list 03.分页查询临时任务
  2011. * @apiName 分页查询临时任务
  2012. * @apiGroup 临时任务-全部临时任务
  2013. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2014. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2015. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2016. * @apiPermission 【/v1/temporary/task/list#GET】
  2017. * @apiVersion 1.0.0
  2018. * @apiQuery { String } [ title ] 任务标题
  2019. * @apiQuery { Integer } [ type ] 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  2020. * @apiQuery { Integer } [ status ] 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  2021. * @apiQuery { String } [ content ] 任务内容
  2022. * @apiQuery { String } [ username ] 发起人名称
  2023. * @apiQuery { String } [ executor ] 执行人名称
  2024. * @apiQuery { Date } [ startTime ] 开始日期
  2025. * @apiQuery { Date } [ endTime ] 结束日期
  2026. * @apiQuery { Integer } [ page = 1 ] 页码
  2027. * @apiQuery { Integer } [ size = 10 ] 页大小
  2028. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2029. * @apiSuccess { Object } data 数据
  2030. * @apiSuccess { Long } data.total 数据总数
  2031. * @apiSuccess { Object[] } data.list 数据列表
  2032. * @apiSuccess { Long } data.list.id 任务id
  2033. * @apiSuccess { String } data.list.title 任务标题
  2034. * @apiSuccess { Integer } data.list.type 任务类型 1:一般任务 2: 较急任务 3:紧急任务
  2035. * @apiSuccess { String } data.list.username 发起人姓名
  2036. * @apiSuccess { Integer } data.list.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  2037. * @apiSuccess { String } data.list.content 任务内容
  2038. * @apiSuccess { Integer } data.list.feedbackTotal 执行反馈次数
  2039. * @apiSuccess { Date } data.list.publishTime 发布时间
  2040. * @apiSuccess { Date } data.list.finishTime 完成时间
  2041. * @apiSuccess { String } data.list.images 任务图片
  2042. * @apiSuccess { String[] } data.list.executors 执行人
  2043. * @apiSuccess { String } message 信息
  2044. * @apiSuccess { Integer } code 状态码
  2045. * @apiSuccessExample Response
  2046. *
  2047. * {"data":{"total":1, "list":[{"id":1, "title":"", "type":1, "username":"", "status":1, "content":"", "feedbackTotal":1, "publishTime":1650761871428, "finishTime":1650761871428, "images":"", "executors":[""]}]}, "message":"", "code":1}
  2048. */
  2049. /**
  2050. * @api {get} /v1/temporary/task/list/statistical 04.临时任务统计
  2051. * @apiName 临时任务统计
  2052. * @apiGroup 临时任务-全部临时任务
  2053. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2054. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2055. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2056. * @apiPermission 【/v1/temporary/task/list/statistical#GET】
  2057. * @apiVersion 1.0.0
  2058. * @apiQuery { Integer } type 统计口径 1:执行人 2:任务类型 3:任务日期 4:任务月份
  2059. * @apiQuery { Date } [ startTime ] 开始日期
  2060. * @apiQuery { Date } [ endTime ] 结束日期
  2061. * @apiQuery { Integer } [ page = 1 ] 页码
  2062. * @apiQuery { Integer } [ size = 10 ] 页大小
  2063. * @apiQuery { String { ^[-+][\w]+ } } [ order = +name ] 排序规则(默认name正序),排序字段前加:+表示正序 -表示倒序
  2064. * @apiSuccess { Object } data 数据
  2065. * @apiSuccess { Long } data.total 数据总数
  2066. * @apiSuccess { Object[] } data.list 数据列表
  2067. * @apiSuccess { String } data.list.name 项目名称
  2068. * @apiSuccess { Object[] } data.list.statusList 状态列表
  2069. * @apiSuccess { Integer } data.list.statusList.status 任务状态 1:正在处理 2:已经完成 3:已经取消 4:超时任务
  2070. * @apiSuccess { Integer } data.list.statusList.count 任务总数
  2071. * @apiSuccess { String } message 信息
  2072. * @apiSuccess { Integer } code 状态码
  2073. * @apiSuccessExample Response
  2074. *
  2075. * {"data":{"total":1, "list":[{"name":"", "statusList":[{"status":1, "count":1}]}]}, "message":"", "code":1}
  2076. */
  2077. /**
  2078. * @api {delete} /v1/temporary/task/delete 05.删除多条临时任务
  2079. * @apiName 删除多条临时任务
  2080. * @apiGroup 临时任务-全部临时任务
  2081. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2082. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2083. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2084. * @apiPermission 【/v1/temporary/task/delete#DELETE】
  2085. * @apiVersion 1.0.0
  2086. * @apiQuery { Long[] { 1-2147483647 } } ids 临时任务id数组
  2087. * @apiSuccess { Boolean } data 数据
  2088. * @apiSuccess { String } message 信息
  2089. * @apiSuccess { Integer } code 状态码
  2090. * @apiSuccessExample Response
  2091. *
  2092. * {"data":true, "message":"", "code":1}
  2093. */
  2094. /**
  2095. * @api {delete} /v1/temporary/task/delete/:id 06.删除临时任务
  2096. * @apiName 删除临时任务
  2097. * @apiGroup 临时任务-全部临时任务
  2098. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2099. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2100. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2101. * @apiPermission 【/v1/temporary/task/delete/{id}#DELETE】
  2102. * @apiVersion 1.0.0
  2103. * @apiParam { Long } id 临时任务id
  2104. * @apiSuccess { Boolean } data 数据
  2105. * @apiSuccess { String } message 信息
  2106. * @apiSuccess { Integer } code 状态码
  2107. * @apiSuccessExample Response
  2108. *
  2109. * {"data":true, "message":"", "code":1}
  2110. */
  2111. /**
  2112. * @api {get} /v1/temporary/task/feedback/list 01.分页查询临时任务反馈
  2113. * @apiName 分页查询临时任务反馈
  2114. * @apiGroup 临时任务-临时任务反馈
  2115. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2116. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2117. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2118. * @apiPermission 【/v1/temporary/task/feedback/list#GET】
  2119. * @apiVersion 1.0.0
  2120. * @apiQuery { Long } taskId 任务id
  2121. * @apiQuery { Integer } [ page = 1 ] 页码
  2122. * @apiQuery { Integer } [ size = 10 ] 页大小
  2123. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2124. * @apiSuccess { Object } data 数据
  2125. * @apiSuccess { Long } data.total 数据总数
  2126. * @apiSuccess { Object[] } data.list 数据列表
  2127. * @apiSuccess { Long } data.list.id id 主键
  2128. * @apiSuccess { String } data.list.username 反馈人
  2129. * @apiSuccess { String } data.list.content 反馈内容
  2130. * @apiSuccess { Date } data.list.createTime 反馈时间
  2131. * @apiSuccess { String } data.list.images 图片地址
  2132. * @apiSuccess { String } message 信息
  2133. * @apiSuccess { Integer } code 状态码
  2134. * @apiSuccessExample Response
  2135. *
  2136. * {"data":{"total":1, "list":[{"id":1, "username":"", "content":"", "createTime":1650761871429, "images":""}]}, "message":"", "code":1}
  2137. */
  2138. /**
  2139. * @api {post} /v1/device/building/add 01.添加楼栋
  2140. * @apiName 添加楼栋
  2141. * @apiGroup 资产管理-楼栋管理
  2142. * @apiHeader {String = application/json} Content-Type = application/json
  2143. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2144. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2145. * @apiPermission 【/v1/device/building/add#POST】
  2146. * @apiVersion 1.0.0
  2147. * @apiBody { String } name 楼栋名称
  2148. * @apiSuccess { Object } data 数据
  2149. * @apiSuccess { Long } data.id 楼栋id
  2150. * @apiSuccess { String } data.name 楼栋名称
  2151. * @apiSuccess { Date } data.createTime 创建时间
  2152. * @apiSuccess { Date } data.updateTime 最后更新时间
  2153. * @apiSuccess { Long } data.updateUserId 最后更新用户id
  2154. * @apiSuccess { String } data.updateUsername 最后更新用户名
  2155. * @apiSuccess { String } message 信息
  2156. * @apiSuccess { Integer } code 状态码
  2157. * @apiSuccessExample Response
  2158. *
  2159. * {"data":{"id":1, "name":"", "createTime":1650761871429, "updateTime":1650761871429, "updateUserId":1, "updateUsername":""}, "message":"", "code":1}
  2160. */
  2161. /**
  2162. * @api {delete} /v1/device/building/delete 02.删除多条楼栋
  2163. * @apiName 删除多条楼栋
  2164. * @apiGroup 资产管理-楼栋管理
  2165. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2166. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2167. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2168. * @apiPermission 【/v1/device/building/delete#DELETE】
  2169. * @apiVersion 1.0.0
  2170. * @apiQuery { Long[] { 1-2147483647 } } ids 楼栋id数组
  2171. * @apiSuccess { Boolean } data 数据
  2172. * @apiSuccess { String } message 信息
  2173. * @apiSuccess { Integer } code 状态码
  2174. * @apiSuccessExample Response
  2175. *
  2176. * {"data":true, "message":"", "code":1}
  2177. */
  2178. /**
  2179. * @api {delete} /v1/device/building/delete/:id 03.删除楼栋
  2180. * @apiName 删除楼栋
  2181. * @apiGroup 资产管理-楼栋管理
  2182. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2183. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2184. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2185. * @apiPermission 【/v1/device/building/delete/{id}#DELETE】
  2186. * @apiVersion 1.0.0
  2187. * @apiParam { Long } id 楼栋id
  2188. * @apiSuccess { Boolean } data 数据
  2189. * @apiSuccess { String } message 信息
  2190. * @apiSuccess { Integer } code 状态码
  2191. * @apiSuccessExample Response
  2192. *
  2193. * {"data":true, "message":"", "code":1}
  2194. */
  2195. /**
  2196. * @api {put} /v1/device/building/update 04.更新楼栋
  2197. * @apiName 更新楼栋
  2198. * @apiGroup 资产管理-楼栋管理
  2199. * @apiHeader {String = application/json} Content-Type = application/json
  2200. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2201. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2202. * @apiPermission 【/v1/device/building/update#PUT】
  2203. * @apiVersion 1.0.0
  2204. * @apiBody { Long } id 楼栋ID
  2205. * @apiBody { String } name 楼栋名称
  2206. * @apiSuccess { Boolean } data 数据
  2207. * @apiSuccess { String } message 信息
  2208. * @apiSuccess { Integer } code 状态码
  2209. * @apiSuccessExample Response
  2210. *
  2211. * {"data":true, "message":"", "code":1}
  2212. */
  2213. /**
  2214. * @api {get} /v1/device/building/list 05.分页查询楼栋
  2215. * @apiName 分页查询楼栋
  2216. * @apiGroup 资产管理-楼栋管理
  2217. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2218. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2219. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2220. * @apiPermission 【/v1/device/building/list#GET】
  2221. * @apiVersion 1.0.0
  2222. * @apiQuery { String } [ name ] 楼栋名称
  2223. * @apiQuery { Integer } [ page = 1 ] 页码
  2224. * @apiQuery { Integer } [ size = 10 ] 页大小
  2225. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2226. * @apiSuccess { Object } data 数据
  2227. * @apiSuccess { Long } data.total 数据总数
  2228. * @apiSuccess { Object[] } data.list 数据列表
  2229. * @apiSuccess { Long } data.list.id 楼栋id
  2230. * @apiSuccess { String } data.list.name 楼栋名称
  2231. * @apiSuccess { Integer } data.list.floorTotal 总层高
  2232. * @apiSuccess { Integer } data.list.roomTotal 总房间数
  2233. * @apiSuccess { Date } data.list.updateTime 最后更新时间
  2234. * @apiSuccess { String } data.list.updateUsername 最后更新用户名
  2235. * @apiSuccess { String } message 信息
  2236. * @apiSuccess { Integer } code 状态码
  2237. * @apiSuccessExample Response
  2238. *
  2239. * {"data":{"total":1, "list":[{"id":1, "name":"", "floorTotal":1, "roomTotal":1, "updateTime":1650761871429, "updateUsername":""}]}, "message":"", "code":1}
  2240. */
  2241. /**
  2242. * @api {get} /v1/device/building/list/option 06.获取所有楼栋选项列表
  2243. * @apiName 获取所有楼栋选项列表
  2244. * @apiGroup 资产管理-楼栋管理
  2245. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2246. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2247. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2248. * @apiVersion 1.0.0
  2249. * @apiSuccess { Object[] } data 数据
  2250. * @apiSuccess { Long } data.id 选项key
  2251. * @apiSuccess { String } data.name 选项值
  2252. * @apiSuccess { String } message 信息
  2253. * @apiSuccess { Integer } code 状态码
  2254. * @apiSuccessExample Response
  2255. *
  2256. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  2257. */
  2258. /**
  2259. * @api {post} /v1/device/floor/add 01.添加楼层
  2260. * @apiName 添加楼层
  2261. * @apiGroup 资产管理-楼层管理
  2262. * @apiHeader {String = application/json} Content-Type = application/json
  2263. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2264. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2265. * @apiPermission 【/v1/device/floor/add#POST】
  2266. * @apiVersion 1.0.0
  2267. * @apiBody { String } name 楼层名称
  2268. * @apiBody { Long } buildingId 楼栋id
  2269. * @apiSuccess { Object } data 数据
  2270. * @apiSuccess { Long } data.id 楼层id
  2271. * @apiSuccess { String } data.name 楼层名称
  2272. * @apiSuccess { Long } data.buildingId 楼栋id
  2273. * @apiSuccess { Date } data.createTime 楼层创建时间
  2274. * @apiSuccess { Date } data.updateTime 楼层更新时间
  2275. * @apiSuccess { Long } data.updateUserId 最后更新用户id
  2276. * @apiSuccess { String } data.updateUsername 最后更新用户名
  2277. * @apiSuccess { String } message 信息
  2278. * @apiSuccess { Integer } code 状态码
  2279. * @apiSuccessExample Response
  2280. *
  2281. * {"data":{"id":1, "name":"", "buildingId":1, "createTime":1650761871430, "updateTime":1650761871430, "updateUserId":1, "updateUsername":""}, "message":"", "code":1}
  2282. */
  2283. /**
  2284. * @api {delete} /v1/device/floor/delete 02.删除多条楼层
  2285. * @apiName 删除多条楼层
  2286. * @apiGroup 资产管理-楼层管理
  2287. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2288. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2289. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2290. * @apiPermission 【/v1/device/floor/delete#DELETE】
  2291. * @apiVersion 1.0.0
  2292. * @apiQuery { Long[] { 1-2147483647 } } ids 楼层id数组
  2293. * @apiSuccess { Boolean } data 数据
  2294. * @apiSuccess { String } message 信息
  2295. * @apiSuccess { Integer } code 状态码
  2296. * @apiSuccessExample Response
  2297. *
  2298. * {"data":true, "message":"", "code":1}
  2299. */
  2300. /**
  2301. * @api {delete} /v1/device/floor/delete/:id 03.删除楼层
  2302. * @apiName 删除楼层
  2303. * @apiGroup 资产管理-楼层管理
  2304. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2305. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2306. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2307. * @apiPermission 【/v1/device/floor/delete/{id}#DELETE】
  2308. * @apiVersion 1.0.0
  2309. * @apiParam { Long } id 楼层id
  2310. * @apiSuccess { Boolean } data 数据
  2311. * @apiSuccess { String } message 信息
  2312. * @apiSuccess { Integer } code 状态码
  2313. * @apiSuccessExample Response
  2314. *
  2315. * {"data":true, "message":"", "code":1}
  2316. */
  2317. /**
  2318. * @api {put} /v1/device/floor/update 04.更新楼层
  2319. * @apiName 更新楼层
  2320. * @apiGroup 资产管理-楼层管理
  2321. * @apiHeader {String = application/json} Content-Type = application/json
  2322. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2323. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2324. * @apiPermission 【/v1/device/floor/update#PUT】
  2325. * @apiVersion 1.0.0
  2326. * @apiBody { Long } id 楼层id
  2327. * @apiBody { String } name 楼层名称
  2328. * @apiBody { Long } buildingId 楼栋id
  2329. * @apiSuccess { Object } data 数据
  2330. * @apiSuccess { Long } data.id 楼层id
  2331. * @apiSuccess { String } data.name 楼层名称
  2332. * @apiSuccess { Long } data.buildingId 楼栋id
  2333. * @apiSuccess { Date } data.createTime 楼层创建时间
  2334. * @apiSuccess { Date } data.updateTime 楼层更新时间
  2335. * @apiSuccess { Long } data.updateUserId 最后更新用户id
  2336. * @apiSuccess { String } data.updateUsername 最后更新用户名
  2337. * @apiSuccess { String } message 信息
  2338. * @apiSuccess { Integer } code 状态码
  2339. * @apiSuccessExample Response
  2340. *
  2341. * {"data":{"id":1, "name":"", "buildingId":1, "createTime":1650761871430, "updateTime":1650761871430, "updateUserId":1, "updateUsername":""}, "message":"", "code":1}
  2342. */
  2343. /**
  2344. * @api {get} /v1/device/floor/list 05.分页查询楼层
  2345. * @apiName 分页查询楼层
  2346. * @apiGroup 资产管理-楼层管理
  2347. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2348. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2349. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2350. * @apiPermission 【/v1/device/floor/list#GET】
  2351. * @apiVersion 1.0.0
  2352. * @apiQuery { Long } [ buildingId ] 楼栋id
  2353. * @apiQuery { String } [ buildingName ] 楼栋名称
  2354. * @apiQuery { String } [ name ] 楼层名称
  2355. * @apiQuery { Integer } [ page = 1 ] 页码
  2356. * @apiQuery { Integer } [ size = 10 ] 页大小
  2357. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2358. * @apiSuccess { Object } data 数据
  2359. * @apiSuccess { Long } data.total 数据总数
  2360. * @apiSuccess { Object[] } data.list 数据列表
  2361. * @apiSuccess { Long } data.list.id 楼层id
  2362. * @apiSuccess { String } data.list.name 楼层名称
  2363. * @apiSuccess { String } data.list.buildingId 所属楼栋
  2364. * @apiSuccess { String } data.list.buildingName 所属楼栋
  2365. * @apiSuccess { Integer } data.list.roomTotal 总房间数
  2366. * @apiSuccess { Date } data.list.updateTime 楼层更新时间
  2367. * @apiSuccess { String } data.list.updateUsername 最后更新用户名
  2368. * @apiSuccess { String } message 信息
  2369. * @apiSuccess { Integer } code 状态码
  2370. * @apiSuccessExample Response
  2371. *
  2372. * {"data":{"total":1, "list":[{"id":1, "name":"", "buildingId":"", "buildingName":"", "roomTotal":1, "updateTime":1650761871430, "updateUsername":""}]}, "message":"", "code":1}
  2373. */
  2374. /**
  2375. * @api {get} /v1/device/floor/list/option/:buildingId 06.获取楼栋中的所有楼层选项
  2376. * @apiName 获取楼栋中的所有楼层选项
  2377. * @apiGroup 资产管理-楼层管理
  2378. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2379. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2380. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2381. * @apiVersion 1.0.0
  2382. * @apiParam { Long } buildingId 楼栋id
  2383. * @apiSuccess { Object[] } data 数据
  2384. * @apiSuccess { Long } data.id 选项key
  2385. * @apiSuccess { String } data.name 选项值
  2386. * @apiSuccess { String } message 信息
  2387. * @apiSuccess { Integer } code 状态码
  2388. * @apiSuccessExample Response
  2389. *
  2390. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  2391. */
  2392. /**
  2393. * @api {post} /v1/device/room/add 01.添加房间
  2394. * @apiName 添加房间
  2395. * @apiGroup 资产管理-房间管理
  2396. * @apiHeader {String = application/json} Content-Type = application/json
  2397. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2398. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2399. * @apiPermission 【/v1/device/room/add#POST】
  2400. * @apiVersion 1.0.0
  2401. * @apiBody { String } name 房间名称
  2402. * @apiBody { String } number 房间编号
  2403. * @apiBody { Long } floorId 房间位置(楼层id)
  2404. * @apiBody { Long[] } [ checkItems = [] ] 检查项
  2405. * @apiSuccess { Object } data 数据
  2406. * @apiSuccess { Long } data.id 房间id
  2407. * @apiSuccess { String } data.name 房间名称
  2408. * @apiSuccess { Long } data.floorId 楼层id
  2409. * @apiSuccess { String } data.number 房间编号
  2410. * @apiSuccess { Date } data.createTime 房间创建时间
  2411. * @apiSuccess { Date } data.updateTime 房间最后更新时间
  2412. * @apiSuccess { Long } data.updateUserId 房间最后更新用户id
  2413. * @apiSuccess { String } data.updateUsername 房间最后更新用户名
  2414. * @apiSuccess { String } message 信息
  2415. * @apiSuccess { Integer } code 状态码
  2416. * @apiSuccessExample Response
  2417. *
  2418. * {"data":{"id":1, "name":"", "floorId":1, "number":"", "createTime":1650761871430, "updateTime":1650761871430, "updateUserId":1, "updateUsername":""}, "message":"", "code":1}
  2419. */
  2420. /**
  2421. * @api {delete} /v1/device/room/delete/:id 02.删除房间
  2422. * @apiName 删除房间
  2423. * @apiGroup 资产管理-房间管理
  2424. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2425. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2426. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2427. * @apiPermission 【/v1/device/room/delete/{id}#DELETE】
  2428. * @apiVersion 1.0.0
  2429. * @apiParam { Long } id 房间id
  2430. * @apiSuccess { Boolean } data 数据
  2431. * @apiSuccess { String } message 信息
  2432. * @apiSuccess { Integer } code 状态码
  2433. * @apiSuccessExample Response
  2434. *
  2435. * {"data":true, "message":"", "code":1}
  2436. */
  2437. /**
  2438. * @api {delete} /v1/device/room/delete 03.删除多条房间
  2439. * @apiName 删除多条房间
  2440. * @apiGroup 资产管理-房间管理
  2441. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2442. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2443. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2444. * @apiPermission 【/v1/device/room/delete#DELETE】
  2445. * @apiVersion 1.0.0
  2446. * @apiQuery { Long[] { 1-2147483647 } } ids 房间id数组
  2447. * @apiSuccess { Boolean } data 数据
  2448. * @apiSuccess { String } message 信息
  2449. * @apiSuccess { Integer } code 状态码
  2450. * @apiSuccessExample Response
  2451. *
  2452. * {"data":true, "message":"", "code":1}
  2453. */
  2454. /**
  2455. * @api {put} /v1/device/room/update 04.更新房间
  2456. * @apiName 更新房间
  2457. * @apiGroup 资产管理-房间管理
  2458. * @apiHeader {String = application/json} Content-Type = application/json
  2459. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2460. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2461. * @apiPermission 【/v1/device/room/update#PUT】
  2462. * @apiVersion 1.0.0
  2463. * @apiBody { Long } id 房间id
  2464. * @apiBody { String } name 房间名称
  2465. * @apiBody { String } number 房间编号
  2466. * @apiBody { Long } floorId 房间位置(楼层id)
  2467. * @apiBody { Long[] } [ checkItems = [] ] 检查项
  2468. * @apiSuccess { Object } data 数据
  2469. * @apiSuccess { Long } data.id 房间id
  2470. * @apiSuccess { String } data.name 房间名称
  2471. * @apiSuccess { Long } data.floorId 楼层id
  2472. * @apiSuccess { String } data.number 房间编号
  2473. * @apiSuccess { Date } data.createTime 房间创建时间
  2474. * @apiSuccess { Date } data.updateTime 房间最后更新时间
  2475. * @apiSuccess { Long } data.updateUserId 房间最后更新用户id
  2476. * @apiSuccess { String } data.updateUsername 房间最后更新用户名
  2477. * @apiSuccess { String } message 信息
  2478. * @apiSuccess { Integer } code 状态码
  2479. * @apiSuccessExample Response
  2480. *
  2481. * {"data":{"id":1, "name":"", "floorId":1, "number":"", "createTime":1650761871430, "updateTime":1650761871430, "updateUserId":1, "updateUsername":""}, "message":"", "code":1}
  2482. */
  2483. /**
  2484. * @api {get} /v1/device/room/query/:id 05.查询房间
  2485. * @apiName 查询房间
  2486. * @apiGroup 资产管理-房间管理
  2487. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2488. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2489. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2490. * @apiPermission 【/v1/device/room/query/{id}#GET】
  2491. * @apiVersion 1.0.0
  2492. * @apiParam { Long } id 房间id
  2493. * @apiSuccess { Object } data 数据
  2494. * @apiSuccess { Long } data.id 房间id
  2495. * @apiSuccess { String } data.name 房间名称
  2496. * @apiSuccess { String } data.number 房间编号
  2497. * @apiSuccess { Long } data.buildingId 楼栋id
  2498. * @apiSuccess { Long } data.floorId 楼层id
  2499. * @apiSuccess { Object[] } data.checkItems 检查项列表
  2500. * @apiSuccess { Integer } data.checkItems.itemType 检查项类别 1选择、2数字、3文本、4拍照
  2501. * @apiSuccess { String } data.checkItems.isScore 是否参与评分 1是、2否
  2502. * @apiSuccess { Long } data.checkItems.id 选项key
  2503. * @apiSuccess { String } data.checkItems.name 选项值
  2504. * @apiSuccess { String } message 信息
  2505. * @apiSuccess { Integer } code 状态码
  2506. * @apiSuccessExample Response
  2507. *
  2508. * {"data":{"id":1, "name":"", "number":"", "buildingId":1, "floorId":1, "checkItems":[{"itemType":1, "isScore":"", "id":1, "name":""}]}, "message":"", "code":1}
  2509. */
  2510. /**
  2511. * @api {get} /v1/device/room/list 06.分页查询房间
  2512. * @apiName 分页查询房间
  2513. * @apiGroup 资产管理-房间管理
  2514. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2515. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2516. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2517. * @apiPermission 【/v1/device/room/list#GET】
  2518. * @apiVersion 1.0.0
  2519. * @apiQuery { Long } [ buildingId ] 楼栋id
  2520. * @apiQuery { String } [ buildingName ] 楼栋名称
  2521. * @apiQuery { Long } [ floorId ] 楼层id
  2522. * @apiQuery { String } [ floorName ] 楼层名称
  2523. * @apiQuery { String } [ name ] 房间名称
  2524. * @apiQuery { Integer } [ page = 1 ] 页码
  2525. * @apiQuery { Integer } [ size = 10 ] 页大小
  2526. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2527. * @apiSuccess { Object } data 数据
  2528. * @apiSuccess { Long } data.total 数据总数
  2529. * @apiSuccess { Object[] } data.list 数据列表
  2530. * @apiSuccess { Long } data.list.id 房间id
  2531. * @apiSuccess { String } data.list.name 房间名称
  2532. * @apiSuccess { String } data.list.number 房间编号
  2533. * @apiSuccess { Long } data.list.buildingId 楼栋id
  2534. * @apiSuccess { String } data.list.buildingName 楼栋名称
  2535. * @apiSuccess { Long } data.list.floorId 楼层id
  2536. * @apiSuccess { String } data.list.floorName 楼层名称
  2537. * @apiSuccess { Integer } data.list.deviceTotal 设备数量
  2538. * @apiSuccess { Integer } data.list.itemTotal 项目数量
  2539. * @apiSuccess { Date } data.list.updateTime 房间最后更新时间
  2540. * @apiSuccess { String } data.list.updateUsername 房间最后更新用户名
  2541. * @apiSuccess { String } message 信息
  2542. * @apiSuccess { Integer } code 状态码
  2543. * @apiSuccessExample Response
  2544. *
  2545. * {"data":{"total":1, "list":[{"id":1, "name":"", "number":"", "buildingId":1, "buildingName":"", "floorId":1, "floorName":"", "deviceTotal":1, "itemTotal":1, "updateTime":1650761871431, "updateUsername":""}]}, "message":"", "code":1}
  2546. */
  2547. /**
  2548. * @api {get} /v1/device/room/list/option/:floorId 07.获取楼层中的所有房间选项
  2549. * @apiName 获取楼层中的所有房间选项
  2550. * @apiGroup 资产管理-房间管理
  2551. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2552. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2553. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2554. * @apiVersion 1.0.0
  2555. * @apiParam { Long } floorId 楼层id
  2556. * @apiSuccess { Object[] } data 数据
  2557. * @apiSuccess { Long } data.id 选项key
  2558. * @apiSuccess { String } data.name 选项值
  2559. * @apiSuccess { String } message 信息
  2560. * @apiSuccess { Integer } code 状态码
  2561. * @apiSuccessExample Response
  2562. *
  2563. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  2564. */
  2565. /**
  2566. * @api {delete} /v1/device/delete 01.删除多条设备
  2567. * @apiName 删除多条设备
  2568. * @apiGroup 资产管理-设备管理
  2569. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2570. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2571. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2572. * @apiPermission 【/v1/device/delete#DELETE】
  2573. * @apiVersion 1.0.0
  2574. * @apiQuery { Long[] { 1-2147483647 } } ids 设备id数组
  2575. * @apiSuccess { Boolean } data 数据
  2576. * @apiSuccess { String } message 信息
  2577. * @apiSuccess { Integer } code 状态码
  2578. * @apiSuccessExample Response
  2579. *
  2580. * {"data":true, "message":"", "code":1}
  2581. */
  2582. /**
  2583. * @api {delete} /v1/device/delete/:id 02.删除设备
  2584. * @apiName 删除设备
  2585. * @apiGroup 资产管理-设备管理
  2586. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2587. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2588. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2589. * @apiPermission 【/v1/device/delete/{id}#DELETE】
  2590. * @apiVersion 1.0.0
  2591. * @apiParam { Long } id 设备id
  2592. * @apiSuccess { Boolean } data 数据
  2593. * @apiSuccess { String } message 信息
  2594. * @apiSuccess { Integer } code 状态码
  2595. * @apiSuccessExample Response
  2596. *
  2597. * {"data":true, "message":"", "code":1}
  2598. */
  2599. /**
  2600. * @api {post} /v1/device/add 03.添加设备
  2601. * @apiName 添加设备
  2602. * @apiGroup 资产管理-设备管理
  2603. * @apiHeader {String = application/json} Content-Type = application/json
  2604. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2605. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2606. * @apiPermission 【/v1/device/add#POST】
  2607. * @apiVersion 1.0.0
  2608. * @apiBody { String } name 设备名称
  2609. * @apiBody { Long } roomId 房间id
  2610. * @apiBody { String } [ vendor ] 设备厂家
  2611. * @apiBody { String } [ model ] 设备型号
  2612. * @apiBody { Integer } type 设备类型 1:机柜设备 99:其他设备
  2613. * @apiBody { Integer } [ layerTotal ] 设备层数 机柜设备有效
  2614. * @apiBody { String } [ params ] 设备参数 json格式
  2615. * @apiBody { Long[] } [ checkItems ] 检查项
  2616. * @apiBody { String } [ images ] 设备照片 json格式
  2617. * @apiBody { String } [ files ] 设备附件 json格式
  2618. * @apiSuccess { Object } data 数据
  2619. * @apiSuccess { Long } data.id 设备id
  2620. * @apiSuccess { String } data.name 设备名称
  2621. * @apiSuccess { Long } data.roomId 房间id
  2622. * @apiSuccess { String } data.number 设备编号
  2623. * @apiSuccess { String } data.vendor 设备厂家
  2624. * @apiSuccess { String } data.model 设备型号
  2625. * @apiSuccess { Integer } data.type 设备类型 1:机柜设备 99:其他设备
  2626. * @apiSuccess { Date } data.createTime 设备创建时间
  2627. * @apiSuccess { Date } data.updateTime 设备更新时间
  2628. * @apiSuccess { Long } data.updateUserId 设备更新用户id
  2629. * @apiSuccess { String } data.updateUsername 设备更新用户名
  2630. * @apiSuccess { String } data.params 设备参数 json格式
  2631. * @apiSuccess { String } data.images 设备照片 json格式
  2632. * @apiSuccess { String } data.files 设备附件 json格式
  2633. * @apiSuccess { String } message 信息
  2634. * @apiSuccess { Integer } code 状态码
  2635. * @apiSuccessExample Response
  2636. *
  2637. * {"data":{"id":1, "name":"", "roomId":1, "number":"", "vendor":"", "model":"", "type":1, "createTime":1650761871431, "updateTime":1650761871431, "updateUserId":1, "updateUsername":"", "params":"", "images":"", "files":""}, "message":"", "code":1}
  2638. */
  2639. /**
  2640. * @api {put} /v1/device/update 04.更新设备
  2641. * @apiName 更新设备
  2642. * @apiGroup 资产管理-设备管理
  2643. * @apiHeader {String = application/json} Content-Type = application/json
  2644. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2645. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2646. * @apiPermission 【/v1/device/update#PUT】
  2647. * @apiVersion 1.0.0
  2648. * @apiBody { Long } id 设备id
  2649. * @apiBody { String } name 设备名称
  2650. * @apiBody { Long } roomId 房间id
  2651. * @apiBody { String } number 设备编号
  2652. * @apiBody { String } [ vendor ] 设备厂家
  2653. * @apiBody { String } [ model ] 设备型号
  2654. * @apiBody { String } [ params ] 设备参数 json格式
  2655. * @apiBody { Long[] } [ checkItems = [] ] 检查项
  2656. * @apiBody { String } [ images ] 设备照片 json格式
  2657. * @apiBody { String } [ files ] 设备附件 json格式
  2658. * @apiSuccess { Object } data 数据
  2659. * @apiSuccess { Long } data.id 设备id
  2660. * @apiSuccess { String } data.name 设备名称
  2661. * @apiSuccess { Long } data.roomId 房间id
  2662. * @apiSuccess { String } data.number 设备编号
  2663. * @apiSuccess { String } data.vendor 设备厂家
  2664. * @apiSuccess { String } data.model 设备型号
  2665. * @apiSuccess { Integer } data.type 设备类型 1:机柜设备 99:其他设备
  2666. * @apiSuccess { Date } data.createTime 设备创建时间
  2667. * @apiSuccess { Date } data.updateTime 设备更新时间
  2668. * @apiSuccess { Long } data.updateUserId 设备更新用户id
  2669. * @apiSuccess { String } data.updateUsername 设备更新用户名
  2670. * @apiSuccess { String } data.params 设备参数 json格式
  2671. * @apiSuccess { String } data.images 设备照片 json格式
  2672. * @apiSuccess { String } data.files 设备附件 json格式
  2673. * @apiSuccess { String } message 信息
  2674. * @apiSuccess { Integer } code 状态码
  2675. * @apiSuccessExample Response
  2676. *
  2677. * {"data":{"id":1, "name":"", "roomId":1, "number":"", "vendor":"", "model":"", "type":1, "createTime":1650761871431, "updateTime":1650761871431, "updateUserId":1, "updateUsername":"", "params":"", "images":"", "files":""}, "message":"", "code":1}
  2678. */
  2679. /**
  2680. * @api {get} /v1/device/query/:id 05.查询设备
  2681. * @apiName 查询设备
  2682. * @apiGroup 资产管理-设备管理
  2683. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2684. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2685. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2686. * @apiPermission 【/v1/device/query/{id}#GET】
  2687. * @apiVersion 1.0.0
  2688. * @apiParam { Long } id 设备id
  2689. * @apiSuccess { Object } data 数据
  2690. * @apiSuccess { Long } data.id 设备id
  2691. * @apiSuccess { String } data.name 设备名称
  2692. * @apiSuccess { Long } data.buildingId 楼栋id
  2693. * @apiSuccess { Long } data.floorId 楼层id
  2694. * @apiSuccess { Long } data.roomId 房间id
  2695. * @apiSuccess { String } data.number 设备编号
  2696. * @apiSuccess { String } data.vendor 设备厂家
  2697. * @apiSuccess { String } data.model 设备型号
  2698. * @apiSuccess { Integer } data.type 设备类型 1:机柜设备 99:其他设备
  2699. * @apiSuccess { Date } data.createTime 设备创建时间
  2700. * @apiSuccess { Date } data.updateTime 设备更新时间
  2701. * @apiSuccess { Long } data.updateUserId 设备更新用户id
  2702. * @apiSuccess { String } data.updateUsername 设备更新用户名
  2703. * @apiSuccess { String } data.params 设备参数 json格式
  2704. * @apiSuccess { String } data.images 设备照片 json格式
  2705. * @apiSuccess { String } data.files 设备附件 json格式
  2706. * @apiSuccess { Object } data.cabinet 机柜 机柜设备有效
  2707. * @apiSuccess { Long } data.cabinet.id 机柜id
  2708. * @apiSuccess { Long } data.cabinet.deviceId 设备id
  2709. * @apiSuccess { Integer } data.cabinet.layerTotal 机柜层数
  2710. * @apiSuccess { Integer } data.cabinet.layerUsed 机柜已使用层数
  2711. * @apiSuccess { Object[] } data.checkItems 检查项列表
  2712. * @apiSuccess { Integer } data.checkItems.itemType 检查项类别 1选择、2数字、3文本、4拍照
  2713. * @apiSuccess { String } data.checkItems.isScore 是否参与评分 1是、2否
  2714. * @apiSuccess { Long } data.checkItems.id 选项key
  2715. * @apiSuccess { String } data.checkItems.name 选项值
  2716. * @apiSuccess { String } message 信息
  2717. * @apiSuccess { Integer } code 状态码
  2718. * @apiSuccessExample Response
  2719. *
  2720. * {"data":{"id":1, "name":"", "buildingId":1, "floorId":1, "roomId":1, "number":"", "vendor":"", "model":"", "type":1, "createTime":1650761871431, "updateTime":1650761871431, "updateUserId":1, "updateUsername":"", "params":"", "images":"", "files":"", "cabinet":{"id":1, "deviceId":1, "layerTotal":1, "layerUsed":1}, "checkItems":[{"itemType":1, "isScore":"", "id":1, "name":""}]}, "message":"", "code":1}
  2721. */
  2722. /**
  2723. * @api {get} /v1/device/list 06.分页查询设备
  2724. * @apiName 分页查询设备
  2725. * @apiGroup 资产管理-设备管理
  2726. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2727. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2728. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2729. * @apiPermission 【/v1/device/list#GET】
  2730. * @apiVersion 1.0.0
  2731. * @apiQuery { Long } [ buildingId ] 楼栋id
  2732. * @apiQuery { String } [ buildingName ] 楼栋名称
  2733. * @apiQuery { Long } [ floorId ] 楼层id
  2734. * @apiQuery { String } [ floorName ] 楼层名称
  2735. * @apiQuery { Long } [ roomId ] 房间id
  2736. * @apiQuery { String } [ roomName ] 房间名称
  2737. * @apiQuery { String } [ name ] 设备名称
  2738. * @apiQuery { Integer } [ type ] 设备类型 1:机柜设备 99:其他设备
  2739. * @apiQuery { Integer } [ page = 1 ] 页码
  2740. * @apiQuery { Integer } [ size = 10 ] 页大小
  2741. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2742. * @apiSuccess { Object } data 数据
  2743. * @apiSuccess { Long } data.total 数据总数
  2744. * @apiSuccess { Object[] } data.list 数据列表
  2745. * @apiSuccess { Long } data.list.id 设备id
  2746. * @apiSuccess { String } data.list.name 设备名称
  2747. * @apiSuccess { String } data.list.number 设备编号
  2748. * @apiSuccess { String } data.list.buildingName 楼栋名称
  2749. * @apiSuccess { String } data.list.floorName 楼层名称
  2750. * @apiSuccess { String } data.list.roomName 房间名称
  2751. * @apiSuccess { Integer } data.list.checkItemTotal 关联检查项数
  2752. * @apiSuccess { Integer } data.list.type 设备类型 1:机柜设备 99:其他设备
  2753. * @apiSuccess { Date } data.list.createTime 设备创建时间
  2754. * @apiSuccess { Object } data.list.cabinet 机柜 机柜设备有效
  2755. * @apiSuccess { Long } data.list.cabinet.id 机柜id
  2756. * @apiSuccess { Long } data.list.cabinet.deviceId 设备id
  2757. * @apiSuccess { Integer } data.list.cabinet.layerTotal 机柜层数
  2758. * @apiSuccess { Integer } data.list.cabinet.layerUsed 机柜已使用层数
  2759. * @apiSuccess { String } message 信息
  2760. * @apiSuccess { Integer } code 状态码
  2761. * @apiSuccessExample Response
  2762. *
  2763. * {"data":{"total":1, "list":[{"id":1, "name":"", "number":"", "buildingName":"", "floorName":"", "roomName":"", "checkItemTotal":1, "type":1, "createTime":1650761871431, "cabinet":{"id":1, "deviceId":1, "layerTotal":1, "layerUsed":1}}]}, "message":"", "code":1}
  2764. */
  2765. /**
  2766. * @api {get} /v1/device/list/option/:roomId 07.获取房间中的所有设备选项
  2767. * @apiName 获取房间中的所有设备选项
  2768. * @apiGroup 资产管理-设备管理
  2769. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2770. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2771. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2772. * @apiVersion 1.0.0
  2773. * @apiParam { Long } roomId 房间id
  2774. * @apiSuccess { Object[] } data 数据
  2775. * @apiSuccess { Long } data.id 选项key
  2776. * @apiSuccess { String } data.name 选项值
  2777. * @apiSuccess { String } message 信息
  2778. * @apiSuccess { Integer } code 状态码
  2779. * @apiSuccessExample Response
  2780. *
  2781. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  2782. */
  2783. /**
  2784. * @api {put} /v1/device/cabinet/child/device/update 01.更新机柜内设备
  2785. * @apiName 更新机柜内设备
  2786. * @apiGroup 资产管理-设备管理-机柜-设备
  2787. * @apiHeader {String = application/json} Content-Type = application/json
  2788. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2789. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2790. * @apiPermission 【/v1/device/cabinet/child/device/update#PUT】
  2791. * @apiVersion 1.0.0
  2792. * @apiBody { Long } [ id ] 机柜内设备id
  2793. * @apiBody { Long } [ cabinetId ] 机柜id
  2794. * @apiBody { String } [ name ] 设备名称
  2795. * @apiBody { String } [ vendor ] 设备厂商
  2796. * @apiBody { String } [ model ] 设备型号
  2797. * @apiBody { Integer } [ layerCount ] 设备占用层数
  2798. * @apiBody { String } [ remark ] 备注
  2799. * @apiBody { Integer } [ top ] 设备顶部距机柜顶端距离
  2800. * @apiBody { Integer } [ bottom ] 设备底部距机柜顶端距离
  2801. * @apiSuccess { Object } data 数据
  2802. * @apiSuccess { Long } data.id 机柜内设备id
  2803. * @apiSuccess { Long } data.cabinetId 机柜id
  2804. * @apiSuccess { String } data.name 设备名称
  2805. * @apiSuccess { String } data.vendor 设备厂商
  2806. * @apiSuccess { String } data.model 设备型号
  2807. * @apiSuccess { Integer } data.layerCount 设备占用层数
  2808. * @apiSuccess { String } data.remark 备注
  2809. * @apiSuccess { Integer } data.top 设备顶部距机柜顶端距离
  2810. * @apiSuccess { Integer } data.bottom 设备底部距机柜顶端距离
  2811. * @apiSuccess { String } message 信息
  2812. * @apiSuccess { Integer } code 状态码
  2813. * @apiSuccessExample Response
  2814. *
  2815. * {"data":{"id":1, "cabinetId":1, "name":"", "vendor":"", "model":"", "layerCount":1, "remark":"", "top":1, "bottom":1}, "message":"", "code":1}
  2816. */
  2817. /**
  2818. * @api {get} /v1/device/cabinet/child/device/list 02.分页查询机柜内设备
  2819. * @apiName 分页查询机柜内设备
  2820. * @apiGroup 资产管理-设备管理-机柜-设备
  2821. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2822. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2823. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2824. * @apiPermission 【/v1/device/cabinet/child/device/list#GET】
  2825. * @apiVersion 1.0.0
  2826. * @apiQuery { Long } [ cabinetId ] 机柜id
  2827. * @apiQuery { String } [ name ] 设备名称
  2828. * @apiQuery { String } [ vendor ] 设备厂商
  2829. * @apiQuery { String } [ model ] 设备型号
  2830. * @apiQuery { Integer } [ layerCount ] 设备占用层数
  2831. * @apiQuery { String } [ remark ] 备注
  2832. * @apiQuery { Integer } [ top ] 设备顶部距机柜顶端距离
  2833. * @apiQuery { Integer } [ bottom ] 设备底部距机柜顶端距离
  2834. * @apiQuery { Integer } [ page = 1 ] 页码
  2835. * @apiQuery { Integer } [ size = 10 ] 页大小
  2836. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  2837. * @apiSuccess { Object } data 数据
  2838. * @apiSuccess { Long } data.total 数据总数
  2839. * @apiSuccess { Object[] } data.list 数据列表
  2840. * @apiSuccess { Long } data.list.id 机柜内设备id
  2841. * @apiSuccess { Long } data.list.cabinetId 机柜id
  2842. * @apiSuccess { String } data.list.name 设备名称
  2843. * @apiSuccess { String } data.list.vendor 设备厂商
  2844. * @apiSuccess { String } data.list.model 设备型号
  2845. * @apiSuccess { Integer } data.list.layerCount 设备占用层数
  2846. * @apiSuccess { String } data.list.remark 备注
  2847. * @apiSuccess { Integer } data.list.top 设备顶部距机柜顶端距离
  2848. * @apiSuccess { Integer } data.list.bottom 设备底部距机柜顶端距离
  2849. * @apiSuccess { String } message 信息
  2850. * @apiSuccess { Integer } code 状态码
  2851. * @apiSuccessExample Response
  2852. *
  2853. * {"data":{"total":1, "list":[{"id":1, "cabinetId":1, "name":"", "vendor":"", "model":"", "layerCount":1, "remark":"", "top":1, "bottom":1}]}, "message":"", "code":1}
  2854. */
  2855. /**
  2856. * @api {post} /v1/device/cabinet/child/device/add 03.添加机柜内设备
  2857. * @apiName 添加机柜内设备
  2858. * @apiGroup 资产管理-设备管理-机柜-设备
  2859. * @apiHeader {String = application/json} Content-Type = application/json
  2860. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2861. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2862. * @apiPermission 【/v1/device/cabinet/child/device/add#POST】
  2863. * @apiVersion 1.0.0
  2864. * @apiBody { Long } cabinetId 机柜id
  2865. * @apiBody { String } name 设备名称
  2866. * @apiBody { String } [ vendor ] 设备厂商
  2867. * @apiBody { String } [ model ] 设备型号
  2868. * @apiBody { Integer } layerCount 设备占用层数
  2869. * @apiBody { String } [ remark ] 备注
  2870. * @apiBody { Integer } top 设备顶部距机柜顶端距离
  2871. * @apiBody { Integer } bottom 设备底部距机柜顶端距离
  2872. * @apiSuccess { Object } data 数据
  2873. * @apiSuccess { Long } data.id 机柜内设备id
  2874. * @apiSuccess { Long } data.cabinetId 机柜id
  2875. * @apiSuccess { String } data.name 设备名称
  2876. * @apiSuccess { String } data.vendor 设备厂商
  2877. * @apiSuccess { String } data.model 设备型号
  2878. * @apiSuccess { Integer } data.layerCount 设备占用层数
  2879. * @apiSuccess { String } data.remark 备注
  2880. * @apiSuccess { Integer } data.top 设备顶部距机柜顶端距离
  2881. * @apiSuccess { Integer } data.bottom 设备底部距机柜顶端距离
  2882. * @apiSuccess { String } message 信息
  2883. * @apiSuccess { Integer } code 状态码
  2884. * @apiSuccessExample Response
  2885. *
  2886. * {"data":{"id":1, "cabinetId":1, "name":"", "vendor":"", "model":"", "layerCount":1, "remark":"", "top":1, "bottom":1}, "message":"", "code":1}
  2887. */
  2888. /**
  2889. * @api {delete} /v1/device/cabinet/child/device/delete/:id 04.删除机柜内设备
  2890. * @apiName 删除机柜内设备
  2891. * @apiGroup 资产管理-设备管理-机柜-设备
  2892. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2893. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2894. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2895. * @apiPermission 【/v1/device/cabinet/child/device/delete/{id}#DELETE】
  2896. * @apiVersion 1.0.0
  2897. * @apiParam { Long } id 机柜内设备id
  2898. * @apiSuccess { Boolean } data 数据
  2899. * @apiSuccess { String } message 信息
  2900. * @apiSuccess { Integer } code 状态码
  2901. * @apiSuccessExample Response
  2902. *
  2903. * {"data":true, "message":"", "code":1}
  2904. */
  2905. /**
  2906. * @api {post} /v1/device/template/add 01.添加机柜内设备模板
  2907. * @apiName 添加机柜内设备模板
  2908. * @apiGroup 资产管理-设备管理-机柜-设备模板
  2909. * @apiHeader {String = application/json} Content-Type = application/json
  2910. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2911. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2912. * @apiPermission 【/v1/device/template/add#POST】
  2913. * @apiVersion 1.0.0
  2914. * @apiBody { Long } [ id ] 设备id
  2915. * @apiBody { String } [ name ] 设备名称
  2916. * @apiBody { Integer } [ layerCount ] 占用层数
  2917. * @apiBody { String } [ vendor ] 设备厂商
  2918. * @apiBody { String } [ model ] 设备型号
  2919. * @apiSuccess { Object } data 数据
  2920. * @apiSuccess { Long } data.id 设备id
  2921. * @apiSuccess { String } data.name 设备名称
  2922. * @apiSuccess { Integer } data.layerCount 占用层数
  2923. * @apiSuccess { String } data.vendor 设备厂商
  2924. * @apiSuccess { String } data.model 设备型号
  2925. * @apiSuccess { String } message 信息
  2926. * @apiSuccess { Integer } code 状态码
  2927. * @apiSuccessExample Response
  2928. *
  2929. * {"data":{"id":1, "name":"", "layerCount":1, "vendor":"", "model":""}, "message":"", "code":1}
  2930. */
  2931. /**
  2932. * @api {delete} /v1/device/template/delete/:id 02.删除机柜内设备模板
  2933. * @apiName 删除机柜内设备模板
  2934. * @apiGroup 资产管理-设备管理-机柜-设备模板
  2935. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2936. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2937. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2938. * @apiPermission 【/v1/device/template/delete/{id}#DELETE】
  2939. * @apiVersion 1.0.0
  2940. * @apiParam { Long } id 机柜内设备模板id
  2941. * @apiSuccess { Boolean } data 数据
  2942. * @apiSuccess { String } message 信息
  2943. * @apiSuccess { Integer } code 状态码
  2944. * @apiSuccessExample Response
  2945. *
  2946. * {"data":true, "message":"", "code":1}
  2947. */
  2948. /**
  2949. * @api {put} /v1/device/template/update 03.更新机柜内设备模板
  2950. * @apiName 更新机柜内设备模板
  2951. * @apiGroup 资产管理-设备管理-机柜-设备模板
  2952. * @apiHeader {String = application/json} Content-Type = application/json
  2953. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2954. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2955. * @apiPermission 【/v1/device/template/update#PUT】
  2956. * @apiVersion 1.0.0
  2957. * @apiBody { Long } [ id ] 设备id
  2958. * @apiBody { String } [ name ] 设备名称
  2959. * @apiBody { Integer } [ layerCount ] 占用层数
  2960. * @apiBody { String } [ vendor ] 设备厂商
  2961. * @apiBody { String } [ model ] 设备型号
  2962. * @apiSuccess { Object } data 数据
  2963. * @apiSuccess { Long } data.id 设备id
  2964. * @apiSuccess { String } data.name 设备名称
  2965. * @apiSuccess { Integer } data.layerCount 占用层数
  2966. * @apiSuccess { String } data.vendor 设备厂商
  2967. * @apiSuccess { String } data.model 设备型号
  2968. * @apiSuccess { String } message 信息
  2969. * @apiSuccess { Integer } code 状态码
  2970. * @apiSuccessExample Response
  2971. *
  2972. * {"data":{"id":1, "name":"", "layerCount":1, "vendor":"", "model":""}, "message":"", "code":1}
  2973. */
  2974. /**
  2975. * @api {get} /v1/device/template/query/:id 04.查询机柜内设备模板
  2976. * @apiName 查询机柜内设备模板
  2977. * @apiGroup 资产管理-设备管理-机柜-设备模板
  2978. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  2979. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  2980. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  2981. * @apiPermission 【/v1/device/template/query/{id}#GET】
  2982. * @apiVersion 1.0.0
  2983. * @apiParam { Long } id 机柜内设备模板id
  2984. * @apiSuccess { Object } data 数据
  2985. * @apiSuccess { Long } data.id 设备id
  2986. * @apiSuccess { String } data.name 设备名称
  2987. * @apiSuccess { Integer } data.layerCount 占用层数
  2988. * @apiSuccess { String } data.vendor 设备厂商
  2989. * @apiSuccess { String } data.model 设备型号
  2990. * @apiSuccess { String } message 信息
  2991. * @apiSuccess { Integer } code 状态码
  2992. * @apiSuccessExample Response
  2993. *
  2994. * {"data":{"id":1, "name":"", "layerCount":1, "vendor":"", "model":""}, "message":"", "code":1}
  2995. */
  2996. /**
  2997. * @api {get} /v1/device/template/list 05.分页查询机柜内设备模板
  2998. * @apiName 分页查询机柜内设备模板
  2999. * @apiGroup 资产管理-设备管理-机柜-设备模板
  3000. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3001. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3002. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3003. * @apiPermission 【/v1/device/template/list#GET】
  3004. * @apiVersion 1.0.0
  3005. * @apiQuery { String } [ name ] 设备名称
  3006. * @apiQuery { Integer } [ layerCount ] 占用层数
  3007. * @apiQuery { String } [ vendor ] 设备厂商
  3008. * @apiQuery { String } [ model ] 设备型号
  3009. * @apiQuery { Integer } [ page = 1 ] 页码
  3010. * @apiQuery { Integer } [ size = 10 ] 页大小
  3011. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3012. * @apiSuccess { Object } data 数据
  3013. * @apiSuccess { Long } data.total 数据总数
  3014. * @apiSuccess { Object[] } data.list 数据列表
  3015. * @apiSuccess { Long } data.list.id 设备id
  3016. * @apiSuccess { String } data.list.name 设备名称
  3017. * @apiSuccess { Integer } data.list.layerCount 占用层数
  3018. * @apiSuccess { String } data.list.vendor 设备厂商
  3019. * @apiSuccess { String } data.list.model 设备型号
  3020. * @apiSuccess { String } message 信息
  3021. * @apiSuccess { Integer } code 状态码
  3022. * @apiSuccessExample Response
  3023. *
  3024. * {"data":{"total":1, "list":[{"id":1, "name":"", "layerCount":1, "vendor":"", "model":""}]}, "message":"", "code":1}
  3025. */
  3026. /**
  3027. * @api {get} /v1/device/cabinet/log/list 01.分页查询机柜操作日志
  3028. * @apiName 分页查询机柜操作日志
  3029. * @apiGroup 资产管理-设备管理-机柜-操作日志
  3030. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3031. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3032. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3033. * @apiPermission 【/v1/device/cabinet/log/list#GET】
  3034. * @apiVersion 1.0.0
  3035. * @apiQuery { Long } [ cabinetId ] 机柜id
  3036. * @apiQuery { String } [ content ] 操作内容
  3037. * @apiQuery { Date } [ createTimeStart ] 操作时间 开始时间
  3038. * @apiQuery { Date } [ createTimeEnd ] 操作时间 结束时间
  3039. * @apiQuery { Long } [ operateUserId ] 操作用户id
  3040. * @apiQuery { String } [ operateUsername ] 操作用户名
  3041. * @apiQuery { Integer } [ page = 1 ] 页码
  3042. * @apiQuery { Integer } [ size = 10 ] 页大小
  3043. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3044. * @apiSuccess { Object } data 数据
  3045. * @apiSuccess { Long } data.total 数据总数
  3046. * @apiSuccess { Object[] } data.list 数据列表
  3047. * @apiSuccess { Long } data.list.id 机柜操作日志id
  3048. * @apiSuccess { Long } data.list.cabinetId 机柜id
  3049. * @apiSuccess { String } data.list.content 操作内容
  3050. * @apiSuccess { Date } data.list.createTime 操作时间
  3051. * @apiSuccess { Long } data.list.operateUserId 操作用户id
  3052. * @apiSuccess { String } data.list.operateUsername 操作用户名
  3053. * @apiSuccess { String } message 信息
  3054. * @apiSuccess { Integer } code 状态码
  3055. * @apiSuccessExample Response
  3056. *
  3057. * {"data":{"total":1, "list":[{"id":1, "cabinetId":1, "content":"", "createTime":1650761871433, "operateUserId":1, "operateUsername":""}]}, "message":"", "code":1}
  3058. */
  3059. /**
  3060. * @api {post} /v1/stock/classify/add 01.添加资产分类
  3061. * @apiName 添加资产分类
  3062. * @apiGroup 出入库管理-物品分类
  3063. * @apiHeader {String = application/json} Content-Type = application/json
  3064. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3065. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3066. * @apiPermission 【/v1/stock/classify/add#POST】
  3067. * @apiVersion 1.0.0
  3068. * @apiBody { String } name 分类名称
  3069. * @apiSuccess { Object } data 数据
  3070. * @apiSuccess { Long } data.id id主键
  3071. * @apiSuccess { String } data.name 分类名称
  3072. * @apiSuccess { Date } data.createTime 添加时间
  3073. * @apiSuccess { Date } data.updateTime 更新时间
  3074. * @apiSuccess { String } message 信息
  3075. * @apiSuccess { Integer } code 状态码
  3076. * @apiSuccessExample Response
  3077. *
  3078. * {"data":{"id":1, "name":"", "createTime":1650761871434, "updateTime":1650761871434}, "message":"", "code":1}
  3079. */
  3080. /**
  3081. * @api {put} /v1/stock/classify/update 02.更新资产分类
  3082. * @apiName 更新资产分类
  3083. * @apiGroup 出入库管理-物品分类
  3084. * @apiHeader {String = application/json} Content-Type = application/json
  3085. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3086. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3087. * @apiPermission 【/v1/stock/classify/update#PUT】
  3088. * @apiVersion 1.0.0
  3089. * @apiBody { Long } id id 主键
  3090. * @apiBody { String } name 分类名称
  3091. * @apiSuccess { Object } data 数据
  3092. * @apiSuccess { Long } data.id id主键
  3093. * @apiSuccess { String } data.name 分类名称
  3094. * @apiSuccess { Date } data.createTime 添加时间
  3095. * @apiSuccess { Date } data.updateTime 更新时间
  3096. * @apiSuccess { String } message 信息
  3097. * @apiSuccess { Integer } code 状态码
  3098. * @apiSuccessExample Response
  3099. *
  3100. * {"data":{"id":1, "name":"", "createTime":1650761871434, "updateTime":1650761871434}, "message":"", "code":1}
  3101. */
  3102. /**
  3103. * @api {delete} /v1/stock/classify/delete/:id 03.删除物品类别
  3104. * @apiName 删除物品类别
  3105. * @apiGroup 出入库管理-物品分类
  3106. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3107. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3108. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3109. * @apiPermission 【/v1/stock/classify/delete/{id}#DELETE】
  3110. * @apiVersion 1.0.0
  3111. * @apiParam { Long } id 物品类别id
  3112. * @apiSuccess { Boolean } data 数据
  3113. * @apiSuccess { String } message 信息
  3114. * @apiSuccess { Integer } code 状态码
  3115. * @apiSuccessExample Response
  3116. *
  3117. * {"data":true, "message":"", "code":1}
  3118. */
  3119. /**
  3120. * @api {delete} /v1/stock/classify/delete 04.删除多条物品类别
  3121. * @apiName 删除多条物品类别
  3122. * @apiGroup 出入库管理-物品分类
  3123. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3124. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3125. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3126. * @apiPermission 【/v1/stock/classify/delete#DELETE】
  3127. * @apiVersion 1.0.0
  3128. * @apiQuery { Long[] { 1-2147483647 } } ids 物品类别id数组
  3129. * @apiSuccess { Boolean } data 数据
  3130. * @apiSuccess { String } message 信息
  3131. * @apiSuccess { Integer } code 状态码
  3132. * @apiSuccessExample Response
  3133. *
  3134. * {"data":true, "message":"", "code":1}
  3135. */
  3136. /**
  3137. * @api {get} /v1/stock/classify/list 05.分页查询物品类别
  3138. * @apiName 分页查询物品类别
  3139. * @apiGroup 出入库管理-物品分类
  3140. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3141. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3142. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3143. * @apiPermission 【/v1/stock/classify/list#GET】
  3144. * @apiVersion 1.0.0
  3145. * @apiQuery { String } [ name ] 分类名称
  3146. * @apiQuery { Date } [ createTimeStart ] 添加时间 开始时间
  3147. * @apiQuery { Date } [ createTimeEnd ] 添加时间 结束时间
  3148. * @apiQuery { Date } [ updateTimeStart ] 更新时间 开始时间
  3149. * @apiQuery { Date } [ updateTimeEnd ] 更新时间 结束时间
  3150. * @apiQuery { Integer } [ page = 1 ] 页码
  3151. * @apiQuery { Integer } [ size = 10 ] 页大小
  3152. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3153. * @apiSuccess { Object } data 数据
  3154. * @apiSuccess { Long } data.total 数据总数
  3155. * @apiSuccess { Object[] } data.list 数据列表
  3156. * @apiSuccess { Long } data.list.id id主键
  3157. * @apiSuccess { String } data.list.name 分类名称
  3158. * @apiSuccess { Date } data.list.createTime 添加时间
  3159. * @apiSuccess { Date } data.list.updateTime 更新时间
  3160. * @apiSuccess { String } message 信息
  3161. * @apiSuccess { Integer } code 状态码
  3162. * @apiSuccessExample Response
  3163. *
  3164. * {"data":{"total":1, "list":[{"id":1, "name":"", "createTime":1650761871434, "updateTime":1650761871434}]}, "message":"", "code":1}
  3165. */
  3166. /**
  3167. * @api {post} /v1/stock/goods/add 01.添加物品
  3168. * @apiName 添加物品
  3169. * @apiGroup 出入库管理-物品库存
  3170. * @apiHeader {String = application/json} Content-Type = application/json
  3171. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3172. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3173. * @apiPermission 【/v1/stock/goods/add#POST】
  3174. * @apiVersion 1.0.0
  3175. * @apiBody { Long } classifyId 物品分类id
  3176. * @apiBody { String } name 物品名称
  3177. * @apiBody { Integer { 1- } } count 物品数量
  3178. * @apiBody { String } description 物品介绍
  3179. * @apiSuccess { Object } data 数据
  3180. * @apiSuccess { Long } data.id id主键(物品编号)
  3181. * @apiSuccess { Long } data.classifyId 物品分类id
  3182. * @apiSuccess { String } data.name 物品名称
  3183. * @apiSuccess { Integer } data.count 物品数量
  3184. * @apiSuccess { String } data.description 物品介绍
  3185. * @apiSuccess { Date } data.createTime 物品添加时间
  3186. * @apiSuccess { Date } data.updateTime 物品更新时间
  3187. * @apiSuccess { String } message 信息
  3188. * @apiSuccess { Integer } code 状态码
  3189. * @apiSuccessExample Response
  3190. *
  3191. * {"data":{"id":1, "classifyId":1, "name":"", "count":1, "description":"", "createTime":1650761871434, "updateTime":1650761871434}, "message":"", "code":1}
  3192. */
  3193. /**
  3194. * @api {put} /v1/stock/goods/take 02.出库
  3195. * @apiName 出库
  3196. * @apiGroup 出入库管理-物品库存
  3197. * @apiHeader {String = application/json} Content-Type = application/json
  3198. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3199. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3200. * @apiPermission 【/v1/stock/goods/take#PUT】
  3201. * @apiVersion 1.0.0
  3202. * @apiBody { Long } id 物品id
  3203. * @apiBody { Integer { 1- } } count 物品出库数量
  3204. * @apiBody { Long } userId 领取人id
  3205. * @apiSuccess { Object } data 数据
  3206. * @apiSuccess { Long } data.id id主键(物品编号)
  3207. * @apiSuccess { Long } data.classifyId 物品分类id
  3208. * @apiSuccess { String } data.name 物品名称
  3209. * @apiSuccess { Integer } data.count 物品数量
  3210. * @apiSuccess { String } data.description 物品介绍
  3211. * @apiSuccess { Date } data.createTime 物品添加时间
  3212. * @apiSuccess { Date } data.updateTime 物品更新时间
  3213. * @apiSuccess { String } message 信息
  3214. * @apiSuccess { Integer } code 状态码
  3215. * @apiSuccessExample Response
  3216. *
  3217. * {"data":{"id":1, "classifyId":1, "name":"", "count":1, "description":"", "createTime":1650761871434, "updateTime":1650761871434}, "message":"", "code":1}
  3218. */
  3219. /**
  3220. * @api {get} /v1/stock/goods/list 03.分页查询物品
  3221. * @apiName 分页查询物品
  3222. * @apiGroup 出入库管理-物品库存
  3223. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3224. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3225. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3226. * @apiPermission 【/v1/stock/goods/list#GET】
  3227. * @apiVersion 1.0.0
  3228. * @apiQuery { Long } [ classifyId ] 物品分类id
  3229. * @apiQuery { String } [ name ] 物品名称
  3230. * @apiQuery { Integer } [ count ] 物品数量
  3231. * @apiQuery { String } [ description ] 物品介绍
  3232. * @apiQuery { Date } [ createTimeStart ] 物品添加时间 开始时间
  3233. * @apiQuery { Date } [ createTimeEnd ] 物品添加时间 结束时间
  3234. * @apiQuery { Date } [ updateTimeStart ] 物品更新时间 开始时间
  3235. * @apiQuery { Date } [ updateTimeEnd ] 物品更新时间 结束时间
  3236. * @apiQuery { Integer } [ page = 1 ] 页码
  3237. * @apiQuery { Integer } [ size = 10 ] 页大小
  3238. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3239. * @apiSuccess { Object } data 数据
  3240. * @apiSuccess { Long } data.total 数据总数
  3241. * @apiSuccess { Object[] } data.list 数据列表
  3242. * @apiSuccess { Long } data.list.id id主键(物品编号)
  3243. * @apiSuccess { Long } data.list.classifyId 物品分类id
  3244. * @apiSuccess { String } data.list.name 物品名称
  3245. * @apiSuccess { Integer } data.list.count 物品数量
  3246. * @apiSuccess { String } data.list.description 物品介绍
  3247. * @apiSuccess { Date } data.list.createTime 物品添加时间
  3248. * @apiSuccess { Date } data.list.updateTime 物品更新时间
  3249. * @apiSuccess { String } message 信息
  3250. * @apiSuccess { Integer } code 状态码
  3251. * @apiSuccessExample Response
  3252. *
  3253. * {"data":{"total":1, "list":[{"id":1, "classifyId":1, "name":"", "count":1, "description":"", "createTime":1650761871434, "updateTime":1650761871434}]}, "message":"", "code":1}
  3254. */
  3255. /**
  3256. * @api {get} /v1/stock/change/record/list 01.分页查询出入库记录
  3257. * @apiName 分页查询出入库记录
  3258. * @apiGroup 出入库管理-出入库记录
  3259. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3260. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3261. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3262. * @apiPermission 【/v1/stock/change/record/list#GET】
  3263. * @apiVersion 1.0.0
  3264. * @apiQuery { Long } [ classifyId ] 物品分类id
  3265. * @apiQuery { String } [ name ] 物品名称
  3266. * @apiQuery { Integer } [ page = 1 ] 页码
  3267. * @apiQuery { Integer } [ size = 10 ] 页大小
  3268. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3269. * @apiSuccess { Object } data 数据
  3270. * @apiSuccess { Long } data.total 数据总数
  3271. * @apiSuccess { Object[] } data.list 数据列表
  3272. * @apiSuccess { Long } data.list.id id主键
  3273. * @apiSuccess { Long } data.list.goodsId 物品id
  3274. * @apiSuccess { Integer } data.list.count 变化数量,入库时大于0,出库时小于0
  3275. * @apiSuccess { Date } data.list.createTime 操作时间
  3276. * @apiSuccess { Long } data.list.userId 领取人id
  3277. * @apiSuccess { Long } data.list.operatorId 操作人id
  3278. * @apiSuccess { String } message 信息
  3279. * @apiSuccess { Integer } code 状态码
  3280. * @apiSuccessExample Response
  3281. *
  3282. * {"data":{"total":1, "list":[{"id":1, "goodsId":1, "count":1, "createTime":1650761871434, "userId":1, "operatorId":1}]}, "message":"", "code":1}
  3283. */
  3284. /**
  3285. * @api {get} /v1/visitor/list 01.分页查询访客
  3286. * @apiName 分页查询访客
  3287. * @apiGroup 访客管理
  3288. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3289. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3290. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3291. * @apiPermission 【/v1/visitor/list#GET】
  3292. * @apiVersion 1.0.0
  3293. * @apiDeprecated 接口已弃用 使用(#访客管理-访客审批:分页查询访客审批)
  3294. * @apiQuery { String } [ openid ] 用户openid
  3295. * @apiQuery { Integer } [ number ] 编号,年+4位编号
  3296. * @apiQuery { String } [ username ] 访客姓名
  3297. * @apiQuery { String } [ userPhone ] 访客手机号
  3298. * @apiQuery { String } [ company ] 访客公司
  3299. * @apiQuery { Boolean } [ contact ] 是否密接
  3300. * @apiQuery { Boolean } [ highRisk ] 是否高风险
  3301. * @apiQuery { Boolean } [ confirm ] 是否确诊
  3302. * @apiQuery { Date } [ entryTimeStart ] 进入时间 开始时间
  3303. * @apiQuery { Date } [ entryTimeEnd ] 进入时间 结束时间
  3304. * @apiQuery { String } [ reason ] 事由
  3305. * @apiQuery { Date } [ leaveTimeStart ] 离开时间 开始时间
  3306. * @apiQuery { Date } [ leaveTimeEnd ] 离开时间 结束时间
  3307. * @apiQuery { String } [ remark ] 出场备注
  3308. * @apiQuery { String } [ images ] 图片
  3309. * @apiQuery { Integer } [ page = 1 ] 页码
  3310. * @apiQuery { Integer } [ size = 10 ] 页大小
  3311. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3312. * @apiSuccess { Object } data 数据
  3313. * @apiSuccess { Long } data.total 数据总数
  3314. * @apiSuccess { Object[] } data.list 数据列表
  3315. * @apiSuccess { Long } data.list.id id主键
  3316. * @apiSuccess { String } data.list.openid 用户openid
  3317. * @apiSuccess { Integer } data.list.number 编号,年+4位编号
  3318. * @apiSuccess { String } data.list.username 访客姓名
  3319. * @apiSuccess { String } data.list.userPhone 访客手机号
  3320. * @apiSuccess { String } data.list.company 访客公司
  3321. * @apiSuccess { Boolean } data.list.contact 是否密接
  3322. * @apiSuccess { Boolean } data.list.highRisk 是否高风险
  3323. * @apiSuccess { Boolean } data.list.confirm 是否确诊
  3324. * @apiSuccess { Date } data.list.entryTime 进入时间
  3325. * @apiSuccess { String } data.list.reason 事由
  3326. * @apiSuccess { Date } data.list.leaveTime 离开时间
  3327. * @apiSuccess { String } data.list.remark 出场备注
  3328. * @apiSuccess { String } data.list.images 图片
  3329. * @apiSuccess { String } message 信息
  3330. * @apiSuccess { Integer } code 状态码
  3331. * @apiSuccessExample Response
  3332. *
  3333. * {"data":{"total":1, "list":[{"id":1, "openid":"", "number":1, "username":"", "userPhone":"", "company":"", "contact":true, "highRisk":true, "confirm":true, "entryTime":1650761871435, "reason":"", "leaveTime":1650761871435, "remark":"", "images":""}]}, "message":"", "code":1}
  3334. */
  3335. /**
  3336. * @api {get} /v1/system/permissions/list/tree 01.获取所有权限-树形
  3337. * @apiName 获取所有权限-树形
  3338. * @apiGroup 系统设置-权限管理
  3339. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3340. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3341. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3342. * @apiVersion 1.0.0
  3343. * @apiSuccess { Object[] } data 数据
  3344. * @apiSuccess { Long } data.parentId 父级权限ID
  3345. * @apiSuccess { String } data.uri 请求路径
  3346. * @apiSuccess { Boolean } data.disabled 是否禁用
  3347. * @apiSuccess { Object[] } data.children 子级权限
  3348. * @apiSuccess { Long } data.children.parentId 父级权限ID
  3349. * @apiSuccess { String } data.children.uri 请求路径
  3350. * @apiSuccess { Boolean } data.children.disabled 是否禁用
  3351. * @apiSuccess { Object[] } data.children.children 子级权限
  3352. * @apiSuccess { Long } data.children.id 选项key
  3353. * @apiSuccess { String } data.children.name 选项值
  3354. * @apiSuccess { Long } data.id 选项key
  3355. * @apiSuccess { String } data.name 选项值
  3356. * @apiSuccess { String } message 信息
  3357. * @apiSuccess { Integer } code 状态码
  3358. * @apiSuccessExample Response
  3359. *
  3360. * {"data":[{"parentId":1, "uri":"", "disabled":true, "children":[{"parentId":1, "uri":"", "disabled":true, "children":[], "id":1, "name":""}], "id":1, "name":""}], "message":"", "code":1}
  3361. */
  3362. /**
  3363. * @api {put} /v1/system/permissions/update/enable 02.启用权限
  3364. * @apiName 启用权限
  3365. * @apiGroup 系统设置-权限管理
  3366. * @apiHeader {String = application/json} Content-Type = application/json
  3367. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3368. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3369. * @apiPermission 【/v1/system/permissions/update/enable#PUT】
  3370. * @apiVersion 1.0.0
  3371. * @apiBody { Long[] } ids 权限ID列表
  3372. * @apiSuccess { Boolean } data 数据
  3373. * @apiSuccess { String } message 信息
  3374. * @apiSuccess { Integer } code 状态码
  3375. * @apiSuccessExample Response
  3376. *
  3377. * {"data":true, "message":"", "code":1}
  3378. */
  3379. /**
  3380. * @api {post} /v1/system/role/add 01.添加角色-角色名称验证
  3381. * @apiName 添加角色-角色名称验证
  3382. * @apiGroup 系统设置-角色管理
  3383. * @apiHeader {String = application/json} Content-Type = application/json
  3384. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3385. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3386. * @apiPermission 【/v1/system/role/add#POST】
  3387. * @apiVersion 1.0.0
  3388. * @apiBody { String { 0..15 } } name 角色
  3389. * @apiSuccess { Boolean } data 数据
  3390. * @apiSuccess { String } message 信息
  3391. * @apiSuccess { Integer } code 状态码
  3392. * @apiSuccessExample Response
  3393. *
  3394. * {"data":true, "message":"", "code":1}
  3395. */
  3396. /**
  3397. * @api {delete} /v1/system/role/delete 02.删除角色
  3398. * @apiName 删除角色
  3399. * @apiGroup 系统设置-角色管理
  3400. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3401. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3402. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3403. * @apiPermission 【/v1/system/role/delete#DELETE】
  3404. * @apiVersion 1.0.0
  3405. * @apiQuery { Long[] { 1-2147483647 } } ids 角色id数组
  3406. * @apiSuccess { Boolean } data 数据
  3407. * @apiSuccess { String } message 信息
  3408. * @apiSuccess { Integer } code 状态码
  3409. * @apiSuccessExample Response
  3410. *
  3411. * {"data":true, "message":"", "code":1}
  3412. */
  3413. /**
  3414. * @api {get} /v1/system/role/list 03.查询角色列表
  3415. * @apiName 查询角色列表
  3416. * @apiGroup 系统设置-角色管理
  3417. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3418. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3419. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3420. * @apiPermission 【/v1/system/role/list#GET】
  3421. * @apiVersion 1.0.0
  3422. * @apiQuery { String } [ name ] 名称
  3423. * @apiQuery { Date } [ createTimeStart ] 创建时间 开始时间
  3424. * @apiQuery { Date } [ createTimeEnd ] 创建时间 结束时间
  3425. * @apiQuery { Boolean } [ disabled ] 是否禁用
  3426. * @apiQuery { String { ^[-+][\w]+ } } [ order = +id ] 排序规则(默认按ID正序),排序字段前加:+表示正序 -表示倒序
  3427. * @apiSuccess { Object[] } data 数据
  3428. * @apiSuccess { Long } data.id 角色ID
  3429. * @apiSuccess { String } data.name 名称
  3430. * @apiSuccess { Date } data.createTime 创建时间
  3431. * @apiSuccess { Boolean } data.disabled 是否禁用
  3432. * @apiSuccess { String } message 信息
  3433. * @apiSuccess { Integer } code 状态码
  3434. * @apiSuccessExample Response
  3435. *
  3436. * {"data":[{"id":1, "name":"", "createTime":1650761871435, "disabled":true}], "message":"", "code":1}
  3437. */
  3438. /**
  3439. * @api {put} /v1/system/role/update/status 04.更新角色禁用状态
  3440. * @apiName 更新角色禁用状态
  3441. * @apiGroup 系统设置-角色管理
  3442. * @apiHeader {String = application/json} Content-Type = application/json
  3443. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3444. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3445. * @apiPermission 【/v1/system/role/update/status#PUT】
  3446. * @apiVersion 1.0.0
  3447. * @apiBody { Long } id 数据ID
  3448. * @apiBody { Boolean } disabled 是否禁用
  3449. * @apiSuccess { Boolean } data 数据
  3450. * @apiSuccess { String } message 信息
  3451. * @apiSuccess { Integer } code 状态码
  3452. * @apiSuccessExample Response
  3453. *
  3454. * {"data":true, "message":"", "code":1}
  3455. */
  3456. /**
  3457. * @api {put} /v1/system/role/update 05.更新角色名称和权限
  3458. * @apiName 更新角色名称和权限
  3459. * @apiGroup 系统设置-角色管理
  3460. * @apiHeader {String = application/json} Content-Type = application/json
  3461. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3462. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3463. * @apiPermission 【/v1/system/role/update#PUT】
  3464. * @apiVersion 1.0.0
  3465. * @apiBody { Long { 2- } } id 角色ID
  3466. * @apiBody { Long[] } [ permissions ] 权限id集合
  3467. * @apiBody { String { 0..15 } } name 角色
  3468. * @apiSuccess { Boolean } data 数据
  3469. * @apiSuccess { String } message 信息
  3470. * @apiSuccess { Integer } code 状态码
  3471. * @apiSuccessExample Response
  3472. *
  3473. * {"data":true, "message":"", "code":1}
  3474. */
  3475. /**
  3476. * @api {get} /v1/system/role/list/:roleId/permissions 06.查询角色权限列表
  3477. * @apiName 查询角色权限列表
  3478. * @apiGroup 系统设置-角色管理
  3479. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3480. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3481. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3482. * @apiPermission 【/v1/system/role/list/{roleId}/permissions#GET】
  3483. * @apiVersion 1.0.0
  3484. * @apiParam { Long } roleId 角色ID
  3485. * @apiSuccess { Long[] } data 数据
  3486. * @apiSuccess { String } message 信息
  3487. * @apiSuccess { Integer } code 状态码
  3488. * @apiSuccessExample Response
  3489. *
  3490. * {"data":[1], "message":"", "code":1}
  3491. */
  3492. /**
  3493. * @api {get} /v1/system/role/list/option 07.查询所有角色选项
  3494. * @apiName 查询所有角色选项
  3495. * @apiGroup 系统设置-角色管理
  3496. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3497. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3498. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3499. * @apiVersion 1.0.0
  3500. * @apiSuccess { Object[] } data 数据
  3501. * @apiSuccess { Long } data.id 选项key
  3502. * @apiSuccess { String } data.name 选项值
  3503. * @apiSuccess { String } message 信息
  3504. * @apiSuccess { Integer } code 状态码
  3505. * @apiSuccessExample Response
  3506. *
  3507. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  3508. */
  3509. /**
  3510. * @api {post} /v1/system/dept/add 01.添加部门
  3511. * @apiName 添加部门
  3512. * @apiGroup 系统设置-部门管理
  3513. * @apiHeader {String = application/json} Content-Type = application/json
  3514. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3515. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3516. * @apiPermission 【/v1/system/dept/add#POST】
  3517. * @apiVersion 1.0.0
  3518. * @apiBody { String } name 名称
  3519. * @apiBody { Long } parentId 上级部门id
  3520. * @apiSuccess { Object } data 数据
  3521. * @apiSuccess { Long } data.id id主键
  3522. * @apiSuccess { String } data.name 名称
  3523. * @apiSuccess { Long } data.parentId 上级部门id
  3524. * @apiSuccess { String } message 信息
  3525. * @apiSuccess { Integer } code 状态码
  3526. * @apiSuccessExample Response
  3527. *
  3528. * {"data":{"id":1, "name":"", "parentId":1}, "message":"", "code":1}
  3529. */
  3530. /**
  3531. * @api {delete} /v1/system/dept/delete/:id 02.删除部门
  3532. * @apiName 删除部门
  3533. * @apiGroup 系统设置-部门管理
  3534. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3535. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3536. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3537. * @apiPermission 【/v1/system/dept/delete/{id}#DELETE】
  3538. * @apiVersion 1.0.0
  3539. * @apiParam { Long } id 部门id
  3540. * @apiSuccess { Boolean } data 数据
  3541. * @apiSuccess { String } message 信息
  3542. * @apiSuccess { Integer } code 状态码
  3543. * @apiSuccessExample Response
  3544. *
  3545. * {"data":true, "message":"", "code":1}
  3546. */
  3547. /**
  3548. * @api {put} /v1/system/dept/update 03.更新部门
  3549. * @apiName 更新部门
  3550. * @apiGroup 系统设置-部门管理
  3551. * @apiHeader {String = application/json} Content-Type = application/json
  3552. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3553. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3554. * @apiPermission 【/v1/system/dept/update#PUT】
  3555. * @apiVersion 1.0.0
  3556. * @apiBody { Long } id 部门id
  3557. * @apiBody { String } name 名称
  3558. * @apiSuccess { Boolean } data 数据
  3559. * @apiSuccess { String } message 信息
  3560. * @apiSuccess { Integer } code 状态码
  3561. * @apiSuccessExample Response
  3562. *
  3563. * {"data":true, "message":"", "code":1}
  3564. */
  3565. /**
  3566. * @api {get} /v1/system/dept/list/tree 04.查询部门树
  3567. * @apiName 查询部门树
  3568. * @apiGroup 系统设置-部门管理
  3569. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3570. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3571. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3572. * @apiVersion 1.0.0
  3573. * @apiSuccess { Object[] } data 数据
  3574. * @apiSuccess { Long } data.parentId 父级部门ID
  3575. * @apiSuccess { Object[] } data.children 子级部门
  3576. * @apiSuccess { Long } data.children.parentId 父级部门ID
  3577. * @apiSuccess { Object[] } data.children.children 子级部门
  3578. * @apiSuccess { Long } data.children.id 选项key
  3579. * @apiSuccess { String } data.children.name 选项值
  3580. * @apiSuccess { Long } data.id 选项key
  3581. * @apiSuccess { String } data.name 选项值
  3582. * @apiSuccess { String } message 信息
  3583. * @apiSuccess { Integer } code 状态码
  3584. * @apiSuccessExample Response
  3585. *
  3586. * {"data":[{"parentId":1, "children":[{"parentId":1, "children":[], "id":1, "name":""}], "id":1, "name":""}], "message":"", "code":1}
  3587. */
  3588. /**
  3589. * @api {get} /v1/system/user/check/authorize 01.用户授权验证
  3590. * @apiName 用户授权验证
  3591. * @apiGroup 系统设置-用户管理
  3592. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3593. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3594. * @apiVersion 1.0.0
  3595. */
  3596. /**
  3597. * @api {post} /v1/system/user/register 02.注册
  3598. * @apiName 注册
  3599. * @apiGroup 系统设置-用户管理
  3600. * @apiHeader {String = application/json} Content-Type = application/json
  3601. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3602. * @apiVersion 1.0.0
  3603. * @apiBody { String { 6..20 } } username 用户名
  3604. * @apiBody { String { 32..2147483647 } } password 用户密码(md5加密)
  3605. * @apiBody { String { ^1[3|45789][0-9]\d{8}$ } } telephone 手机号
  3606. * @apiBody { Long[] { 1-2147483647 } } roles 用户角色
  3607. * @apiSuccess { Boolean } data 数据
  3608. * @apiSuccess { String } message 信息
  3609. * @apiSuccess { Integer } code 状态码
  3610. * @apiSuccessExample Response
  3611. *
  3612. * {"data":true, "message":"", "code":1}
  3613. */
  3614. /**
  3615. * @api {post} /v1/system/user/add 03.添加用户
  3616. * @apiName 添加用户
  3617. * @apiGroup 系统设置-用户管理
  3618. * @apiHeader {String = application/json} Content-Type = application/json
  3619. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3620. * @apiVersion 1.0.0
  3621. * @apiBody { String { 2..20 } } username 用户名
  3622. * @apiBody { String { ^1[3|45789][0-9]\d{8}$ } } telephone 手机号
  3623. * @apiBody { String { 32..2147483647 } } password 用户密码(md5加密)
  3624. * @apiBody { Long } [ deptId ] 用户部门
  3625. * @apiBody { Long[] { 1-2147483647 } } roles 用户角色
  3626. * @apiSuccess { Boolean } data 数据
  3627. * @apiSuccess { String } message 信息
  3628. * @apiSuccess { Integer } code 状态码
  3629. * @apiSuccessExample Response
  3630. *
  3631. * {"data":true, "message":"", "code":1}
  3632. */
  3633. /**
  3634. * @api {post} /v1/system/user/login 04.登录
  3635. * @apiName 登录
  3636. * @apiGroup 系统设置-用户管理
  3637. * @apiHeader {String = application/json} Content-Type = application/json
  3638. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3639. * @apiVersion 1.0.0
  3640. * @apiBody { String } [ username ] 用户名
  3641. * @apiBody { String } [ telephone ] 手机号码
  3642. * @apiBody { String } password 用户密码(md5加密)
  3643. * @apiSuccess { Object } data 数据
  3644. * @apiSuccess { Long } data.id 用户id
  3645. * @apiSuccess { String } data.username 用户名称
  3646. * @apiSuccess { String } data.telephone 手机号
  3647. * @apiSuccess { String } data.token 授权信息
  3648. * @apiSuccess { String[] } data.permissions 权限列表
  3649. * @apiSuccess { String } message 信息
  3650. * @apiSuccess { Integer } code 状态码
  3651. * @apiSuccessExample Response
  3652. *
  3653. * {"data":{"id":1, "username":"", "telephone":"", "token":"", "permissions":[""]}, "message":"", "code":1}
  3654. */
  3655. /**
  3656. * @api {get} /v1/system/user/query/:userId 05.查询用户信息
  3657. * @apiName 查询用户信息
  3658. * @apiGroup 系统设置-用户管理
  3659. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3660. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3661. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3662. * @apiPermission 【/v1/system/user/query/{userId}#GET】
  3663. * @apiVersion 1.0.0
  3664. * @apiParam { Long { 2- } } userId 用户ID
  3665. * @apiSuccess { Object } data 数据
  3666. * @apiSuccess { Long } data.id 用户ID
  3667. * @apiSuccess { String } data.username 用户名
  3668. * @apiSuccess { String } data.telephone 手机号
  3669. * @apiSuccess { Long } data.deptId 部门id
  3670. * @apiSuccess { String } data.deptName 部门名称
  3671. * @apiSuccess { Boolean } data.disabled 是否禁用
  3672. * @apiSuccess { Date } data.createTime 创建时间
  3673. * @apiSuccess { Object[] } data.roles 角色列表
  3674. * @apiSuccess { Long } data.roles.id 选项key
  3675. * @apiSuccess { String } data.roles.name 选项值
  3676. * @apiSuccess { String } message 信息
  3677. * @apiSuccess { Integer } code 状态码
  3678. * @apiSuccessExample Response
  3679. *
  3680. * {"data":{"id":1, "username":"", "telephone":"", "deptId":1, "deptName":"", "disabled":true, "createTime":1650761871436, "roles":[{"id":1, "name":""}]}, "message":"", "code":1}
  3681. */
  3682. /**
  3683. * @api {get} /v1/system/user/list 06.分页查询用户列表
  3684. * @apiName 分页查询用户列表
  3685. * @apiGroup 系统设置-用户管理
  3686. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3687. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3688. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3689. * @apiPermission 【/v1/system/user/list#GET】
  3690. * @apiVersion 1.0.0
  3691. * @apiQuery { Long } [ roleId ] 角色
  3692. * @apiQuery { Long } [ deptId ] 部门
  3693. * @apiQuery { String } [ username ] 用户名
  3694. * @apiQuery { String } [ telephone ] 手机号
  3695. * @apiQuery { Boolean } [ disabled ] 是否禁用
  3696. * @apiQuery { Date } [ createTimeStart ] 创建时间 开始时间
  3697. * @apiQuery { Date } [ createTimeEnd ] 创建时间 结束时间
  3698. * @apiQuery { Integer } [ page = 1 ] 页码
  3699. * @apiQuery { Integer } [ size = 10 ] 页大小
  3700. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3701. * @apiSuccess { Object } data 数据
  3702. * @apiSuccess { Long } data.total 数据总数
  3703. * @apiSuccess { Object[] } data.list 数据列表
  3704. * @apiSuccess { Long } data.list.id 用户ID
  3705. * @apiSuccess { String } data.list.username 用户名
  3706. * @apiSuccess { String } data.list.telephone 手机号
  3707. * @apiSuccess { Long } data.list.deptId 部门id
  3708. * @apiSuccess { String } data.list.deptName 部门名称
  3709. * @apiSuccess { Boolean } data.list.disabled 是否禁用
  3710. * @apiSuccess { Date } data.list.createTime 创建时间
  3711. * @apiSuccess { Object[] } data.list.roles 角色列表
  3712. * @apiSuccess { Long } data.list.roles.id 选项key
  3713. * @apiSuccess { String } data.list.roles.name 选项值
  3714. * @apiSuccess { String } message 信息
  3715. * @apiSuccess { Integer } code 状态码
  3716. * @apiSuccessExample Response
  3717. *
  3718. * {"data":{"total":1, "list":[{"id":1, "username":"", "telephone":"", "deptId":1, "deptName":"", "disabled":true, "createTime":1650761871436, "roles":[{"id":1, "name":""}]}]}, "message":"", "code":1}
  3719. */
  3720. /**
  3721. * @api {delete} /v1/system/user/delete 07.删除多个用户
  3722. * @apiName 删除多个用户
  3723. * @apiGroup 系统设置-用户管理
  3724. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3725. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3726. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3727. * @apiPermission 【/v1/system/user/delete#DELETE】
  3728. * @apiVersion 1.0.0
  3729. * @apiQuery { Long[] { 1-2147483647 } } ids 用户id数组
  3730. * @apiSuccess { Boolean } data 数据
  3731. * @apiSuccess { String } message 信息
  3732. * @apiSuccess { Integer } code 状态码
  3733. * @apiSuccessExample Response
  3734. *
  3735. * {"data":true, "message":"", "code":1}
  3736. */
  3737. /**
  3738. * @api {delete} /v1/system/user/delete/:id 08.删除用户
  3739. * @apiName 删除用户
  3740. * @apiGroup 系统设置-用户管理
  3741. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3742. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3743. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3744. * @apiPermission 【/v1/system/user/delete/{id}#DELETE】
  3745. * @apiVersion 1.0.0
  3746. * @apiParam { Long { 2- } } id 用户id
  3747. * @apiSuccess { Boolean } data 数据
  3748. * @apiSuccess { String } message 信息
  3749. * @apiSuccess { Integer } code 状态码
  3750. * @apiSuccessExample Response
  3751. *
  3752. * {"data":true, "message":"", "code":1}
  3753. */
  3754. /**
  3755. * @api {put} /v1/system/user/update/status 09.更新用户禁用状态
  3756. * @apiName 更新用户禁用状态
  3757. * @apiGroup 系统设置-用户管理
  3758. * @apiHeader {String = application/json} Content-Type = application/json
  3759. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3760. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3761. * @apiPermission 【/v1/system/user/update/status#PUT】
  3762. * @apiVersion 1.0.0
  3763. * @apiBody { Long } id 数据ID
  3764. * @apiBody { Boolean } disabled 是否禁用
  3765. * @apiSuccess { Boolean } data 数据
  3766. * @apiSuccess { String } message 信息
  3767. * @apiSuccess { Integer } code 状态码
  3768. * @apiSuccessExample Response
  3769. *
  3770. * {"data":true, "message":"", "code":1}
  3771. */
  3772. /**
  3773. * @api {put} /v1/system/user/update 10.更新用户信息
  3774. * @apiName 更新用户信息
  3775. * @apiGroup 系统设置-用户管理
  3776. * @apiHeader {String = application/json} Content-Type = application/json
  3777. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3778. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3779. * @apiPermission 【/v1/system/user/update#PUT】
  3780. * @apiVersion 1.0.0
  3781. * @apiBody { Long } id 用户id
  3782. * @apiBody { String { 2..20 } } username 用户名
  3783. * @apiBody { String { ^1[3|45789][0-9]\d{8}$ } } telephone 手机号
  3784. * @apiBody { Long } [ deptId ] 用户部门
  3785. * @apiBody { Long[] { 1-2147483647 } } roles 用户角色
  3786. * @apiSuccess { Boolean } data 数据
  3787. * @apiSuccess { String } message 信息
  3788. * @apiSuccess { Integer } code 状态码
  3789. * @apiSuccessExample Response
  3790. *
  3791. * {"data":true, "message":"", "code":1}
  3792. */
  3793. /**
  3794. * @api {get} /v1/system/user/list/option 11.通过用户名或手机号查询用户选项
  3795. * @apiName 通过用户名或手机号查询用户选项
  3796. * @apiGroup 系统设置-用户管理
  3797. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3798. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3799. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3800. * @apiVersion 1.0.0
  3801. * @apiQuery { String } keyword 用户名或手机号
  3802. * @apiSuccess { Object[] } data 数据
  3803. * @apiSuccess { Long } data.id 选项key
  3804. * @apiSuccess { String } data.name 选项值
  3805. * @apiSuccess { String } message 信息
  3806. * @apiSuccess { Integer } code 状态码
  3807. * @apiSuccessExample Response
  3808. *
  3809. * {"data":[{"id":1, "name":""}], "message":"", "code":1}
  3810. */
  3811. /**
  3812. * @api {delete} /v1/system/user/comment/delete/:id 01.删除用户评价
  3813. * @apiName 删除用户评价
  3814. * @apiGroup 系统设置-用户评价
  3815. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3816. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3817. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3818. * @apiPermission 【/v1/system/user/comment/delete/{id}#DELETE】
  3819. * @apiVersion 1.0.0
  3820. * @apiParam { Long } id 用户评价id
  3821. * @apiSuccess { Boolean } data 数据
  3822. * @apiSuccess { String } message 信息
  3823. * @apiSuccess { Integer } code 状态码
  3824. * @apiSuccessExample Response
  3825. *
  3826. * {"data":true, "message":"", "code":1}
  3827. */
  3828. /**
  3829. * @api {delete} /v1/system/user/comment/delete 02.删除多条用户评价
  3830. * @apiName 删除多条用户评价
  3831. * @apiGroup 系统设置-用户评价
  3832. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3833. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3834. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3835. * @apiPermission 【/v1/system/user/comment/delete#DELETE】
  3836. * @apiVersion 1.0.0
  3837. * @apiQuery { Long[] { 1-2147483647 } } ids 用户评价id数组
  3838. * @apiSuccess { Boolean } data 数据
  3839. * @apiSuccess { String } message 信息
  3840. * @apiSuccess { Integer } code 状态码
  3841. * @apiSuccessExample Response
  3842. *
  3843. * {"data":true, "message":"", "code":1}
  3844. */
  3845. /**
  3846. * @api {get} /v1/system/user/comment/list 03.分页查询用户评价
  3847. * @apiName 分页查询用户评价
  3848. * @apiGroup 系统设置-用户评价
  3849. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3850. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3851. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3852. * @apiPermission 【/v1/system/user/comment/list#GET】
  3853. * @apiVersion 1.0.0
  3854. * @apiQuery { Long } [ userId ] 评价人id
  3855. * @apiQuery { String } [ username ] 评价人姓名
  3856. * @apiQuery { Long } [ respondentUserId ] 被评价人id
  3857. * @apiQuery { String } [ respondentUsername ] 被评价人姓名
  3858. * @apiQuery { String } [ content ] 评论内容
  3859. * @apiQuery { Integer } [ score ] 评论分数
  3860. * @apiQuery { Date } [ createTimeStart ] 评论时间 开始时间
  3861. * @apiQuery { Date } [ createTimeEnd ] 评论时间 结束时间
  3862. * @apiQuery { String } [ images ] 评论图片地址数组
  3863. * @apiQuery { Integer } [ page = 1 ] 页码
  3864. * @apiQuery { Integer } [ size = 10 ] 页大小
  3865. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3866. * @apiSuccess { Object } data 数据
  3867. * @apiSuccess { Long } data.total 数据总数
  3868. * @apiSuccess { Object[] } data.list 数据列表
  3869. * @apiSuccess { Long } data.list.id id主键
  3870. * @apiSuccess { Long } data.list.userId 评价人id
  3871. * @apiSuccess { String } data.list.username 评价人姓名
  3872. * @apiSuccess { Long } data.list.respondentUserId 被评价人id
  3873. * @apiSuccess { String } data.list.respondentUsername 被评价人姓名
  3874. * @apiSuccess { String } data.list.content 评论内容
  3875. * @apiSuccess { Integer } data.list.score 评论分数
  3876. * @apiSuccess { Date } data.list.createTime 评论时间
  3877. * @apiSuccess { String } data.list.images 评论图片地址数组
  3878. * @apiSuccess { String } message 信息
  3879. * @apiSuccess { Integer } code 状态码
  3880. * @apiSuccessExample Response
  3881. *
  3882. * {"data":{"total":1, "list":[{"id":1, "userId":1, "username":"", "respondentUserId":1, "respondentUsername":"", "content":"", "score":1, "createTime":1650761871437, "images":""}]}, "message":"", "code":1}
  3883. */
  3884. /**
  3885. * @api {delete} /v1/system/login/log/delete/:id 01.删除登录日志
  3886. * @apiName 删除登录日志
  3887. * @apiGroup 系统设置-登录日志管理
  3888. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3889. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3890. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3891. * @apiPermission 【/v1/system/login/log/delete/{id}#DELETE】
  3892. * @apiVersion 1.0.0
  3893. * @apiParam { Long } id 登录日志id
  3894. * @apiSuccess { Boolean } data 数据
  3895. * @apiSuccess { String } message 信息
  3896. * @apiSuccess { Integer } code 状态码
  3897. * @apiSuccessExample Response
  3898. *
  3899. * {"data":true, "message":"", "code":1}
  3900. */
  3901. /**
  3902. * @api {delete} /v1/system/login/log/delete 02.删除多条登录日志
  3903. * @apiName 删除多条登录日志
  3904. * @apiGroup 系统设置-登录日志管理
  3905. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3906. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3907. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3908. * @apiPermission 【/v1/system/login/log/delete#DELETE】
  3909. * @apiVersion 1.0.0
  3910. * @apiQuery { Long[] { 1-2147483647 } } ids 登录日志id数组
  3911. * @apiSuccess { Boolean } data 数据
  3912. * @apiSuccess { String } message 信息
  3913. * @apiSuccess { Integer } code 状态码
  3914. * @apiSuccessExample Response
  3915. *
  3916. * {"data":true, "message":"", "code":1}
  3917. */
  3918. /**
  3919. * @api {get} /v1/system/login/log/list 03.分页查询登录日志
  3920. * @apiName 分页查询登录日志
  3921. * @apiGroup 系统设置-登录日志管理
  3922. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3923. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3924. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3925. * @apiPermission 【/v1/system/login/log/list#GET】
  3926. * @apiVersion 1.0.0
  3927. * @apiQuery { Long } [ userId ] 用户ID
  3928. * @apiQuery { Integer } [ platform ] 平台类型 1:管理端 2:小程序端
  3929. * @apiQuery { Date } [ loginTimeStart ] 登录时间 开始时间
  3930. * @apiQuery { Date } [ loginTimeEnd ] 登录时间 结束时间
  3931. * @apiQuery { String } [ ip ] 用户IP
  3932. * @apiQuery { String } [ address ] 地址
  3933. * @apiQuery { Integer } [ page = 1 ] 页码
  3934. * @apiQuery { Integer } [ size = 10 ] 页大小
  3935. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  3936. * @apiSuccess { Object } data 数据
  3937. * @apiSuccess { Long } data.total 数据总数
  3938. * @apiSuccess { Object[] } data.list 数据列表
  3939. * @apiSuccess { Long } data.list.id 登录日志ID
  3940. * @apiSuccess { Long } data.list.userId 用户ID
  3941. * @apiSuccess { Integer } data.list.platform 平台类型 1:管理端 2:小程序端
  3942. * @apiSuccess { Date } data.list.loginTime 登录时间
  3943. * @apiSuccess { String } data.list.ip 用户IP
  3944. * @apiSuccess { String } data.list.address 地址
  3945. * @apiSuccess { String } message 信息
  3946. * @apiSuccess { Integer } code 状态码
  3947. * @apiSuccessExample Response
  3948. *
  3949. * {"data":{"total":1, "list":[{"id":1, "userId":1, "platform":1, "loginTime":1650761871437, "ip":"", "address":""}]}, "message":"", "code":1}
  3950. */
  3951. /**
  3952. * @api {delete} /v1/system/log/delete/:id 01.删除操作日志
  3953. * @apiName 删除操作日志
  3954. * @apiGroup 系统设置-操作日志管理
  3955. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3956. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3957. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3958. * @apiPermission 【/v1/system/log/delete/{id}#DELETE】
  3959. * @apiVersion 1.0.0
  3960. * @apiParam { Long } id 操作日志id
  3961. * @apiSuccess { Boolean } data 数据
  3962. * @apiSuccess { String } message 信息
  3963. * @apiSuccess { Integer } code 状态码
  3964. * @apiSuccessExample Response
  3965. *
  3966. * {"data":true, "message":"", "code":1}
  3967. */
  3968. /**
  3969. * @api {delete} /v1/system/log/delete 02.删除多条操作日志
  3970. * @apiName 删除多条操作日志
  3971. * @apiGroup 系统设置-操作日志管理
  3972. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3973. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3974. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3975. * @apiPermission 【/v1/system/log/delete#DELETE】
  3976. * @apiVersion 1.0.0
  3977. * @apiQuery { Long[] { 1-2147483647 } } ids 操作日志id数组
  3978. * @apiSuccess { Boolean } data 数据
  3979. * @apiSuccess { String } message 信息
  3980. * @apiSuccess { Integer } code 状态码
  3981. * @apiSuccessExample Response
  3982. *
  3983. * {"data":true, "message":"", "code":1}
  3984. */
  3985. /**
  3986. * @api {get} /v1/system/log/list 03.分页查询操作日志
  3987. * @apiName 分页查询操作日志
  3988. * @apiGroup 系统设置-操作日志管理
  3989. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  3990. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  3991. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  3992. * @apiPermission 【/v1/system/log/list#GET】
  3993. * @apiVersion 1.0.0
  3994. * @apiQuery { Long } [ userId ] 用户ID
  3995. * @apiQuery { String } [ userIp ] 用户IP
  3996. * @apiQuery { String } [ method ] 请求类型
  3997. * @apiQuery { Integer } [ platform ] 平台类型 1:管理端 2:小程序端
  3998. * @apiQuery { String } [ uri ] 请求接口名
  3999. * @apiQuery { Boolean } [ success ] 是否请求成功
  4000. * @apiQuery { Long } [ time ] 请求耗时
  4001. * @apiQuery { String } [ fileName ] 异常文件
  4002. * @apiQuery { Integer } [ lineNumber ] 异常行号
  4003. * @apiQuery { Date } [ createTimeStart ] 请求时间 开始时间
  4004. * @apiQuery { Date } [ createTimeEnd ] 请求时间 结束时间
  4005. * @apiQuery { String } [ request ] 请求参数
  4006. * @apiQuery { String } [ response ] 响应结果
  4007. * @apiQuery { Integer } [ page = 1 ] 页码
  4008. * @apiQuery { Integer } [ size = 10 ] 页大小
  4009. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  4010. * @apiSuccess { Object } data 数据
  4011. * @apiSuccess { Long } data.total 数据总数
  4012. * @apiSuccess { Object[] } data.list 数据列表
  4013. * @apiSuccess { Long } data.list.id 日志ID
  4014. * @apiSuccess { Long } data.list.userId 用户ID
  4015. * @apiSuccess { String } data.list.userIp 用户IP
  4016. * @apiSuccess { String } data.list.method 请求类型
  4017. * @apiSuccess { Integer } data.list.platform 平台类型 1:管理端 2:小程序端
  4018. * @apiSuccess { String } data.list.uri 请求接口名
  4019. * @apiSuccess { Boolean } data.list.success 是否请求成功
  4020. * @apiSuccess { Long } data.list.time 请求耗时
  4021. * @apiSuccess { String } data.list.fileName 异常文件
  4022. * @apiSuccess { Integer } data.list.lineNumber 异常行号
  4023. * @apiSuccess { Date } data.list.createTime 请求时间
  4024. * @apiSuccess { String } data.list.request 请求参数
  4025. * @apiSuccess { String } data.list.response 响应结果
  4026. * @apiSuccess { String } message 信息
  4027. * @apiSuccess { Integer } code 状态码
  4028. * @apiSuccessExample Response
  4029. *
  4030. * {"data":{"total":1, "list":[{"id":1, "userId":1, "userIp":"", "method":"", "platform":1, "uri":"", "success":true, "time":1, "fileName":"", "lineNumber":1, "createTime":1650761871437, "request":"", "response":""}]}, "message":"", "code":1}
  4031. */
  4032. /**
  4033. * @api {post} /v1/system/attendance/score 01.评分
  4034. * @apiName 评分
  4035. * @apiGroup 系统设置-考勤管理
  4036. * @apiHeader {String = application/json} Content-Type = application/json
  4037. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4038. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4039. * @apiPermission 【/v1/system/attendance/score#POST】
  4040. * @apiVersion 1.0.0
  4041. * @apiBody { Long } userId 用户id
  4042. * @apiBody { String { ^[0-9]{4}-(0[1-9]|1[0-2])$ } } month 考勤月份 yyyy-MM
  4043. * @apiBody { Integer } changeScore 变动分值
  4044. * @apiBody { String } event 事件
  4045. * @apiSuccess { Object } data 数据
  4046. * @apiSuccess { Long } data.id id 主键
  4047. * @apiSuccess { Long } data.userId 用户id
  4048. * @apiSuccess { Integer } data.lastScore 上次分值
  4049. * @apiSuccess { Integer } data.changeScore 变动分值
  4050. * @apiSuccess { Integer } data.currentScore 当前分值
  4051. * @apiSuccess { String } data.month 考勤年月
  4052. * @apiSuccess { Integer } data.type 考勤类型 1:任务 2:手动
  4053. * @apiSuccess { String } data.event 事件
  4054. * @apiSuccess { Date } data.createTime 创建时间
  4055. * @apiSuccess { String } message 信息
  4056. * @apiSuccess { Integer } code 状态码
  4057. * @apiSuccessExample Response
  4058. *
  4059. * {"data":{"id":1, "userId":1, "lastScore":1, "changeScore":1, "currentScore":1, "month":"", "type":1, "event":"", "createTime":1650761871437}, "message":"", "code":1}
  4060. */
  4061. /**
  4062. * @api {get} /v1/system/attendance/list/statistical 02.分页查询考勤统计
  4063. * @apiName 分页查询考勤统计
  4064. * @apiGroup 系统设置-考勤管理
  4065. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4066. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4067. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4068. * @apiPermission 【/v1/system/attendance/list/statistical#GET】
  4069. * @apiVersion 1.0.0
  4070. * @apiQuery { String { ^[0-9]{4}-(0[1-9]|1[0-2])$ } } [ month ] 考勤年月
  4071. * @apiQuery { String } [ username ] 用户名
  4072. * @apiQuery { Integer } [ page = 1 ] 页码
  4073. * @apiQuery { Integer } [ size = 10 ] 页大小
  4074. * @apiQuery { String { ^[-+][\w]+ } } [ order = -month ] 排序规则(默认month倒序),排序字段前加:+表示正序 -表示倒序
  4075. * @apiSuccess { Object } data 数据
  4076. * @apiSuccess { Long } data.total 数据总数
  4077. * @apiSuccess { Object[] } data.list 数据列表
  4078. * @apiSuccess { Long } data.list.userId 用户id
  4079. * @apiSuccess { String } data.list.username 用户姓名
  4080. * @apiSuccess { String } data.list.telephone 手机号
  4081. * @apiSuccess { Integer } data.list.score 本月评分
  4082. * @apiSuccess { String } data.list.month 考勤年月
  4083. * @apiSuccess { String } message 信息
  4084. * @apiSuccess { Integer } code 状态码
  4085. * @apiSuccessExample Response
  4086. *
  4087. * {"data":{"total":1, "list":[{"userId":1, "username":"", "telephone":"", "score":1, "month":""}]}, "message":"", "code":1}
  4088. */
  4089. /**
  4090. * @api {get} /v1/system/attendance/list 03.分页查询考勤
  4091. * @apiName 分页查询考勤
  4092. * @apiGroup 系统设置-考勤管理
  4093. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4094. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4095. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4096. * @apiPermission 【/v1/system/attendance/list#GET】
  4097. * @apiVersion 1.0.0
  4098. * @apiQuery { String { ^[0-9]{4}-(0[1-9]|1[0-2])$ } } month 考勤年月
  4099. * @apiQuery { Long } userId 用户id
  4100. * @apiQuery { Integer } [ page = 1 ] 页码
  4101. * @apiQuery { Integer } [ size = 10 ] 页大小
  4102. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  4103. * @apiSuccess { Object } data 数据
  4104. * @apiSuccess { Long } data.total 数据总数
  4105. * @apiSuccess { Object[] } data.list 数据列表
  4106. * @apiSuccess { Long } data.list.id id 主键
  4107. * @apiSuccess { Long } data.list.userId 用户id
  4108. * @apiSuccess { Integer } data.list.lastScore 上次分值
  4109. * @apiSuccess { Integer } data.list.changeScore 变动分值
  4110. * @apiSuccess { Integer } data.list.currentScore 当前分值
  4111. * @apiSuccess { String } data.list.month 考勤年月
  4112. * @apiSuccess { Integer } data.list.type 考勤类型 1:任务 2:手动
  4113. * @apiSuccess { String } data.list.event 事件
  4114. * @apiSuccess { Date } data.list.createTime 创建时间
  4115. * @apiSuccess { String } message 信息
  4116. * @apiSuccess { Integer } code 状态码
  4117. * @apiSuccessExample Response
  4118. *
  4119. * {"data":{"total":1, "list":[{"id":1, "userId":1, "lastScore":1, "changeScore":1, "currentScore":1, "month":"", "type":1, "event":"", "createTime":1650761871439}]}, "message":"", "code":1}
  4120. */
  4121. /**
  4122. * @api {put} /v1/system/pue/update 01.更新电量
  4123. * @apiName 更新电量
  4124. * @apiGroup 系统设置-PUE管理
  4125. * @apiHeader {String = application/json} Content-Type = application/json
  4126. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4127. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4128. * @apiPermission 【/v1/system/pue/update#PUT】
  4129. * @apiVersion 1.0.0
  4130. * @apiBody { Date } month 年月
  4131. * @apiBody { Float } electricityIt it用电量
  4132. * @apiBody { Float } electricityTotal 总用电量
  4133. * @apiSuccess { Object } data 数据
  4134. * @apiSuccess { Long } data.id id主键
  4135. * @apiSuccess { Float } data.electricityIt it用电量
  4136. * @apiSuccess { Float } data.electricityTotal 总用电量
  4137. * @apiSuccess { Date } data.month 年月
  4138. * @apiSuccess { String } message 信息
  4139. * @apiSuccess { Integer } code 状态码
  4140. * @apiSuccessExample Response
  4141. *
  4142. * {"data":{"id":1, "electricityIt":1.0, "electricityTotal":1.0, "month":1650761871439}, "message":"", "code":1}
  4143. */
  4144. /**
  4145. * @api {get} /v1/system/pue/list/statistical 02.分页查询电量统计数据
  4146. * @apiName 分页查询电量统计数据
  4147. * @apiGroup 系统设置-PUE管理
  4148. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4149. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4150. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4151. * @apiPermission 【/v1/system/pue/list/statistical#GET】
  4152. * @apiVersion 1.0.0
  4153. * @apiQuery { Date } [ time ] 年
  4154. * @apiQuery { Integer } [ page = 1 ] 页码
  4155. * @apiQuery { Integer } [ size = 10 ] 页大小
  4156. * @apiQuery { String { ^[-+][\w]+ } } [ order = -month ] 排序规则(默认month倒序),排序字段前加:+表示正序 -表示倒序
  4157. * @apiSuccess { Object } data 数据
  4158. * @apiSuccess { Long } data.total 数据总数
  4159. * @apiSuccess { Object[] } data.list 数据列表
  4160. * @apiSuccess { String } data.list.year 年
  4161. * @apiSuccess { String } data.list.month 月
  4162. * @apiSuccess { Float } data.list.electricityIt it用电量
  4163. * @apiSuccess { Float } data.list.electricityTotal 总用电量
  4164. * @apiSuccess { String } message 信息
  4165. * @apiSuccess { Integer } code 状态码
  4166. * @apiSuccessExample Response
  4167. *
  4168. * {"data":{"total":1, "list":[{"year":"", "month":"", "electricityIt":1.0, "electricityTotal":1.0}]}, "message":"", "code":1}
  4169. */
  4170. /**
  4171. * @api {get} /v1/system/status 01.系统状态
  4172. * @apiName 系统状态
  4173. * @apiGroup 系统设置-系统信息
  4174. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4175. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4176. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4177. * @apiPermission 【/v1/system/status#GET】
  4178. * @apiVersion 1.0.0
  4179. * @apiSuccess { Object } data 数据
  4180. * @apiSuccess { Object } data.cpu CPU信息
  4181. * @apiSuccess { String } data.cpu.name 名称
  4182. * @apiSuccess { Integer } data.cpu.pack 物理CPU数
  4183. * @apiSuccess { Integer } data.cpu.core 物理核心数
  4184. * @apiSuccess { Integer } data.cpu.coreNumber 核心数
  4185. * @apiSuccess { Integer } data.cpu.logic 逻辑CPU数
  4186. * @apiSuccess { String } data.cpu.usageRate CPU用户使用率
  4187. * @apiSuccess { String } data.cpu.idle CPU当前空闲率
  4188. * @apiSuccess { Object } data.memory 內存信息
  4189. * @apiSuccess { String } data.memory.total 内存总量
  4190. * @apiSuccess { String } data.memory.available 剩余内存
  4191. * @apiSuccess { String } data.memory.used 已用内存
  4192. * @apiSuccess { String } data.memory.usageRate 使用率
  4193. * @apiSuccess { Object } data.sys 服务器信息
  4194. * @apiSuccess { String } data.sys.os 操作系统
  4195. * @apiSuccess { String } data.sys.time 服务器运行时间
  4196. * @apiSuccess { String } data.sys.ip 服务器Ip
  4197. * @apiSuccess { String } data.sys.dir 项目路径
  4198. * @apiSuccess { Object } data.swap 交换区信息
  4199. * @apiSuccess { String } data.swap.total 内存总量
  4200. * @apiSuccess { String } data.swap.available 剩余内存
  4201. * @apiSuccess { String } data.swap.used 已用内存
  4202. * @apiSuccess { String } data.swap.usageRate 使用率
  4203. * @apiSuccess { Object } data.disk 磁盘信息
  4204. * @apiSuccess { String } data.disk.total 磁盘总量
  4205. * @apiSuccess { String } data.disk.available 剩余容量
  4206. * @apiSuccess { String } data.disk.used 已用容量
  4207. * @apiSuccess { String } data.disk.usageRate 使用率
  4208. * @apiSuccess { Date } data.time 时间
  4209. * @apiSuccess { String } message 信息
  4210. * @apiSuccess { Integer } code 状态码
  4211. * @apiSuccessExample Response
  4212. *
  4213. * {"data":{"cpu":{"name":"", "pack":1, "core":1, "coreNumber":1, "logic":1, "usageRate":"", "idle":""}, "memory":{"total":"", "available":"", "used":"", "usageRate":""}, "sys":{"os":"", "time":"", "ip":"", "dir":""}, "swap":{"total":"", "available":"", "used":"", "usageRate":""}, "disk":{"total":"", "available":"", "used":"", "usageRate":""}, "time":1650761871439}, "message":"", "code":1}
  4214. */
  4215. /**
  4216. * @api {post} /v1/system/database/backup/add 01.添加数据备份
  4217. * @apiName 添加数据备份
  4218. * @apiGroup 系统设置-数据备份
  4219. * @apiHeader {String = application/json} Content-Type = application/json
  4220. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4221. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4222. * @apiPermission 【/v1/system/database/backup/add#POST】
  4223. * @apiVersion 1.0.0
  4224. * @apiBody { String } remark 备注
  4225. * @apiSuccess { Boolean } data 数据
  4226. * @apiSuccess { String } message 信息
  4227. * @apiSuccess { Integer } code 状态码
  4228. * @apiSuccessExample Response
  4229. *
  4230. * {"data":true, "message":"", "code":1}
  4231. */
  4232. /**
  4233. * @api {delete} /v1/system/database/backup/delete/:id 02.删除数据备份
  4234. * @apiName 删除数据备份
  4235. * @apiGroup 系统设置-数据备份
  4236. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4237. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4238. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4239. * @apiPermission 【/v1/system/database/backup/delete/{id}#DELETE】
  4240. * @apiVersion 1.0.0
  4241. * @apiParam { Long } id 数据备份id
  4242. * @apiSuccess { Boolean } data 数据
  4243. * @apiSuccess { String } message 信息
  4244. * @apiSuccess { Integer } code 状态码
  4245. * @apiSuccessExample Response
  4246. *
  4247. * {"data":true, "message":"", "code":1}
  4248. */
  4249. /**
  4250. * @api {delete} /v1/system/database/backup/delete 03.删除多条数据备份
  4251. * @apiName 删除多条数据备份
  4252. * @apiGroup 系统设置-数据备份
  4253. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4254. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4255. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4256. * @apiPermission 【/v1/system/database/backup/delete#DELETE】
  4257. * @apiVersion 1.0.0
  4258. * @apiQuery { Long[] { 1-2147483647 } } ids 数据备份id数组
  4259. * @apiSuccess { Boolean } data 数据
  4260. * @apiSuccess { String } message 信息
  4261. * @apiSuccess { Integer } code 状态码
  4262. * @apiSuccessExample Response
  4263. *
  4264. * {"data":true, "message":"", "code":1}
  4265. */
  4266. /**
  4267. * @api {get} /v1/system/database/backup/list 04.分页查询数据备份
  4268. * @apiName 分页查询数据备份
  4269. * @apiGroup 系统设置-数据备份
  4270. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4271. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4272. * @apiHeader {String} Authorization = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3V1aWQiOjMzODkzNTc0MDMzNjk0NzIwLCJuYmYiOjE2NDcxMDMzMjV9.zkk2igTRJMx15TPwlpVRa63sV11YHFgAqPZpnp9hGEU" 授权信息
  4273. * @apiPermission 【/v1/system/database/backup/list#GET】
  4274. * @apiVersion 1.0.0
  4275. * @apiQuery { String } [ name ] 文件名
  4276. * @apiQuery { String } [ path ] 访问路径
  4277. * @apiQuery { Integer } [ type ] 类型 1:自动备份 2:手动备份
  4278. * @apiQuery { Integer } [ status ] 状态 1:正在备份 2:备份失败 3:备份完成
  4279. * @apiQuery { Long } [ fileSize ] 文件大小
  4280. * @apiQuery { String } [ remark ] 备注
  4281. * @apiQuery { Date } [ createTimeStart ] 创建时间 开始时间
  4282. * @apiQuery { Date } [ createTimeEnd ] 创建时间 结束时间
  4283. * @apiQuery { Integer } [ page = 1 ] 页码
  4284. * @apiQuery { Integer } [ size = 10 ] 页大小
  4285. * @apiQuery { String { ^[-+][\w]+ } } [ order = -id ] 排序规则(默认ID倒序),排序字段前加:+表示正序 -表示倒序
  4286. * @apiSuccess { Object } data 数据
  4287. * @apiSuccess { Long } data.total 数据总数
  4288. * @apiSuccess { Object[] } data.list 数据列表
  4289. * @apiSuccess { Long } data.list.id id主键
  4290. * @apiSuccess { String } data.list.name 文件名
  4291. * @apiSuccess { String } data.list.path 访问路径
  4292. * @apiSuccess { Integer } data.list.type 类型 1:自动备份 2:手动备份
  4293. * @apiSuccess { Integer } data.list.status 状态 1:正在备份 2:备份失败 3:备份完成
  4294. * @apiSuccess { Long } data.list.fileSize 文件大小
  4295. * @apiSuccess { String } data.list.remark 备注
  4296. * @apiSuccess { Date } data.list.createTime 创建时间
  4297. * @apiSuccess { String } message 信息
  4298. * @apiSuccess { Integer } code 状态码
  4299. * @apiSuccessExample Response
  4300. *
  4301. * {"data":{"total":1, "list":[{"id":1, "name":"", "path":"", "type":1, "status":1, "fileSize":1, "remark":"", "createTime":1650761871439}]}, "message":"", "code":1}
  4302. */
  4303. /**
  4304. * @api {post} /v1/file/upload 01.文件上传
  4305. * @apiName 文件上传
  4306. * @apiGroup 文件服务-文件
  4307. * @apiHeader {String = multipart/form-data} Content-Type = multipart/form-data
  4308. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4309. * @apiVersion 1.0.0
  4310. * @apiBody { File } file 文件
  4311. * @apiSuccess { String } data 数据
  4312. * @apiSuccess { String } message 信息
  4313. * @apiSuccess { Integer } code 状态码
  4314. * @apiSuccessExample Response
  4315. *
  4316. * {"data":"", "message":"", "code":1}
  4317. */
  4318. /**
  4319. * @api {post} /v1/file/uploads 02.多文件上传
  4320. * @apiName 多文件上传
  4321. * @apiGroup 文件服务-文件
  4322. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4323. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4324. * @apiVersion 1.0.0
  4325. * @apiSuccess { String[] } data 数据
  4326. * @apiSuccess { String } message 信息
  4327. * @apiSuccess { Integer } code 状态码
  4328. * @apiSuccessExample Response
  4329. *
  4330. * {"data":[""], "message":"", "code":1}
  4331. */
  4332. /**
  4333. * @api {get} /v1/file/query/:path 03.文件下载
  4334. * @apiName 文件下载
  4335. * @apiGroup 文件服务-文件
  4336. * @apiHeader {String = application/x-www-form-urlencoded} Content-Type = application/x-www-form-urlencoded
  4337. * @apiHeader {String = zh-CN,en-US } accept-language = zh-CN
  4338. * @apiVersion 1.0.0
  4339. * @apiParam { String } path 文件存储路径
  4340. */