zentao-api 0.4.0 → 0.4.1

package/README.md

@@ -243,6 +243,8 @@ import { ZentaoClient } from 'zentao-api';
 
 ## 测试
 
+本仓库开发依赖管理仅使用 [Bun](https://bun.sh)（`bun install`）。请勿使用 npm / pnpm / yarn，以免生成其它 lockfile。
+
 ```sh
 bun test              # 单元测试
 bun run test:coverage # 含覆盖率的单元测试

package/dist/browser/zentao-api.global.js

@@ -1,2 +1,2 @@
-(()=>{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)}
-`;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;})();
+(()=>{var{defineProperty:HX,getOwnPropertyNames:oX,getOwnPropertyDescriptor:eX}=Object,X1=Object.prototype.hasOwnProperty;function $1(X){return this[X]}var Q1=(X)=>{var $=(TX??=new WeakMap).get(X),Q;if($)return $;if($=HX({},"__esModule",{value:!0}),X&&typeof X==="object"||typeof X==="function"){for(var J of oX(X))if(!X1.call($,J))HX($,J,{get:$1.bind(X,J),enumerable:!(Q=eX(X,J))||Q.enumerable})}return TX.set(X,$),$},TX;var J1=(X)=>X;function W1(X,$){this[X]=J1.bind(null,$)}var MX=(X,$)=>{for(var Q in $)HX(X,Q,{get:$[Q],enumerable:!0,configurable:!0,set:W1.bind($,Q)})};var e1={};MX(e1,{switchProfile:()=>u,sortData:()=>b,setGlobalOptions:()=>N,searchData:()=>f,request:()=>WX,processData:()=>z,pickFieldsSingle:()=>x,pickFields:()=>g,getProfileKey:()=>R,getProfile:()=>VX,getModuleNames:()=>JX,getModuleActionParams:()=>QX,getModuleAction:()=>_,getModule:()=>P,getGlobalOptions:()=>j,getAllProfiles:()=>KX,filterData:()=>h,extendModuleAction:()=>O,deleteProfile:()=>AX,defineModules:()=>XX,defineModuleActions:()=>$X,addProfile:()=>c,ZentaoError:()=>q,ZentaoClient:()=>T,ZENTAO_PROFILES_STORAGE_KEY:()=>v,VERSION:()=>ZX,ERRORS:()=>i,BUILD:()=>jX});var YX={};MX(YX,{switchProfile:()=>u,sortData:()=>b,setGlobalOptions:()=>N,searchData:()=>f,request:()=>WX,processData:()=>z,pickFieldsSingle:()=>x,pickFields:()=>g,getProfileKey:()=>R,getProfile:()=>VX,getModuleNames:()=>JX,getModuleActionParams:()=>QX,getModuleAction:()=>_,getModule:()=>P,getGlobalOptions:()=>j,getAllProfiles:()=>KX,filterData:()=>h,extendModuleAction:()=>O,deleteProfile:()=>AX,defineModules:()=>XX,defineModuleActions:()=>$X,addProfile:()=>c,ZentaoError:()=>q,ZentaoClient:()=>T,ZENTAO_PROFILES_STORAGE_KEY:()=>v,VERSION:()=>ZX,ERRORS:()=>i,BUILD:()=>jX});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 q extends Error{code;details;constructor(X,$,Q){let J=i[X];if($)for(let[W,Y]of Object.entries($))J=J.replaceAll(`{${W}}`,String(Y));super(J);this.name="ZentaoError",this.code=X,this.details=Q}}function s(){return typeof process<"u"&&Boolean(process.versions?.node)}function PX(X){return import(X)}function Y1(X){let $={};return new Headers(X).forEach((Q,J)=>{$[J]=Q}),$}function H1(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 qX(X,$){let Q=$.toLowerCase();return Object.keys(X).some((J)=>J.toLowerCase()===Q)}async function q1(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&&!qX($,"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&&!qX($,"content-type"))$["content-type"]=J;return new Uint8Array(await Q.arrayBuffer())}if(typeof URLSearchParams<"u"&&X instanceof URLSearchParams){if(!qX($,"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 D1(X){let $=X.reduce((W,Y)=>W+Y.byteLength,0),Q=new Uint8Array($),J=0;for(let W of X)Q.set(W,J),J+=W.byteLength;return Q.buffer}async function G1(X,$,Q){let J=new URL(X),W=J.protocol==="https:"?await PX("node:https"):await PX("node:http"),Y=Y1($.headers),H=await q1($.body,Y);return new Promise((B,G)=>{if($.signal?.aborted){G(wX());return}let D=W.request(J,{method:$.method??"GET",headers:Y,rejectUnauthorized:Q},(A)=>{let F=[];A.on("data",(I)=>{F.push(typeof I==="string"?new TextEncoder().encode(I):I)}),A.on("end",()=>{U();let I=F.length>0?D1(F):void 0,n=new Response(I,{status:A.statusCode??200,statusText:A.statusMessage??"",headers:H1(A.headers)});Object.defineProperty(n,"url",{value:X}),B(n)})}),U=()=>{$.signal?.removeEventListener("abort",C)},C=()=>{U(),D.destroy(wX())};if(D.on("error",(A)=>{U(),G(A)}),$.signal?.addEventListener("abort",C,{once:!0}),H!==void 0)D.write(H);D.end()})}function DX(X){if(X&&!s())throw new q("E_INSECURE_BROWSER")}async function SX(X,$,Q){if(!X)return fetch($,Q);return DX(X),G1($,Q,!1)}var GX={};function j(){return{...GX}}function N(X){GX={...GX,...X}}function L(X){return Boolean(X)&&typeof X==="object"&&!Array.isArray(X)}function w(X){return X===void 0||X===null||X===""}function K(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 Z(X){return Array.isArray(X)?X:[X]}function S(X){let $=X.trim().replace(/\/+$/,"");if(!$)throw new q("E_INVALID_BASE_URL");let Q=$.replace(/\/api\.php\/v2$/i,""),J;try{J=new URL(Q)}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 x(X,$){let Q={};for(let J of $){let W=K(X,J);if(W===void 0)continue;let Y=J.split("."),H=Q;for(let B=0;B<Y.length-1;B++){let G=Y[B];if(!L(H[G]))H[G]={};H=H[G]}H[Y[Y.length-1]]=W}return Q}function g(X,$){return X.map((Q)=>x(Q,$))}function k(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 Z($).some((J)=>Q.includes(String(J).toLowerCase()))}function NX(X,$){let Q=K(X,$.key),{operator:J,value:W}=$;switch(J){case"=":return Z(W).some((Y)=>xX(Q,Y));case"!=":return Z(W).every((Y)=>!xX(Q,Y));case"~":return EX(Q,W);case"!~":return!EX(Q,W);case">":return k(Q,W)>0;case"<":return k(Q,W)<0;case">=":return k(Q,W)>=0;case"<=":return k(Q,W)<=0;default:return!1}}function B1(X,$){if($.conditions.length===0)return!0;return $.operator==="OR"?$.conditions.some((Q)=>NX(X,Q)):$.conditions.every((Q)=>NX(X,Q))}function h(X,$){if($.length===0)return X.slice();return X.filter((Q)=>$.every((J)=>B1(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(L(X))for(let Q of Object.values(X))t(Q,$);else $.push(String(X))}function C1(X,$){let Q=[];if($&&$.length>0)for(let J of $)t(K(X,J),Q);else t(X,Q);return Q.join("\x00").toLowerCase()}function f(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 Y=C1(W,Q);return J.every((H)=>H.some((B)=>Y.includes(B)))})}function U1(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(Y,H)=>k(K(Y,Q),K(H,Q))*W}function b(X,$){let Q=$.map(U1);return X.slice().sort((J,W)=>{for(let Y of Q){let H=Y(J,W);if(H!==0)return H}return 0})}var L1=[">=","<=","!=","!~","=","~",">","<"];function K1(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 V1(X){for(let $ of L1){let Q=X.indexOf($);if(Q>0)return{key:X.slice(0,Q).trim(),operator:$,value:K1(X.slice(Q+$.length).trim())}}return}function A1(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?x(X,$.pick):{...X};let Q=$,J=X;if(Q.filter&&Q.filter.length>0){let Y=Q.filter.map(V1).filter((H)=>H!==void 0);if(Y.length>0)J=h(J,[{operator:"AND",conditions:Y}])}if(Q.search&&Q.search.length>0)J=f(J,Q.search,Q.searchFields);if(Q.sort){let Y=Q.sort.split(",").map((H)=>H.trim()).filter(Boolean);if(Y.length>0)J=b(J,Y)}let W=A1(Q.limit);if(W!==void 0)J=J.slice(0,W);if(Q.pick)J=g(J,Q.pick);return J}var v="ZENTAO_PROFILES",O1=[".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 y(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 y("node:path"),$=process.env.HOME??process.env.USERPROFILE??(await y("node:os")).homedir();if(!$)throw new q("E_PROFILE_STORAGE_UNAVAILABLE");return X.join($,...O1)}function F1(X,$){let Q=X.trim(),J=S($);if(!Q)throw new q("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 q("E_INVALID_PROFILE");let $=X.token.trim();if(!$)throw new q("E_INVALID_PROFILE");let Q=fX(X);return delete Q.key,{...Q,server:S(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 q("E_PROFILE_STORAGE_INVALID",void 0,$)}}async function m(){if(s()){let Q=await y("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 q("E_PROFILE_STORAGE_UNAVAILABLE");let $=X.getItem(v);return $?gX($):{profiles:[]}}async function UX(X){let $=mX(X),Q=`${JSON.stringify($,null,2)}
+`;if(s()){let W=await y("node:fs/promises"),Y=await y("node:path"),H=await vX(),B=Y.dirname(H),G=Y.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,H),await W.chmod(H,384).catch(()=>{return})}catch(D){throw await W.rm(G,{force:!0}).catch(()=>{return}),D}return}let J=yX();if(!J)throw new q("E_PROFILE_STORAGE_UNAVAILABLE");J.setItem(v,Q)}function r(X){let $=CX(X);return{...fX($),key:R($)}}function LX(X,$){return X.profiles.find((Q)=>R(Q)===$)}function R1(X){if(!X.currentProfile||!LX(X,X.currentProfile)){let $=X.profiles.at(-1);X.currentProfile=$?R($):void 0}}function R(X){return F1(X.account,X.server)}async function KX(){return(await m()).profiles.map(r)}async function VX(X){let $=await m(),Q=X??$.currentProfile;if(!Q)return;let J=LX($,Q);return J?r(J):void 0}function c(X){return BX(async()=>{let $=await m(),Q=bX(),J=CX({...X,loginTime:X.loginTime??Q,lastUsedTime:X.lastUsedTime??Q}),W=R(J),Y=$.profiles.findIndex((H)=>R(H)===W);if(Y>=0)$.profiles[Y]=J;else $.profiles.push(J);return $.currentProfile=W,await UX($),r(J)})}function AX(X){return BX(async()=>{let $=await m(),Q=$.profiles.filter((J)=>R(J)!==X);if(Q.length===$.profiles.length)return!1;return $.profiles=Q,R1($),await UX($),!0})}function u(X){return BX(async()=>{let $=await m(),Q=X??$.currentProfile;if(!Q)throw new q("E_NO_PROFILE");let J=LX($,Q);if(!J)throw new q("E_PROFILE_NOT_FOUND",{profileKey:Q});return J.lastUsedTime=bX(),$.currentProfile=Q,await UX($),r(J)})}var _1=1e4;function I1(X,$,Q){let J=$.startsWith("/")?$:`/${$}`,W=new URL(`${X}${J}`);for(let[Y,H]of Object.entries(Q??{})){if(H===void 0)continue;W.searchParams.set(Y,String(H))}return W.toString()}function j1(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 z1(X,$,Q){if(X===void 0||X===null)return;if($==="form"){let J=X instanceof URLSearchParams?X:new URLSearchParams;if(!(X instanceof URLSearchParams)&&j1(X))for(let[W,Y]of Object.entries(X))cX(J,W,Y);else if(!(X instanceof URLSearchParams))throw new q("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 T1(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 M1(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=S($.baseUrl),this.baseUrl=`${this.siteUrl}/api.php/v2`,this.token=$.token,this.timeout=$.timeout,this.insecure=$.insecure}async request(X,$={}){let Q=j(),J=$.method??"GET",W=$.timeout??Q.timeout??this.timeout??_1,Y=$.insecure??Q.insecure??this.insecure;DX(Y);let H=I1(this.baseUrl,X,$.query),B=new Headers($.headers);if(this.token)B.set("Token",this.token);let{signal:G,cleanup:D}=T1(W,$.signal),U={method:J,headers:B,signal:G};if($.body!==void 0&&J!=="GET")U.body=z1($.body,$.bodyType,B);try{let C=await SX(Y,H,U);if(!C.ok)throw new q("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 M1(C,$.responseType)}catch(C){if(C instanceof q)throw C;if(C instanceof DOMException&&C.name==="AbortError")throw new q("E_TIMEOUT");throw new q("E_NETWORK_ERROR",{message:C.message??String(C)},C)}finally{D()}}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 q("E_LOGIN_FAILED");this.token=Q.token;let J=j();if(J.persistProfiles){let W={},Y=this.timeout??J.timeout,H=this.insecure??J.insecure;if(Y!==void 0)W.timeout=Y;if(H!==void 0)W.insecure=H;await c({server:this.siteUrl,account:X,token:Q.token,user:L(Q.user)?Q.user:void 0,serverConfig:L(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 N({client:$}),$}static async fromProfile(X){let $=await u(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 P1={list:"get",get:"get",create:"post",update:"put",delete:"delete",action:"post"},w1={list:"list",get:"object",create:"object",update:"object",delete:"text",action:"text"},OX=E1(S1()),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 FX(X,$){if(!L($))return $===void 0?X:V($);let Q=L(X)?{...X}:{};for(let[J,W]of Object.entries($)){if(W===void 0)continue;let Y=Q[J];Q[J]=L(W)&&L(Y)?FX(Y,W):V(W)}return Q}function S1(){return V(uX)}function RX(X){if(X===null||typeof X!=="object")return X;if(Object.isFrozen(X))return X;for(let $ of Object.keys(X))RX(X[$]);return Object.freeze(X)}function x1(X){if(X.method===void 0){let $=P1[X.type];if($===void 0)throw new q("E_INDETERMINATE_ACTION_METHOD",{action:String(X.name),type:String(X.type)});X.method=$}if(X.resultType===void 0){let $=w1[X.type];if($===void 0)throw new q("E_INDETERMINATE_ACTION_RESULT_TYPE",{action:String(X.name),type:String(X.type)});X.resultType=$}return X}function d(X){return RX(x1(X))}function M(X){return X.actions.forEach(d),RX(X)}function E1(X){return X.forEach(M),X}function o(X,$){let Q=$.toLowerCase();return X.findIndex((J)=>String(J.name).toLowerCase()===Q)}function N1(X,$){let Q=X.slice();for(let J of $){let W=o(Q,String(J.name)),Y=d(V(J));if(W>=0)Q[W]=Y;else Q.push(Y)}return Q}function pX(X,$){return M({...X,...V($),actions:N1(X.actions,$.actions)})}function nX(X){return new Map(X.map(($)=>[$.name.toLowerCase(),$]))}function lX(X){if(!X||typeof X.name!=="string"||!Array.isArray(X.actions))throw new q("E_INVALID_MODULE_DEFINITION")}function _X(X){if(!X||typeof X.name!=="string"||typeof X.path!=="string")throw new q("E_INVALID_ACTION_DEFINITION");if(X.method!==void 0&&typeof X.method!=="string")throw new q("E_INVALID_ACTION_DEFINITION");if(X.resultType!==void 0&&typeof X.resultType!=="string")throw new q("E_INVALID_ACTION_DEFINITION")}function E(){return OX}function p(){return dX}function e(){dX=nX(OX)}var k1;function iX(X){k1=X}function XX(X,$={}){let Q=E();for(let J of Z(X)){lX(J);let W=J.name.toLowerCase(),Y=Q.findIndex((H)=>H.name.toLowerCase()===W);if(Y>=0)Q[Y]=$.replace?M(V(J)):pX(Q[Y],J);else Q.push(M(V(J)))}e()}function $X(X,$){let Q=X.toLowerCase(),J=p().get(Q);if(!J)throw new q("E_INVALID_MODULE",{module:X});let W=J.actions.slice();for(let G of Z($)){_X(G);let D=o(W,String(G.name)),U=d(V(G));if(D>=0)W[D]=U;else W.push(U)}let Y=M({...J,actions:W}),H=E(),B=H.findIndex((G)=>G.name.toLowerCase()===Q);H[B]=Y,e()}function O(X,$,Q){let J=X.toLowerCase(),W=p().get(J);if(!W)throw new q("E_INVALID_MODULE",{module:X});let Y=W.actions.slice(),H=o(Y,$);if(H<0)throw new q("E_INVALID_ACTION",{module:X,action:$});let B=Y[H],G=typeof Q==="function"?Q(V(B)):FX(B,Q);_X(G),Y[H]=d(G);let D=M({...W,actions:Y}),U=E(),C=U.findIndex((A)=>A.name.toLowerCase()===J);U[C]=D,e()}function IX(){O("execution","create",(X)=>{let $=X.requestBody.schema?.required;if(Array.isArray($)&&!$.includes("products"))$.push("products");return X}),O("story","update",(X)=>{let $=X.requestBody.schema?.properties;if($&&!$.plan)$.plan={type:"integer",description:"所属计划",format:"int32"};if($&&$.category)$.category={type:"string",description:"类别"};return X}),O("task","list",(X)=>{return X.path="/executions/{executionID}/tasks",X.pathParams={executionID:"执行ID"},X}),[["product","create"],["product","update"],["execution","create"],["execution","update"]].forEach(([X,$])=>{O(X,$,(Q)=>{let J=Q.requestBody.schema?.properties;if(J.acl&&J.acl.defaultValue===void 0)J.acl.defaultValue="open";return Q})}),["create","update"].forEach((X)=>{O("task",X,($)=>{let Q=$.requestBody?.schema?.properties;if(Q&&!Q.parent)Q.parent={type:"integer",description:"父任务",format:"int32"};return $})})}function P(X){return p().get(X.toLowerCase())}function _(X,$){let Q=P(X);if(!Q)return;let J=$==="ls"?"list":$,W=Q.actions.find((H)=>String(H.name).toLowerCase()===J.toLowerCase());if(W)return W;if(!new Set(["list","get","create","update","delete"]).has(J)){let H=Q.actions.find((B)=>B.type==="action"&&String(B.name).toLowerCase()===J.toLowerCase());if(H)return H}return}function QX(X,$,Q){let{roles:J}=Q??{},W=[],Y=_(X,$);if(!Y)return[];if(Y.pathParams&&(!J||J.includes("path")))Object.entries(Y.pathParams).forEach(([B,G])=>{if(typeof G==="string")G={description:G};W.push({name:B,role:"path",required:!0,...G})});if(Y.params&&(!J||J.includes("query")))W.push(...Y.params.map((B)=>({...B,role:"query"})));let H=Y.requestBody?.schema;if(H&&(!J||J.includes("body")))if(H.type==="object"){let B=new Set(H.required?H.required.map((G)=>G.toLowerCase()):[]);Object.entries(H.properties).forEach(([G,D])=>{W.push({name:G,role:"body",required:D.required??B.has(G.toLowerCase()),type:(D.type==="integer"?"number":D.type)??"string",...D})})}else W.push({name:"data",role:"body",required:!0,type:H.type});return W}function JX(){return E().map((X)=>X.name)}iX(IX);IX();var sX={product:"products",project:"projects",execution:"executions"},g1=new Set(Object.values(sX)),h1=["execution","project","product"];function f1(X){let{scope:$,scopeID:Q}=X;if(!w($)&&!w(Q)){let J=String($);if(!g1.has(J))throw new q("E_INVALID_PARAM",{param:"scope",value:J});let W=Number(Q);if(Number.isNaN(W))throw new q("E_INVALID_PARAM",{param:"scopeID",value:String(Q)});return{scope:J,scopeID:W}}for(let J of h1){let W=X[J]??X[`${J}ID`];if(w(W))continue;let Y=Number(W);if(!Number.isNaN(Y))return{scope:sX[J],scopeID:Y}}return}function b1(X,$){return X.path.replace(/\{(\w+)\}/g,(Q,J)=>{let W=$[J];if(w(W))throw new q("E_MISSING_PARAM",{param:J});return String(W)})}function y1(X){if(X===void 0)return;if(typeof X==="string")try{let $=JSON.parse(X);return L($)?$:void 0}catch{return}return L(X)?X:void 0}var v1=new Set(["true","1","yes","on"]),m1=new Set(["false","0","no","off"]);function c1(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 q("E_INVALID_PARAM",{param:Q,value:String(X)})}if(typeof X==="string"){let W=X.trim().toLowerCase();if(v1.has(W))return!0;if(m1.has(W))return!1;throw new q("E_INVALID_PARAM",{param:Q,value:X})}throw new q("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&&L(X))return X;return[X]}return X}function u1(X,$,Q){let J={},W=Object.keys($.pathParams??{});if(W.includes("scope")){let D=f1(Q);if(!D)throw new q("E_MISSING_PARAM",{param:"scope/scopeID or product/project/execution"});J.scope=D.scope,J.scopeID=D.scopeID}let Y=W.find((D)=>D.endsWith("ID")&&D!=="scopeID"),H=Q.id??Q[`${X.name}ID`]??(Y?Q[Y]:void 0),B=H===void 0?Number.NaN:Number(H),G=Number.isNaN(B)?void 0:B;if(Y&&G!==void 0)J[Y]=G;for(let D of W){if(D==="scope"||D==="scopeID"||J[D]!==void 0)continue;let U=$.pathParams?.[D],C=Q[D];if(C!==void 0){J[D]=C;continue}if(typeof U==="object"){if(U.defaultValue!==void 0)J[D]=U.defaultValue;else if(U.options?.[0]?.value!==void 0)J[D]=U.options[0].value}if(J[D]===void 0)throw new q("E_MISSING_PARAM",{param:D})}return{values:J,id:G}}function d1(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 q("E_MISSING_PARAM",{param:J.name});if(W!==void 0)Q[J.name]=W}return Q}function p1(X,$){let Q=y1($.data);if(X.requestBody?.schema?.type!=="object")return Q;let J=Q?{...Q}:{},W=X.requestBody.schema,Y=new Set(W.required??[]);for(let[H,B]of Object.entries(W.properties??{})){let G=Object.prototype.hasOwnProperty.call(J,H),D=Object.prototype.hasOwnProperty.call($,H),U=G?J[H]:D?$[H]:B.defaultValue;if(U===void 0&&(B.required||Y.has(H)))throw new q("E_MISSING_PARAM",{param:H});let C=c1(U,B.type,H,G);if(C!==void 0)J[H]=C}return J}function tX(X,$,Q={}){let J=_(X.name,$);if(!J)throw new q("E_INVALID_ACTION",{module:X.name,action:$});let{values:W,id:Y}=u1(X,J,Q);return{module:X.name,action:J,params:Q,path:b1(J,W),query:d1(J,Q),data:p1(J,Q),id:Y}}function rX(X,$,Q={}){let J=X.resultGetter;if(!J)return $.data??$;if(typeof J==="function")return J($,Q);if(typeof J==="string")return K($,J);let W={};for(let[Y,H]of Object.entries(J))W[Y]=K($,H);return W}function aX(X,$,Q={}){let J=X.pagerGetter;if(!J)return $.pager;if(typeof J==="function")return J($,Q);if(typeof J==="string")return K($,J);let W=K($,J.pageID),Y=K($,J.recPerPage),H=K($,J.recTotal);if(W===void 0||Y===void 0||H===void 0)return;return{pageID:Number(W),recPerPage:Number(Y),recTotal:Number(H)}}function n1(X){let $=X.split("/");if($.length>2||!$[0])throw new q("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 l1(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,Y=X.actions.find((D)=>D.type==="get");if(!W||!Y)return Q;let H=(await WX(`${X.name}/${Y.name}`,Q,{client:J.client,timeout:J.timeout,insecure:J.insecure,throwOnFail:!0})).data;if(!L(H))return Q;let B=l1(Q.data),G={...Q};for(let D of Object.keys(W))if(!(Object.prototype.hasOwnProperty.call(Q,D)||B.has(D))&&Object.prototype.hasOwnProperty.call(H,D))G[D]=H[D];return G}function s1(X){if(typeof X==="string")return X;if(X===void 0)return;try{return JSON.stringify(X)}catch{return String(X)}}function t1(X){for(let $ of["code","errorCode","errno"]){let Q=X[$];if(typeof Q==="string"||typeof Q==="number")return Q}return}function r1(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 a1(X,$){if(Array.isArray(X)){if(!r1($))return X;if(X.every(L))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(L(X)&&$.pick&&$.pick.length>0)return z(X,{pick:$.pick});return X}function o1(X,$,Q){if(!$||typeof $!=="object"||Array.isArray($))return{status:"success",data:$};let J=$,W=J.status==="fail"?"fail":"success",Y=a1(rX(X.action,J,X.params),Q),H=J.message,B=aX(X.action,J,X.params),G={status:W,message:s1(H),data:Y,pager:B?{total:Number(B.recTotal),page:Number(B.pageID),recPerPage:Number(B.recPerPage)}:void 0};if(H!==void 0&&typeof H!=="string")G.rawMessage=H;let D=t1(J);if(D!==void 0)G.apiCode=D;if(W==="fail")G.raw=J;return G}async function WX(X,$={},Q={}){let J=j(),W=Q.client??J.client;if(!W)throw new q("E_NO_GLOBAL_CLIENT");let{moduleName:Y,actionName:H,id:B}=n1(X),G=P(Y);if(!G)throw new q("E_INVALID_MODULE",{module:Y});let D=$.recPerPage??Q.recPerPage??J.recPerPage,U={...$,...B!==void 0?{id:B}:{},...D!==void 0?{recPerPage:D}:{}},C=_(Y,H);if(!C)throw new q("E_INVALID_ACTION",{module:Y,action:H});let A=C.type==="update"&&(Q.autoFill??J.autoFill)?await i1(G,C,U,Q):U,F=tX(G,H,A),I=await W.request(F.path,{method:String(F.action.method).toUpperCase(),query:F.query,body:F.data,timeout:Q.timeout??J.timeout,insecure:Q.insecure??J.insecure});if(Q.raw)return I;let n={...Q,limit:Q.limit??J.limit},l=o1(F,I,n);if(l.status==="fail"&&(Q.throwOnFail??J.throwOnFail))throw new q("E_API_FAILED",{message:l.message??""},l);return l}var jX="2026-08-04T07:16:16.980Z",ZX="0.4.1";var zX=globalThis;zX.ZentaoAPI=YX;if(zX.window)zX.window.ZentaoAPI=YX;})();

package/dist/modules/override.js

@@ -110,4 +110,18 @@ export function applyBuiltinOverrides() {
             return action;
         });
     });
+    // 为 task/create|update 补充 parent 字段（创建子任务）
+    ['create', 'update'].forEach((actionName) => {
+        extendModuleAction('task', actionName, (action) => {
+            const properties = action.requestBody?.schema?.properties;
+            if (properties && !properties.parent) {
+                properties.parent = {
+                    type: 'integer',
+                    description: '父任务',
+                    format: 'int32',
+                };
+            }
+            return action;
+        });
+    });
 }

package/dist/modules/query.d.ts

@@ -6,10 +6,9 @@ import type { ModuleAction, ModuleActionParam, ModuleActionParamRole, ModuleDefi
  * 任何写入尝试在严格模式下会抛 `TypeError`；如需修改请使用 {@link defineModules}。
  *
  * @param moduleName - 模块名。
- * @returns 已注册的模块定义。
- * @throws {ZentaoError} `E_INVALID_MODULE` —— 模块未注册。
+ * @returns 已注册的模块定义；模块未注册时返回 `undefined`。
  */
-export declare function getModule(moduleName: string): ModuleDefinition;
+export declare function getModule(moduleName: string): ModuleDefinition | undefined;
 /**
  * 获取指定模块下的某个动作。
  *
@@ -23,10 +22,9 @@ export declare function getModule(moduleName: string): ModuleDefinition;
  *
  * @param moduleName - 模块名（大小写不敏感）。
  * @param actionName - 动作名（大小写不敏感）；支持 `ls` 作为 `list` 的别名。
- * @returns 匹配到的动作定义。
- * @throws {ZentaoError} `E_INVALID_MODULE`（模块未注册）或 `E_INVALID_ACTION`（动作不存在）。
+ * @returns 匹配到的动作定义；模块未注册或动作不存在时返回 `undefined`。
  */
-export declare function getModuleAction(moduleName: string, actionName: string): ModuleAction;
+export declare function getModuleAction(moduleName: string, actionName: string): ModuleAction | undefined;
 /**
  * 获取指定模块下的某个动作的参数。
  *

package/dist/modules/query.js

@@ -1,4 +1,3 @@
-import { ZentaoError } from '../misc/errors.js';
 import { getModuleMapState, getModulesState } from './registry-store.js';
 /**
  * 获取模块定义。
@@ -7,15 +6,10 @@ import { getModuleMapState, getModulesState } from './registry-store.js';
  * 任何写入尝试在严格模式下会抛 `TypeError`；如需修改请使用 {@link defineModules}。
  *
  * @param moduleName - 模块名。
- * @returns 已注册的模块定义。
- * @throws {ZentaoError} `E_INVALID_MODULE` —— 模块未注册。
+ * @returns 已注册的模块定义；模块未注册时返回 `undefined`。
  */
 export function getModule(moduleName) {
-    const module = getModuleMapState().get(moduleName.toLowerCase());
-    if (!module) {
-        throw new ZentaoError('E_INVALID_MODULE', { module: moduleName });
-    }
-    return module;
+    return getModuleMapState().get(moduleName.toLowerCase());
 }
 /**
  * 获取指定模块下的某个动作。
@@ -30,11 +24,12 @@ export function getModule(moduleName) {
  *
  * @param moduleName - 模块名（大小写不敏感）。
  * @param actionName - 动作名（大小写不敏感）；支持 `ls` 作为 `list` 的别名。
- * @returns 匹配到的动作定义。
- * @throws {ZentaoError} `E_INVALID_MODULE`（模块未注册）或 `E_INVALID_ACTION`（动作不存在）。
+ * @returns 匹配到的动作定义；模块未注册或动作不存在时返回 `undefined`。
  */
 export function getModuleAction(moduleName, actionName) {
     const module = getModule(moduleName);
+    if (!module)
+        return undefined;
     const normalized = actionName === 'ls' ? 'list' : actionName;
     const direct = module.actions.find((action) => String(action.name).toLowerCase() === normalized.toLowerCase());
     if (direct)
@@ -45,7 +40,7 @@ export function getModuleAction(moduleName, actionName) {
         if (custom)
             return custom;
     }
-    throw new ZentaoError('E_INVALID_ACTION', { module: moduleName, action: actionName });
+    return undefined;
 }
 /**
  * 获取指定模块下的某个动作的参数。

package/dist/modules/resolve.js

@@ -6,9 +6,28 @@ const SCOPE_MAP = {
     project: 'projects',
     execution: 'executions',
 };
+const VALID_SCOPES = new Set(Object.values(SCOPE_MAP));
 const SCOPE_KEY_ORDER = ['execution', 'project', 'product'];
-/** 从调用参数中推断作用域列表路径，优先级为执行 > 项目 > 产品。 */
+/**
+ * 从调用参数中推断作用域列表路径。
+ *
+ * 优先使用显式 `scope` + `scopeID`；二者缺一则回落到别名推断，
+ * 别名优先级为执行 > 项目 > 产品。
+ */
 function pickScope(params) {
+    const explicitScope = params.scope;
+    const explicitScopeID = params.scopeID;
+    if (!isBlank(explicitScope) && !isBlank(explicitScopeID)) {
+        const scope = String(explicitScope);
+        if (!VALID_SCOPES.has(scope)) {
+            throw new ZentaoError('E_INVALID_PARAM', { param: 'scope', value: scope });
+        }
+        const scopeID = Number(explicitScopeID);
+        if (Number.isNaN(scopeID)) {
+            throw new ZentaoError('E_INVALID_PARAM', { param: 'scopeID', value: String(explicitScopeID) });
+        }
+        return { scope, scopeID };
+    }
     for (const key of SCOPE_KEY_ORDER) {
         const value = params[key] ?? params[`${key}ID`];
         if (isBlank(value))
@@ -98,7 +117,7 @@ function resolvePathValues(module, action, params) {
     if (pathParamNames.includes('scope')) {
         const scope = pickScope(params);
         if (!scope)
-            throw new ZentaoError('E_MISSING_PARAM', { param: 'product/project/execution' });
+            throw new ZentaoError('E_MISSING_PARAM', { param: 'scope/scopeID or product/project/execution' });
         values.scope = scope.scope;
         values.scopeID = scope.scopeID;
     }
@@ -180,6 +199,9 @@ function buildRequestBody(action, params) {
 /** 将模块名、动作名和调用参数解析为实际 API 请求路径、查询参数和请求体。 */
 export function resolveActionRequest(module, actionName, params = {}) {
     const action = getModuleAction(module.name, actionName);
+    if (!action) {
+        throw new ZentaoError('E_INVALID_ACTION', { module: module.name, action: actionName });
+    }
     const { values, id } = resolvePathValues(module, action, params);
     return {
         module: module.name,

package/dist/request/index.d.ts

@@ -70,6 +70,8 @@ type BodyParams<A> = A extends {
     data?: string | Record<string, unknown>;
 };
 type ScopedParams<PathParams> = 'scope' extends keyof PathParams ? {
+    scope?: 'products' | 'projects' | 'executions' | (string & {});
+    scopeID?: string | number;
     product?: string | number;
     productID?: string | number;
     project?: string | number;

package/dist/request/index.js

@@ -176,6 +176,9 @@ export async function request(name, params = {}, options = {}) {
     }
     const { moduleName, actionName, id } = splitRequestName(name);
     const module = getModule(moduleName);
+    if (!module) {
+        throw new ZentaoError('E_INVALID_MODULE', { module: moduleName });
+    }
     // recPerPage 是最常用的列表参数，允许在全局或本次调用中统一覆盖。
     const recPerPage = params.recPerPage ?? options.recPerPage ?? globals.recPerPage;
     const mergedParams = {
@@ -186,6 +189,9 @@ export async function request(name, params = {}, options = {}) {
     // autoFill：update 动作先 GET 当前对象，用现值补齐用户未显式传入的字段，
     // 避免禅道 PUT 把未提交字段覆盖为空。
     const action = getModuleAction(moduleName, actionName);
+    if (!action) {
+        throw new ZentaoError('E_INVALID_ACTION', { module: moduleName, action: actionName });
+    }
     const finalParams = action.type === 'update' && (options.autoFill ?? globals.autoFill)
         ? await autoFillUpdateParams(module, action, mergedParams, options)
         : mergedParams;

package/dist/version.js

@@ -1,5 +1,5 @@
-const fallbackBuild = "2026-07-21T02:40:34.356Z";
-const fallbackVersion = "0.4.0";
+const fallbackBuild = "2026-08-04T07:16:16.980Z";
+const fallbackVersion = "0.4.1";
 /**
  * 构建标识，由构建脚本通过 `__ZENTAO_API_BUILD__` 注入。
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zentao-api",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Browser and Node.js SDK for ZenTao API",
   "license": "MIT",
@@ -70,6 +70,8 @@
     "vitepress": "^1.6.4"
   },
   "engines": {
-    "node": ">=18"
-  }
+    "node": ">=18",
+    "bun": ">=1.0.0"
+  },
+  "packageManager": "bun@1.3.13"
 }