zentao-api 0.3.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,2 +1,2 @@
1
- (()=>{var{defineProperty:DQ,getOwnPropertyNames:rQ,getOwnPropertyDescriptor:aQ}=Object,oQ=Object.prototype.hasOwnProperty;function eQ(Q){return this[Q]}var QX=(Q)=>{var X=(zQ??=new WeakMap).get(Q),$;if(X)return X;if(X=DQ({},"__esModule",{value:!0}),Q&&typeof Q==="object"||typeof Q==="function"){for(var J of rQ(Q))if(!oQ.call(X,J))DQ(X,J,{get:eQ.bind(Q,J),enumerable:!($=aQ(Q,J))||$.enumerable})}return zQ.set(Q,X),X},zQ;var XX=(Q)=>Q;function $X(Q,X){this[Q]=XX.bind(null,X)}var TQ=(Q,X)=>{for(var $ in X)DQ(Q,$,{get:X[$],enumerable:!0,configurable:!0,set:$X.bind(X,$)})};var sX={};TQ(sX,{switchProfile:()=>d,sortData:()=>v,setGlobalOptions:()=>g,searchData:()=>y,request:()=>JQ,processData:()=>M,pickFieldsSingle:()=>N,pickFields:()=>f,getProfileKey:()=>F,getProfile:()=>UQ,getModuleNames:()=>$Q,getModuleAction:()=>z,getModule:()=>S,getGlobalOptions:()=>j,getAllProfiles:()=>LQ,filterData:()=>b,extendModuleAction:()=>_,deleteProfile:()=>KQ,defineModules:()=>QQ,defineModuleActions:()=>XQ,addProfile:()=>p,ZentaoError:()=>q,ZentaoClient:()=>w,ZENTAO_PROFILES_STORAGE_KEY:()=>c,VERSION:()=>jQ,ERRORS:()=>l,BUILD:()=>_Q});var WQ={};TQ(WQ,{switchProfile:()=>d,sortData:()=>v,setGlobalOptions:()=>g,searchData:()=>y,request:()=>JQ,processData:()=>M,pickFieldsSingle:()=>N,pickFields:()=>f,getProfileKey:()=>F,getProfile:()=>UQ,getModuleNames:()=>$Q,getModuleAction:()=>z,getModule:()=>S,getGlobalOptions:()=>j,getAllProfiles:()=>LQ,filterData:()=>b,extendModuleAction:()=>_,deleteProfile:()=>KQ,defineModules:()=>QQ,defineModuleActions:()=>XQ,addProfile:()=>p,ZentaoError:()=>q,ZentaoClient:()=>w,ZENTAO_PROFILES_STORAGE_KEY:()=>c,VERSION:()=>jQ,ERRORS:()=>l,BUILD:()=>_Q});var l={E_INVALID_BASE_URL:"Invalid ZenTao baseUrl.",E_NO_GLOBAL_CLIENT:"No global client configured. Call ZentaoClient.init() or pass options.client.",E_HTTP_ERROR:"HTTP request failed: {status} {statusText}",E_NETWORK_ERROR:"Network request failed: {message}",E_TIMEOUT:"Request timed out.",E_INSECURE_BROWSER:"The insecure option is only supported in Node.js runtimes.",E_LOGIN_FAILED:"ZenTao login failed.",E_INVALID_PROFILE:"Invalid ZenTao profile.",E_NO_PROFILE:"No ZenTao profile is configured.",E_PROFILE_NOT_FOUND:"ZenTao profile not found: {profileKey}",E_PROFILE_STORAGE_INVALID:"ZenTao profile storage is not valid JSON.",E_PROFILE_STORAGE_UNAVAILABLE:"ZenTao profile storage is unavailable in this runtime.",E_INVALID_MODULE:"Unknown module: {module}",E_INVALID_ACTION:"Unknown action: {module}-{action}",E_INVALID_MODULE_DEFINITION:"Invalid module definition.",E_INVALID_ACTION_DEFINITION:"Invalid module action definition.",E_INDETERMINATE_ACTION_METHOD:'Cannot infer HTTP method for action "{action}" from type "{type}"; specify "method" explicitly.',E_INDETERMINATE_ACTION_RESULT_TYPE:'Cannot infer result type for action "{action}" from type "{type}"; specify "resultType" explicitly.',E_MISSING_PARAM:"Missing required parameter: {param}",E_INVALID_PARAM:"Invalid value for parameter {param}: {value}",E_INVALID_REQUEST_NAME:'Request name must use the form "moduleName", "moduleName/methodName", or "moduleName/<objectID>".',E_API_FAILED:"ZenTao API returned failure: {message}"};class q extends Error{code;details;constructor(Q,X,$){let J=l[Q];if(X)for(let[W,D]of Object.entries(X))J=J.replaceAll(`{${W}}`,String(D));super(J);this.name="ZentaoError",this.code=Q,this.details=$}}function s(){return typeof process<"u"&&Boolean(process.versions?.node)}function MQ(Q){return import(Q)}function JX(Q){let X={};return new Headers(Q).forEach(($,J)=>{X[J]=$}),X}function WX(Q){let X=new Headers;for(let[$,J]of Object.entries(Q)){if(J===void 0)continue;X.set($,Array.isArray(J)?J.join(", "):String(J))}return X}function YQ(Q,X){let $=X.toLowerCase();return Object.keys(Q).some((J)=>J.toLowerCase()===$)}async function DX(Q,X){if(Q===void 0||Q===null)return;if(typeof Q==="string")return Q;if(Q instanceof Uint8Array)return Q;if(Q instanceof ArrayBuffer)return new Uint8Array(Q);if(ArrayBuffer.isView(Q))return new Uint8Array(Q.buffer,Q.byteOffset,Q.byteLength);if(Q instanceof Blob){if(Q.type&&!YQ(X,"content-type"))X["content-type"]=Q.type;return new Uint8Array(await Q.arrayBuffer())}if(typeof FormData<"u"&&Q instanceof FormData){let $=new Request("https://zentao-api.local/",{method:"POST",body:Q}),J=$.headers.get("content-type");if(J&&!YQ(X,"content-type"))X["content-type"]=J;return new Uint8Array(await $.arrayBuffer())}if(typeof URLSearchParams<"u"&&Q instanceof URLSearchParams){if(!YQ(X,"content-type"))X["content-type"]="application/x-www-form-urlencoded;charset=UTF-8";return Q.toString()}return String(Q)}function wQ(){return new DOMException("The operation was aborted.","AbortError")}function YX(Q){let X=Q.reduce((W,D)=>W+D.byteLength,0),$=new Uint8Array(X),J=0;for(let W of Q)$.set(W,J),J+=W.byteLength;return $.buffer}async function qX(Q,X,$){let J=new URL(Q),W=J.protocol==="https:"?await MQ("node:https"):await MQ("node:http"),D=JX(X.headers),Y=await DX(X.body,D);return new Promise((G,B)=>{if(X.signal?.aborted){B(wQ());return}let C=W.request(J,{method:X.method??"GET",headers:D,rejectUnauthorized:$},(A)=>{let U=[];A.on("data",(O)=>{U.push(typeof O==="string"?new TextEncoder().encode(O):O)}),A.on("end",()=>{L();let O=U.length>0?YX(U):void 0,T=new Response(O,{status:A.statusCode??200,statusText:A.statusMessage??"",headers:WX(A.headers)});Object.defineProperty(T,"url",{value:Q}),G(T)})}),L=()=>{X.signal?.removeEventListener("abort",H)},H=()=>{L(),C.destroy(wQ())};if(C.on("error",(A)=>{L(),B(A)}),X.signal?.addEventListener("abort",H,{once:!0}),Y!==void 0)C.write(Y);C.end()})}function qQ(Q){if(Q&&!s())throw new q("E_INSECURE_BROWSER")}async function PQ(Q,X,$){if(!Q)return fetch(X,$);return qQ(Q),qX(X,$,!1)}var HQ={};function j(){return{...HQ}}function g(Q){HQ={...HQ,...Q}}function K(Q){return Boolean(Q)&&typeof Q==="object"&&!Array.isArray(Q)}function V(Q,X){let $=X.split("."),J=Q;for(let W of $){if(J===null||J===void 0||typeof J!=="object")return;J=J[W]}return J}function Z(Q){return Array.isArray(Q)?Q:[Q]}function E(Q){let X=Q.trim().replace(/\/+$/,"");if(!X)throw new q("E_INVALID_BASE_URL");let $=X.replace(/\/api\.php\/v2$/i,""),J;try{J=new URL($)}catch{throw new q("E_INVALID_BASE_URL")}if(!["http:","https:"].includes(J.protocol)||J.search||J.hash)throw new q("E_INVALID_BASE_URL");return J.toString().replace(/\/+$/,"")}function N(Q,X){let $={};for(let J of X){let W=V(Q,J);if(W===void 0)continue;let D=J.split("."),Y=$;for(let G=0;G<D.length-1;G++){let B=D[G];if(!K(Y[B]))Y[B]={};Y=Y[B]}Y[D[D.length-1]]=W}return $}function f(Q,X){return Q.map(($)=>N($,X))}function h(Q,X){let $=Number(Q),J=Number(X);if(Q!==""&&X!==""&&!Number.isNaN($)&&!Number.isNaN(J))return $-J;return String(Q).localeCompare(String(X))}function SQ(Q,X){let $=Number(Q),J=Number(X);if(Q!==""&&X!==""&&!Number.isNaN($)&&!Number.isNaN(J))return $===J;return String(Q)===String(X)}function xQ(Q,X){if(Q===void 0||Q===null)return!1;let $=String(Q).toLowerCase();return Z(X).some((J)=>$.includes(String(J).toLowerCase()))}function EQ(Q,X){let $=V(Q,X.key),{operator:J,value:W}=X;switch(J){case"=":return Z(W).some((D)=>SQ($,D));case"!=":return Z(W).every((D)=>!SQ($,D));case"~":return xQ($,W);case"!~":return!xQ($,W);case">":return h($,W)>0;case"<":return h($,W)<0;case">=":return h($,W)>=0;case"<=":return h($,W)<=0;default:return!1}}function HX(Q,X){if(X.conditions.length===0)return!0;return X.operator==="OR"?X.conditions.some(($)=>EQ(Q,$)):X.conditions.every(($)=>EQ(Q,$))}function b(Q,X){if(X.length===0)return Q.slice();return Q.filter(($)=>X.every((J)=>HX($,J)))}function t(Q,X){if(Q===null||Q===void 0)return;if(Array.isArray(Q))for(let $ of Q)t($,X);else if(K(Q))for(let $ of Object.values(Q))t($,X);else X.push(String(Q))}function BX(Q,X){let $=[];if(X&&X.length>0)for(let J of X)t(V(Q,J),$);else t(Q,$);return $.join("\x00").toLowerCase()}function y(Q,X,$){let J=X.map((W)=>W.toLowerCase().split(/\s+/).filter(Boolean)).filter((W)=>W.length>0);if(J.length===0)return Q.slice();return Q.filter((W)=>{let D=BX(W,$);return J.every((Y)=>Y.some((G)=>D.includes(G)))})}function GX(Q){if(typeof Q==="function")return Q;let X=Q.lastIndexOf(":"),$=X>=0?Q.slice(0,X):Q,W=(X>=0?Q.slice(X+1):"asc")==="desc"?-1:1;return(D,Y)=>h(V(D,$),V(Y,$))*W}function v(Q,X){let $=X.map(GX);return Q.slice().sort((J,W)=>{for(let D of $){let Y=D(J,W);if(Y!==0)return Y}return 0})}var CX=[">=","<=","!=","!~","=","~",">","<"];function AX(Q){if(Q.startsWith("[")&&Q.endsWith("]"))return Q.slice(1,-1).split(",").map((X)=>X.trim()).filter(Boolean);if(Q==="true")return!0;if(Q==="false")return!1;if(Q!==""&&!Number.isNaN(Number(Q)))return Number(Q);return Q}function LX(Q){for(let X of CX){let $=Q.indexOf(X);if($>0)return{key:Q.slice(0,$).trim(),operator:X,value:AX(Q.slice($+X.length).trim())}}return}function UX(Q){if(Q===void 0||Q==="")return;let X=Number(Q);if(!Number.isFinite(X)||X<0)return;return Math.floor(X)}function M(Q,X){if(!Array.isArray(Q))return X.pick?N(Q,X.pick):{...Q};let $=X,J=Q;if($.filter&&$.filter.length>0){let D=$.filter.map(LX).filter((Y)=>Y!==void 0);if(D.length>0)J=b(J,[{operator:"AND",conditions:D}])}if($.search&&$.search.length>0)J=y(J,$.search,$.searchFields);if($.sort){let D=$.sort.split(",").map((Y)=>Y.trim()).filter(Boolean);if(D.length>0)J=v(J,D)}let W=UX($.limit);if(W!==void 0)J=J.slice(0,W);if($.pick)J=f(J,$.pick);return J}var c="ZENTAO_PROFILES",KX=[".config","zentao","zentao.json"];function gQ(Q){return Boolean(Q)&&typeof Q==="object"&&!Array.isArray(Q)}function hQ(Q){if(Q===void 0)return Q;return JSON.parse(JSON.stringify(Q))}function fQ(){return new Date().toISOString()}function m(Q){return import(Q)}var NQ=Promise.resolve();function BQ(Q){let X=NQ.then(Q,Q);return NQ=X.catch(()=>{return}),X}function bQ(){try{return globalThis.localStorage}catch{return}}async function yQ(){let Q=await m("node:path"),X=process.env.HOME??process.env.USERPROFILE??(await m("node:os")).homedir();if(!X)throw new q("E_PROFILE_STORAGE_UNAVAILABLE");return Q.join(X,...KX)}function RX(Q,X){let $=Q.trim(),J=E(X);if(!$)throw new q("E_INVALID_PROFILE");return`${$}@${J}`}function GQ(Q){if(!gQ(Q)||typeof Q.server!=="string"||typeof Q.account!=="string"||typeof Q.token!=="string")throw new q("E_INVALID_PROFILE");let X=Q.token.trim();if(!X)throw new q("E_INVALID_PROFILE");let $=hQ(Q);return delete $.key,{...$,server:E(Q.server),account:Q.account.trim(),token:X}}function vQ(Q){if(!gQ(Q))return{profiles:[]};let X=Array.isArray(Q.profiles)?Q.profiles.flatMap((J)=>{try{return[GQ(J)]}catch{return[]}}):[],$=typeof Q.currentProfile==="string"?Q.currentProfile:void 0;return $?{currentProfile:$,profiles:X}:{profiles:X}}function kQ(Q){try{return vQ(JSON.parse(Q))}catch(X){throw new q("E_PROFILE_STORAGE_INVALID",void 0,X)}}async function u(){if(s()){let $=await m("node:fs/promises"),J=await yQ();try{return kQ(await $.readFile(J,"utf8"))}catch(W){if(W.code==="ENOENT")return{profiles:[]};throw W}}let Q=bQ();if(!Q)throw new q("E_PROFILE_STORAGE_UNAVAILABLE");let X=Q.getItem(c);return X?kQ(X):{profiles:[]}}async function CQ(Q){let X=vQ(Q),$=`${JSON.stringify(X,null,2)}
2
- `;if(s()){let W=await m("node:fs/promises"),D=await m("node:path"),Y=await yQ(),G=D.dirname(Y),B=D.join(G,`.zentao.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`);await W.mkdir(G,{recursive:!0,mode:448}),await W.chmod(G,448).catch(()=>{return});try{await W.writeFile(B,$,{encoding:"utf8",mode:384}),await W.rename(B,Y),await W.chmod(Y,384).catch(()=>{return})}catch(C){throw await W.rm(B,{force:!0}).catch(()=>{return}),C}return}let J=bQ();if(!J)throw new q("E_PROFILE_STORAGE_UNAVAILABLE");J.setItem(c,$)}function r(Q){let X=GQ(Q);return{...hQ(X),key:F(X)}}function AQ(Q,X){return Q.profiles.find(($)=>F($)===X)}function VX(Q){if(!Q.currentProfile||!AQ(Q,Q.currentProfile)){let X=Q.profiles.at(-1);Q.currentProfile=X?F(X):void 0}}function F(Q){return RX(Q.account,Q.server)}async function LQ(){return(await u()).profiles.map(r)}async function UQ(Q){let X=await u(),$=Q??X.currentProfile;if(!$)return;let J=AQ(X,$);return J?r(J):void 0}function p(Q){return BQ(async()=>{let X=await u(),$=fQ(),J=GQ({...Q,loginTime:Q.loginTime??$,lastUsedTime:Q.lastUsedTime??$}),W=F(J),D=X.profiles.findIndex((Y)=>F(Y)===W);if(D>=0)X.profiles[D]=J;else X.profiles.push(J);return X.currentProfile=W,await CQ(X),r(J)})}function KQ(Q){return BQ(async()=>{let X=await u(),$=X.profiles.filter((J)=>F(J)!==Q);if($.length===X.profiles.length)return!1;return X.profiles=$,VX(X),await CQ(X),!0})}function d(Q){return BQ(async()=>{let X=await u(),$=Q??X.currentProfile;if(!$)throw new q("E_NO_PROFILE");let J=AQ(X,$);if(!J)throw new q("E_PROFILE_NOT_FOUND",{profileKey:$});return J.lastUsedTime=fQ(),X.currentProfile=$,await CQ(X),r(J)})}var OX=1e4;function IX(Q,X,$){let J=X.startsWith("/")?X:`/${X}`,W=new URL(`${Q}${J}`);for(let[D,Y]of Object.entries($??{})){if(Y===void 0)continue;W.searchParams.set(D,String(Y))}return W.toString()}function FX(Q){if(!Q||typeof Q!=="object")return!1;let X=Object.getPrototypeOf(Q);return X===Object.prototype||X===null}function a(Q,X){let $=globalThis[X];return typeof $==="function"&&Q instanceof $}function _X(Q){return Q instanceof ArrayBuffer||ArrayBuffer.isView(Q)}function mQ(Q,X,$){if($===void 0)return;if(Array.isArray($)){for(let J of $)mQ(Q,X,J);return}Q.append(X,$===null?"":String($))}function jX(Q,X,$){if(Q===void 0||Q===null)return;if(X==="form"){let J=Q instanceof URLSearchParams?Q:new URLSearchParams;if(!(Q instanceof URLSearchParams)&&FX(Q))for(let[W,D]of Object.entries(Q))mQ(J,W,D);else if(!(Q instanceof URLSearchParams))throw new q("E_INVALID_PARAM",{param:"body",value:String(Q)});if(!$.has("Content-Type"))$.set("Content-Type","application/x-www-form-urlencoded;charset=UTF-8");return J}if(X==="raw"||typeof Q==="string"||_X(Q)||a(Q,"FormData")||a(Q,"URLSearchParams")||a(Q,"Blob")||a(Q,"ReadableStream"))return Q;if(!$.has("Content-Type"))$.set("Content-Type","application/json");return JSON.stringify(Q)}function ZX(Q,X){let $=new AbortController,J=()=>$.abort(X?.reason),W=setTimeout(()=>$.abort(),Q);if(X?.aborted)J();else X?.addEventListener("abort",J,{once:!0});return{signal:$.signal,cleanup:()=>{clearTimeout(W),X?.removeEventListener("abort",J)}}}async function zX(Q,X="auto"){if(X==="response")return Q;if(X==="arrayBuffer")return Q.arrayBuffer();if(X==="blob")return Q.blob();if(X==="text")return Q.text();if(X==="json"){let J=await Q.text();return J===""?void 0:JSON.parse(J)}let $=await Q.text();if($==="")return;try{return JSON.parse($)}catch{return $}}class w{siteUrl;baseUrl;token;timeout;insecure;constructor(Q){let X=typeof Q==="string"?{baseUrl:Q}:Q;this.siteUrl=E(X.baseUrl),this.baseUrl=`${this.siteUrl}/api.php/v2`,this.token=X.token,this.timeout=X.timeout,this.insecure=X.insecure}async request(Q,X={}){let $=j(),J=X.method??"GET",W=X.timeout??$.timeout??this.timeout??OX,D=X.insecure??$.insecure??this.insecure;qQ(D);let Y=IX(this.baseUrl,Q,X.query),G=new Headers(X.headers);if(this.token)G.set("Token",this.token);let{signal:B,cleanup:C}=ZX(W,X.signal),L={method:J,headers:G,signal:B};if(X.body!==void 0&&J!=="GET")L.body=jX(X.body,X.bodyType,G);try{let H=await PQ(D,Y,L);if(!H.ok)throw new q("E_HTTP_ERROR",{status:H.status,statusText:H.statusText},{url:H.url,status:H.status,statusText:H.statusText,body:await H.text().catch(()=>{return})});return zX(H,X.responseType)}catch(H){if(H instanceof q)throw H;if(H instanceof DOMException&&H.name==="AbortError")throw new q("E_TIMEOUT");throw new q("E_NETWORK_ERROR",{message:H.message??String(H)},H)}finally{C()}}async get(Q,X={}){return this.request(Q,{...X,method:"GET"})}async post(Q,X,$={}){return this.request(Q,{...$,method:"POST",body:X})}async put(Q,X,$={}){return this.request(Q,{...$,method:"PUT",body:X})}async delete(Q,X={}){return this.request(Q,{...X,method:"DELETE"})}async login(Q,X){let $=await this.post("/users/login",{account:Q,password:X});if($.status!=="success"||!$.token)throw new q("E_LOGIN_FAILED");this.token=$.token;let J=j();if(J.persistProfiles){let W={},D=this.timeout??J.timeout,Y=this.insecure??J.insecure;if(D!==void 0)W.timeout=D;if(Y!==void 0)W.insecure=Y;await p({server:this.siteUrl,account:Q,token:$.token,user:K($.user)?$.user:void 0,serverConfig:K($.serverConfig)?$.serverConfig:void 0,config:Object.keys(W).length>0?W:void 0})}return $.token}static create(Q){return new w(Q)}static init(Q){let X=new w(Q);return g({client:X}),X}static async fromProfile(Q){let X=await d(Q);return new w({baseUrl:X.server,token:X.token,timeout:typeof X.config?.timeout==="number"?X.config.timeout:void 0,insecure:typeof X.config?.insecure==="boolean"?X.config.insecure:void 0})}}var cQ=[{name:"user",display:"用户",description:"用户管理,支持获取用户列表、创建用户、获取用户详情、修改用户信息、删除用户",actions:[{name:"list",display:"获取用户列表",type:"list",method:"get",path:"/users",resultType:"list",pagerGetter:"pager",resultGetter:"users",params:[{name:"browseType",required:!1,type:"string",description:"浏览类型",options:[{value:"inside",label:"内部用户"},{value:"outside",label:"内部用户"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"realname_asc",label:"姓名 升序"},{value:"realname_desc",label:"姓名 降序"},{value:"account_asc",label:"用户名 升序"},{value:"account_desc",label:"用户名 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建用户",type:"create",method:"post",path:"/users",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{account:{type:"string",description:"登录名"},realname:{type:"string",description:"姓名"},password:{type:"string",description:"密码"}},required:["account","realname","password"]}}},{name:"get",display:"获取用户详情",type:"get",method:"get",path:"/users/{userID}",resultType:"object",resultGetter:"user",pathParams:{userID:"用户ID"}},{name:"update",display:"修改用户信息",type:"update",method:"put",path:"/users/{userID}",resultType:"object",pathParams:{userID:"用户ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{realname:{type:"string",description:"真实姓名"},dept:{type:"integer",description:"部门",format:"int32"},join:{type:"string",description:"入职日期"},group:{type:"array",items:{type:"string"},description:"权限分组"},email:{type:"string",description:"邮箱"},visions:{type:"array",items:{type:"string"},description:"界面类型(研发综合界面 rnd | 运营管理界面 lite)"},mobile:{type:"string",description:"手机"},weixin:{type:"string",description:"微信"},password:{type:"string",description:"密码"}}}}},{name:"delete",display:"删除用户",type:"delete",method:"delete",path:"/users/{userID}",resultType:"text",pathParams:{userID:"用户ID"}}]},{name:"program",display:"项目集",description:"项目集管理,支持获取项目集列表、创建项目集、获取项目集详情、修改项目集、删除项目集",actions:[{name:"list",display:"获取项目集列表",type:"list",method:"get",path:"/programs",resultType:"list",pagerGetter:"pager",resultGetter:"programs",params:[{name:"status",required:!1,type:"string",description:"状态",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"},{value:"suspended",label:"已挂起"},{value:"delayed",label:"已延期"},{value:"closed",label:"已关闭"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"name_asc",label:"名称 升序"},{value:"name_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建项目集",type:"create",method:"post",path:"/programs",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目集名称"},begin:{type:"string",description:"计划开始日期"},end:{type:"string",description:"计划完成日期"},PM:{type:"string",description:"计划完成日期"},desc:{type:"string",description:"项目集描述"}},required:["name","begin","end"]}}},{name:"get",display:"获取项目集详情",type:"get",method:"get",path:"/programs/{programID}",resultType:"object",resultGetter:"program",pathParams:{programID:"项目集ID"}},{name:"update",display:"修改项目集",type:"update",method:"put",path:"/programs/{programID}",resultType:"object",pathParams:{programID:"项目集ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目集名称"},begin:{type:"string",description:"计划开始日期"},end:{type:"string",description:"计划完成日期"},PM:{type:"string",description:"计划完成日期"},desc:{type:"string",description:"项目集描述"}},required:["name","begin","end"]}}},{name:"delete",display:"删除项目集",type:"delete",method:"delete",path:"/programs/{programID}",resultType:"text",pathParams:{programID:"项目集ID"}}]},{name:"product",display:"产品",description:"产品管理,支持获取产品列表、创建产品、获取产品详情、修改产品、删除产品",actions:[{name:"list",display:"获取产品列表",type:"list",method:"get",path:"/products",resultType:"list",pagerGetter:"pager",resultGetter:"products",params:[{name:"browseType",required:!1,type:"string",description:"浏览类型",options:[{value:"all",label:"全部"},{value:"noclosed",label:"未关闭"},{value:"closed",label:"已结束"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"名称 升序"},{value:"title_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建产品",type:"create",method:"post",path:"/products",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"产品名称"},program:{type:"integer",description:"所属项目集",format:"int32"},line:{type:"integer",description:"所属产品线",format:"int32"},type:{type:"string",description:"类型(normal 正常 | branch 多分支 | platform 多平台)"},PO:{type:"string",description:"产品负责人"},reviewer:{type:"array",items:{type:"string"},description:"评审人"},desc:{type:"array",items:{type:"string"},description:"产品描述"},QD:{type:"string",description:"测试负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["name"]}}},{name:"get",display:"获取产品详情",type:"get",method:"get",path:"/products/{productID}",resultType:"object",resultGetter:"product",pathParams:{productID:"产品ID"}},{name:"update",display:"修改产品",type:"update",method:"put",path:"/products/{productID}",resultType:"object",pathParams:{productID:"产品ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"产品名称"},program:{type:"integer",description:"所属项目集",format:"int32"},line:{type:"integer",description:"所属产品线",format:"int32"},type:{type:"string",description:"类型(normal 正常 | branch 多分支 | platform 多平台)"},PO:{type:"string",description:"产品负责人"},reviewer:{type:"array",items:{type:"string"},description:"评审人"},desc:{type:"array",items:{type:"string"},description:"产品描述"},QD:{type:"string",description:"测试负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["name"]}}},{name:"delete",display:"删除产品",type:"delete",method:"delete",path:"/products/{productID}",resultType:"text",pathParams:{productID:"产品ID"}}]},{name:"project",display:"项目",description:"项目管理,支持获取项目列表、创建项目、修改项目、删除项目",actions:[{name:"list",display:"获取项目列表",type:"list",method:"get",path:"/projects",resultType:"list",pagerGetter:"pager",resultGetter:"projects",params:[{name:"browseType",required:!1,type:"string",description:"项目状态,默认是undone",defaultValue:"undone",options:[{value:"all",label:"全部"},{value:"undone",label:"未完成"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"name_asc",label:"名称 升序"},{value:"name_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建项目",type:"create",method:"post",path:"/projects",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目名称"},model:{type:"string",description:"项目管理方式(scrum 敏捷 | waterfall 瀑布 | kanban 看板 | agileplus 融合敏捷 | waterfallplus 融合瀑布)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},products:{type:"array",items:{type:"string"},description:"关联产品"},parent:{type:"integer",description:"所属项目集",format:"int32"},workflowGroup:{type:"integer",description:"项目流程,付费版功能,开源版可以不填",format:"int32"},PM:{type:"string",description:"项目负责人"}},required:["name","model","begin","end","workflowGroup"]}}},{name:"update",display:"修改项目",type:"update",method:"put",path:"/projects/{projectID}",resultType:"object",pathParams:{projectID:"项目ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目名称"},model:{type:"string",description:"项目管理方式(scrum 敏捷 | waterfall 瀑布 | kanban 看板 | agileplus 融合敏捷 | waterfallplus 融合瀑布)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},products:{type:"array",items:{type:"string"},description:"关联产品"},parent:{type:"integer",description:"所属项目集",format:"int32"},workflowGroup:{type:"integer",description:"项目流程,付费版功能,开源版可以不填",format:"int32"},PM:{type:"string",description:"项目负责人"}},required:["name","model","begin","end","workflowGroup"]}}},{name:"delete",display:"删除项目",type:"delete",method:"delete",path:"/projects/{projectID}",resultType:"text",pathParams:{projectID:"项目ID"}}]},{name:"execution",display:"执行",description:"执行管理,支持获取执行列表、创建执行、获取执行详情、修改执行、删除执行",actions:[{name:"list",display:"获取执行列表",type:"list",method:"get",path:"/executions",resultType:"list",pagerGetter:"pager",resultGetter:"executions",params:[{name:"status",required:!1,type:"string",description:"执行状态,默认是undone",defaultValue:"undone",options:[{value:"all",label:"全部"},{value:"undone",label:"未完成"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"rawID_asc",label:"RAWID 升序"},{value:"rawID_desc",label:"RAWID 降序"},{value:"nameCol_asc",label:"名称 升序"},{value:"nameCol_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建执行",type:"create",method:"post",path:"/executions",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{project:{type:"integer",description:"所属项目",format:"int32"},name:{type:"string",description:"迭代名称"},lifetime:{type:"string",description:"执行类型(short 短期 | long 长期 | ops 运维)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},days:{type:"integer",description:"可用工作日",format:"int32"},products:{type:"array",items:{type:"string"},description:"关联产品"},plans:{type:"array",items:{type:"string"},description:"关联计划,必须是产品+planID的二维数组"},PO:{type:"string",description:"产品负责人"},QD:{type:"string",description:"测试负责人"},PM:{type:"string",description:"执行负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["project","name","begin","end"]}}},{name:"get",display:"获取执行详情",type:"get",method:"get",path:"/executions/{executionID}",resultType:"object",resultGetter:"execution",pathParams:{executionID:"执行ID"}},{name:"update",display:"修改执行",type:"update",method:"put",path:"/executions/{executionID}",resultType:"object",pathParams:{executionID:"执行ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{project:{type:"integer",description:"所属项目",format:"int32"},name:{type:"string",description:"迭代名称"},lifetime:{type:"string",description:"执行类型(short 短期 | long 长期 | ops 运维)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},days:{type:"integer",description:"可用工作日",format:"int32"},products:{type:"array",items:{type:"string"},description:"关联产品"},plans:{type:"array",items:{type:"string"},description:"关联计划,必须是产品+planID的二维数组"},PO:{type:"string",description:"产品负责人"},QD:{type:"string",description:"测试负责人"},PM:{type:"string",description:"执行负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["name","begin","end"]}}},{name:"delete",display:"删除执行",type:"delete",method:"delete",path:"/executions/{executionID}",resultType:"text",pathParams:{executionID:"执行ID"}}]},{name:"productplan",display:"产品计划",description:"产品计划管理,支持获取产品计划列表,支持获取产品下的产品计划、创建产品计划、获取产品计划详情、修改产品计划、删除产品计划",actions:[{name:"list",display:"获取产品计划列表,支持获取产品下的产品计划",type:"list",method:"get",path:"/{scope}/{scopeID}/productplans",resultType:"list",pagerGetter:"pager",resultGetter:"productplans",pathParams:{scope:{description:"产品计划范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"执行状态,默认是undone",defaultValue:"undone",options:[{value:"all",label:"全部"},{value:"undone",label:"未完成"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"名称 升序"},{value:"title_desc",label:"名称 降序"},{value:"begin_asc",label:"开始日期 升序"},{value:"begin_desc",label:"开始日期 降序"},{value:"end_asc",label:"结束日期 升序"},{value:"end_desc",label:"结束日期 降序"},{value:"status_asc",label:"状态 升序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建产品计划",type:"create",method:"post",path:"/productplans",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string",description:"计划名称"},parent:{type:"integer",description:"父计划ID",format:"int32"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},branchID:{type:"integer",description:"分支ID",format:"int32"},desc:{type:"string",description:"计划描述"}},required:["productID","title"]}}},{name:"get",display:"获取产品计划详情",type:"get",method:"get",path:"/productplans/{planID}",resultType:"object",resultGetter:"productplan",pathParams:{planID:"产品计划ID"}},{name:"update",display:"修改产品计划",type:"update",method:"put",path:"/productplans/{productplanID}",resultType:"object",pathParams:{productplanID:"产品计划ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"计划名称"},parent:{type:"integer",description:"父计划",format:"int32"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},branchID:{type:"integer",description:"分支ID",format:"int32"},desc:{type:"string",description:"计划描述"}},required:["title"]}}},{name:"delete",display:"删除产品计划",type:"delete",method:"delete",path:"/productplans/{productplanID}",resultType:"text",pathParams:{productplanID:"产品计划ID"}}]},{name:"story",display:"需求",description:"需求管理,支持获取需求列表,支持获取产品/项目/执行下的需求、创建需求、获取需求详情、修改需求、删除需求、激活需求、变更需求、关闭需求",actions:[{name:"list",display:"获取需求列表,支持获取产品/项目/执行下的需求",type:"list",method:"get",path:"/{scope}/{scopeID}/stories",resultType:"list",pagerGetter:"pager",resultGetter:"stories",pathParams:{scope:{description:"需求范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"allstory",label:"全部"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"reviewbyme",label:"待我评审"},{value:"draftstory",label:"草稿"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建需求",type:"create",method:"post",path:"/stories",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},spec:{type:"string",description:"需求描述"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},verify:{type:"string",description:"验收标准"},assignedTo:{type:"string",description:"指派给"},reviewer:{type:"array",items:{type:"string"},description:"评审人,如果设置必须评审,必须填写"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"}},required:["productID","title"]}}},{name:"get",display:"获取需求详情",type:"get",method:"get",path:"/stories/{storyID}",resultType:"object",resultGetter:"story",pathParams:{storyID:"需求ID"}},{name:"update",display:"修改需求",type:"update",method:"put",path:"/stories/{storyID}",resultType:"object",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},assignedTo:{type:"string",description:"指派给"}},required:["title"]}}},{name:"delete",display:"删除需求",type:"delete",method:"delete",path:"/stories/{storyID}",resultType:"text",pathParams:{storyID:"需求ID"}},{name:"activate",display:"激活需求",type:"action",method:"put",path:"/stories/{storyID}/activate",resultType:"text",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"change",display:"变更需求",type:"action",method:"put",path:"/stories/{storyID}/change",resultType:"text",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},reviewer:{type:"array",items:{type:"string"},description:"评审人员"},spec:{type:"string",description:"需求描述"},verify:{type:"string",description:"验收标准"}},required:["reviewer"]}}},{name:"close",display:"关闭需求",type:"action",method:"put",path:"/stories/{storyID}/close",resultType:"text",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(done 已完成 | subdivided 已拆分 | duplicate 重复 | postponed 延期 | willnotdo 不做 | cancel 已取消 | bydesign 设计如此)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"epic",display:"业务需求",description:"业务需求管理,支持获取业务需求列表,支持获取产品下的业务需求、创建业务需求、获取业务需求详情、修改业务需求、删除业务需求、激活业务需求、变更业务需求、关闭业务需求",actions:[{name:"list",display:"获取业务需求列表,支持获取产品下的业务需求",type:"list",method:"get",path:"/{scope}/{scopeID}/epics",resultType:"list",pagerGetter:"pager",resultGetter:"epics",pathParams:{scope:{description:"业务需求范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"allstory",label:"全部"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"reviewbyme",label:"待我评审"},{value:"draftstory",label:"草稿"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建业务需求",type:"create",method:"post",path:"/epics",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父业务需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},spec:{type:"string",description:"业务需求描述"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},verify:{type:"string",description:"验收标准"},assignedTo:{type:"string",description:"指派给"},reviewer:{type:"array",items:{type:"string"},description:"评审人,如果设置必须评审,必须填写"}},required:["productID","title"]}}},{name:"get",display:"获取业务需求详情",type:"get",method:"get",path:"/epics/{storyID}",resultType:"object",resultGetter:"epic",pathParams:{storyID:"需求ID"}},{name:"update",display:"修改业务需求",type:"update",method:"put",path:"/epics/{epicID}",resultType:"object",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父业务需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},assignedTo:{type:"string",description:"指派给"}},required:["title"]}}},{name:"delete",display:"删除业务需求",type:"delete",method:"delete",path:"/epics/{epicID}",resultType:"text",pathParams:{epicID:"业务需求ID"}},{name:"activate",display:"激活业务需求",type:"action",method:"put",path:"/epics/{epicID}/activate",resultType:"text",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"change",display:"变更业务需求",type:"action",method:"put",path:"/epics/{epicID}/change",resultType:"text",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},reviewer:{type:"array",items:{type:"string"},description:"评审人员"},spec:{type:"string",description:"需求描述"},verify:{type:"string",description:"验收标准"}},required:["reviewer"]}}},{name:"close",display:"关闭业务需求",type:"action",method:"put",path:"/epics/{epicID}/close",resultType:"text",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(done 已完成 | subdivided 已拆分 | duplicate 重复 | postponed 延期 | willnotdo 不做 | cancel 已取消 | bydesign 设计如此)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"requirement",display:"用户需求",description:"用户需求管理,支持获取用户需求列表,支持获取产品下的用户需求、创建用户需求、获取用户需求详情、修改用户需求、删除用户需求、激活用户需求、变更用户需求、关闭用户需求",actions:[{name:"list",display:"获取用户需求列表,支持获取产品下的用户需求",type:"list",method:"get",path:"/{scope}/{scopeID}/requirements",resultType:"list",pagerGetter:"pager",resultGetter:"requirements",pathParams:{scope:{description:"用户需求范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"allstory",label:"全部"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"reviewbyme",label:"待我评审"},{value:"draftstory",label:"草稿"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建用户需求",type:"create",method:"post",path:"/requirements",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父用户需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},spec:{type:"string",description:"用户需求描述"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},verify:{type:"string",description:"验收标准"},assignedTo:{type:"string",description:"指派给"},reviewer:{type:"array",items:{type:"string"},description:"评审人,如果设置必须评审,必须填写"}},required:["productID","title"]}}},{name:"get",display:"获取用户需求详情",type:"get",method:"get",path:"/requirements/{storyID}",resultType:"object",resultGetter:"requirement",pathParams:{storyID:"需求ID"}},{name:"update",display:"修改用户需求",type:"update",method:"put",path:"/requirements/{requirementID}",resultType:"object",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父用户需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},assignedTo:{type:"string",description:"指派给"}},required:["title"]}}},{name:"delete",display:"删除用户需求",type:"delete",method:"delete",path:"/requirements/{requirementID}",resultType:"text",pathParams:{requirementID:"用户需求ID"}},{name:"activate",display:"激活用户需求",type:"action",method:"put",path:"/requirements/{requirementID}/activate",resultType:"text",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"change",display:"变更用户需求",type:"action",method:"put",path:"/requirements/{requirementID}/change",resultType:"text",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},spec:{type:"string",description:"需求描述"},verify:{type:"string",description:"验收标准"}}}}},{name:"close",display:"关闭用户需求",type:"action",method:"put",path:"/requirements/{requirementID}/close",resultType:"text",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(done 已完成 | subdivided 已拆分 | duplicate 重复 | postponed 延期 | willnotdo 不做 | cancel 已取消 | bydesign 设计如此)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"bug",display:"Bug",description:"Bug管理,支持获取Bug列表,支持获取产品/项目/执行下的Bug、创建Bug、获取Bug详情、修改Bug、删除Bug、激活Bug、关闭Bug、解决Bug",actions:[{name:"list",display:"获取Bug列表,支持获取产品/项目/执行下的Bug",type:"list",method:"get",path:"/{scope}/{scopeID}/bugs",resultType:"list",pagerGetter:"pager",resultGetter:"bugs",pathParams:{scope:{description:"Bug范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"assignedbyme",label:"由我指派"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建Bug",type:"create",method:"post",path:"/bugs",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},title:{type:"string",description:"Bug标题"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本,主干是trunk,其他版本使用版本ID"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},severity:{type:"integer",description:"严重程度,默认是3",format:"int32"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},type:{type:"string",description:"Bug类型(codeerror 代码错误 | config 配置相关 | install 安装部署 | security 安全相关 | performance 性能问题 | standard 标准规范 | automation 测试脚本 | designdefect 设计缺陷 | others 其他)"},steps:{type:"string",description:"重现步骤"},story:{type:"integer",description:"相关需求",format:"int32"}},required:["productID","title","openedBuild"]}}},{name:"get",display:"获取Bug详情",type:"get",method:"get",path:"/bugs/{bugID}",resultType:"object",resultGetter:"bug",pathParams:{bugID:"Bug ID"}},{name:"update",display:"修改Bug",type:"update",method:"put",path:"/bugs/{bugID}",resultType:"object",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"Bug标题"},severity:{type:"integer",description:"严重程度,默认是3",format:"int32"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},type:{type:"string",description:"Bug类型(codeerror 代码错误 | config 配置相关 | install 安装部署 | security 安全相关 | performance 性能问题 | standard 标准规范 | automation 测试脚本 | designdefect 设计缺陷 | others 其他)"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本,主干是trunk,其他版本使用版本ID"},steps:{type:"string",description:"重现步骤"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"}}}}},{name:"delete",display:"删除Bug",type:"delete",method:"delete",path:"/bugs/{bugID}",resultType:"text",pathParams:{bugID:"Bug ID"}},{name:"activate",display:"激活Bug",type:"action",method:"put",path:"/bugs/{bugID}/activate",resultType:"text",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{openedBuild:{type:"array",items:{type:"string"},description:"影响版本, trunk为主干"},assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭Bug",type:"action",method:"put",path:"/bugs/{bugID}/close",resultType:"text",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{comment:{type:"string",description:"备注"}}}}},{name:"resolve",display:"解决Bug",type:"action",method:"put",path:"/bugs/{bugID}/resolve",resultType:"text",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{resolution:{type:"string",description:"fixed 已解决 | notrepro 无法重现 | bydesign 设计如此 | duplicate 重复Bug | external 外部原因| postponed 延期处理 | willnotfix 不予解决 | tostory 转为需求"},resolvedDate:{type:"string",description:"解决日期,默认今天"},resolvedBuild:{type:"string",description:"解决版本, trunk为主干"},assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}},required:["resolution"]}}}]},{name:"testcase",display:"测试用例",description:"测试用例管理,支持获取测试用例列表,支持获取产品/项目/执行下的测试用例、创建测试用例、获取测试用例详情、修改测试用例、删除测试用例",actions:[{name:"list",display:"获取测试用例列表,支持获取产品/项目/执行下的测试用例",type:"list",method:"get",path:"/{scope}/{scopeID}/testcases",resultType:"list",pagerGetter:"pager",resultGetter:"testcases",pathParams:{scope:{description:"测试用例范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是all",defaultValue:"all",options:[{value:"all",label:"全部"},{value:"wait",label:"未关闭"},{value:"needconfirm",label:"需求变动"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建测试用例",type:"create",method:"post",path:"/testcases",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},title:{type:"string",description:"用例标题"},module:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},pri:{type:"integer",description:"优先级",format:"int32"},type:{type:"string",description:"用例类型(unit 单元测试 | interface 接口测试 | feature 功能测试 | install 安装部署 | config 配置相关 | performance 性能测试 | security 安全相关 | other 其他)"},precondition:{type:"string",description:"前置条件"},steps:{type:"array",items:{type:"string"},description:"用例步骤"},expects:{type:"array",items:{type:"string"},description:"用例步骤期望"},stepType:{type:"array",items:{type:"string"},description:"用例步骤类型(step 步骤 | group 父级步骤)"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"}},required:["productID","title"]}}},{name:"get",display:"获取测试用例详情",type:"get",method:"get",path:"/testcases/{caseID}",resultType:"object",resultGetter:"testcase",pathParams:{caseID:"测试用例ID"}},{name:"update",display:"修改测试用例",type:"update",method:"put",path:"/testcases/{testcasID}",resultType:"object",pathParams:{testcasID:"测试用例ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"用例标题"},moudule:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},pri:{type:"integer",description:"优先级",format:"int32"},type:{type:"string",description:"用例类型(unit 单元测试 | interface 接口测试 | feature 功能测试 | install 安装部署 | config 配置相关 | performance 性能测试 | security 安全相关 | other 其他)"},precondition:{type:"string",description:"前置条件"},steps:{type:"array",items:{type:"string"},description:"用例步骤"},expects:{type:"array",items:{type:"string"},description:"用例步骤期望"},stepType:{type:"array",items:{type:"string"},description:"用例步骤类型(step 步骤 | group 父级步骤)"}},required:["title"]}}},{name:"delete",display:"删除测试用例",type:"delete",method:"delete",path:"/testcases/{testcasID}",resultType:"text",pathParams:{testcasID:"测试用例ID"}}]},{name:"task",display:"任务",description:"任务管理,支持获取任务列表,支持获取执行下的任务、创建任务、获取任务详情、修改任务、删除任务、激活任务、关闭任务、完成任务、启动任务",actions:[{name:"list",display:"获取任务列表,支持获取执行下的任务",type:"list",method:"get",path:"/{scope}/{scopeID}/tasks",resultType:"list",pagerGetter:"pager",resultGetter:"tasks",pathParams:{scope:{description:"任务范围",options:[{value:"executions",label:"执行"}]},scopeID:"范围ID"},params:[{name:"status",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"assignedtome",label:"指派给我"},{value:"assignedtome",label:"指派给我"},{value:"myinvolved",label:"由我参与"},{value:"assignedbyme",label:"由我指派"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"name_asc",label:"名称 升序"},{value:"name_desc",label:"名称 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建任务",type:"create",method:"post",path:"/tasks",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"任务名称"},executionID:{type:"integer",description:"所属执行",format:"int32"},type:{type:"string",description:"任务类型"},assignedTo:{type:"string",description:"指派给"},estStarted:{type:"string",description:"预计开始"},deadline:{type:"string",description:"截止日期"},pri:{type:"integer",description:"优先级",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},module:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},desc:{type:"string",description:"任务描述"}},required:["name","executionID"]}}},{name:"get",display:"获取任务详情",type:"get",method:"get",path:"/tasks/{taskID}",resultType:"object",pathParams:{taskID:"任务ID"}},{name:"update",display:"修改任务",type:"update",method:"put",path:"/tasks/{taskID}",resultType:"object",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"任务名称"},type:{type:"string",description:"任务类型"},assignedTo:{type:"string",description:"指派给"},estStarted:{type:"string",description:"预计开始"},deadline:{type:"string",description:"截止日期"},pri:{type:"integer",description:"优先级",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},module:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},desc:{type:"string",description:"任务描述"}}}}},{name:"delete",display:"删除任务",type:"delete",method:"delete",path:"/tasks/{taskID}",resultType:"text",pathParams:{taskID:"任务ID"}},{name:"activate",display:"激活任务",type:"action",method:"put",path:"/tasks/{taskID}/activate",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{left:{type:"number",description:"预计剩余",format:"float"},assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭任务",type:"action",method:"put",path:"/tasks/{taskID}/close",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{comment:{type:"string",description:"备注"}}}}},{name:"finish",display:"完成任务",type:"action",method:"put",path:"/tasks/{taskID}/finish",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{currentConsumed:{type:"number",description:"本次消耗",format:"float"},assignedTo:{type:"string",description:"任务名称"},consumed:{type:"number",description:"总计消耗",format:"float"},realStarted:{type:"string",description:"实际开始"},finishedDate:{type:"string",description:"实际完成"},comment:{type:"string",description:"备注"}},required:["currentConsumed","realStarted","finishedDate"]}}},{name:"start",display:"启动任务",type:"action",method:"put",path:"/tasks/{taskID}/start",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"任务名称"},realStarted:{type:"string",description:"实际开始"},consumed:{type:"number",description:"总计消耗",format:"float"},left:{type:"number",description:"预计剩余",format:"float"},comment:{type:"string",description:"备注"}},required:["realStarted"]}}}]},{name:"feedback",display:"反馈",description:"反馈管理,支持获取反馈列表,支持获取产品下的反馈、创建反馈、获取反馈详情、修改反馈、删除反馈、激活反馈、关闭反馈",actions:[{name:"list",display:"获取反馈列表,支持获取产品下的反馈",type:"list",method:"get",path:"/{scope}/{scopeID}/feedbacks",resultType:"list",pagerGetter:"pager",resultGetter:"feedbacks",pathParams:{scope:{description:"反馈范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是wait",defaultValue:"wait",options:[{value:"all",label:"全部"},{value:"wait",label:"待处理"},{value:"doing",label:"处理中"},{value:"toclosed",label:"待关闭"},{value:"review",label:"待评审"},{value:"assigntome",label:"指派给我"},{value:"openedbyme",label:"由我反馈"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建反馈",type:"create",method:"post",path:"/feedbacks",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},title:{type:"string",description:"标题"},module:{type:"integer",description:"所属模块",format:"int32"},type:{type:"string",description:"类型(story 需求 | task 任务 | bug Bug | todo 待办 | advice 建议 | issue 问题 | risk 风险 | opportunity 机会)"},desc:{type:"string",description:"描述"},feedbackBy:{type:"string",description:"反馈者"},source:{type:"string",description:"来源"}},required:["product","title"]}}},{name:"get",display:"获取反馈详情",type:"get",method:"get",path:"/feedbacks/{feedbackID}",resultType:"object",resultGetter:"feedback",pathParams:{feedbackID:"反馈ID"}},{name:"update",display:"修改反馈",type:"update",method:"put",path:"/feedbacks/{feedbackID}",resultType:"object",pathParams:{feedbackID:"反馈ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},title:{type:"string",description:"标题"},type:{type:"string",description:"类型(story 需求 | task 任务 | bug Bug | todo 待办 | advice 建议 | issue 问题 | risk 风险 | opportunity 机会)"},desc:{type:"string",description:"描述"},feedbackBy:{type:"string",description:"反馈者"},source:{type:"string",description:"来源"}},required:["product","title"]}}},{name:"delete",display:"删除反馈",type:"delete",method:"delete",path:"/feedbacks/{feedbackID}",resultType:"text",pathParams:{feedbackID:"反馈ID"}},{name:"activate",display:"激活反馈",type:"action",method:"put",path:"/feedbacks/{feedbackID}/activate",resultType:"text",pathParams:{feedbackID:"反馈ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭反馈",type:"action",method:"put",path:"/feedbacks/{feedbackID}/close",resultType:"text",pathParams:{feedbackID:"反馈ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(commented 已处理 | repeat 重复 | refuse 不予采纳)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"ticket",display:"工单",description:"工单管理,支持获取工单列表,支持获取产品下的工单、创建工单、获取工单详情、修改工单、删除工单、激活工单、关闭工单",actions:[{name:"list",display:"获取工单列表,支持获取产品下的工单",type:"list",method:"get",path:"/{scope}/{scopeID}/tickets",resultType:"list",pagerGetter:"pager",resultGetter:"tickets",pathParams:{scope:{description:"工单范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是wait",defaultValue:"wait",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"wait",label:"待处理"},{value:"doing",label:"处理中"},{value:"done",label:"待关闭"},{value:"finishedbyme",label:"由我解决"},{value:"assigntome",label:"指派给我"},{value:"openedbyme",label:"由我创建"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建工单",type:"create",method:"post",path:"/tickets",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},title:{type:"string",description:"标题"},type:{type:"string",description:"类型(code 程序报错 | data 数据错误 | stuck 流程卡断 | security 安全问题 | affair 事务)"},desc:{type:"string",description:"描述"},assignedTo:{type:"string",description:"指派给"},deadline:{type:"string",description:"截止日期"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本"}},required:["product","title"]}}},{name:"get",display:"获取工单详情",type:"get",method:"get",path:"/tickets/{ticketID}",resultType:"object",resultGetter:"ticket",pathParams:{ticketID:"工单ID"}},{name:"update",display:"修改工单",type:"update",method:"put",path:"/tickets/{ticketID}",resultType:"object",pathParams:{ticketID:"工单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},title:{type:"string",description:"标题"},type:{type:"string",description:"类型(code 程序报错 | data 数据错误 | stuck 流程卡断 | security 安全问题 | affair 事务)"},desc:{type:"string",description:"描述"},assignedTo:{type:"string",description:"指派给"},deadline:{type:"string",description:"截止日期"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本"}}}}},{name:"delete",display:"删除工单",type:"delete",method:"delete",path:"/tickets/{ticketID}",resultType:"text",pathParams:{ticketID:"工单ID"}},{name:"activate",display:"激活工单",type:"action",method:"put",path:"/tickets/{ticketID}/activate",resultType:"text",pathParams:{ticketID:"工单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭工单",type:"action",method:"put",path:"/tickets/{ticketID}/close",resultType:"text",pathParams:{ticketID:"工单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(commented 已处理 | repeat 重复 | refuse 不予处理)"},comment:{type:"string",description:"备注"}},required:["closedReason","comment"]}}}]},{name:"system",display:"应用",description:"应用管理,支持获取应用列表,支持获取产品下的应用、创建应用、修改应用",actions:[{name:"list",display:"获取应用列表,支持获取产品下的应用",type:"list",method:"get",path:"/{scope}/{scopeID}/systems",resultType:"list",pagerGetter:"pager",pathParams:{scope:{description:"应用范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"}},{name:"create",display:"创建应用",type:"create",method:"post",path:"/systems",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},integrated:{type:"integer",description:"是否集成应用(0 否| 1 是)",format:"int32"},children:{type:"array",items:{type:"string"},description:"集成应用需要包含其他应用,非集成应用传空数组[]"},name:{type:"string",description:"应用名称"},desc:{type:"string",description:"描述"}},required:["productID","integrated","children","name"]}}},{name:"update",display:"修改应用",type:"update",method:"put",path:"/systems/{systemID}",resultType:"object",pathParams:{systemID:"应用ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"应用名称"},children:{type:"array",items:{type:"string"},description:"集成应用需要包含其他应用,非集成应用传空数组[]"},desc:{type:"string",description:"描述"}},required:["name","children"]}}}]},{name:"build",display:"版本",description:"版本管理,支持获取版本列表,支持获取项目/执行下的版本、创建版本/构建、修改版本、删除版本",actions:[{name:"list",display:"获取版本列表,支持获取项目/执行下的版本",type:"list",method:"get",path:"/{scope}/{scopeID}/builds",resultType:"list",pagerGetter:"pager",resultGetter:"builds",pathParams:{scope:{description:"版本范围",options:[{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"范围ID"}},{name:"create",display:"创建版本/构建",type:"create",method:"post",path:"/builds",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{executionID:{type:"integer",description:"所属执行/迭代",format:"int32"},product:{type:"integer",description:"所属产品",format:"int32"},name:{type:"string",description:"构建名称"},system:{type:"integer",description:"所属应用",format:"int32"},builder:{type:"string",description:"构建者"},date:{type:"string",description:"打包日期"},scmPath:{type:"string",description:"源代码地址"},filePath:{type:"string",description:"下载地址"},desc:{type:"string",description:"描述"}},required:["executionID","product","name","system","builder","date"]}}},{name:"update",display:"修改版本",type:"update",method:"put",path:"/builds/{buildID}",resultType:"object",pathParams:{buildID:"版本ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{execution:{type:"integer",description:"所属执行/迭代",format:"int32"},product:{type:"integer",description:"所属产品",format:"int32"},name:{type:"string",description:"构建名称"},system:{type:"integer",description:"所属应用",format:"int32"},builder:{type:"string",description:"构建者"},date:{type:"string",description:"打包日期"},scmPath:{type:"string",description:"源代码地址"},filePath:{type:"string",description:"下载地址"},desc:{type:"string",description:"描述"}},required:["execution","product","name","system","builder","date"]}}},{name:"delete",display:"删除版本",type:"delete",method:"delete",path:"/builds/{buildID}",resultType:"text",pathParams:{buildID:"版本ID"}}]},{name:"testtask",display:"测试单",description:"测试单管理,支持获取测试单列表,支持获取产品/项目/执行下的测试单、创建测试单、修改测试单、删除测试单",actions:[{name:"list",display:"获取测试单列表,支持获取产品/项目/执行下的测试单",type:"list",method:"get",path:"/{scope}/{scopeID}/testtasks",resultType:"list",pagerGetter:"pager",resultGetter:"testtasks",pathParams:{scope:{description:"测试单范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"范围ID"}},{name:"create",display:"创建测试单",type:"create",method:"post",path:"/testtasks",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品ID",format:"int32"},name:{type:"string",description:"测试单名称"},build:{type:"integer",description:"提测构建/版本",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},type:{type:"array",items:{type:"string"},description:"类型(integrate 集成测试 | system 系统测试 | acceptance 验收测试 | performance 性能测试 | safety 安全测试)"},owner:{type:"string",description:"负责人"},status:{type:"string",description:"状态(wait 未开始 | doing 进行中 | done 已关闭 | blocked 被阻塞)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},desc:{type:"string",description:"描述"}},required:["productID","name","build","begin","end"]}}},{name:"update",display:"修改测试单",type:"update",method:"put",path:"/testtasks/{testtaskID}",resultType:"object",pathParams:{testtaskID:"测试单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"测试单名称"},build:{type:"integer",description:"提测构建/版本",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},type:{type:"array",items:{type:"string"},description:"类型(integrate 集成测试 | system 系统测试 | acceptance 验收测试 | performance 性能测试 | safety 安全测试)"},owner:{type:"string",description:"负责人"},status:{type:"string",description:"状态(wait 未开始 | doing 进行中 | done 已关闭 | blocked 被阻塞)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},desc:{type:"string",description:"描述"}},required:["name","build","begin","end"]}}},{name:"delete",display:"删除测试单",type:"delete",method:"delete",path:"/testtasks/{testtaskID}",resultType:"text",pathParams:{testtaskID:"测试单ID"}}]},{name:"release",display:"发布",description:"发布管理,支持获取发布列表,支持获取产品下的发布、创建发布、修改发布、删除发布",actions:[{name:"list",display:"获取发布列表,支持获取产品下的发布",type:"list",method:"get",path:"/{scope}/{scopeID}/releases",resultType:"list",pagerGetter:"pager",resultGetter:"releases",pathParams:{scope:{description:"发布范围",options:[{value:"products",label:"产品"}]},scopeID:"范围ID"}},{name:"create",display:"创建发布",type:"create",method:"post",path:"/releases",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},system:{type:"integer",description:"所属应用",format:"int32"},name:{type:"string",description:"应用版本号"},build:{type:"array",items:{type:"string"},description:"包含构建"},status:{type:"string",description:"状态(wait 未开始 | normal 已发布 | fail 发布失败 | terminate 停止维护)"},date:{type:"string",description:"计划发布日期"},desc:{type:"string",description:"描述"}},required:["productID","system","name","build","date"]}}},{name:"update",display:"修改发布",type:"update",method:"put",path:"/releases/{releasID}",resultType:"object",pathParams:{releasID:"发布ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{system:{type:"integer",description:"所属应用",format:"int32"},name:{type:"string",description:"应用版本号"},build:{type:"array",items:{type:"string"},description:"包含构建"},status:{type:"string",description:"状态(wait 未开始 | normal 已发布 | fail 发布失败 | terminate 停止维护)"},date:{type:"string",description:"计划发布日期"},desc:{type:"string",description:"描述"}},required:["system","name","build","date"]}}},{name:"delete",display:"删除发布",type:"delete",method:"delete",path:"/releases/{releasID}",resultType:"text",pathParams:{releasID:"发布ID"}}]},{name:"file",display:"附件",description:"附件管理,支持编辑附件,修改附件的名称、删除附件",actions:[{name:"create",display:"编辑附件,修改附件的名称",type:"create",method:"post",path:"/files",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{fileName:{type:"string",description:"附件名称"}},required:["fileName"]}}},{name:"delete",display:"删除附件",type:"delete",method:"delete",path:"/files/{fileID}",resultType:"text",pathParams:{fileID:"附件ID"}}]}];var TX={list:"get",get:"get",create:"post",update:"put",delete:"delete",action:"post"},MX={list:"list",get:"object",create:"object",update:"object",delete:"text",action:"text"},RQ=SX(wX()),uQ=dQ(RQ);function I(Q){if(Array.isArray(Q))return Q.map((X)=>I(X));if(Q&&typeof Q==="object"&&!(Q instanceof Function)){let X={};for(let[$,J]of Object.entries(Q))X[$]=I(J);return X}return Q}function VQ(Q,X){if(!K(X))return X===void 0?Q:I(X);let $=K(Q)?{...Q}:{};for(let[J,W]of Object.entries(X)){if(W===void 0)continue;let D=$[J];$[J]=K(W)&&K(D)?VQ(D,W):I(W)}return $}function wX(){return I(cQ)}function OQ(Q){if(Q===null||typeof Q!=="object")return Q;if(Object.isFrozen(Q))return Q;for(let X of Object.keys(Q))OQ(Q[X]);return Object.freeze(Q)}function PX(Q){if(Q.method===void 0){let X=TX[Q.type];if(X===void 0)throw new q("E_INDETERMINATE_ACTION_METHOD",{action:String(Q.name),type:String(Q.type)});Q.method=X}if(Q.resultType===void 0){let X=MX[Q.type];if(X===void 0)throw new q("E_INDETERMINATE_ACTION_RESULT_TYPE",{action:String(Q.name),type:String(Q.type)});Q.resultType=X}return Q}function n(Q){return OQ(PX(Q))}function P(Q){return Q.actions.forEach(n),OQ(Q)}function SX(Q){return Q.forEach(P),Q}function o(Q,X){let $=X.toLowerCase();return Q.findIndex((J)=>String(J.name).toLowerCase()===$)}function xX(Q,X){let $=Q.slice();for(let J of X){let W=o($,String(J.name)),D=n(I(J));if(W>=0)$[W]=D;else $.push(D)}return $}function pQ(Q,X){return P({...Q,...I(X),actions:xX(Q.actions,X.actions)})}function dQ(Q){return new Map(Q.map((X)=>[X.name.toLowerCase(),X]))}function nQ(Q){if(!Q||typeof Q.name!=="string"||!Array.isArray(Q.actions))throw new q("E_INVALID_MODULE_DEFINITION")}function IQ(Q){if(!Q||typeof Q.name!=="string"||typeof Q.path!=="string")throw new q("E_INVALID_ACTION_DEFINITION");if(Q.method!==void 0&&typeof Q.method!=="string")throw new q("E_INVALID_ACTION_DEFINITION");if(Q.resultType!==void 0&&typeof Q.resultType!=="string")throw new q("E_INVALID_ACTION_DEFINITION")}function k(){return RQ}function i(){return uQ}function e(){uQ=dQ(RQ)}var EX;function iQ(Q){EX=Q}function QQ(Q,X={}){let $=k();for(let J of Z(Q)){nQ(J);let W=J.name.toLowerCase(),D=$.findIndex((Y)=>Y.name.toLowerCase()===W);if(D>=0)$[D]=X.replace?P(I(J)):pQ($[D],J);else $.push(P(I(J)))}e()}function XQ(Q,X){let $=Q.toLowerCase(),J=i().get($);if(!J)throw new q("E_INVALID_MODULE",{module:Q});let W=J.actions.slice();for(let B of Z(X)){IQ(B);let C=o(W,String(B.name)),L=n(I(B));if(C>=0)W[C]=L;else W.push(L)}let D=P({...J,actions:W}),Y=k(),G=Y.findIndex((B)=>B.name.toLowerCase()===$);Y[G]=D,e()}function _(Q,X,$){let J=Q.toLowerCase(),W=i().get(J);if(!W)throw new q("E_INVALID_MODULE",{module:Q});let D=W.actions.slice(),Y=o(D,X);if(Y<0)throw new q("E_INVALID_ACTION",{module:Q,action:X});let G=D[Y],B=typeof $==="function"?$(I(G)):VQ(G,$);IQ(B),D[Y]=n(B);let C=P({...W,actions:D}),L=k(),H=L.findIndex((A)=>A.name.toLowerCase()===J);L[H]=C,e()}function FQ(){_("execution","create",(Q)=>{let X=Q.requestBody.schema?.required;if(Array.isArray(X)&&!X.includes("products"))X.push("products");return Q}),_("story","update",(Q)=>{let X=Q.requestBody.schema?.properties;if(X&&!X.plan)X.plan={type:"integer",description:"所属计划",format:"int32"};if(X&&X.category)X.category={type:"string",description:"类别"};return Q}),_("task","list",(Q)=>{return Q.path="/executions/{executionID}/tasks",Q.pathParams={executionID:"执行ID"},Q}),[["product","create"],["product","update"],["execution","create"],["execution","update"]].forEach(([Q,X])=>{_(Q,X,($)=>{let J=$.requestBody.schema?.properties;if(J.acl&&J.acl.defaultValue===void 0)J.acl.defaultValue="open";return $})})}function S(Q){let X=i().get(Q.toLowerCase());if(!X)throw new q("E_INVALID_MODULE",{module:Q});return X}function z(Q,X){let $=S(Q),J=X==="ls"?"list":X,W=$.actions.find((Y)=>String(Y.name).toLowerCase()===J.toLowerCase());if(W)return W;if(!new Set(["list","get","create","update","delete"]).has(J)){let Y=$.actions.find((G)=>G.type==="action"&&String(G.name).toLowerCase()===J.toLowerCase());if(Y)return Y}throw new q("E_INVALID_ACTION",{module:Q,action:X})}function $Q(){return k().map((Q)=>Q.name)}iQ(FQ);FQ();var NX={product:"products",project:"projects",execution:"executions"},kX=["execution","project","product"];function gX(Q){for(let X of kX){let $=Q[X]??Q[`${X}ID`];if($===void 0||$===null||$==="")continue;let J=Number($);if(!Number.isNaN(J))return{scope:NX[X],scopeID:J}}return}function hX(Q,X){return Q.path.replace(/\{(\w+)\}/g,($,J)=>{let W=X[J];if(W===void 0||W==="")throw new q("E_MISSING_PARAM",{param:J});return String(W)})}function fX(Q){if(Q===void 0)return;if(typeof Q==="string")try{let X=JSON.parse(Q);return X&&typeof X==="object"&&!Array.isArray(X)?X:void 0}catch{return}return Q&&typeof Q==="object"&&!Array.isArray(Q)?Q:void 0}var bX=new Set(["true","1","yes","on"]),yX=new Set(["false","0","no","off"]);function vX(Q,X,$){if(Q===void 0||Q===null)return Q;if(X==="number"||X==="integer"){let J=Number(Q);return Number.isNaN(J)?Q:J}if(X==="boolean"){if(typeof Q==="boolean")return Q;if(typeof Q==="number"){if(Q===1)return!0;if(Q===0)return!1;throw new q("E_INVALID_PARAM",{param:$,value:String(Q)})}if(typeof Q==="string"){let J=Q.trim().toLowerCase();if(bX.has(J))return!0;if(yX.has(J))return!1;throw new q("E_INVALID_PARAM",{param:$,value:Q})}throw new q("E_INVALID_PARAM",{param:$,value:String(Q)})}return Q}function lQ(Q,X,$={}){let J=z(Q.name,X),W={},D=Object.keys(J.pathParams??{});if(D.includes("scope")){let H=gX($);if(!H)throw new q("E_MISSING_PARAM",{param:"product/project/execution"});W.scope=H.scope,W.scopeID=H.scopeID}let Y=D.find((H)=>H.endsWith("ID")&&H!=="scopeID"),G=$.id??$[`${Q.name}ID`]??(Y?$[Y]:void 0),B=G===void 0?void 0:Number(G);if(Y&&B!==void 0&&!Number.isNaN(B))W[Y]=B;for(let H of D){if(H==="scope"||H==="scopeID"||W[H]!==void 0)continue;let A=J.pathParams?.[H],U=$[H];if(U!==void 0){W[H]=U;continue}if(typeof A==="object"){if(A.defaultValue!==void 0)W[H]=A.defaultValue;else if(A.options?.[0]?.value!==void 0)W[H]=A.options[0].value}if(W[H]===void 0)throw new q("E_MISSING_PARAM",{param:H})}let C={};for(let H of J.params??[]){let A=$[H.name];if(A===void 0&&H.name==="pageID")A=$.page;if(A===void 0)A=H.defaultValue??H.options?.[0]?.value;if(A===void 0&&H.required)throw new q("E_MISSING_PARAM",{param:H.name});if(A!==void 0)C[H.name]=A}let L=fX($.data);if(J.requestBody?.schema?.type==="object"){L=L?{...L}:{};let H=J.requestBody.schema,A=new Set(H.required??[]);for(let[U,O]of Object.entries(H.properties??{})){let T=Object.prototype.hasOwnProperty.call(L,U),x=Object.prototype.hasOwnProperty.call($,U),R=T?L[U]:x?$[U]:O.defaultValue;if(R===void 0&&(O.required||A.has(U)))throw new q("E_MISSING_PARAM",{param:U});if(R=vX(R,O.type,U),O.type==="array"&&R!==void 0&&R!==null&&!Array.isArray(R)){if(typeof R==="string")R=R.split(",");else if(!T||!K(R))R=[R]}if(R!==void 0)L[U]=R}}return{module:Q.name,action:J,params:$,path:hX(J,W),query:C,data:L,id:B===void 0||Number.isNaN(B)?void 0:B}}function sQ(Q,X,$={}){let J=Q.resultGetter;if(!J)return X.data??X;if(typeof J==="function")return J(X,$);if(typeof J==="string")return V(X,J);let W={};for(let[D,Y]of Object.entries(J))W[D]=V(X,Y);return W}function tQ(Q,X,$={}){let J=Q.pagerGetter;if(!J)return X.pager;if(typeof J==="function")return J(X,$);if(typeof J==="string")return V(X,J);let W=V(X,J.pageID),D=V(X,J.recPerPage),Y=V(X,J.recTotal);if(W===void 0||D===void 0||Y===void 0)return;return{pageID:Number(W),recPerPage:Number(D),recTotal:Number(Y)}}function mX(Q){let X=Q.split("/");if(X.length>2||!X[0])throw new q("E_INVALID_REQUEST_NAME");let[$,J]=X;if(!J?.length)return{moduleName:$,actionName:"list"};if(Number.isInteger(Number(J)))return{moduleName:$,actionName:"get",id:Number(J)};return{moduleName:$,actionName:J}}function cX(Q){let X=Q;if(typeof X==="string")try{X=JSON.parse(X)}catch{return new Set}if(X&&typeof X==="object"&&!Array.isArray(X))return new Set(Object.keys(X));return new Set}async function uX(Q,X,$,J){let W=X.requestBody?.schema?.properties,D=Q.actions.find((C)=>C.type==="get");if(!W||!D)return $;let Y=(await JQ(`${Q.name}/${D.name}`,$,{client:J.client,timeout:J.timeout,insecure:J.insecure,throwOnFail:J.throwOnFail})).data;if(!K(Y))return $;let G=cX($.data),B={...$};for(let C of Object.keys(W))if(!(Object.prototype.hasOwnProperty.call($,C)||G.has(C))&&Object.prototype.hasOwnProperty.call(Y,C))B[C]=Y[C];return B}function pX(Q){if(typeof Q==="string")return Q;if(Q===void 0)return;try{return JSON.stringify(Q)}catch{return String(Q)}}function dX(Q){for(let X of["code","errorCode","errno"]){let $=Q[X];if(typeof $==="string"||typeof $==="number")return $}return}function nX(Q){return Boolean(Q.filter&&Q.filter.length>0||Q.search&&Q.search.length>0||Q.sort||Q.limit||Q.pick&&Q.pick.length>0)}function iX(Q,X){if(Array.isArray(Q)){if(!nX(X))return Q;if(Q.every(K))return M(Q,{filter:X.filter,search:X.search,searchFields:X.searchFields,sort:X.sort,limit:X.limit,pick:X.pick});let $=Number(X.limit);return Number.isFinite($)&&$>=0?Q.slice(0,Math.floor($)):Q}if(K(Q)&&X.pick&&X.pick.length>0)return M(Q,{pick:X.pick});return Q}function lX(Q,X,$){if(!X||typeof X!=="object"||Array.isArray(X))return{status:"success",data:X};let J=X,W=J.status==="fail"?"fail":"success",D=iX(sQ(Q.action,J,Q.params),$),Y=J.message,G=tQ(Q.action,J,Q.params),B={status:W,message:pX(Y),data:D,pager:G?{total:Number(G.recTotal),page:Number(G.pageID),recPerPage:Number(G.recPerPage)}:void 0};if(Y!==void 0&&typeof Y!=="string")B.rawMessage=Y;let C=dX(J);if(C!==void 0)B.apiCode=C;if(W==="fail")B.raw=J;return B}async function JQ(Q,X={},$={}){let J=j(),W=$.client??J.client;if(!W)throw new q("E_NO_GLOBAL_CLIENT");let{moduleName:D,actionName:Y,id:G}=mX(Q),B=S(D),C=X.recPerPage??$.recPerPage??J.recPerPage,L={...X,...G!==void 0?{id:G}:{},...C!==void 0?{recPerPage:C}:{}},H=z(D,Y),A=H.type==="update"&&($.autoFill??J.autoFill)?await uX(B,H,L,$):L,U=lQ(B,Y,A),O=await W.request(U.path,{method:String(U.action.method).toUpperCase(),query:U.query,body:U.data,timeout:$.timeout??J.timeout,insecure:$.insecure??J.insecure}),T={...$,limit:$.limit??J.limit},x=lX(U,O,T);if(x.status==="fail"&&($.throwOnFail??J.throwOnFail))throw new q("E_API_FAILED",{message:x.message??""},x);return x}var _Q="2026-06-30T10:00:59.615Z",jQ="0.3.3";var ZQ=globalThis;ZQ.ZentaoAPI=WQ;if(ZQ.window)ZQ.window.ZentaoAPI=WQ;})();
1
+ (()=>{var{defineProperty:YX,getOwnPropertyNames:aX,getOwnPropertyDescriptor:oX}=Object,eX=Object.prototype.hasOwnProperty;function X1(X){return this[X]}var $1=(X)=>{var $=(TX??=new WeakMap).get(X),Q;if($)return $;if($=YX({},"__esModule",{value:!0}),X&&typeof X==="object"||typeof X==="function"){for(var J of aX(X))if(!eX.call($,J))YX($,J,{get:X1.bind(X,J),enumerable:!(Q=oX(X,J))||Q.enumerable})}return TX.set(X,$),$},TX;var Q1=(X)=>X;function J1(X,$){this[X]=Q1.bind(null,$)}var MX=(X,$)=>{for(var Q in $)YX(X,Q,{get:$[Q],enumerable:!0,configurable:!0,set:J1.bind($,Q)})};var o1={};MX(o1,{switchProfile:()=>c,sortData:()=>f,setGlobalOptions:()=>E,searchData:()=>h,request:()=>WX,processData:()=>z,pickFieldsSingle:()=>S,pickFields:()=>k,getProfileKey:()=>I,getProfile:()=>VX,getModuleNames:()=>JX,getModuleActionParams:()=>QX,getModuleAction:()=>R,getModule:()=>P,getGlobalOptions:()=>Z,getAllProfiles:()=>AX,filterData:()=>g,extendModuleAction:()=>F,deleteProfile:()=>KX,defineModules:()=>XX,defineModuleActions:()=>$X,addProfile:()=>m,ZentaoError:()=>H,ZentaoClient:()=>T,ZENTAO_PROFILES_STORAGE_KEY:()=>y,VERSION:()=>jX,ERRORS:()=>i,BUILD:()=>ZX});var DX={};MX(DX,{switchProfile:()=>c,sortData:()=>f,setGlobalOptions:()=>E,searchData:()=>h,request:()=>WX,processData:()=>z,pickFieldsSingle:()=>S,pickFields:()=>k,getProfileKey:()=>I,getProfile:()=>VX,getModuleNames:()=>JX,getModuleActionParams:()=>QX,getModuleAction:()=>R,getModule:()=>P,getGlobalOptions:()=>Z,getAllProfiles:()=>AX,filterData:()=>g,extendModuleAction:()=>F,deleteProfile:()=>KX,defineModules:()=>XX,defineModuleActions:()=>$X,addProfile:()=>m,ZentaoError:()=>H,ZentaoClient:()=>T,ZENTAO_PROFILES_STORAGE_KEY:()=>y,VERSION:()=>jX,ERRORS:()=>i,BUILD:()=>ZX});var i={E_INVALID_BASE_URL:"Invalid ZenTao baseUrl.",E_NO_GLOBAL_CLIENT:"No global client configured. Call ZentaoClient.init() or pass options.client.",E_HTTP_ERROR:"HTTP request failed: {status} {statusText}",E_NETWORK_ERROR:"Network request failed: {message}",E_TIMEOUT:"Request timed out.",E_INSECURE_BROWSER:"The insecure option is only supported in Node.js runtimes.",E_LOGIN_FAILED:"ZenTao login failed.",E_INVALID_PROFILE:"Invalid ZenTao profile.",E_NO_PROFILE:"No ZenTao profile is configured.",E_PROFILE_NOT_FOUND:"ZenTao profile not found: {profileKey}",E_PROFILE_STORAGE_INVALID:"ZenTao profile storage is not valid JSON.",E_PROFILE_STORAGE_UNAVAILABLE:"ZenTao profile storage is unavailable in this runtime.",E_INVALID_MODULE:"Unknown module: {module}",E_INVALID_ACTION:"Unknown action: {module}-{action}",E_INVALID_MODULE_DEFINITION:"Invalid module definition.",E_INVALID_ACTION_DEFINITION:"Invalid module action definition.",E_INDETERMINATE_ACTION_METHOD:'Cannot infer HTTP method for action "{action}" from type "{type}"; specify "method" explicitly.',E_INDETERMINATE_ACTION_RESULT_TYPE:'Cannot infer result type for action "{action}" from type "{type}"; specify "resultType" explicitly.',E_MISSING_PARAM:"Missing required parameter: {param}",E_INVALID_PARAM:"Invalid value for parameter {param}: {value}",E_INVALID_REQUEST_NAME:'Request name must use the form "moduleName", "moduleName/methodName", or "moduleName/<objectID>".',E_API_FAILED:"ZenTao API returned failure: {message}"};class H extends Error{code;details;constructor(X,$,Q){let J=i[X];if($)for(let[W,D]of Object.entries($))J=J.replaceAll(`{${W}}`,String(D));super(J);this.name="ZentaoError",this.code=X,this.details=Q}}function l(){return typeof process<"u"&&Boolean(process.versions?.node)}function PX(X){return import(X)}function W1(X){let $={};return new Headers(X).forEach((Q,J)=>{$[J]=Q}),$}function D1(X){let $=new Headers;for(let[Q,J]of Object.entries(X)){if(J===void 0)continue;$.set(Q,Array.isArray(J)?J.join(", "):String(J))}return $}function HX(X,$){let Q=$.toLowerCase();return Object.keys(X).some((J)=>J.toLowerCase()===Q)}async function Y1(X,$){if(X===void 0||X===null)return;if(typeof X==="string")return X;if(X instanceof Uint8Array)return X;if(X instanceof ArrayBuffer)return new Uint8Array(X);if(ArrayBuffer.isView(X))return new Uint8Array(X.buffer,X.byteOffset,X.byteLength);if(X instanceof Blob){if(X.type&&!HX($,"content-type"))$["content-type"]=X.type;return new Uint8Array(await X.arrayBuffer())}if(typeof FormData<"u"&&X instanceof FormData){let Q=new Request("https://zentao-api.local/",{method:"POST",body:X}),J=Q.headers.get("content-type");if(J&&!HX($,"content-type"))$["content-type"]=J;return new Uint8Array(await Q.arrayBuffer())}if(typeof URLSearchParams<"u"&&X instanceof URLSearchParams){if(!HX($,"content-type"))$["content-type"]="application/x-www-form-urlencoded;charset=UTF-8";return X.toString()}return String(X)}function wX(){return new DOMException("The operation was aborted.","AbortError")}function H1(X){let $=X.reduce((W,D)=>W+D.byteLength,0),Q=new Uint8Array($),J=0;for(let W of X)Q.set(W,J),J+=W.byteLength;return Q.buffer}async function q1(X,$,Q){let J=new URL(X),W=J.protocol==="https:"?await PX("node:https"):await PX("node:http"),D=W1($.headers),Y=await Y1($.body,D);return new Promise((B,G)=>{if($.signal?.aborted){G(wX());return}let q=W.request(J,{method:$.method??"GET",headers:D,rejectUnauthorized:Q},(K)=>{let O=[];K.on("data",(_)=>{O.push(typeof _==="string"?new TextEncoder().encode(_):_)}),K.on("end",()=>{L();let _=O.length>0?H1(O):void 0,p=new Response(_,{status:K.statusCode??200,statusText:K.statusMessage??"",headers:D1(K.headers)});Object.defineProperty(p,"url",{value:X}),B(p)})}),L=()=>{$.signal?.removeEventListener("abort",C)},C=()=>{L(),q.destroy(wX())};if(q.on("error",(K)=>{L(),G(K)}),$.signal?.addEventListener("abort",C,{once:!0}),Y!==void 0)q.write(Y);q.end()})}function qX(X){if(X&&!l())throw new H("E_INSECURE_BROWSER")}async function SX(X,$,Q){if(!X)return fetch($,Q);return qX(X),q1($,Q,!1)}var GX={};function Z(){return{...GX}}function E(X){GX={...GX,...X}}function U(X){return Boolean(X)&&typeof X==="object"&&!Array.isArray(X)}function s(X){return X===void 0||X===null||X===""}function A(X,$){let Q=$.split("."),J=X;for(let W of Q){if(J===null||J===void 0||typeof J!=="object")return;J=J[W]}return J}function j(X){return Array.isArray(X)?X:[X]}function w(X){let $=X.trim().replace(/\/+$/,"");if(!$)throw new H("E_INVALID_BASE_URL");let Q=$.replace(/\/api\.php\/v2$/i,""),J;try{J=new URL(Q)}catch{throw new H("E_INVALID_BASE_URL")}if(!["http:","https:"].includes(J.protocol)||J.search||J.hash)throw new H("E_INVALID_BASE_URL");return J.toString().replace(/\/+$/,"")}function S(X,$){let Q={};for(let J of $){let W=A(X,J);if(W===void 0)continue;let D=J.split("."),Y=Q;for(let B=0;B<D.length-1;B++){let G=D[B];if(!U(Y[G]))Y[G]={};Y=Y[G]}Y[D[D.length-1]]=W}return Q}function k(X,$){return X.map((Q)=>S(Q,$))}function N(X,$){let Q=Number(X),J=Number($);if(X!==""&&$!==""&&!Number.isNaN(Q)&&!Number.isNaN(J))return Q-J;return String(X).localeCompare(String($))}function xX(X,$){let Q=Number(X),J=Number($);if(X!==""&&$!==""&&!Number.isNaN(Q)&&!Number.isNaN(J))return Q===J;return String(X)===String($)}function EX(X,$){if(X===void 0||X===null)return!1;let Q=String(X).toLowerCase();return j($).some((J)=>Q.includes(String(J).toLowerCase()))}function NX(X,$){let Q=A(X,$.key),{operator:J,value:W}=$;switch(J){case"=":return j(W).some((D)=>xX(Q,D));case"!=":return j(W).every((D)=>!xX(Q,D));case"~":return EX(Q,W);case"!~":return!EX(Q,W);case">":return N(Q,W)>0;case"<":return N(Q,W)<0;case">=":return N(Q,W)>=0;case"<=":return N(Q,W)<=0;default:return!1}}function G1(X,$){if($.conditions.length===0)return!0;return $.operator==="OR"?$.conditions.some((Q)=>NX(X,Q)):$.conditions.every((Q)=>NX(X,Q))}function g(X,$){if($.length===0)return X.slice();return X.filter((Q)=>$.every((J)=>G1(Q,J)))}function t(X,$){if(X===null||X===void 0)return;if(Array.isArray(X))for(let Q of X)t(Q,$);else if(U(X))for(let Q of Object.values(X))t(Q,$);else $.push(String(X))}function B1(X,$){let Q=[];if($&&$.length>0)for(let J of $)t(A(X,J),Q);else t(X,Q);return Q.join("\x00").toLowerCase()}function h(X,$,Q){let J=$.map((W)=>W.toLowerCase().split(/\s+/).filter(Boolean)).filter((W)=>W.length>0);if(J.length===0)return X.slice();return X.filter((W)=>{let D=B1(W,Q);return J.every((Y)=>Y.some((B)=>D.includes(B)))})}function C1(X){if(typeof X==="function")return X;let $=X.lastIndexOf(":"),Q=$>=0?X.slice(0,$):X,W=($>=0?X.slice($+1):"asc")==="desc"?-1:1;return(D,Y)=>N(A(D,Q),A(Y,Q))*W}function f(X,$){let Q=$.map(C1);return X.slice().sort((J,W)=>{for(let D of Q){let Y=D(J,W);if(Y!==0)return Y}return 0})}var L1=[">=","<=","!=","!~","=","~",">","<"];function U1(X){if(X.startsWith("[")&&X.endsWith("]"))return X.slice(1,-1).split(",").map(($)=>$.trim()).filter(Boolean);if(X==="true")return!0;if(X==="false")return!1;if(X!==""&&!Number.isNaN(Number(X)))return Number(X);return X}function A1(X){for(let $ of L1){let Q=X.indexOf($);if(Q>0)return{key:X.slice(0,Q).trim(),operator:$,value:U1(X.slice(Q+$.length).trim())}}return}function V1(X){if(X===void 0||X==="")return;let $=Number(X);if(!Number.isFinite($)||$<0)return;return Math.floor($)}function z(X,$){if(!Array.isArray(X))return $.pick?S(X,$.pick):{...X};let Q=$,J=X;if(Q.filter&&Q.filter.length>0){let D=Q.filter.map(A1).filter((Y)=>Y!==void 0);if(D.length>0)J=g(J,[{operator:"AND",conditions:D}])}if(Q.search&&Q.search.length>0)J=h(J,Q.search,Q.searchFields);if(Q.sort){let D=Q.sort.split(",").map((Y)=>Y.trim()).filter(Boolean);if(D.length>0)J=f(J,D)}let W=V1(Q.limit);if(W!==void 0)J=J.slice(0,W);if(Q.pick)J=k(J,Q.pick);return J}var y="ZENTAO_PROFILES",K1=[".config","zentao","zentao.json"];function hX(X){return Boolean(X)&&typeof X==="object"&&!Array.isArray(X)}function fX(X){if(X===void 0)return X;return JSON.parse(JSON.stringify(X))}function bX(){return new Date().toISOString()}function b(X){return import(X)}var kX=Promise.resolve();function BX(X){let $=kX.then(X,X);return kX=$.catch(()=>{return}),$}function yX(){try{return globalThis.localStorage}catch{return}}async function vX(){let X=await b("node:path"),$=process.env.HOME??process.env.USERPROFILE??(await b("node:os")).homedir();if(!$)throw new H("E_PROFILE_STORAGE_UNAVAILABLE");return X.join($,...K1)}function O1(X,$){let Q=X.trim(),J=w($);if(!Q)throw new H("E_INVALID_PROFILE");return`${Q}@${J}`}function CX(X){if(!hX(X)||typeof X.server!=="string"||typeof X.account!=="string"||typeof X.token!=="string")throw new H("E_INVALID_PROFILE");let $=X.token.trim();if(!$)throw new H("E_INVALID_PROFILE");let Q=fX(X);return delete Q.key,{...Q,server:w(X.server),account:X.account.trim(),token:$}}function mX(X){if(!hX(X))return{profiles:[]};let $=Array.isArray(X.profiles)?X.profiles.flatMap((J)=>{try{return[CX(J)]}catch{return[]}}):[],Q=typeof X.currentProfile==="string"?X.currentProfile:void 0;return Q?{currentProfile:Q,profiles:$}:{profiles:$}}function gX(X){try{return mX(JSON.parse(X))}catch($){throw new H("E_PROFILE_STORAGE_INVALID",void 0,$)}}async function v(){if(l()){let Q=await b("node:fs/promises"),J=await vX();try{return gX(await Q.readFile(J,"utf8"))}catch(W){if(W.code==="ENOENT")return{profiles:[]};throw W}}let X=yX();if(!X)throw new H("E_PROFILE_STORAGE_UNAVAILABLE");let $=X.getItem(y);return $?gX($):{profiles:[]}}async function LX(X){let $=mX(X),Q=`${JSON.stringify($,null,2)}
2
+ `;if(l()){let W=await b("node:fs/promises"),D=await b("node:path"),Y=await vX(),B=D.dirname(Y),G=D.join(B,`.zentao.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`);await W.mkdir(B,{recursive:!0,mode:448}),await W.chmod(B,448).catch(()=>{return});try{await W.writeFile(G,Q,{encoding:"utf8",mode:384}),await W.rename(G,Y),await W.chmod(Y,384).catch(()=>{return})}catch(q){throw await W.rm(G,{force:!0}).catch(()=>{return}),q}return}let J=yX();if(!J)throw new H("E_PROFILE_STORAGE_UNAVAILABLE");J.setItem(y,Q)}function r(X){let $=CX(X);return{...fX($),key:I($)}}function UX(X,$){return X.profiles.find((Q)=>I(Q)===$)}function I1(X){if(!X.currentProfile||!UX(X,X.currentProfile)){let $=X.profiles.at(-1);X.currentProfile=$?I($):void 0}}function I(X){return O1(X.account,X.server)}async function AX(){return(await v()).profiles.map(r)}async function VX(X){let $=await v(),Q=X??$.currentProfile;if(!Q)return;let J=UX($,Q);return J?r(J):void 0}function m(X){return BX(async()=>{let $=await v(),Q=bX(),J=CX({...X,loginTime:X.loginTime??Q,lastUsedTime:X.lastUsedTime??Q}),W=I(J),D=$.profiles.findIndex((Y)=>I(Y)===W);if(D>=0)$.profiles[D]=J;else $.profiles.push(J);return $.currentProfile=W,await LX($),r(J)})}function KX(X){return BX(async()=>{let $=await v(),Q=$.profiles.filter((J)=>I(J)!==X);if(Q.length===$.profiles.length)return!1;return $.profiles=Q,I1($),await LX($),!0})}function c(X){return BX(async()=>{let $=await v(),Q=X??$.currentProfile;if(!Q)throw new H("E_NO_PROFILE");let J=UX($,Q);if(!J)throw new H("E_PROFILE_NOT_FOUND",{profileKey:Q});return J.lastUsedTime=bX(),$.currentProfile=Q,await LX($),r(J)})}var F1=1e4;function R1(X,$,Q){let J=$.startsWith("/")?$:`/${$}`,W=new URL(`${X}${J}`);for(let[D,Y]of Object.entries(Q??{})){if(Y===void 0)continue;W.searchParams.set(D,String(Y))}return W.toString()}function _1(X){if(!X||typeof X!=="object")return!1;let $=Object.getPrototypeOf(X);return $===Object.prototype||$===null}function a(X,$){let Q=globalThis[$];return typeof Q==="function"&&X instanceof Q}function Z1(X){return X instanceof ArrayBuffer||ArrayBuffer.isView(X)}function cX(X,$,Q){if(Q===void 0)return;if(Array.isArray(Q)){for(let J of Q)cX(X,$,J);return}X.append($,Q===null?"":String(Q))}function j1(X,$,Q){if(X===void 0||X===null)return;if($==="form"){let J=X instanceof URLSearchParams?X:new URLSearchParams;if(!(X instanceof URLSearchParams)&&_1(X))for(let[W,D]of Object.entries(X))cX(J,W,D);else if(!(X instanceof URLSearchParams))throw new H("E_INVALID_PARAM",{param:"body",value:String(X)});if(!Q.has("Content-Type"))Q.set("Content-Type","application/x-www-form-urlencoded;charset=UTF-8");return J}if($==="raw"||typeof X==="string"||Z1(X)||a(X,"FormData")||a(X,"URLSearchParams")||a(X,"Blob")||a(X,"ReadableStream"))return X;if(!Q.has("Content-Type"))Q.set("Content-Type","application/json");return JSON.stringify(X)}function z1(X,$){let Q=new AbortController,J=()=>Q.abort($?.reason),W=setTimeout(()=>Q.abort(),X);if($?.aborted)J();else $?.addEventListener("abort",J,{once:!0});return{signal:Q.signal,cleanup:()=>{clearTimeout(W),$?.removeEventListener("abort",J)}}}async function T1(X,$="auto"){if($==="response")return X;if($==="arrayBuffer")return X.arrayBuffer();if($==="blob")return X.blob();if($==="text")return X.text();if($==="json"){let J=await X.text();return J===""?void 0:JSON.parse(J)}let Q=await X.text();if(Q==="")return;try{return JSON.parse(Q)}catch{return Q}}class T{siteUrl;baseUrl;token;timeout;insecure;constructor(X){let $=typeof X==="string"?{baseUrl:X}:X;this.siteUrl=w($.baseUrl),this.baseUrl=`${this.siteUrl}/api.php/v2`,this.token=$.token,this.timeout=$.timeout,this.insecure=$.insecure}async request(X,$={}){let Q=Z(),J=$.method??"GET",W=$.timeout??Q.timeout??this.timeout??F1,D=$.insecure??Q.insecure??this.insecure;qX(D);let Y=R1(this.baseUrl,X,$.query),B=new Headers($.headers);if(this.token)B.set("Token",this.token);let{signal:G,cleanup:q}=z1(W,$.signal),L={method:J,headers:B,signal:G};if($.body!==void 0&&J!=="GET")L.body=j1($.body,$.bodyType,B);try{let C=await SX(D,Y,L);if(!C.ok)throw new H("E_HTTP_ERROR",{status:C.status,statusText:C.statusText},{url:C.url,status:C.status,statusText:C.statusText,body:await C.text().catch(()=>{return})});return T1(C,$.responseType)}catch(C){if(C instanceof H)throw C;if(C instanceof DOMException&&C.name==="AbortError")throw new H("E_TIMEOUT");throw new H("E_NETWORK_ERROR",{message:C.message??String(C)},C)}finally{q()}}async get(X,$={}){return this.request(X,{...$,method:"GET"})}async post(X,$,Q={}){return this.request(X,{...Q,method:"POST",body:$})}async put(X,$,Q={}){return this.request(X,{...Q,method:"PUT",body:$})}async delete(X,$={}){return this.request(X,{...$,method:"DELETE"})}async login(X,$){let Q=await this.post("/users/login",{account:X,password:$});if(Q.status!=="success"||!Q.token)throw new H("E_LOGIN_FAILED");this.token=Q.token;let J=Z();if(J.persistProfiles){let W={},D=this.timeout??J.timeout,Y=this.insecure??J.insecure;if(D!==void 0)W.timeout=D;if(Y!==void 0)W.insecure=Y;await m({server:this.siteUrl,account:X,token:Q.token,user:U(Q.user)?Q.user:void 0,serverConfig:U(Q.serverConfig)?Q.serverConfig:void 0,config:Object.keys(W).length>0?W:void 0})}return Q.token}static create(X){return new T(X)}static init(X){let $=new T(X);return E({client:$}),$}static async fromProfile(X){let $=await c(X);return new T({baseUrl:$.server,token:$.token,timeout:typeof $.config?.timeout==="number"?$.config.timeout:void 0,insecure:typeof $.config?.insecure==="boolean"?$.config.insecure:void 0})}}var uX=[{name:"user",display:"用户",description:"用户管理,支持获取用户列表、创建用户、获取用户详情、修改用户信息、删除用户",actions:[{name:"list",display:"获取用户列表",type:"list",method:"get",path:"/users",resultType:"list",pagerGetter:"pager",resultGetter:"users",params:[{name:"browseType",required:!1,type:"string",description:"浏览类型",options:[{value:"inside",label:"内部用户"},{value:"outside",label:"内部用户"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"realname_asc",label:"姓名 升序"},{value:"realname_desc",label:"姓名 降序"},{value:"account_asc",label:"用户名 升序"},{value:"account_desc",label:"用户名 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建用户",type:"create",method:"post",path:"/users",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{account:{type:"string",description:"登录名"},realname:{type:"string",description:"姓名"},password:{type:"string",description:"密码"}},required:["account","realname","password"]}}},{name:"get",display:"获取用户详情",type:"get",method:"get",path:"/users/{userID}",resultType:"object",resultGetter:"user",pathParams:{userID:"用户ID"}},{name:"update",display:"修改用户信息",type:"update",method:"put",path:"/users/{userID}",resultType:"object",pathParams:{userID:"用户ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{realname:{type:"string",description:"真实姓名"},dept:{type:"integer",description:"部门",format:"int32"},join:{type:"string",description:"入职日期"},group:{type:"array",items:{type:"string"},description:"权限分组"},email:{type:"string",description:"邮箱"},visions:{type:"array",items:{type:"string"},description:"界面类型(研发综合界面 rnd | 运营管理界面 lite)"},mobile:{type:"string",description:"手机"},weixin:{type:"string",description:"微信"},password:{type:"string",description:"密码"}}}}},{name:"delete",display:"删除用户",type:"delete",method:"delete",path:"/users/{userID}",resultType:"text",pathParams:{userID:"用户ID"}}]},{name:"program",display:"项目集",description:"项目集管理,支持获取项目集列表、创建项目集、获取项目集详情、修改项目集、删除项目集",actions:[{name:"list",display:"获取项目集列表",type:"list",method:"get",path:"/programs",resultType:"list",pagerGetter:"pager",resultGetter:"programs",params:[{name:"status",required:!1,type:"string",description:"状态",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"},{value:"suspended",label:"已挂起"},{value:"delayed",label:"已延期"},{value:"closed",label:"已关闭"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"name_asc",label:"名称 升序"},{value:"name_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建项目集",type:"create",method:"post",path:"/programs",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目集名称"},begin:{type:"string",description:"计划开始日期"},end:{type:"string",description:"计划完成日期"},PM:{type:"string",description:"计划完成日期"},desc:{type:"string",description:"项目集描述"}},required:["name","begin","end"]}}},{name:"get",display:"获取项目集详情",type:"get",method:"get",path:"/programs/{programID}",resultType:"object",resultGetter:"program",pathParams:{programID:"项目集ID"}},{name:"update",display:"修改项目集",type:"update",method:"put",path:"/programs/{programID}",resultType:"object",pathParams:{programID:"项目集ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目集名称"},begin:{type:"string",description:"计划开始日期"},end:{type:"string",description:"计划完成日期"},PM:{type:"string",description:"计划完成日期"},desc:{type:"string",description:"项目集描述"}},required:["name","begin","end"]}}},{name:"delete",display:"删除项目集",type:"delete",method:"delete",path:"/programs/{programID}",resultType:"text",pathParams:{programID:"项目集ID"}}]},{name:"product",display:"产品",description:"产品管理,支持获取产品列表、创建产品、获取产品详情、修改产品、删除产品",actions:[{name:"list",display:"获取产品列表",type:"list",method:"get",path:"/products",resultType:"list",pagerGetter:"pager",resultGetter:"products",params:[{name:"browseType",required:!1,type:"string",description:"浏览类型",options:[{value:"all",label:"全部"},{value:"noclosed",label:"未关闭"},{value:"closed",label:"已结束"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"名称 升序"},{value:"title_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建产品",type:"create",method:"post",path:"/products",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"产品名称"},program:{type:"integer",description:"所属项目集",format:"int32"},line:{type:"integer",description:"所属产品线",format:"int32"},type:{type:"string",description:"类型(normal 正常 | branch 多分支 | platform 多平台)"},PO:{type:"string",description:"产品负责人"},reviewer:{type:"array",items:{type:"string"},description:"评审人"},desc:{type:"array",items:{type:"string"},description:"产品描述"},QD:{type:"string",description:"测试负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["name"]}}},{name:"get",display:"获取产品详情",type:"get",method:"get",path:"/products/{productID}",resultType:"object",resultGetter:"product",pathParams:{productID:"产品ID"}},{name:"update",display:"修改产品",type:"update",method:"put",path:"/products/{productID}",resultType:"object",pathParams:{productID:"产品ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"产品名称"},program:{type:"integer",description:"所属项目集",format:"int32"},line:{type:"integer",description:"所属产品线",format:"int32"},type:{type:"string",description:"类型(normal 正常 | branch 多分支 | platform 多平台)"},PO:{type:"string",description:"产品负责人"},reviewer:{type:"array",items:{type:"string"},description:"评审人"},desc:{type:"array",items:{type:"string"},description:"产品描述"},QD:{type:"string",description:"测试负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["name"]}}},{name:"delete",display:"删除产品",type:"delete",method:"delete",path:"/products/{productID}",resultType:"text",pathParams:{productID:"产品ID"}}]},{name:"project",display:"项目",description:"项目管理,支持获取项目列表、创建项目、修改项目、删除项目",actions:[{name:"list",display:"获取项目列表",type:"list",method:"get",path:"/projects",resultType:"list",pagerGetter:"pager",resultGetter:"projects",params:[{name:"browseType",required:!1,type:"string",description:"项目状态,默认是undone",defaultValue:"undone",options:[{value:"all",label:"全部"},{value:"undone",label:"未完成"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"name_asc",label:"名称 升序"},{value:"name_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建项目",type:"create",method:"post",path:"/projects",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目名称"},model:{type:"string",description:"项目管理方式(scrum 敏捷 | waterfall 瀑布 | kanban 看板 | agileplus 融合敏捷 | waterfallplus 融合瀑布)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},products:{type:"array",items:{type:"string"},description:"关联产品"},parent:{type:"integer",description:"所属项目集",format:"int32"},workflowGroup:{type:"integer",description:"项目流程,付费版功能,开源版可以不填",format:"int32"},PM:{type:"string",description:"项目负责人"}},required:["name","model","begin","end","workflowGroup"]}}},{name:"update",display:"修改项目",type:"update",method:"put",path:"/projects/{projectID}",resultType:"object",pathParams:{projectID:"项目ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"项目名称"},model:{type:"string",description:"项目管理方式(scrum 敏捷 | waterfall 瀑布 | kanban 看板 | agileplus 融合敏捷 | waterfallplus 融合瀑布)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},products:{type:"array",items:{type:"string"},description:"关联产品"},parent:{type:"integer",description:"所属项目集",format:"int32"},workflowGroup:{type:"integer",description:"项目流程,付费版功能,开源版可以不填",format:"int32"},PM:{type:"string",description:"项目负责人"}},required:["name","model","begin","end","workflowGroup"]}}},{name:"delete",display:"删除项目",type:"delete",method:"delete",path:"/projects/{projectID}",resultType:"text",pathParams:{projectID:"项目ID"}}]},{name:"execution",display:"执行",description:"执行管理,支持获取执行列表、创建执行、获取执行详情、修改执行、删除执行",actions:[{name:"list",display:"获取执行列表",type:"list",method:"get",path:"/executions",resultType:"list",pagerGetter:"pager",resultGetter:"executions",params:[{name:"status",required:!1,type:"string",description:"执行状态,默认是undone",defaultValue:"undone",options:[{value:"all",label:"全部"},{value:"undone",label:"未完成"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"rawID_asc",label:"RAWID 升序"},{value:"rawID_desc",label:"RAWID 降序"},{value:"nameCol_asc",label:"名称 升序"},{value:"nameCol_desc",label:"名称 降序"},{value:"begin_asc",label:"计划开始 升序"},{value:"begin_desc",label:"计划开始 降序"},{value:"end_asc",label:"计划结束 升序"},{value:"end_desc",label:"计划结束 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建执行",type:"create",method:"post",path:"/executions",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{project:{type:"integer",description:"所属项目",format:"int32"},name:{type:"string",description:"迭代名称"},lifetime:{type:"string",description:"执行类型(short 短期 | long 长期 | ops 运维)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},days:{type:"integer",description:"可用工作日",format:"int32"},products:{type:"array",items:{type:"string"},description:"关联产品"},plans:{type:"array",items:{type:"string"},description:"关联计划,必须是产品+planID的二维数组"},PO:{type:"string",description:"产品负责人"},QD:{type:"string",description:"测试负责人"},PM:{type:"string",description:"执行负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["project","name","begin","end"]}}},{name:"get",display:"获取执行详情",type:"get",method:"get",path:"/executions/{executionID}",resultType:"object",resultGetter:"execution",pathParams:{executionID:"执行ID"}},{name:"update",display:"修改执行",type:"update",method:"put",path:"/executions/{executionID}",resultType:"object",pathParams:{executionID:"执行ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{project:{type:"integer",description:"所属项目",format:"int32"},name:{type:"string",description:"迭代名称"},lifetime:{type:"string",description:"执行类型(short 短期 | long 长期 | ops 运维)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},days:{type:"integer",description:"可用工作日",format:"int32"},products:{type:"array",items:{type:"string"},description:"关联产品"},plans:{type:"array",items:{type:"string"},description:"关联计划,必须是产品+planID的二维数组"},PO:{type:"string",description:"产品负责人"},QD:{type:"string",description:"测试负责人"},PM:{type:"string",description:"执行负责人"},RD:{type:"string",description:"发布负责人"},acl:{type:"string",description:"访问控制(open 公开 | private 私有)"}},required:["name","begin","end"]}}},{name:"delete",display:"删除执行",type:"delete",method:"delete",path:"/executions/{executionID}",resultType:"text",pathParams:{executionID:"执行ID"}}]},{name:"productplan",display:"产品计划",description:"产品计划管理,支持获取产品计划列表,支持获取产品下的产品计划、创建产品计划、获取产品计划详情、修改产品计划、删除产品计划",actions:[{name:"list",display:"获取产品计划列表,支持获取产品下的产品计划",type:"list",method:"get",path:"/products/{productID}/productplans",resultType:"list",pagerGetter:"pager",resultGetter:"productplans",pathParams:{productID:"所属产品ID"},params:[{name:"browseType",required:!1,type:"string",description:"执行状态,默认是undone",defaultValue:"undone",options:[{value:"all",label:"全部"},{value:"undone",label:"未完成"},{value:"wait",label:"未开始"},{value:"doing",label:"进行中"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"名称 升序"},{value:"title_desc",label:"名称 降序"},{value:"begin_asc",label:"开始日期 升序"},{value:"begin_desc",label:"开始日期 降序"},{value:"end_asc",label:"结束日期 升序"},{value:"end_desc",label:"结束日期 降序"},{value:"status_asc",label:"状态 升序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建产品计划",type:"create",method:"post",path:"/productplans",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string",description:"计划名称"},parent:{type:"integer",description:"父计划ID",format:"int32"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},branchID:{type:"integer",description:"分支ID",format:"int32"},desc:{type:"string",description:"计划描述"}},required:["productID","title"]}}},{name:"get",display:"获取产品计划详情",type:"get",method:"get",path:"/productplans/{planID}",resultType:"object",resultGetter:"productplan",pathParams:{planID:"产品计划ID"}},{name:"update",display:"修改产品计划",type:"update",method:"put",path:"/productplans/{productplanID}",resultType:"object",pathParams:{productplanID:"产品计划ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"计划名称"},parent:{type:"integer",description:"父计划",format:"int32"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},branchID:{type:"integer",description:"分支ID",format:"int32"},desc:{type:"string",description:"计划描述"}},required:["title"]}}},{name:"delete",display:"删除产品计划",type:"delete",method:"delete",path:"/productplans/{productplanID}",resultType:"text",pathParams:{productplanID:"产品计划ID"}}]},{name:"story",display:"需求",description:"需求管理,支持获取需求列表,支持获取产品/项目/执行下的需求、创建需求、获取需求详情、修改需求、删除需求、激活需求、变更需求、关闭需求",actions:[{name:"list",display:"获取需求列表,支持获取产品/项目/执行下的需求",type:"list",method:"get",path:"/{scope}/{scopeID}/stories",resultType:"list",pagerGetter:"pager",resultGetter:"stories",pathParams:{scope:{description:"需求所属范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"所属范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"allstory",label:"全部"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"reviewbyme",label:"待我评审"},{value:"draftstory",label:"草稿"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建需求",type:"create",method:"post",path:"/stories",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},spec:{type:"string",description:"需求描述"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},verify:{type:"string",description:"验收标准"},assignedTo:{type:"string",description:"指派给"},reviewer:{type:"array",items:{type:"string"},description:"评审人,如果设置必须评审,必须填写"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"}},required:["productID","title"]}}},{name:"get",display:"获取需求详情",type:"get",method:"get",path:"/stories/{storyID}",resultType:"object",resultGetter:"story",pathParams:{storyID:"需求ID"}},{name:"update",display:"修改需求",type:"update",method:"put",path:"/stories/{storyID}",resultType:"object",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},assignedTo:{type:"string",description:"指派给"}},required:["title"]}}},{name:"delete",display:"删除需求",type:"delete",method:"delete",path:"/stories/{storyID}",resultType:"text",pathParams:{storyID:"需求ID"}},{name:"activate",display:"激活需求",type:"action",method:"put",path:"/stories/{storyID}/activate",resultType:"text",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"change",display:"变更需求",type:"action",method:"put",path:"/stories/{storyID}/change",resultType:"text",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},reviewer:{type:"array",items:{type:"string"},description:"评审人员"},spec:{type:"string",description:"需求描述"},verify:{type:"string",description:"验收标准"}},required:["reviewer"]}}},{name:"close",display:"关闭需求",type:"action",method:"put",path:"/stories/{storyID}/close",resultType:"text",pathParams:{storyID:"需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(done 已完成 | subdivided 已拆分 | duplicate 重复 | postponed 延期 | willnotdo 不做 | cancel 已取消 | bydesign 设计如此)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"epic",display:"业务需求",description:"业务需求管理,支持获取业务需求列表,支持获取产品下的业务需求、创建业务需求、获取业务需求详情、修改业务需求、删除业务需求、激活业务需求、变更业务需求、关闭业务需求",actions:[{name:"list",display:"获取业务需求列表,支持获取产品下的业务需求",type:"list",method:"get",path:"/products/{productID}/epics",resultType:"list",pagerGetter:"pager",resultGetter:"epics",pathParams:{productID:"所属产品ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"allstory",label:"全部"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"reviewbyme",label:"待我评审"},{value:"draftstory",label:"草稿"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建业务需求",type:"create",method:"post",path:"/epics",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父业务需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},spec:{type:"string",description:"业务需求描述"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},verify:{type:"string",description:"验收标准"},assignedTo:{type:"string",description:"指派给"},reviewer:{type:"array",items:{type:"string"},description:"评审人,如果设置必须评审,必须填写"}},required:["productID","title"]}}},{name:"get",display:"获取业务需求详情",type:"get",method:"get",path:"/epics/{storyID}",resultType:"object",resultGetter:"epic",pathParams:{storyID:"需求ID"}},{name:"update",display:"修改业务需求",type:"update",method:"put",path:"/epics/{epicID}",resultType:"object",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父业务需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},assignedTo:{type:"string",description:"指派给"}},required:["title"]}}},{name:"delete",display:"删除业务需求",type:"delete",method:"delete",path:"/epics/{epicID}",resultType:"text",pathParams:{epicID:"业务需求ID"}},{name:"activate",display:"激活业务需求",type:"action",method:"put",path:"/epics/{epicID}/activate",resultType:"text",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"change",display:"变更业务需求",type:"action",method:"put",path:"/epics/{epicID}/change",resultType:"text",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},reviewer:{type:"array",items:{type:"string"},description:"评审人员"},spec:{type:"string",description:"需求描述"},verify:{type:"string",description:"验收标准"}},required:["reviewer"]}}},{name:"close",display:"关闭业务需求",type:"action",method:"put",path:"/epics/{epicID}/close",resultType:"text",pathParams:{epicID:"业务需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(done 已完成 | subdivided 已拆分 | duplicate 重复 | postponed 延期 | willnotdo 不做 | cancel 已取消 | bydesign 设计如此)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"requirement",display:"用户需求",description:"用户需求管理,支持获取用户需求列表,支持获取产品下的用户需求、创建用户需求、获取用户需求详情、修改用户需求、删除用户需求、激活用户需求、变更用户需求、关闭用户需求",actions:[{name:"list",display:"获取用户需求列表,支持获取产品下的用户需求",type:"list",method:"get",path:"/products/{productID}/requirements",resultType:"list",pagerGetter:"pager",resultGetter:"requirements",pathParams:{productID:"所属产品ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"allstory",label:"全部"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"reviewbyme",label:"待我评审"},{value:"draftstory",label:"草稿"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建用户需求",type:"create",method:"post",path:"/requirements",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"产品ID",format:"int32"},title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父用户需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},spec:{type:"string",description:"用户需求描述"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},verify:{type:"string",description:"验收标准"},assignedTo:{type:"string",description:"指派给"},reviewer:{type:"array",items:{type:"string"},description:"评审人,如果设置必须评审,必须填写"}},required:["productID","title"]}}},{name:"get",display:"获取用户需求详情",type:"get",method:"get",path:"/requirements/{storyID}",resultType:"object",resultGetter:"requirement",pathParams:{storyID:"需求ID"}},{name:"update",display:"修改用户需求",type:"update",method:"put",path:"/requirements/{requirementID}",resultType:"object",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},parent:{type:"integer",description:"父用户需求",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},category:{type:"integer",description:"类别(feature 功能 | interface 接口 | performance 性能 | safe 安全 | experience 体验 | improve 改进 | other 其他)",format:"int32"},source:{type:"string",description:"来源(customer 客户 | user 用户 | po 产品经理 | market 市场 | service 客服 | operation 运营 | support 技术支持 | competitor 竞争对手 | partner 合作伙伴 | dev 开发人员 | tester 测试人员 | bug Bug | forum 论坛 | other 其他)"},assignedTo:{type:"string",description:"指派给"}},required:["title"]}}},{name:"delete",display:"删除用户需求",type:"delete",method:"delete",path:"/requirements/{requirementID}",resultType:"text",pathParams:{requirementID:"用户需求ID"}},{name:"activate",display:"激活用户需求",type:"action",method:"put",path:"/requirements/{requirementID}/activate",resultType:"text",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"change",display:"变更用户需求",type:"action",method:"put",path:"/requirements/{requirementID}/change",resultType:"text",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"需求名称"},spec:{type:"string",description:"需求描述"},verify:{type:"string",description:"验收标准"}}}}},{name:"close",display:"关闭用户需求",type:"action",method:"put",path:"/requirements/{requirementID}/close",resultType:"text",pathParams:{requirementID:"用户需求ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(done 已完成 | subdivided 已拆分 | duplicate 重复 | postponed 延期 | willnotdo 不做 | cancel 已取消 | bydesign 设计如此)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"bug",display:"Bug",description:"Bug管理,支持获取Bug列表,支持获取产品/项目/执行下的Bug、创建Bug、获取Bug详情、修改Bug、删除Bug、激活Bug、关闭Bug、解决Bug",actions:[{name:"list",display:"获取Bug列表,支持获取产品/项目/执行下的Bug",type:"list",method:"get",path:"/{scope}/{scopeID}/bugs",resultType:"list",pagerGetter:"pager",resultGetter:"bugs",pathParams:{scope:{description:"Bug所属范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"所属范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"assignedtome",label:"指派给我"},{value:"openedbyme",label:"我创建"},{value:"assignedbyme",label:"由我指派"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建Bug",type:"create",method:"post",path:"/bugs",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},title:{type:"string",description:"Bug标题"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本,主干是trunk,其他版本使用版本ID"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},severity:{type:"integer",description:"严重程度,默认是3",format:"int32"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},type:{type:"string",description:"Bug类型(codeerror 代码错误 | config 配置相关 | install 安装部署 | security 安全相关 | performance 性能问题 | standard 标准规范 | automation 测试脚本 | designdefect 设计缺陷 | others 其他)"},steps:{type:"string",description:"重现步骤"},story:{type:"integer",description:"相关需求",format:"int32"}},required:["productID","title","openedBuild"]}}},{name:"get",display:"获取Bug详情",type:"get",method:"get",path:"/bugs/{bugID}",resultType:"object",resultGetter:"bug",pathParams:{bugID:"Bug ID"}},{name:"update",display:"修改Bug",type:"update",method:"put",path:"/bugs/{bugID}",resultType:"object",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"Bug标题"},severity:{type:"integer",description:"严重程度,默认是3",format:"int32"},pri:{type:"integer",description:"优先级,默认是3",format:"int32"},type:{type:"string",description:"Bug类型(codeerror 代码错误 | config 配置相关 | install 安装部署 | security 安全相关 | performance 性能问题 | standard 标准规范 | automation 测试脚本 | designdefect 设计缺陷 | others 其他)"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本,主干是trunk,其他版本使用版本ID"},steps:{type:"string",description:"重现步骤"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"}}}}},{name:"delete",display:"删除Bug",type:"delete",method:"delete",path:"/bugs/{bugID}",resultType:"text",pathParams:{bugID:"Bug ID"}},{name:"activate",display:"激活Bug",type:"action",method:"put",path:"/bugs/{bugID}/activate",resultType:"text",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{openedBuild:{type:"array",items:{type:"string"},description:"影响版本, trunk为主干"},assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭Bug",type:"action",method:"put",path:"/bugs/{bugID}/close",resultType:"text",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{comment:{type:"string",description:"备注"}}}}},{name:"resolve",display:"解决Bug",type:"action",method:"put",path:"/bugs/{bugID}/resolve",resultType:"text",pathParams:{bugID:"Bug ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{resolution:{type:"string",description:"fixed 已解决 | notrepro 无法重现 | bydesign 设计如此 | duplicate 重复Bug | external 外部原因| postponed 延期处理 | willnotfix 不予解决 | tostory 转为需求"},resolvedDate:{type:"string",description:"解决日期,默认今天"},resolvedBuild:{type:"string",description:"解决版本, trunk为主干"},assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}},required:["resolution"]}}}]},{name:"testcase",display:"测试用例",description:"测试用例管理,支持获取测试用例列表,支持获取产品/项目/执行下的测试用例、创建测试用例、获取测试用例详情、修改测试用例、删除测试用例",actions:[{name:"list",display:"获取测试用例列表,支持获取产品/项目/执行下的测试用例",type:"list",method:"get",path:"/{scope}/{scopeID}/testcases",resultType:"list",pagerGetter:"pager",resultGetter:"testcases",pathParams:{scope:{description:"测试用例所属范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"所属范围ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是all",defaultValue:"all",options:[{value:"all",label:"全部"},{value:"wait",label:"未关闭"},{value:"needconfirm",label:"需求变动"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建测试用例",type:"create",method:"post",path:"/testcases",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},title:{type:"string",description:"用例标题"},module:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},pri:{type:"integer",description:"优先级",format:"int32"},type:{type:"string",description:"用例类型(unit 单元测试 | interface 接口测试 | feature 功能测试 | install 安装部署 | config 配置相关 | performance 性能测试 | security 安全相关 | other 其他)"},precondition:{type:"string",description:"前置条件"},steps:{type:"array",items:{type:"string"},description:"用例步骤"},expects:{type:"array",items:{type:"string"},description:"用例步骤期望"},stepType:{type:"array",items:{type:"string"},description:"用例步骤类型(step 步骤 | group 父级步骤)"},project:{type:"integer",description:"所属项目",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"}},required:["productID","title"]}}},{name:"get",display:"获取测试用例详情",type:"get",method:"get",path:"/testcases/{caseID}",resultType:"object",resultGetter:"testcase",pathParams:{caseID:"测试用例ID"}},{name:"update",display:"修改测试用例",type:"update",method:"put",path:"/testcases/{testcasID}",resultType:"object",pathParams:{testcasID:"测试用例ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{title:{type:"string",description:"用例标题"},moudule:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},pri:{type:"integer",description:"优先级",format:"int32"},type:{type:"string",description:"用例类型(unit 单元测试 | interface 接口测试 | feature 功能测试 | install 安装部署 | config 配置相关 | performance 性能测试 | security 安全相关 | other 其他)"},precondition:{type:"string",description:"前置条件"},steps:{type:"array",items:{type:"string"},description:"用例步骤"},expects:{type:"array",items:{type:"string"},description:"用例步骤期望"},stepType:{type:"array",items:{type:"string"},description:"用例步骤类型(step 步骤 | group 父级步骤)"}},required:["title"]}}},{name:"delete",display:"删除测试用例",type:"delete",method:"delete",path:"/testcases/{testcasID}",resultType:"text",pathParams:{testcasID:"测试用例ID"}}]},{name:"task",display:"任务",description:"任务管理,支持获取任务列表,支持获取执行下的任务、创建任务、获取任务详情、修改任务、删除任务、激活任务、关闭任务、完成任务、启动任务",actions:[{name:"list",display:"获取任务列表,支持获取执行下的任务",type:"list",method:"get",path:"/executions/{executionID}/tasks",resultType:"list",pagerGetter:"pager",resultGetter:"tasks",pathParams:{executionID:"所属执行ID"},params:[{name:"status",required:!1,type:"string",description:"状态,默认是unclosed",defaultValue:"unclosed",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"assignedtome",label:"指派给我"},{value:"assignedtome",label:"指派给我"},{value:"myinvolved",label:"由我参与"},{value:"assignedbyme",label:"由我指派"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"name_asc",label:"名称 升序"},{value:"name_desc",label:"名称 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建任务",type:"create",method:"post",path:"/tasks",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"任务名称"},executionID:{type:"integer",description:"所属执行",format:"int32"},type:{type:"string",description:"任务类型"},assignedTo:{type:"string",description:"指派给"},estStarted:{type:"string",description:"预计开始"},deadline:{type:"string",description:"截止日期"},pri:{type:"integer",description:"优先级",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},module:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},desc:{type:"string",description:"任务描述"}},required:["name","executionID"]}}},{name:"get",display:"获取任务详情",type:"get",method:"get",path:"/tasks/{taskID}",resultType:"object",pathParams:{taskID:"任务ID"}},{name:"update",display:"修改任务",type:"update",method:"put",path:"/tasks/{taskID}",resultType:"object",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"任务名称"},type:{type:"string",description:"任务类型"},assignedTo:{type:"string",description:"指派给"},estStarted:{type:"string",description:"预计开始"},deadline:{type:"string",description:"截止日期"},pri:{type:"integer",description:"优先级",format:"int32"},estimate:{type:"number",description:"预计工时",format:"float"},module:{type:"integer",description:"所属模块",format:"int32"},story:{type:"integer",description:"相关需求",format:"int32"},desc:{type:"string",description:"任务描述"}}}}},{name:"delete",display:"删除任务",type:"delete",method:"delete",path:"/tasks/{taskID}",resultType:"text",pathParams:{taskID:"任务ID"}},{name:"activate",display:"激活任务",type:"action",method:"put",path:"/tasks/{taskID}/activate",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{left:{type:"number",description:"预计剩余",format:"float"},assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭任务",type:"action",method:"put",path:"/tasks/{taskID}/close",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{comment:{type:"string",description:"备注"}}}}},{name:"finish",display:"完成任务",type:"action",method:"put",path:"/tasks/{taskID}/finish",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{currentConsumed:{type:"number",description:"本次消耗",format:"float"},assignedTo:{type:"string",description:"任务名称"},consumed:{type:"number",description:"总计消耗",format:"float"},realStarted:{type:"string",description:"实际开始"},finishedDate:{type:"string",description:"实际完成"},comment:{type:"string",description:"备注"}},required:["currentConsumed","realStarted","finishedDate"]}}},{name:"start",display:"启动任务",type:"action",method:"put",path:"/tasks/{taskID}/start",resultType:"text",pathParams:{taskID:"任务ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"任务名称"},realStarted:{type:"string",description:"实际开始"},consumed:{type:"number",description:"总计消耗",format:"float"},left:{type:"number",description:"预计剩余",format:"float"},comment:{type:"string",description:"备注"}},required:["realStarted"]}}}]},{name:"feedback",display:"反馈",description:"反馈管理,支持获取反馈列表,支持获取产品下的反馈、创建反馈、获取反馈详情、修改反馈、删除反馈、激活反馈、关闭反馈",actions:[{name:"list",display:"获取反馈列表,支持获取产品下的反馈",type:"list",method:"get",path:"/products/{productID}/feedbacks",resultType:"list",pagerGetter:"pager",resultGetter:"feedbacks",pathParams:{productID:"所属产品ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是wait",defaultValue:"wait",options:[{value:"all",label:"全部"},{value:"wait",label:"待处理"},{value:"doing",label:"处理中"},{value:"toclosed",label:"待关闭"},{value:"review",label:"待评审"},{value:"assigntome",label:"指派给我"},{value:"openedbyme",label:"由我反馈"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建反馈",type:"create",method:"post",path:"/feedbacks",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},title:{type:"string",description:"标题"},module:{type:"integer",description:"所属模块",format:"int32"},type:{type:"string",description:"类型(story 需求 | task 任务 | bug Bug | todo 待办 | advice 建议 | issue 问题 | risk 风险 | opportunity 机会)"},desc:{type:"string",description:"描述"},feedbackBy:{type:"string",description:"反馈者"},source:{type:"string",description:"来源"}},required:["product","title"]}}},{name:"get",display:"获取反馈详情",type:"get",method:"get",path:"/feedbacks/{feedbackID}",resultType:"object",resultGetter:"feedback",pathParams:{feedbackID:"反馈ID"}},{name:"update",display:"修改反馈",type:"update",method:"put",path:"/feedbacks/{feedbackID}",resultType:"object",pathParams:{feedbackID:"反馈ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},title:{type:"string",description:"标题"},type:{type:"string",description:"类型(story 需求 | task 任务 | bug Bug | todo 待办 | advice 建议 | issue 问题 | risk 风险 | opportunity 机会)"},desc:{type:"string",description:"描述"},feedbackBy:{type:"string",description:"反馈者"},source:{type:"string",description:"来源"}},required:["product","title"]}}},{name:"delete",display:"删除反馈",type:"delete",method:"delete",path:"/feedbacks/{feedbackID}",resultType:"text",pathParams:{feedbackID:"反馈ID"}},{name:"activate",display:"激活反馈",type:"action",method:"put",path:"/feedbacks/{feedbackID}/activate",resultType:"text",pathParams:{feedbackID:"反馈ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭反馈",type:"action",method:"put",path:"/feedbacks/{feedbackID}/close",resultType:"text",pathParams:{feedbackID:"反馈ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(commented 已处理 | repeat 重复 | refuse 不予采纳)"},comment:{type:"string",description:"备注"}},required:["closedReason"]}}}]},{name:"ticket",display:"工单",description:"工单管理,支持获取工单列表,支持获取产品下的工单、创建工单、获取工单详情、修改工单、删除工单、激活工单、关闭工单",actions:[{name:"list",display:"获取工单列表,支持获取产品下的工单",type:"list",method:"get",path:"/products/{productID}/tickets",resultType:"list",pagerGetter:"pager",resultGetter:"tickets",pathParams:{productID:"所属产品ID"},params:[{name:"browseType",required:!1,type:"string",description:"状态,默认是wait",defaultValue:"wait",options:[{value:"all",label:"全部"},{value:"unclosed",label:"未关闭"},{value:"wait",label:"待处理"},{value:"doing",label:"处理中"},{value:"done",label:"待关闭"},{value:"finishedbyme",label:"由我解决"},{value:"assigntome",label:"指派给我"},{value:"openedbyme",label:"由我创建"}]},{name:"orderBy",required:!1,type:"string",description:"排序",options:[{value:"id_asc",label:"ID 升序"},{value:"id_desc",label:"ID 降序"},{value:"title_asc",label:"标题 升序"},{value:"title_desc",label:"标题 降序"},{value:"status_asc",label:"状态 升序"},{value:"status_desc",label:"状态 降序"}]},{name:"recPerPage",required:!1,type:"number",description:"每页数量,不超过1000"},{name:"pageID",required:!1,type:"number",description:"页码,从第1页开始"}]},{name:"create",display:"创建工单",type:"create",method:"post",path:"/tickets",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},title:{type:"string",description:"标题"},type:{type:"string",description:"类型(code 程序报错 | data 数据错误 | stuck 流程卡断 | security 安全问题 | affair 事务)"},desc:{type:"string",description:"描述"},assignedTo:{type:"string",description:"指派给"},deadline:{type:"string",description:"截止日期"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本"}},required:["product","title"]}}},{name:"get",display:"获取工单详情",type:"get",method:"get",path:"/tickets/{ticketID}",resultType:"object",resultGetter:"ticket",pathParams:{ticketID:"工单ID"}},{name:"update",display:"修改工单",type:"update",method:"put",path:"/tickets/{ticketID}",resultType:"object",pathParams:{ticketID:"工单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{product:{type:"integer",description:"所属产品",format:"int32"},module:{type:"integer",description:"所属模块",format:"int32"},title:{type:"string",description:"标题"},type:{type:"string",description:"类型(code 程序报错 | data 数据错误 | stuck 流程卡断 | security 安全问题 | affair 事务)"},desc:{type:"string",description:"描述"},assignedTo:{type:"string",description:"指派给"},deadline:{type:"string",description:"截止日期"},openedBuild:{type:"array",items:{type:"string"},description:"影响版本"}}}}},{name:"delete",display:"删除工单",type:"delete",method:"delete",path:"/tickets/{ticketID}",resultType:"text",pathParams:{ticketID:"工单ID"}},{name:"activate",display:"激活工单",type:"action",method:"put",path:"/tickets/{ticketID}/activate",resultType:"text",pathParams:{ticketID:"工单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{assignedTo:{type:"string",description:"指派给"},comment:{type:"string",description:"备注"}}}}},{name:"close",display:"关闭工单",type:"action",method:"put",path:"/tickets/{ticketID}/close",resultType:"text",pathParams:{ticketID:"工单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{closedReason:{type:"string",description:"关闭原因(commented 已处理 | repeat 重复 | refuse 不予处理)"},comment:{type:"string",description:"备注"}},required:["closedReason","comment"]}}}]},{name:"system",display:"应用",description:"应用管理,支持获取应用列表,支持获取产品下的应用、创建应用、修改应用",actions:[{name:"list",display:"获取应用列表,支持获取产品下的应用",type:"list",method:"get",path:"/products/{productID}/systems",resultType:"list",pagerGetter:"pager",pathParams:{productID:"所属产品ID"}},{name:"create",display:"创建应用",type:"create",method:"post",path:"/systems",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},integrated:{type:"integer",description:"是否集成应用(0 否| 1 是)",format:"int32"},children:{type:"array",items:{type:"string"},description:"集成应用需要包含其他应用,非集成应用传空数组[]"},name:{type:"string",description:"应用名称"},desc:{type:"string",description:"描述"}},required:["productID","integrated","children","name"]}}},{name:"update",display:"修改应用",type:"update",method:"put",path:"/systems/{systemID}",resultType:"object",pathParams:{systemID:"应用ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"应用名称"},children:{type:"array",items:{type:"string"},description:"集成应用需要包含其他应用,非集成应用传空数组[]"},desc:{type:"string",description:"描述"}},required:["name","children"]}}}]},{name:"build",display:"版本",description:"版本管理,支持获取版本列表,支持获取项目/执行下的版本、创建版本/构建、修改版本、删除版本",actions:[{name:"list",display:"获取版本列表,支持获取项目/执行下的版本",type:"list",method:"get",path:"/{scope}/{scopeID}/builds",resultType:"list",pagerGetter:"pager",resultGetter:"builds",pathParams:{scope:{description:"版本所属范围",options:[{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"所属范围ID"}},{name:"create",display:"创建版本/构建",type:"create",method:"post",path:"/builds",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{executionID:{type:"integer",description:"所属执行/迭代",format:"int32"},product:{type:"integer",description:"所属产品",format:"int32"},name:{type:"string",description:"构建名称"},system:{type:"integer",description:"所属应用",format:"int32"},builder:{type:"string",description:"构建者"},date:{type:"string",description:"打包日期"},scmPath:{type:"string",description:"源代码地址"},filePath:{type:"string",description:"下载地址"},desc:{type:"string",description:"描述"}},required:["executionID","product","name","system","builder","date"]}}},{name:"update",display:"修改版本",type:"update",method:"put",path:"/builds/{buildID}",resultType:"object",pathParams:{buildID:"版本ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{execution:{type:"integer",description:"所属执行/迭代",format:"int32"},product:{type:"integer",description:"所属产品",format:"int32"},name:{type:"string",description:"构建名称"},system:{type:"integer",description:"所属应用",format:"int32"},builder:{type:"string",description:"构建者"},date:{type:"string",description:"打包日期"},scmPath:{type:"string",description:"源代码地址"},filePath:{type:"string",description:"下载地址"},desc:{type:"string",description:"描述"}},required:["execution","product","name","system","builder","date"]}}},{name:"delete",display:"删除版本",type:"delete",method:"delete",path:"/builds/{buildID}",resultType:"text",pathParams:{buildID:"版本ID"}}]},{name:"testtask",display:"测试单",description:"测试单管理,支持获取测试单列表,支持获取产品/项目/执行下的测试单、创建测试单、修改测试单、删除测试单",actions:[{name:"list",display:"获取测试单列表,支持获取产品/项目/执行下的测试单",type:"list",method:"get",path:"/{scope}/{scopeID}/testtasks",resultType:"list",pagerGetter:"pager",resultGetter:"testtasks",pathParams:{scope:{description:"测试单所属范围",options:[{value:"products",label:"产品"},{value:"projects",label:"项目"},{value:"executions",label:"执行"}]},scopeID:"所属范围ID"}},{name:"create",display:"创建测试单",type:"create",method:"post",path:"/testtasks",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品ID",format:"int32"},name:{type:"string",description:"测试单名称"},build:{type:"integer",description:"提测构建/版本",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},type:{type:"array",items:{type:"string"},description:"类型(integrate 集成测试 | system 系统测试 | acceptance 验收测试 | performance 性能测试 | safety 安全测试)"},owner:{type:"string",description:"负责人"},status:{type:"string",description:"状态(wait 未开始 | doing 进行中 | done 已关闭 | blocked 被阻塞)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},desc:{type:"string",description:"描述"}},required:["productID","name","build","begin","end"]}}},{name:"update",display:"修改测试单",type:"update",method:"put",path:"/testtasks/{testtaskID}",resultType:"object",pathParams:{testtaskID:"测试单ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{name:{type:"string",description:"测试单名称"},build:{type:"integer",description:"提测构建/版本",format:"int32"},execution:{type:"integer",description:"所属执行",format:"int32"},type:{type:"array",items:{type:"string"},description:"类型(integrate 集成测试 | system 系统测试 | acceptance 验收测试 | performance 性能测试 | safety 安全测试)"},owner:{type:"string",description:"负责人"},status:{type:"string",description:"状态(wait 未开始 | doing 进行中 | done 已关闭 | blocked 被阻塞)"},begin:{type:"string",description:"开始日期"},end:{type:"string",description:"结束日期"},desc:{type:"string",description:"描述"}},required:["name","build","begin","end"]}}},{name:"delete",display:"删除测试单",type:"delete",method:"delete",path:"/testtasks/{testtaskID}",resultType:"text",pathParams:{testtaskID:"测试单ID"}}]},{name:"release",display:"发布",description:"发布管理,支持获取发布列表,支持获取产品下的发布、创建发布、修改发布、删除发布",actions:[{name:"list",display:"获取发布列表,支持获取产品下的发布",type:"list",method:"get",path:"/products/{productID}/releases",resultType:"list",pagerGetter:"pager",resultGetter:"releases",pathParams:{productID:"所属产品ID"}},{name:"create",display:"创建发布",type:"create",method:"post",path:"/releases",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{productID:{type:"integer",description:"所属产品",format:"int32"},system:{type:"integer",description:"所属应用",format:"int32"},name:{type:"string",description:"应用版本号"},build:{type:"array",items:{type:"string"},description:"包含构建"},status:{type:"string",description:"状态(wait 未开始 | normal 已发布 | fail 发布失败 | terminate 停止维护)"},date:{type:"string",description:"计划发布日期"},desc:{type:"string",description:"描述"}},required:["productID","system","name","build","date"]}}},{name:"update",display:"修改发布",type:"update",method:"put",path:"/releases/{releasID}",resultType:"object",pathParams:{releasID:"发布ID"},requestBody:{required:!0,type:"object",schema:{type:"object",properties:{system:{type:"integer",description:"所属应用",format:"int32"},name:{type:"string",description:"应用版本号"},build:{type:"array",items:{type:"string"},description:"包含构建"},status:{type:"string",description:"状态(wait 未开始 | normal 已发布 | fail 发布失败 | terminate 停止维护)"},date:{type:"string",description:"计划发布日期"},desc:{type:"string",description:"描述"}},required:["system","name","build","date"]}}},{name:"delete",display:"删除发布",type:"delete",method:"delete",path:"/releases/{releasID}",resultType:"text",pathParams:{releasID:"发布ID"}}]},{name:"file",display:"附件",description:"附件管理,支持编辑附件,修改附件的名称、删除附件",actions:[{name:"create",display:"编辑附件,修改附件的名称",type:"create",method:"post",path:"/files",resultType:"object",requestBody:{required:!0,type:"object",schema:{type:"object",properties:{fileName:{type:"string",description:"附件名称"}},required:["fileName"]}}},{name:"delete",display:"删除附件",type:"delete",method:"delete",path:"/files/{fileID}",resultType:"text",pathParams:{fileID:"附件ID"}}]}];var M1={list:"get",get:"get",create:"post",update:"put",delete:"delete",action:"post"},P1={list:"list",get:"object",create:"object",update:"object",delete:"text",action:"text"},OX=x1(w1()),dX=nX(OX);function V(X){if(Array.isArray(X))return X.map(($)=>V($));if(X&&typeof X==="object"&&!(X instanceof Function)){let $={};for(let[Q,J]of Object.entries(X))$[Q]=V(J);return $}return X}function IX(X,$){if(!U($))return $===void 0?X:V($);let Q=U(X)?{...X}:{};for(let[J,W]of Object.entries($)){if(W===void 0)continue;let D=Q[J];Q[J]=U(W)&&U(D)?IX(D,W):V(W)}return Q}function w1(){return V(uX)}function FX(X){if(X===null||typeof X!=="object")return X;if(Object.isFrozen(X))return X;for(let $ of Object.keys(X))FX(X[$]);return Object.freeze(X)}function S1(X){if(X.method===void 0){let $=M1[X.type];if($===void 0)throw new H("E_INDETERMINATE_ACTION_METHOD",{action:String(X.name),type:String(X.type)});X.method=$}if(X.resultType===void 0){let $=P1[X.type];if($===void 0)throw new H("E_INDETERMINATE_ACTION_RESULT_TYPE",{action:String(X.name),type:String(X.type)});X.resultType=$}return X}function u(X){return FX(S1(X))}function M(X){return X.actions.forEach(u),FX(X)}function x1(X){return X.forEach(M),X}function o(X,$){let Q=$.toLowerCase();return X.findIndex((J)=>String(J.name).toLowerCase()===Q)}function E1(X,$){let Q=X.slice();for(let J of $){let W=o(Q,String(J.name)),D=u(V(J));if(W>=0)Q[W]=D;else Q.push(D)}return Q}function pX(X,$){return M({...X,...V($),actions:E1(X.actions,$.actions)})}function nX(X){return new Map(X.map(($)=>[$.name.toLowerCase(),$]))}function iX(X){if(!X||typeof X.name!=="string"||!Array.isArray(X.actions))throw new H("E_INVALID_MODULE_DEFINITION")}function RX(X){if(!X||typeof X.name!=="string"||typeof X.path!=="string")throw new H("E_INVALID_ACTION_DEFINITION");if(X.method!==void 0&&typeof X.method!=="string")throw new H("E_INVALID_ACTION_DEFINITION");if(X.resultType!==void 0&&typeof X.resultType!=="string")throw new H("E_INVALID_ACTION_DEFINITION")}function x(){return OX}function d(){return dX}function e(){dX=nX(OX)}var N1;function lX(X){N1=X}function XX(X,$={}){let Q=x();for(let J of j(X)){iX(J);let W=J.name.toLowerCase(),D=Q.findIndex((Y)=>Y.name.toLowerCase()===W);if(D>=0)Q[D]=$.replace?M(V(J)):pX(Q[D],J);else Q.push(M(V(J)))}e()}function $X(X,$){let Q=X.toLowerCase(),J=d().get(Q);if(!J)throw new H("E_INVALID_MODULE",{module:X});let W=J.actions.slice();for(let G of j($)){RX(G);let q=o(W,String(G.name)),L=u(V(G));if(q>=0)W[q]=L;else W.push(L)}let D=M({...J,actions:W}),Y=x(),B=Y.findIndex((G)=>G.name.toLowerCase()===Q);Y[B]=D,e()}function F(X,$,Q){let J=X.toLowerCase(),W=d().get(J);if(!W)throw new H("E_INVALID_MODULE",{module:X});let D=W.actions.slice(),Y=o(D,$);if(Y<0)throw new H("E_INVALID_ACTION",{module:X,action:$});let B=D[Y],G=typeof Q==="function"?Q(V(B)):IX(B,Q);RX(G),D[Y]=u(G);let q=M({...W,actions:D}),L=x(),C=L.findIndex((K)=>K.name.toLowerCase()===J);L[C]=q,e()}function _X(){F("execution","create",(X)=>{let $=X.requestBody.schema?.required;if(Array.isArray($)&&!$.includes("products"))$.push("products");return X}),F("story","update",(X)=>{let $=X.requestBody.schema?.properties;if($&&!$.plan)$.plan={type:"integer",description:"所属计划",format:"int32"};if($&&$.category)$.category={type:"string",description:"类别"};return X}),F("task","list",(X)=>{return X.path="/executions/{executionID}/tasks",X.pathParams={executionID:"执行ID"},X}),[["product","create"],["product","update"],["execution","create"],["execution","update"]].forEach(([X,$])=>{F(X,$,(Q)=>{let J=Q.requestBody.schema?.properties;if(J.acl&&J.acl.defaultValue===void 0)J.acl.defaultValue="open";return Q})})}function P(X){let $=d().get(X.toLowerCase());if(!$)throw new H("E_INVALID_MODULE",{module:X});return $}function R(X,$){let Q=P(X),J=$==="ls"?"list":$,W=Q.actions.find((Y)=>String(Y.name).toLowerCase()===J.toLowerCase());if(W)return W;if(!new Set(["list","get","create","update","delete"]).has(J)){let Y=Q.actions.find((B)=>B.type==="action"&&String(B.name).toLowerCase()===J.toLowerCase());if(Y)return Y}throw new H("E_INVALID_ACTION",{module:X,action:$})}function QX(X,$,Q){let{roles:J}=Q??{},W=[],D=R(X,$);if(!D)return[];if(D.pathParams&&(!J||J.includes("path")))Object.entries(D.pathParams).forEach(([B,G])=>{if(typeof G==="string")G={description:G};W.push({name:B,role:"path",required:!0,...G})});if(D.params&&(!J||J.includes("query")))W.push(...D.params.map((B)=>({...B,role:"query"})));let Y=D.requestBody?.schema;if(Y&&(!J||J.includes("body")))if(Y.type==="object"){let B=new Set(Y.required?Y.required.map((G)=>G.toLowerCase()):[]);Object.entries(Y.properties).forEach(([G,q])=>{W.push({name:G,role:"body",required:q.required??B.has(G.toLowerCase()),type:(q.type==="integer"?"number":q.type)??"string",...q})})}else W.push({name:"data",role:"body",required:!0,type:Y.type});return W}function JX(){return x().map((X)=>X.name)}lX(_X);_X();var k1={product:"products",project:"projects",execution:"executions"},g1=["execution","project","product"];function h1(X){for(let $ of g1){let Q=X[$]??X[`${$}ID`];if(s(Q))continue;let J=Number(Q);if(!Number.isNaN(J))return{scope:k1[$],scopeID:J}}return}function f1(X,$){return X.path.replace(/\{(\w+)\}/g,(Q,J)=>{let W=$[J];if(s(W))throw new H("E_MISSING_PARAM",{param:J});return String(W)})}function b1(X){if(X===void 0)return;if(typeof X==="string")try{let $=JSON.parse(X);return U($)?$:void 0}catch{return}return U(X)?X:void 0}var y1=new Set(["true","1","yes","on"]),v1=new Set(["false","0","no","off"]);function m1(X,$,Q,J=!1){if(X===void 0||X===null)return X;if($==="number"||$==="integer"){let W=Number(X);return Number.isNaN(W)?X:W}if($==="boolean"){if(typeof X==="boolean")return X;if(typeof X==="number"){if(X===1)return!0;if(X===0)return!1;throw new H("E_INVALID_PARAM",{param:Q,value:String(X)})}if(typeof X==="string"){let W=X.trim().toLowerCase();if(y1.has(W))return!0;if(v1.has(W))return!1;throw new H("E_INVALID_PARAM",{param:Q,value:X})}throw new H("E_INVALID_PARAM",{param:Q,value:String(X)})}if($==="array"){if(Array.isArray(X))return X;if(typeof X==="string")return X.split(",");if(J&&U(X))return X;return[X]}return X}function c1(X,$,Q){let J={},W=Object.keys($.pathParams??{});if(W.includes("scope")){let q=h1(Q);if(!q)throw new H("E_MISSING_PARAM",{param:"product/project/execution"});J.scope=q.scope,J.scopeID=q.scopeID}let D=W.find((q)=>q.endsWith("ID")&&q!=="scopeID"),Y=Q.id??Q[`${X.name}ID`]??(D?Q[D]:void 0),B=Y===void 0?Number.NaN:Number(Y),G=Number.isNaN(B)?void 0:B;if(D&&G!==void 0)J[D]=G;for(let q of W){if(q==="scope"||q==="scopeID"||J[q]!==void 0)continue;let L=$.pathParams?.[q],C=Q[q];if(C!==void 0){J[q]=C;continue}if(typeof L==="object"){if(L.defaultValue!==void 0)J[q]=L.defaultValue;else if(L.options?.[0]?.value!==void 0)J[q]=L.options[0].value}if(J[q]===void 0)throw new H("E_MISSING_PARAM",{param:q})}return{values:J,id:G}}function u1(X,$){let Q={};for(let J of X.params??[]){let W=$[J.name];if(W===void 0&&J.name==="pageID")W=$.page;if(W===void 0)W=J.defaultValue??J.options?.[0]?.value;if(W===void 0&&J.required)throw new H("E_MISSING_PARAM",{param:J.name});if(W!==void 0)Q[J.name]=W}return Q}function d1(X,$){let Q=b1($.data);if(X.requestBody?.schema?.type!=="object")return Q;let J=Q?{...Q}:{},W=X.requestBody.schema,D=new Set(W.required??[]);for(let[Y,B]of Object.entries(W.properties??{})){let G=Object.prototype.hasOwnProperty.call(J,Y),q=Object.prototype.hasOwnProperty.call($,Y),L=G?J[Y]:q?$[Y]:B.defaultValue;if(L===void 0&&(B.required||D.has(Y)))throw new H("E_MISSING_PARAM",{param:Y});let C=m1(L,B.type,Y,G);if(C!==void 0)J[Y]=C}return J}function sX(X,$,Q={}){let J=R(X.name,$),{values:W,id:D}=c1(X,J,Q);return{module:X.name,action:J,params:Q,path:f1(J,W),query:u1(J,Q),data:d1(J,Q),id:D}}function tX(X,$,Q={}){let J=X.resultGetter;if(!J)return $.data??$;if(typeof J==="function")return J($,Q);if(typeof J==="string")return A($,J);let W={};for(let[D,Y]of Object.entries(J))W[D]=A($,Y);return W}function rX(X,$,Q={}){let J=X.pagerGetter;if(!J)return $.pager;if(typeof J==="function")return J($,Q);if(typeof J==="string")return A($,J);let W=A($,J.pageID),D=A($,J.recPerPage),Y=A($,J.recTotal);if(W===void 0||D===void 0||Y===void 0)return;return{pageID:Number(W),recPerPage:Number(D),recTotal:Number(Y)}}function p1(X){let $=X.split("/");if($.length>2||!$[0])throw new H("E_INVALID_REQUEST_NAME");let[Q,J]=$;if(!J?.length)return{moduleName:Q,actionName:"list"};if(Number.isInteger(Number(J)))return{moduleName:Q,actionName:"get",id:Number(J)};return{moduleName:Q,actionName:J}}function n1(X){let $=X;if(typeof $==="string")try{$=JSON.parse($)}catch{return new Set}if($&&typeof $==="object"&&!Array.isArray($))return new Set(Object.keys($));return new Set}async function i1(X,$,Q,J){let W=$.requestBody?.schema?.properties,D=X.actions.find((q)=>q.type==="get");if(!W||!D)return Q;let Y=(await WX(`${X.name}/${D.name}`,Q,{client:J.client,timeout:J.timeout,insecure:J.insecure,throwOnFail:!0})).data;if(!U(Y))return Q;let B=n1(Q.data),G={...Q};for(let q of Object.keys(W))if(!(Object.prototype.hasOwnProperty.call(Q,q)||B.has(q))&&Object.prototype.hasOwnProperty.call(Y,q))G[q]=Y[q];return G}function l1(X){if(typeof X==="string")return X;if(X===void 0)return;try{return JSON.stringify(X)}catch{return String(X)}}function s1(X){for(let $ of["code","errorCode","errno"]){let Q=X[$];if(typeof Q==="string"||typeof Q==="number")return Q}return}function t1(X){return Boolean(X.filter&&X.filter.length>0||X.search&&X.search.length>0||X.sort||X.limit||X.pick&&X.pick.length>0)}function r1(X,$){if(Array.isArray(X)){if(!t1($))return X;if(X.every(U))return z(X,{filter:$.filter,search:$.search,searchFields:$.searchFields,sort:$.sort,limit:$.limit,pick:$.pick});let Q=Number($.limit);return Number.isFinite(Q)&&Q>=0?X.slice(0,Math.floor(Q)):X}if(U(X)&&$.pick&&$.pick.length>0)return z(X,{pick:$.pick});return X}function a1(X,$,Q){if(!$||typeof $!=="object"||Array.isArray($))return{status:"success",data:$};let J=$,W=J.status==="fail"?"fail":"success",D=r1(tX(X.action,J,X.params),Q),Y=J.message,B=rX(X.action,J,X.params),G={status:W,message:l1(Y),data:D,pager:B?{total:Number(B.recTotal),page:Number(B.pageID),recPerPage:Number(B.recPerPage)}:void 0};if(Y!==void 0&&typeof Y!=="string")G.rawMessage=Y;let q=s1(J);if(q!==void 0)G.apiCode=q;if(W==="fail")G.raw=J;return G}async function WX(X,$={},Q={}){let J=Z(),W=Q.client??J.client;if(!W)throw new H("E_NO_GLOBAL_CLIENT");let{moduleName:D,actionName:Y,id:B}=p1(X),G=P(D),q=$.recPerPage??Q.recPerPage??J.recPerPage,L={...$,...B!==void 0?{id:B}:{},...q!==void 0?{recPerPage:q}:{}},C=R(D,Y),K=C.type==="update"&&(Q.autoFill??J.autoFill)?await i1(G,C,L,Q):L,O=sX(G,Y,K),_=await W.request(O.path,{method:String(O.action.method).toUpperCase(),query:O.query,body:O.data,timeout:Q.timeout??J.timeout,insecure:Q.insecure??J.insecure});if(Q.raw)return _;let p={...Q,limit:Q.limit??J.limit},n=a1(O,_,p);if(n.status==="fail"&&(Q.throwOnFail??J.throwOnFail))throw new H("E_API_FAILED",{message:n.message??""},n);return n}var ZX="2026-07-21T02:40:34.356Z",jX="0.4.0";var zX=globalThis;zX.ZentaoAPI=DX;if(zX.window)zX.window.ZentaoAPI=DX;})();
package/dist/index.d.ts CHANGED
@@ -2,8 +2,8 @@ export { ZentaoClient } from './client/index.js';
2
2
  export { ERRORS, ZentaoError, type ErrorCode } from './misc/errors.js';
3
3
  export { getGlobalOptions, setGlobalOptions } from './misc/global-options.js';
4
4
  export { ZENTAO_PROFILES_STORAGE_KEY, addProfile, deleteProfile, getAllProfiles, getProfile, getProfileKey, switchProfile, } from './profiles/index.js';
5
- export { defineModuleActions, defineModules, type DefineModulesOptions, extendModuleAction, getModuleNames, getModule, getModuleAction, } from './modules/registry.js';
5
+ export { defineModuleActions, defineModules, type DefineModulesOptions, extendModuleAction, getModuleNames, getModule, getModuleAction, getModuleActionParams, } from './modules/registry.js';
6
6
  export { request, type BuiltinRequestName, type RequestParamsFor, type RequestResultFor, } from './request/index.js';
7
7
  export { pickFields, pickFieldsSingle, filterData, searchData, sortData, processData, } from './utils/index.js';
8
8
  export { BUILD, VERSION } from './version.js';
9
- export type { ApiListResponse, ApiResponse, ClientRequestBodyType, ClientRequestOptions, ClientResponseType, DataRecord, DataRecordFilter, DataRecordFilterGroup, GlobalOptions, HttpMethod, ListPagerInfo, LoginResponse, ModuleAction, ModuleActionMethod, ModuleActionName, ModuleActionPagerGetterMap, ModuleActionParam, ModuleActionParamOption, ModuleActionRequestBody, ModuleActionResponse, ModuleActionResultType, ModuleActionType, ModuleDefinition, ModuleName, Pager, ProcessListOptions, ProcessSingleOptions, RequestOptions, ResolvedModuleCommand, ResponseData, ServerConfig, SortExpr, SortFn, ZentaoProfile, ZentaoProfileConfig, ZentaoProfileRecord, ZentaoProfilesStore, ZentaoClientOptions, } from './types/index.js';
9
+ export type { ApiListResponse, ApiResponse, ClientRequestBodyType, ClientRequestOptions, ClientResponseType, DataRecord, DataRecordFilter, DataRecordFilterGroup, GlobalOptions, HttpMethod, ListPagerInfo, LoginResponse, ModuleAction, ModuleActionMethod, ModuleActionName, ModuleActionPagerGetterMap, ModuleActionParam, ModuleActionParamOption, ModuleActionRequest, ModuleActionRequestBody, ModuleActionResponse, ModuleActionResultType, ModuleActionType, ModuleDefinition, ModuleName, Pager, ProcessListOptions, ProcessSingleOptions, RequestOptions, ResponseData, ServerConfig, SortExpr, SortFn, ZentaoProfile, ZentaoProfileConfig, ZentaoProfileRecord, ZentaoProfilesStore, ZentaoClientOptions, } from './types/index.js';
package/dist/index.js CHANGED
@@ -2,7 +2,7 @@ export { ZentaoClient } from './client/index.js';
2
2
  export { ERRORS, ZentaoError } from './misc/errors.js';
3
3
  export { getGlobalOptions, setGlobalOptions } from './misc/global-options.js';
4
4
  export { ZENTAO_PROFILES_STORAGE_KEY, addProfile, deleteProfile, getAllProfiles, getProfile, getProfileKey, switchProfile, } from './profiles/index.js';
5
- export { defineModuleActions, defineModules, extendModuleAction, getModuleNames, getModule, getModuleAction, } from './modules/registry.js';
5
+ export { defineModuleActions, defineModules, extendModuleAction, getModuleNames, getModule, getModuleAction, getModuleActionParams, } from './modules/registry.js';
6
6
  export { request, } from './request/index.js';
7
7
  export { pickFields, pickFieldsSingle, filterData, searchData, sortData, processData, } from './utils/index.js';
8
8
  export { BUILD, VERSION } from './version.js';