zero-ai 0.3.33 → 0.3.35

package/src/commander/ai.zero

@@ -1,12 +1,8 @@
 A;
-command,    executor,       description,                                option1,option2, option3, option4
-uuid,       executeUuid,    生成UUID的值，可直接拷贝,                      n=「20」生成的数量
-csv,        executeCsv,     将JsonArray数据转换成csv,                     p=输入数据文件路径, c=配置文件路径, s=分割符
-uk,         executeUk,      检查数据文件中的Data数据是否符合唯一值规范,       p=输入数据文件路径, f=需要检查的字段名
-data,       executeData,    根据配置文件生成数据,                          c=配置文件路径, o=「.」输出文件基本路径, j=「false」是否Array, n=「23」如果是Array则生效
-key,        executeKey,     为数据模板添加key属性（UUID格式）,              p=输入数据文件路径, f=「key」标识key的字段名
-str,        executeString,  生成随机字符串，可直接拷贝,                     n=「1」生成的数量, l=「64」长度信息（默认64）,f=是否完全生成
-md5,        executeMD5,     加密字符串，可直接拷贝,                        i=输入字符串
-init,       executeInit,    初始化Zero Ui工程,                           n=项目名称（必须填写，最终写入package.json）
-sync,       executeSync,    同步Zero Ui最新框架,                         p=配置文件路径，前端项目根目录,m=是否本地模式
-
+command,    executor,               description,                                option1,option2, option3, option4
+uuid,       executeUuid,            生成UUID的值，可直接拷贝,                      n=「20」生成的数量
+str,        executeString,          生成随机字符串，可直接拷贝,                     n=「1」生成的数量, l=「64」长度信息（默认64）,f=是否完全生成
+md5,        executeMD5,             加密字符串，可直接拷贝,                        i=输入字符串
+sync,       executeFrontendSync,    同步Zero Ui最新框架,                          p=配置文件路径，前端项目根目录,m=是否本地模式
+app,        executeApp,             生成Zero 微服务实例,                          p=配置文件路径,n=名称（最小模式）
+mod,        executeMod,             生成Zero 扩展模块实例,                        p=配置文件路径,n=名称（完整模式）

package/src/commander/app.json

@@ -0,0 +1,24 @@
+{
+    "executor": "executeApp",
+    "description": "（后端）创建一个新的 Zero App 脚手架！",
+    "command": "app",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "创建应用的名称！"
+        },
+        {
+            "name": "config",
+            "alias": "c",
+            "description": "配置文件路径，默认读取 app.json 文件！",
+            "default": "app.json"
+        },
+        {
+            "name": "output",
+            "alias": "o",
+            "description": "默认应用的输出路径，若不制定为当前路径！",
+            "default": "."
+        }
+    ]
+}

package/src/commander/help.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeHelp",
+    "description": "显示帮助的详细信息！",
+    "command": "help",
+    "options": [
+    ]
+}

package/src/commander/md5.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeMD5",
+    "description": "直接针对输入内容生成 MD5 加密值",
+    "command": "md5",
+    "options": [
+        {
+            "name": "input",
+            "alias": "i",
+            "description": "加密输入的字符串的值"
+        }
+    ]
+}

package/src/commander/mod.json

@@ -0,0 +1,24 @@
+{
+    "executor": "executeMod",
+    "description": "（后端）创建一个新的 Zero Extension 模块脚手架！",
+    "command": "mod",
+    "options": [
+        {
+            "name": "module",
+            "alias": "m",
+            "description": "创建模块的名称！"
+        },
+        {
+            "name": "config",
+            "alias": "c",
+            "description": "配置文件路径，默认读取 mod.json 文件！",
+            "default": "mod.json"
+        },
+        {
+            "name": "output",
+            "alias": "o",
+            "description": "默认应用的输出路径，若不制定为当前路径！",
+            "default": "."
+        }
+    ]
+}

package/src/commander/spring.json

@@ -0,0 +1,24 @@
+{
+    "executor": "executeSpring",
+    "description": "（后端）创建一个新的 Spring 脚手架！",
+    "command": "spring",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "创建应用的名称！"
+        },
+        {
+            "name": "config",
+            "alias": "c",
+            "description": "配置文件路径，默认读取 app.json 文件！",
+            "default": "app.json"
+        },
+        {
+            "name": "output",
+            "alias": "o",
+            "description": "默认应用的输出路径，若不制定为当前路径！",
+            "default": "."
+        }
+    ]
+}

package/src/commander/str.json

@@ -0,0 +1,25 @@
+{
+    "executor": "executeString",
+    "description": "生成随机字符串",
+    "command": "str",
+    "options": [
+        {
+            "name": "number",
+            "alias": "n",
+            "description": "生成随机数的数量，默认 1 个",
+            "default": 1
+        },
+        {
+            "name": "length",
+            "alias": "l",
+            "description": "生成随机字符串的长度，默认 10 个字符",
+            "default": 10
+        },
+        {
+            "name": "full",
+            "alias": "f",
+            "description": "是否使用全字符集，默认 false，只使用字母和数字",
+            "default": false
+        }
+    ]
+}

package/src/commander/sync.json

@@ -0,0 +1,19 @@
+{
+    "executor": "executeFrontendSync",
+    "description": "同步 Zero Ui 的最新框架",
+    "command": "sync",
+    "options": [
+        {
+            "name": "path",
+            "alias": "p",
+            "description": "本地配置文件路径，默认 .zero",
+            "default": ".zero"
+        },
+        {
+            "name": "mode",
+            "alias": "m",
+            "description": "指定同步模块的模式，是否本地同步",
+            "default": false
+        }
+    ]
+}

package/src/commander/uuid.json

@@ -0,0 +1,13 @@
+{
+    "executor": "executeUuid",
+    "description": "生成 UUID 的值，可直接拷贝",
+    "command": "uuid",
+    "options": [
+        {
+            "name": "number",
+            "alias": "n",
+            "description": "生成 UUID 的数量，默认 1 个",
+            "default": 1
+        }
+    ]
+}

package/src/commander/web.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeWeb",
+    "description": "（前端）创建一个新的 Zero Ui 的脚手架！",
+    "command": "web",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "创建 Web 应用的名称！"
+        }
+    ]
+}

package/src/commander-ai/fn.help.metadata.js

@@ -0,0 +1,20 @@
+const Ec = require('../epic');
+const os = require('os');
+const Ut = require("../commander-shared");
+module.exports = (options) => {
+    const metadata = Ut.parseMetadata();
+    metadata.forEach(runner => {
+        Ec.execute(`命令：` + `ai ${runner.command} [-options]`.green);
+        Ec.execute(`说明：${runner.description}`.yellow);
+        runner.options.forEach(option => {
+            if (option.hasOwnProperty('default')) {
+                const str = option.default + '';
+                Ec.execute(`\t-${option.alias},--${option.name}`.red + `\t${option.description}, 默认值：\uD83C\uDF37 ` + str.blue);
+            } else {
+                Ec.execute(`\t-${option.alias},--${option.name}`.red + `\t${option.description}`);
+            }
+        })
+        Ec.execute();
+    });
+    Ec.info("命令执行完成！")
+}

package/src/commander-ai/{fn.md5.js → fn.random.md5.js}

@@ -1,28 +1,22 @@
 const Ec = require('../epic');
 const os = require('os');
+const Ut = require("../commander-shared");
 
 const os_compatible = ['darwin', 'win32'];
 
-module.exports = () => {
-    /*
-     * 参数解析
-     */
-    const actual = Ec.executeInput(
-        ['-i', '--input'],
-        [
-            ["-i", "--input"]
-        ]
-    );
+module.exports = (options) => {
+    const parsed = Ut.parseArgument(options);
     /*
      * 基本信息
      */
-    const input = actual.input;
+    const input = parsed.input;
     const platform = os.platform();
     Ec.info(`当前操作系统：${platform}`);
 
     if (os_compatible.indexOf(platform) > -1) {
         const content = Ec.strMD5(input);
-        console.info(content);
+        Ec.execute(`明文值：${input}`)
+        Ec.execute(`加密值：${content}`);
         Ec.outCopy(content)
             .then(sign => Ec.info(`加密的字符串已经成功拷贝到剪切板中！`))
     } else {

package/src/commander-ai/{fn.random.js → fn.random.string.js}

@@ -1,25 +1,19 @@
 const Ec = require('../epic');
 const os = require('os');
+const Ut = require("../commander-shared");
 
 const os_compatible = ['darwin', 'win32'];
 
-module.exports = () => {
+module.exports = (options) => {
     /*
      * 参数解析
      */
-    const actual = Ec.executeInput(
-        [],
-        [
-            ['-n', '--number', 1],
-            ['-l', '--length', 64],
-            ['-f', '--full', false]
-        ]
-    );
+    const parsed = Ut.parseArgument(options);
     /*
      * 基本信息
      */
-    const number = actual.number;
-    const length = actual.length;
+    const number = parsed.number;
+    const length = parsed.length;
     const platform = os.platform();
     Ec.info(`随机字符串，生成数量：${number}，长度：${length}`);
     Ec.info(`当前操作系统：${platform}`);
@@ -27,8 +21,8 @@ module.exports = () => {
     if (os_compatible.indexOf(platform) > -1) {
         const content = [];
         for (let idx = 0; idx < number; idx++) {
-            const generated = Ec.strRandom(length, actual.full);
-            console.info(generated);
+            const generated = Ec.strRandom(length, parsed.full);
+            Ec.execute(generated);
             content.push(generated);
         }
         Ec.outCopy(content.join('\n'))

package/src/commander-ai/{fn.uuid.js → fn.random.uuid.js}

@@ -1,22 +1,18 @@
 const Ec = require('../epic');
+const Ut = require("../commander-shared");
 const os = require('os');
 
 const os_compatible = ['darwin', 'win32'];
 
-module.exports = () => {
+module.exports = (options) => {
     /*
      * 参数解析
      */
-    const actual = Ec.executeInput(
-        [],
-        [
-            ['-n', '--number', 20]
-        ]
-    );
+    const parsed = Ut.parseArgument(options);
     /*
      * 基本信息
      */
-    const number = actual.number;
+    const number = parsed.number;
     const platform = os.platform();
     Ec.info(`UUID生成器，生成数量：${number}`);
     Ec.info(`当前操作系统：${platform}`);
@@ -24,7 +20,7 @@ module.exports = () => {
         const content = [];
         for (let idx = 0; idx < number; idx++) {
             const generated = Ec.strUuid();
-            console.info(generated);
+            Ec.execute(generated);
             content.push(generated);
         }
         Ec.outCopy(content.join('\n'))

package/src/commander-ai/fn.source.app.js

@@ -0,0 +1,20 @@
+const Ec = require("../epic");
+const Ut = require("../commander-shared");
+
+module.exports = (options) => {
+    /*
+     * 参数解析
+     */
+    const parsed = Ut.parseArgument(options);
+    /*
+     * 基本信息验证
+     */
+    if (!Ut.nameValid(parsed.name)) {
+        Ec.error("应用名称只能包含字母、数字、点（.）和短横线（-），且不能以数字、点（.）或短横线（-）开头！");
+        process.exit(1);
+    }
+    const configuration = Ut.initAppConfiguration(parsed);
+    Ec.info(`准备生成 Zero App 应用：${configuration.artifactId}`);
+    configuration.srcType = Symbol("APP");
+    Ut.initApp(configuration).then(() => Ec.info(`应用生成完成！`));
+}

package/src/commander-ai/fn.source.front.js

@@ -0,0 +1,106 @@
+const Ec = require("../epic");
+const Ut = require("../commander-shared");
+const child = require('child_process');
+module.exports = (options) => {
+    const parsed = Ut.parseArgument(options);
+    // 第一步：环境检查
+    if (Ec.isExist(".git")) {
+        Ec.error("请选择不带`.git`或`vertx-ui`的目录执行当前命令，最好使用空目录！");
+        return;
+    }
+    // 第二步：检查 vertx-ui
+    const target = parsed.name;
+    Ec.info(`工程构建目录：${target}`);
+    const cmd = `git clone https://gitee.com/silentbalanceyh/scaffold-ui.git ${target}`;
+    child.execSync(cmd, {stdio: 'inherit'});
+    // 删除目标目录中的 .git 文件夹
+    Ec.info(`执行工程初始化：${target}`);
+    const cmdGit = `rm -rf ${target}/.git`;
+    child.execSync(cmdGit, {stdio: 'inherit'});
+    // 读取目标目录
+    const content = Ec.ioJObject(`${target}/package.json`);
+    content.name = target;
+    Ec.outJson(`${target}/package.json`, content, true);
+    // 后期脚本
+    const commands = [
+        `rm -rf ${target}/.zero/*`,
+        `rm -rf ${target}/document/doc-web`,
+        `rm -rf ${target}/guide/`,
+        `rm -rf ${target}/_config.yml`,
+        `rm -rf ${target}/CNAME`,
+        `rm -rf ${target}/data.json`,
+        `rm -rf ${target}/LICENSE`,
+        `rm -rf ${target}/package-lock.json`,
+        `rm -rf ${target}/yarn.lock`,
+        `rm -rf ${target}/run-cache.sh`,
+        `rm -rf ${target}/run-ux.sh`,
+        `rm -rf ${target}/run-zero-dependency.sh`,
+        `rm -rf ${target}/SUMMARY.md`,
+    ]
+    Ec.info(`执行后期处理：......`.yellow);
+    commands.forEach(command => {
+        Ec.info(`资源清理中：${command.prompt}`);
+        child.execSync(command, {stdio: 'inherit'})
+    });
+    // 重铸 .gitignore 文件
+    Ec.info(`重铸 .gitignore`);
+    child.execSync(`mv ${target}/.gitignore.tpl ${target}/.gitignore`, {stdio: 'inherit'})
+    Ec.info(`工程初始化完成：${target}，您可以开始您的Zero Ui之行了！`.help);
+}
+/**
+ * ## `ai init`
+ *
+ * ### 1. 命令
+ *
+ * ```shell
+ * ai init -name <name>
+ * ```
+ *
+ * |短参|全参|类型|默认|含义|
+ * |---|---|---|---|:---|
+ * |-n|--name|String|（无）|项目名称以及目录名称。|
+ *
+ * ### 2. 介绍
+ *
+ * vertx-ui项目脚手架初始化专用命令。
+ *
+ * ### 3. 执行
+ *
+ * ```shell
+ * ai init -name test-demo
+ * [Zero AI] Zero AI 代码生成工具  : <标准工具>
+ * [Zero AI] HomePage   : http://www.vertxai.cn
+ * [Zero AI] Github     : https://github.com/silentbalanceyh/vertx-ai.git
+ * [Zero AI] Version    : 0.3.2  「确认您的Node版本 ( >= 14.x ) 支持ES6, ES7.」
+ * [Zero AI] Zero AI 系统启动......
+ * [Zero AI] Zero AI 加载输入参数：
+ * {
+ "name": "test-demo"
+ * }
+ * [Zero AI] 工程构建目录：test-demo
+ * Cloning into 'test-demo'...
+ * remote: Enumerating objects: 888, done.
+ * remote: Counting objects: 100% (888/888), done.
+ * remote: Compressing objects: 100% (538/538), done.
+ * remote: Total 36593 (delta 445), reused 610 (delta 339), pack-reused 35705
+ * Receiving objects: 100% (36593/36593), 29.09 MiB | 151.00 KiB/s, done.
+ * Resolving deltas: 100% (24009/24009), done.
+ * [Zero AI] 执行工程初始化：test-demo
+ * [Zero AI] （Sync）成功将数据写入到文件：test-demo/package.json！
+ * [Zero AI] 执行后期处理：......
+ * [Zero AI] 资源清理中：rm -rf test-demo/.zero/*
+ * [Zero AI] 资源清理中：rm -rf test-demo/document/doc-web/*
+ * [Zero AI] 资源清理中：rm -rf test-demo/document/doc-web-extension/*
+ * [Zero AI] 资源清理中：rm -rf test-demo/guide/
+ * [Zero AI] 资源清理中：rm -rf test-demo/_config.yml
+ * [Zero AI] 资源清理中：rm -rf test-demo/CNAME
+ * [Zero AI] 资源清理中：rm -rf test-demo/data.json
+ * [Zero AI] 资源清理中：rm -rf test-demo/LICENSE
+ * [Zero AI] 资源清理中：rm -rf test-demo/package-lock.json
+ * [Zero AI] 资源清理中：rm -rf test-demo/yarn.lock
+ * [Zero AI] 工程初始化完成：test-demo，您可以开始您的Zero Ui之行了！
+ * ```
+ *
+ * @memberOf module:ai
+ * @method init
+ */

package/src/commander-ai/fn.source.mod.js

@@ -0,0 +1,15 @@
+const Ec = require("../epic");
+const Ut = require("../commander-shared");
+
+module.exports = (options) => {
+    /*
+     * 参数解析
+     */
+    const parsed = Ut.parseArgument(options);
+    /*
+     * 基本信息验证
+     */
+    const configuration = Ut.initModuleConfiguration(parsed);
+    Ec.info(`准备生成 Zero Extension 扩展模块：${configuration.artifactId}`);
+    Ut.initMod(configuration).then(() => Ec.info(`模块生成完成！`));
+}

package/src/commander-ai/fn.source.spring.js

@@ -0,0 +1,20 @@
+const Ec = require("../epic");
+const Ut = require("../commander-shared");
+
+module.exports = (options) => {
+    /*
+     * 参数解析
+     */
+    const parsed = Ut.parseArgument(options);
+    /*
+     * 基本信息验证
+     */
+    if (!Ut.nameValid(parsed.name)) {
+        Ec.error("应用名称只能包含字母、数字、点（.）和短横线（-），且不能以数字、点（.）或短横线（-）开头！");
+        process.exit(1);
+    }
+    const configuration = Ut.initSpringConfiguration(parsed);
+    Ec.info(`准备生成 Rapid Spring App 应用：${configuration.artifactId}`);
+    configuration.srcType = Symbol("SPRING");
+    Ut.initSpring(configuration).then(() => Ec.info(`应用生成完成！`));
+}

package/src/commander-ai/{fn.sync.js → fn.source.sync.js}

@@ -1,5 +1,6 @@
 const Ec = require("../epic");
 const child = require('child_process');
+const Ut = require("../commander-shared");
 
 const COMMANDS = [
     "run-default.sh",
@@ -88,29 +89,23 @@ const executeLocal = (actual = {}, options = {}) => {
     return pathEnv;
 }
 
-module.exports = () => {
+module.exports = (options) => {
 
     // 获取当前操作系统
     const platform = process.platform;
 
     // 根据操作系统设置不同的 options 对象
-    let options;
+    let optionsWait;
     if (platform === 'win32') {
         // Windows 系统，使用指定的命令解释器
         Ec.info(`您正在使用WINDOWS系统，请使用随git附带的bash运行此脚本！`.red.bgYellow);
-        options = {stdio: 'inherit', shell: 'bash.exe'};
+        optionsWait = {stdio: 'inherit', shell: 'bash.exe'};
     } else {
         // 非 Windows 系统，不需要额外的 options
-        options = {stdio: 'inherit'};
+        optionsWait = {stdio: 'inherit'};
     }
 
-    const actual = Ec.executeInput(
-        [],
-        [
-            ['-p', '--path', '.zero'],
-            ['-m', '--module', false]       // 是否本地模式
-        ]
-    );
+    const parsed = Ut.parseArgument(options);
     // 1. 环境检查
     if (!Ec.isExist(".git")) {
         Ec.error("请选择带`.git`或`vertx-ui`的目录执行当前命令！");
@@ -118,12 +113,12 @@ module.exports = () => {
     }
 
     let pathSource;
-    if (actual.module) {
+    if (parsed.mode) {
         // 本地模式
-        pathSource = executeLocal(actual, options);
+        pathSource = executeLocal(parsed, optionsWait);
     } else {
         // 远程模式
-        pathSource = executeRemote(actual, options);
+        pathSource = executeRemote(parsed, optionsWait);
     }
     if (pathSource) {
         // 5. 拷贝 Ignore 文件全部指令
@@ -135,14 +130,14 @@ module.exports = () => {
                 // 目录拷贝
                 if (!Ec.isExist(command)) {
                     const cmdDir = `mkdir -p ${command}`;
-                    child.execSync(cmdDir, options);
+                    child.execSync(cmdDir, optionsWait);
                 }
                 cmd = `cp -rf ${pathSource}/${command}* ./${command}`;
-                child.execSync(cmd, options);
+                child.execSync(cmd, optionsWait);
             } else {
                 // 文件拷贝
                 cmd = `cp -rf ${pathSource}/${command} ./${command}`;
-                child.execSync(cmd, options);
+                child.execSync(cmd, optionsWait);
             }
         })
         Ec.info(`主框架更新完成：${pathSource}！`.help);

package/src/commander-ai/index.js

@@ -1,22 +1,22 @@
-const executeUuid = require('./fn.uuid');
-const executeCsv = require('./fn.csv');
-const executeUk = require('./fn.uk');
-const executeKey = require('./fn.key');
-const executeData = require('./fn.data');
-const executeInit = require('./fn.init');
-const executeString = require('./fn.random');
-const executeMD5 = require('./fn.md5');
-const executeSync = require('./fn.sync');
+const executeUuid = require('./fn.random.uuid');
+const executeString = require('./fn.random.string');
+const executeMD5 = require('./fn.random.md5');
+const executeFrontendSync = require('./fn.source.sync');
+const executeApp = require('./fn.source.app');
+const executeMod = require('./fn.source.mod');
+const executeHelp = require('./fn.help.metadata');
+const executeWeb = require('./fn.source.front');
+const executeSpring = require('./fn.source.spring');
 const exported = {
-    executeUuid,        // ai uuid
-    executeCsv,         // ai csv
-    executeUk,          // ai uk
-    executeKey,         // ai key
-    executeData,        // ai data
-    executeInit,        // ai init
-    executeString,      // ai str
-    executeMD5,         // ai md5
-    executeSync,        // ai sync
+    executeUuid,                // ai uuid
+    executeString,              // ai str
+    executeMD5,                 // ai md5
+    executeFrontendSync,        // ai sync
+    executeApp,                 // ai app
+    executeMod,                 // ai mod
+    executeHelp,                // ai help
+    executeWeb,                 // ai web
+    executeSpring,              // ai spring
 };
 module.exports = exported;
 /**
@@ -37,14 +37,11 @@ module.exports = exported;
  * |命令执行|含义|
  * |---|:---|
  * |ai uuid|(M) 随机生成一定数量的UUID字符串|
- * |ai csv|读取数据文件中的Array数组数据，然后转换成csv的文件格式输出。|
- * |ai uk|检查数据文件中的 Data 数据是否符合唯一性约束，可直接针对批量数据执行唯一性检查。|
- * |ai data|专用数据生成器，可根据您的输入生成两个格式的Json数据：`Object/Array`。|
- * |ai key|为输入数据中的Array或Object追加`UUID`格式的字段，字段可配置，默认为`field = key`属性。|
  * |ai str|(M) 生成随机字符串。
  * |ai md5|(M) 针对输入字符串进行符合 Zero 规范的 MD5 加密处理。|
- * |ai init|「工程命令」Zero前端工程初始化专用命令。|
  * |ai sync|「工程命令」Zero前端工程框架同步专用命令（更新Zero Ui框架专用）。|
+ * |ai app| 应用工程初始化。|
+ * |ai mod| 扩展模块初始化（Domain/Provider/Api）。|
  *
  * ### 3. 数据通用格式
  *