snan-cli 1.0.1 → 1.0.3

package/README.md

@@ -67,6 +67,12 @@ astro metadata tableDetail --fqn=tenant-doris_prod.default.prod_dwi.dwi_order
 ### 数据资产
 
 ```bash
+# 查询 L3 业务模型；结果包含所属业务域、业务阶段及关联资产概要
+astro asset businessModels --keyword="销售|订单"
+
+# name 必须来自 businessModels 返回结果
+astro asset businessModelDetail --name="销售订单处理"
+
 astro asset dataModels --keyword="销售|订单"
 astro asset dataModelDetail --nameEn=SalesOrder
 astro asset indicators --keyword="GMV|成交额"
@@ -91,6 +97,19 @@ astro data queryOrigin --body="{\"dsCode\":\"erp_prod\",\"sql\":\"SELECT order_n
 
 `dsCode` 必须来自 `metadata sources`，并且对应 `sourceType=DATASOURCE` 的来源。
 
+### 组织查询
+
+```bash
+# 获取部门清单
+astro org departments --raw
+
+# 按关键字、部门筛选人员
+astro org users --keyword '张三' --dept-code D001 --page 1 --page-size 100 --raw
+
+# 按角色名称筛选角色
+astro org roles --keyword '销售' --page 1 --page-size 1000 --raw
+```
+
 ### 数据标准
 
 ```bash

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "snan-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI tool to expose backend HTTP interfaces as command-line commands",
   "type": "commonjs",
   "bin": {
-    "astro": "./bin/astro"
+    "astro": "bin/astro"
   },
   "main": "src/index.js",
   "files": [
@@ -15,7 +15,7 @@
   ],
   "scripts": {
     "start": "node bin/astro",
-    "test": "node test/cli.test.js"
+    "test": "node --test"
   },
   "keywords": [
     "cli",

package/src/index.js

@@ -34,6 +34,15 @@ function setupCompletion(modules) {
   }
 }
 
+function parseOptionValue(param, value) {
+  if (param.type !== 'integer') return value;
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error(`--${param.flag || param.name} must be a positive integer`);
+  }
+  return parsed;
+}
+
 async function main() {
   const modules = loadModules();
 
@@ -86,13 +95,15 @@ async function main() {
 
       const method = (actionDef.method || 'POST').toUpperCase();
       const paramDefs = actionDef.params || [];
+      const bodyParam = method === 'GET' ? null : paramDefs.find(p => p.name === 'body');
+      const optionParamDefs = bodyParam
+        ? paramDefs.filter(p => p.name !== 'body')
+        : paramDefs;
 
-      if (method === 'GET') {
-        paramDefs.forEach(p => {
-          cmd.option(`--${p.name} <value>`, p.description);
-        });
-      } else {
-        const bodyParam = paramDefs.find(p => p.name === 'body');
+      optionParamDefs.forEach(p => {
+        cmd.option(`--${p.flag || p.name} <value>`, p.description);
+      });
+      if (method !== 'GET') {
         const bodyDescription = bodyParam?.description || 'JSON body for the request';
         if (bodyParam?.required) {
           cmd.requiredOption('--body <json>', bodyDescription);
@@ -107,35 +118,38 @@ async function main() {
         try {
           // action.path 优先（支持子路径），否则自动拼接 /actionName
           const url = actionDef.path ? `${urlPrefix}${actionDef.path}` : `${urlPrefix}/${actionName}`;
-          let requestParams = {};
-
-          if (method === 'GET') {
-            paramDefs.forEach(p => {
-              if (options[p.name] !== undefined) {
-                requestParams[p.name] = options[p.name];
-              } else if (p.required) {
-                console.error(`Error: --${p.name} is required`);
-                process.exit(1);
-              }
-            });
-          } else {
-            if (options.body) {
-              try {
-                requestParams = JSON.parse(options.body);
-              } catch (err) {
-                console.error(`Error: Invalid JSON in --body: ${err.message}`);
-                process.exit(1);
-              }
+          let requestParams = { ...(actionDef.requestDefaults || {}) };
+
+          if (method !== 'GET' && options.body) {
+            try {
+              requestParams = { ...requestParams, ...JSON.parse(options.body) };
+            } catch (err) {
+              console.error(`Error: Invalid JSON in --body: ${err.message}`);
+              process.exit(1);
             }
+          } else if (bodyParam && bodyParam.required) {
+            throw new Error('--body is required');
           }
 
-          const response = await httpClient.request2(method, url, requestParams);
+          optionParamDefs.forEach(p => {
+            if (options[p.name] !== undefined) {
+              requestParams[p.requestName || p.name] = parseOptionValue(p, options[p.name]);
+            } else if (p.required) {
+              throw new Error(`--${p.flag || p.name} is required`);
+            }
+          });
+
+          let response = await httpClient.request2(method, url, requestParams);
 
           if (response && response.isHttpError) {
             printError(response);
             process.exit(1);
           }
 
+          if (actionDef.transformResponse) {
+            response = actionDef.transformResponse(response);
+          }
+
           print(response, { raw: options.raw });
         } catch (err) {
           printError(err);
@@ -152,3 +166,5 @@ main().catch(err => {
   console.error('Fatal error:', err.message);
   process.exit(1);
 });
+
+module.exports = { parseOptionValue };

package/src/modules/asset.js

@@ -1,8 +1,22 @@
 module.exports = {
   name: 'asset',
-  description: '数据资产：数据模型和指标查询',
+  description: '数据资产：业务模型、数据模型和指标查询',
   urlPrefix: '/astro-server/openapi/v1/asset',
   actions: {
+    businessModels: {
+      description: '获取 L3 业务模型列表（含所属业务域、业务阶段及关联资产概要）',
+      method: 'GET',
+      params: [
+        { name: 'keyword', description: '查询关键字，多个关键字用空格或|分隔，为空查询全部', required: false },
+      ],
+    },
+    businessModelDetail: {
+      description: '根据业务模型名称获取详情（含业务定义、层级及关联资产）',
+      method: 'GET',
+      params: [
+        { name: 'name', description: '业务模型名称（唯一标识），必须来自 businessModels 返回结果', required: true },
+      ],
+    },
     dataModels: {
       description: '获取数据资产模型列表（含可用表信息）',
       method: 'GET',

package/src/modules/org.js

@@ -0,0 +1,65 @@
+function mapData(response, mapper) {
+  if (!response || response.data === undefined) return response;
+  return { ...response, data: mapper(response.data) };
+}
+
+function roleSummary(role) {
+  return {
+    code: role && role.code,
+    roleName: role && role.roleName,
+  };
+}
+
+module.exports = {
+  name: 'org',
+  description: '组织查询：部门、人员和角色只读清单',
+  urlPrefix: '/astro-server/openapi/v1/org',
+  actions: {
+    departments: {
+      description: '获取当前租户的部门清单',
+      method: 'GET',
+      path: '/departments',
+      transformResponse: response => mapData(response, data => (data || []).map(item => ({
+        code: item.code,
+        name: item.name,
+      }))),
+    },
+    users: {
+      description: '获取当前租户的人员清单',
+      method: 'GET',
+      path: '/users',
+      requestDefaults: { pageNo: 1, pageSize: 100 },
+      params: [
+        { name: 'keyword', description: '姓名或账号关键字' },
+        { name: 'deptCode', flag: 'dept-code', description: '部门编码' },
+        { name: 'page', requestName: 'pageNo', flag: 'page', description: '页码，默认 1', type: 'integer' },
+        { name: 'pageSize', flag: 'page-size', description: '每页数量，默认 100', type: 'integer' },
+      ],
+      transformResponse: response => mapData(response, data => ({
+        ...data,
+        result: (data && data.result ? data.result : []).map(user => ({
+          account: user.account,
+          name: user.name,
+          deptCode: user.deptCode,
+          deptName: user.deptName,
+          roles: (user.roles || []).map(roleSummary),
+        })),
+      })),
+    },
+    roles: {
+      description: '获取当前租户的角色清单',
+      method: 'GET',
+      path: '/roles',
+      requestDefaults: { pageNo: 1, pageSize: 1000 },
+      params: [
+        { name: 'keyword', description: '角色名称关键字' },
+        { name: 'page', requestName: 'pageNo', flag: 'page', description: '页码，默认 1', type: 'integer' },
+        { name: 'pageSize', flag: 'page-size', description: '每页数量，默认 1000', type: 'integer' },
+      ],
+      transformResponse: response => mapData(response, data => ({
+        ...data,
+        result: (data && data.result ? data.result : []).map(roleSummary),
+      })),
+    },
+  },
+};