zero-ai 0.3.27 → 0.3.30

package/src/commander-aj/fn.j.bundle.js

@@ -54,17 +54,21 @@ module.exports = () => {
  *
  * ### 1. 命令
  *
- * 使用该命令生成一个 OSGI Bundle 专用的目录结构
+ * ```shell
+ * aj bundle -p <path>
+ * ```
  *
- * ### 2. 执行
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-p|--path|String|无|生成目录规范的主目录。|
  *
- * #### 2.1. 基本介绍
+ * ### 2. 介绍
  *
- * ```shell
- * # 2.1.1. 命令语法
- * aj bundle -p <path>
+ * 使用该命令生成一个 OSGI Bundle 专用的目录结构
+ *
+ * ### 3. 执行
  *
- * # 2.1.2. 执行测试
+ * ```shell
  * ai bundle -p <path>
  *
  * [Zero AI] Zero Ecotope AI工具项  : <专用工具>
@@ -81,14 +85,6 @@ module.exports = () => {
  * [Zero AI] （Async）成功将数据写入到文件：./specification.txt！
  * ```
  *
- * ### 3. 选项
- *
- * #### 3.1. 基本说明
- *
- * |短参|全参|类型|默认|含义|
- * |---|---|---|---|:---|
- * |-p|--path|String|无|生成目录规范的主目录。|
- *
  * @memberOf module:aj
  * @method bundle
  **/

package/src/commander-aj/fn.j.init.js

@@ -30,15 +30,21 @@ module.exports = () => {
  *
  * ### 1. 命令
  *
- * vertx-zero-scaffold项目脚手架初始化专用命令。
- *
- * ### 2. 执行
- *
  * ```shell
- * # 2.1. 命令语法
  * aj init -name <name>
+ * ```
+ *
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-n|--name|String|（无）|项目名称以及目录名称。|
+ *
+ * ### 2. 介绍
  *
- * # 2.2. 执行测试
+ * zero-scaffold项目脚手架初始化专用命令。
+ *
+ * ### 3. 执行
+ *
+ * ```shell
  * aj init -name test-demo-api
  * [Zero AI] Zero AI 代码生成工具  : <标准工具>
  * [Zero AI] HomePage   : http://www.vertxai.cn
@@ -61,12 +67,6 @@ module.exports = () => {
  * [Zero AI] 工程初始化完成：test-demo-api，您可以开始您的Zero Api之行了！
  * ```
  *
- * ### 3. 选项
- *
- * |短参|全参|类型|默认|含义|
- * |---|---|---|---|:---|
- * |-n|--name|String|（无）|项目名称以及目录名称。|
- *
  * @memberOf module:aj
  * @method init
  */

package/src/commander-aj/fn.j.permission.js

@@ -30,32 +30,28 @@ module.exports = () => {
  *
  * ### 1. 命令
  *
- * 使用该命令生成某个角色的专用权限文件目录（内置所有Zero Extension标准权限）
+ * ```shell
+ * aj perm -r <role> -i <input>
+ * ```
  *
- * ### 2. 执行
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-r|--role|String|无|系统中角色的UUID。|
+ * |-i|--input|String|无|另外一个目录，用来合并新权限。|
  *
- * #### 2.1. 基本介绍
+ * ### 2. 介绍
  *
- * ```shell
- * # 2.1.1. 命令语法
- * aj perm -r <role> -i <input>
+ * 使用该命令生成某个角色的专用权限文件目录（内置所有Zero Extension标准权限），此命令会直接从单个角色中拷贝
  *
- * # 2.1.2. 执行测试
+ * ### 3. 执行
+ *
+ * ```shell
  * ai perm -r ccc -i input
  *
  * [Zero AI] Zero AI  1. 准备生成角色对应权限：ID = "ccc" ...
  * [Zero AI] Zero AI  2. 生成 Zero Extension 权限...
  * ```
  *
- * ### 3. 选项
- *
- * #### 3.1. 基本说明
- *
- * |短参|全参|类型|默认|含义|
- * |---|---|---|---|:---|
- * |-c|--role|String|无|系统中角色的UUID。|
- * |-i|--input|String|无|另外一个目录，用来合并新权限。|
- *
  * @memberOf module:aj
  * @method perm
  **/

package/src/commander-aj/fn.j.plugin.js

@@ -31,17 +31,23 @@ module.exports = () => {
  *
  * ### 1. 命令
  *
- * 使用该命令执行插件项目初始化，设置第三方集成项目模板专用。
+ * ```shell
+ * aj plugin -m pbc
+ * ```
  *
- * ### 2. 执行
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-p|--path|String|无|根据传入路径设置，如果是`.`则是当前目录，如果不传则从`workspace.json`中读取。|
+ * |-m|--module|String|无|模块名称，通常是`infix-xxx`中的`xxx`名称。|
+ * |-c|--config|String|`workspace.json`|配置文件路径。|
  *
- * #### 2.1. 基本介绍
+ * ### 2. 介绍
  *
- * ```shell
- * # 2.1.1. 命令语法
- * aj plugin -m pbc
+ * 使用该命令执行插件项目初始化，设置第三方集成项目模板专用。
+ *
+ * ### 3. 执行
  *
- * # 2.1.2. 执行测试
+ * ```shell
  * aj plugin -m pbc
  * # ...省略部分...
  * [Zero AI] Zero AI 系统启动......
@@ -105,16 +111,6 @@ module.exports = () => {
  * [Zero AI] Zero AI  3. 执行完成......
  * ```
  *
- * ### 3. 选项
- *
- * #### 3.1. 基本说明
- *
- * |短参|全参|类型|默认|含义|
- * |---|---|---|---|:---|
- * |-p|--path|String|无|根据传入路径设置，如果是`.`则是当前目录，如果不传则从`workspace.json`中读取。|
- * |-m|--module|String|无|模块名称，通常是`infix-xxx`中的`xxx`名称。|
- * |-c|--config|String|`workspace.json`|配置文件路径。|
- *
  * @memberOf module:aj
  * @method plugin
  **/

package/src/commander-aj/index.js

@@ -1,4 +1,3 @@
-
 const javaPermission = require('./fn.j.permission');
 const javaResource = require('./fn.i.resource');
 const javaPlugin = require('./fn.j.plugin');
@@ -13,4 +12,29 @@ const exported = {
     javaInit,           // aj jinit
     javaBundle,
 };
-module.exports = exported;
+module.exports = exported;
+
+/**
+ * ## aj命令
+ *
+ * ### 1. 基本使用
+ *
+ * aj命令的专用语法如下：
+ *
+ * ```shell
+ * aj <command> [options1|options2|options3...]
+ * ```
+ *
+ * ### 2. 命令列表
+ *
+ * |命令执行|含义|
+ * |---|:---|
+ * |aj perm|生成某个角色的权限专用Excel数据文件|
+ * |aj rs|为某个接口直接生成系统所需的权限文件，只针对超级管理员（key = `e501b47a-c08b-4c83-b12b-95ad82873e96`），<br/>若存在其他额外角色可以继续使用命令 `aj perm` 从超级管理员中拷贝。|
+ * |aj plugin|「工程命令」生成第三方插件专用初始化命令，可为某个 Maven 插件实现初始化流程，包括代码生成。|
+ * |aj mod|模块化专用命令，根据当前环境中的 __路由规划器__ 和 __模块规划器__ 自动化重写模块化专用配置文件。|
+ * |aj init|「工程命令」根据后端脚手架初始化Zero后端工程命令。|
+ * |aj bundle|OSGI目录初始化专用命令，可以为某个 OSGI 的 Bundle 按相关规范生成目录结构。|
+ *
+ * @module aj
+ */

package/src/commander-ar/fn.i.complex.js

@@ -28,22 +28,26 @@ module.exports = () => {
     if (configuration) Ec.reactRun(configuration);
 }
 /**
- * ## `aj icomplex`
+ * ## `art complex`
  *
  * ### 1. 命令
  *
- * 使用该命令生成完整的`ExListComplex`完整组件页。
+ * ```shell
+ * art complex
+ * ```
  *
- * ### 2. 执行
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-c|--config|String|`ui.json`|配置文件路径。|
  *
- * #### 2.1. 基本介绍
+ * ### 2. 介绍
  *
- * ```shell
- * # 2.1.1. 命令语法
- * aj icomplex
+ * 使用该命令生成完整的`ExListComplex`完整组件页。
  *
- * # 2.1.2. 执行测试
- * aj icomplex
+ * ### 3. 执行
+ *
+ * ```shell
+ * art complex
  * # ...省略部分...
  * [Zero AI] Zero AI 系统启动......
  * [Zero AI] Zero AI 加载输入参数：
@@ -86,7 +90,7 @@ module.exports = () => {
  * * 执行位置可以是当前项目中的任意一个路径，脚本会自己计算当前项目的根目录（Zero UI专用）。
  * * 该命令执行时模板文件位置位于`src/cab/list`目录中，且模板文件以`tpl`结尾。
  *
- * #### 2.2. 生成的文件说明
+ * ### 4. 生成的文件说明
  *
  * |文件名|模板|含义|
  * |:---|:---|:---|
@@ -99,14 +103,6 @@ module.exports = () => {
  * |Op.js|Op.js.tpl|Action/Callback专用Js事件脚本。|
  * |UI.Form.js|UI.Form.js.tpl|三个表单合一的专用Js脚本。|
  *
- * ### 3. 选项
- *
- * #### 3.1. 基本说明
- *
- * |短参|全参|类型|默认|含义|
- * |---|---|---|---|:---|
- * |-c|--config|String|`ui.json`|配置文件路径。|
- *
- * @memberOf module:aj
- * @method icomplex
+ * @memberOf module:art
+ * @method complex
  */

package/src/commander-ar/fn.i.form.js

@@ -22,22 +22,27 @@ module.exports = () => {
     if (configuration) Ec.reactRun(configuration);
 }
 /**
- * ## `aj iform`
+ * ## `art form`
  *
  * ### 1. 命令
  *
- * 使用该命令生成完整的`ExForm`完整表单组件页。
+ * ```shell
+ * art form -u <ui>
+ * ```
+ *
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-u|--ui|String|无|生成的文件名，最终生成`<Name>.json/<Name>.js`|
+ * |-c|--config|String|`ui.json`|配置文件路径。|
  *
- * ### 2. 执行
+ * ### 2. 介绍
  *
- * #### 2.1. 基本介绍
+ * 使用该命令生成完整的`ExForm`完整表单组件页。
  *
- * ```shell
- * # 2.1.1. 命令语法
- * ai iform -u <ui>
+ * ### 3. 执行
  *
- * # 2.1.2. 执行测试
- * aj iform -u UI.Basic
+ * ```shell
+ * art form -u UI.Basic
  * # ...省略部分...
  * [Zero AI] Zero AI 系统启动......
  * [Zero AI] Zero AI 加载输入参数：
@@ -68,24 +73,8 @@ module.exports = () => {
  * * 该命令执行时模板文件位置位于`src/cab/form`目录中，且模板文件以`tpl`结尾。
  * * 生成的`UI.js`的按钮部分直接位于当前文件中，并且默认包含了`ADD, EDIT, DELETE`三个核心按钮。
  *
- * #### 2.2. 生成的文件说明
- *
- * |文件名|模板|含义|
- * |:---|:---|:---|
- * |Cab.json|无|名空间关联文件，计算得来。|
- * |`<Name>.json`|UI.json.tpl|当前表单专用资源文件。|
- * |`<Name>.js`|UI.js.tpl|当前表单源代码专用文件。|
- *
- *
- * ### 3. 选项
- *
- * #### 3.1. 基本说明
- *
- * |短参|全参|类型|默认|含义|
- * |---|---|---|---|:---|
- * |-u|--ui|String|无|生成的文件名，最终生成`<Name>.json/<Name>.js`|
- * |-c|--config|String|`ui.json`|配置文件路径。|
+ * ### 4. 生成的文件说明
  *
- * @memberOf module:aj
- * @method iform
+ * @memberOf module:art
+ * @method form
  */

package/src/commander-ar/index.js

@@ -4,4 +4,80 @@ const exported = {
     reactComplex,
     reactForm,
 }
-module.exports = exported;
+module.exports = exported;
+
+/**
+ * ## art命令
+ *
+ * ### 1. 基本使用
+ *
+ * art命令的专用语法如下：
+ *
+ * ```shell
+ * art <command> [options1|options2|options3...]
+ * ```
+ *
+ * ### 2. 命令列表
+ *
+ * |命令执行|含义|
+ * |---|:---|
+ * |art complex|「模块」生成`ExListComplex`专用模块。|
+ * |art form|「组件」生成`ExForm`专用组件。|
+ *
+ * ### 3. 标准化配置
+ *
+ * ```js
+ * {
+ *      module: 'ZT环境变量设置的模块',
+ *      language: 'Z_LANGUAGE语言环境变量设置，默认「cn」',
+ *      pathRoot: '系统根据执行目录计算的当前项目根目录',
+ *      pathResource: '资源目录',
+ *      pathUi: '生成代码目录',
+ *      namespace: 'Cab.json中所需的名空间值',
+ *      input: {
+ *          params: {
+ *              MODULE: '当前模块的文字描述名称',
+ *              API: '构造标准接口`/api/xxx`的RESTful接口专用路径替换部分。',
+ *              IDENTIFIER: '模型的统一标识符，最终会绑定到identifier中。'
+ *          },
+ *          tpl: {
+ *              type: '使用的模板tpl文件目录，cab/下的目录名',
+ *              source: '「单文件」单文件的拷贝源',
+ *              target: '「单文件」单文件的目标拷贝文件'
+ *          }
+ *      },
+ *      runtime: {
+ *          namespaceFile: 'Cab.json文件生成路径',
+ *          resource: '资源文件的根目录',
+ *          resourceFiles: {
+ *              'fileName1': '资源文件地址，json后缀，模板则是fileName1.tpl文件',
+ *              'fileName2': '......'
+ *          },
+ *          ui: '代码文件根目录',
+ *          uiFiles: {
+ *              'fileName1': '代码文件地址，js后缀，模板则是fileName1.tpl文件',
+ *              'fileName2': '......'
+ *          }
+ *      }
+ * }
+ * ```
+ *
+ *
+ * ### 4. 标准化模板参数
+ *
+ * > `tpl`文件中替换的部分会使用配置文件中的参数来替换。
+ *
+ * |参数|替换部分|含义|
+ * |:---|---|:---|
+ * |MODULE|`#MODULE#`|当前模块的文字描述名称。|
+ * |API|`#API#`|构造标准接口`/api/xxx`的RESTful接口专用路径替换部分。|
+ * |IDENTIFIER|`#IDENTIFIER#`|模型的统一标识符，最终会绑定到identifier中。|
+ * |NAME|`#NAME#`|绑定文件设定，直接赋值`input.params.NAME = tpl.target`生成单文件专用。|
+ * |SIGMA|`#SIGMA`|SIGMA统一标识符，用于标识租户、应用。|
+ * |ROLE_ID|`#ROLE_ID#`|操作的角色ID。|
+ * |PREFIX|无|生成文件专用参数，不在模板中。|
+ * |SHEET|无|工作专用的Sheet名，不在模板中。|
+ *
+ *
+ * @module art
+ */

package/src/epic/ai.economy.impl.fn.excel.js

@@ -60,6 +60,7 @@ const excelResource = async (config = {}, parameters = {}, pid = [], sheetName =
             const maxRow = worksheetRef['_rows'].length;
             const maxColumn = worksheetRef['_columns'].length;
             __LOG.info(`Zero AI `.cyan + ` 2.2. 分析结果：最大行 - ${maxRow.toString().blue}，最大列 - ${maxColumn.toString().blue}。`);
+
             const pidSet = new Set();
             const generate = 0 === pid.length
             worksheetRef.eachRow((rowRef, rowNumber) => {
@@ -90,7 +91,26 @@ const excelResource = async (config = {}, parameters = {}, pid = [], sheetName =
                     }
                 })
             });
-            __LOG.info(`Zero AI `.cyan + ` 1.3. 创建新数据文件......`.rainbow);
+            __LOG.info(`Zero AI `.cyan + ` 2.3. 正在解析表达式......`);
+            worksheetRef.eachRow((rowRef, rowNumber) => {
+                rowRef.eachCell((cellRef, cellNumber) => {
+                    const original = cellRef.value;
+                    if (original?.sharedFormula || original?.formula) {
+                        let formula;
+                        if (original.sharedFormula) {
+                            formula = original.sharedFormula;
+                        } else if (original.formula) {
+                            formula = original.formula;
+                        }
+                        const cell = worksheetRef.getCell(formula);
+                        if ("string" === typeof cell?.value) {
+                            original.result = cell.value;
+                            cellRef.value = original;
+                        }
+                    }
+                })
+            });
+            __LOG.info(`Zero AI `.cyan + ` 2.4. 创建新数据文件......`.rainbow);
             const targetFile = `./${config.identifier}.xlsx`;
             __LOG.info(`Zero AI `.cyan + ` 执行Worksheet：${targetFile.blue}。`);
             await workbook.xlsx.writeFile(targetFile);

package/src/epic/ai.unified.fn.fn.error.code.js

@@ -57,12 +57,6 @@
  * |10033|`path`|当前路径不符合Zero专用规范（基础Java/Maven规范）。|
  * |10034|`path`|当前路径不符合Ox平台专用规范。|
  *
- * ### 3. 规范
- *
- * #### 3.1. Zero规范
- *
- * #### 3.2. Ox规范
- *
  * @class E
  */
 module.exports = {