zentao-api 0.6.4 → 0.6.6

package/dist/modules/override.js

@@ -1,4 +1,4 @@
-import { extendModuleAction } from './define.js';
+import { extendModuleAction, defineModuleActions } from './define.js';
 import { extractResult } from './resolve.js';
 import { snapshotToMarkdown } from '../utils/doc-helper/markdown.js';
 import { isRecord } from '../utils/index.js';
@@ -90,14 +90,6 @@ export function applyBuiltinOverrides() {
         }
         return action;
     });
-    // 修改 task/list URL 定义
-    extendModuleAction('task', 'list', (action) => {
-        action.path = '/executions/{executionID}/tasks';
-        action.pathParams = {
-            executionID: '执行ID',
-        };
-        return action;
-    });
     // 修改 acl 字段默认值为 open
     [
         ['product', 'create'],
@@ -113,31 +105,10 @@ export function applyBuiltinOverrides() {
             return action;
         });
     });
-    // execution-create 支持创建阶段
+    // execution/create 补充 OpenAPI 尚未声明的里程碑字段
     extendModuleAction('execution', 'create', (action) => {
         const properties = action.requestBody.schema?.properties;
         if (properties) {
-            if (!properties.type) {
-                properties.type = {
-                    type: 'string',
-                    description: '类型(sprint 迭代，敏捷项目用 | stage 阶段，瀑布/IPD 用 | kanban 看板)',
-                };
-            }
-            if (!properties.attribute) {
-                properties.attribute = {
-                    type: 'string',
-                    description: [
-                        '阶段属性：mix - 综合（父阶段可挂不同类型子阶段）',
-                        'request - 需求（不关联需求、不测、不构建、不导入 Bug）',
-                        'design - 设计（不测、不构建、不 DevOps）',
-                        'dev - 开发（功能完整，可需求、任务、测试、构建）',
-                        'qa - 测试（同上，偏测试）',
-                        'release - 发布（同上，偏发布）',
-                        'review - 总结评审（最严：不关联需求、不测、不构建）',
-                        'other - 其他（无上述专项限制）'
-                    ].join(' | '),
-                };
-            }
             if (!properties.milestone) {
                 properties.milestone = {
                     type: 'integer',
@@ -145,13 +116,6 @@ export function applyBuiltinOverrides() {
                     format: 'int32'
                 };
             }
-            if (!properties.parent) {
-                properties.parent = {
-                    type: 'integer',
-                    description: '父级项目',
-                    format: 'int32'
-                };
-            }
         }
         return action;
     });
@@ -179,34 +143,6 @@ export function applyBuiltinOverrides() {
         }
         return action;
     });
-    // 修改 BUG 列表选项
-    extendModuleAction('bug', 'list', (action) => {
-        const params = action.params;
-        const browseTypeParam = params?.find((param) => param.name === 'browseType');
-        if (browseTypeParam && browseTypeParam.options?.length) {
-            const options = browseTypeParam.options;
-            const assignedtomeOption = options.find(x => x.value === 'assignedtome');
-            if (assignedtomeOption) {
-                browseTypeParam.options = [
-                    ...options.filter(x => x !== assignedtomeOption),
-                    {
-                        ...assignedtomeOption,
-                        value: 'assigntome',
-                    }
-                ];
-            }
-            if (!browseTypeParam.options.some(x => x.value === 'resolvedbyme')) {
-                browseTypeParam.options = [
-                    ...browseTypeParam.options,
-                    {
-                        value: 'resolvedbyme',
-                        label: '由我解决',
-                    }
-                ];
-            }
-        }
-        return action;
-    });
     // 获取文档详情时支持将文档原始 JSON 内容转换为 Markdown
     extendModuleAction('doc', 'get', (action) => {
         const oldGetter = action.resultGetter;
@@ -239,4 +175,38 @@ export function applyBuiltinOverrides() {
         };
         return action;
     });
+    // 定义获取需求层级操作
+    defineModuleActions('story', {
+        name: 'getGrades',
+        display: '获取需求层级选项',
+        type: 'list',
+        method: 'get',
+        path: '/storygrades',
+        resultType: 'list',
+        resultGetter: 'grades',
+    });
+    // 需求创建时支持设置需求层级
+    extendModuleAction('story', 'create', (action) => {
+        const properties = action.requestBody.schema?.properties;
+        if (properties && !properties.grade) {
+            properties.grade = {
+                type: 'integer',
+                description: '需求层级，可用的需求层级可以通过 story-getGrades 操作获取',
+            };
+        }
+        return action;
+    });
+    // 创建和修改任务时，任务类型字段
+    ['create', 'update'].forEach((actionName) => {
+        extendModuleAction('task', actionName, (action) => {
+            const properties = action.requestBody.schema?.properties;
+            if (properties && !properties.type) {
+                properties.type = {
+                    type: 'string',
+                    description: '任务类型（枚举：design 设计 | devel 开发 | request 需求 | test 测试 | study 研究 | discuss 讨论 | ui 界面 | affair 事务 | misc 其他）',
+                };
+            }
+            return action;
+        });
+    });
 }

package/dist/modules/query.d.ts

@@ -15,8 +15,6 @@ export declare function getModule(moduleName: string): ModuleDefinition | undefi
  * 解析顺序：
  * 1. `actionName === 'ls'` 时映射为 `list`（仅作为别名，不会修改注册表）。
  * 2. 在该模块的动作中按名称大小写不敏感匹配。
- * 3. 当请求的动作不是基础 CRUD（`list`/`get`/`create`/`update`/`delete`）时，
- *    额外允许命中 `type === 'action'` 的自定义动作（即使名字不在基础 CRUD 中）。
  *
  * 返回值同样是已深冻结的引用，请勿尝试修改。
  *

package/dist/modules/query.js

@@ -18,8 +18,6 @@ export function getModule(moduleName) {
  * 解析顺序：
  * 1. `actionName === 'ls'` 时映射为 `list`（仅作为别名，不会修改注册表）。
  * 2. 在该模块的动作中按名称大小写不敏感匹配。
- * 3. 当请求的动作不是基础 CRUD（`list`/`get`/`create`/`update`/`delete`）时，
- *    额外允许命中 `type === 'action'` 的自定义动作（即使名字不在基础 CRUD 中）。
  *
  * 返回值同样是已深冻结的引用，请勿尝试修改。
  *
@@ -32,16 +30,7 @@ export function getModuleAction(moduleName, actionName) {
     if (!module)
         return undefined;
     const normalized = actionName === 'ls' ? 'list' : actionName;
-    const direct = module.actions.find((action) => String(action.name).toLowerCase() === normalized.toLowerCase());
-    if (direct)
-        return direct;
-    const crud = new Set(['list', 'get', 'create', 'update', 'delete']);
-    if (!crud.has(normalized)) {
-        const custom = module.actions.find((action) => action.type === 'action' && String(action.name).toLowerCase() === normalized.toLowerCase());
-        if (custom)
-            return custom;
-    }
-    return undefined;
+    return module.actions.find((action) => String(action.name).toLowerCase() === normalized.toLowerCase());
 }
 /**
  * 获取指定模块下的某个动作的参数。
@@ -82,12 +71,13 @@ export function getModuleActionParams(moduleName, actionName, options) {
         if (schema.type === 'object') {
             const requiredSet = new Set(schema.required ? schema.required.map(x => x.toLowerCase()) : []);
             Object.entries(schema.properties).forEach(([name, property]) => {
+                const propertyType = property.type;
                 params.push({
+                    ...property,
                     name,
                     role: 'body',
                     required: property.required ?? requiredSet.has(name.toLowerCase()),
-                    type: (property.type === 'integer' ? 'number' : property.type) ?? 'string',
-                    ...property,
+                    type: propertyType === 'integer' ? 'number' : propertyType ?? 'string',
                 });
             });
         }
@@ -128,5 +118,5 @@ export function isModuleName(moduleName) {
  * @returns 对象属性。
  */
 export function getObjectProps(objectType) {
-    return objectProps[objectType];
+    return objectProps[objectType] ?? {};
 }