cloud-web-corejs 1.1.0-dev.6 → 1.1.0-dev.60

package/templates/child-app/.env

@@ -0,0 +1,3 @@
+VUE_APP_BASE_API=/api
+# Put API_TARGET=https://your-gateway.example in .env.development.local.
+# /api is stripped before proxying. Production must configure the same gateway path.

package/templates/child-app/README.md

@@ -0,0 +1,49 @@
+# cloud-web-corejs 子应用
+
+本模板复用完整 Core 启动入口；不是独立组件库演示。技术栈为 Vue 2.6.12、Vue CLI 5、Vue Router 3、Vuex 3。使用 Node 20+；首次安装后提交 package-lock.json。
+
+## 启动
+
+1. 检查 `app.config.js`：appCode 与主应用注册表一致，package.json 的 name 在各应用之间保持唯一。
+2. 在 `.env.development.local` 配置 `API_TARGET=https://实际后端网关`。默认 API 路径 `/api` 经开发代理剥除；按后端实际前缀调整 `src/prefixConfig.js`。
+3. `npm install`，然后 `npm run dev`。
+4. 打开 `http://localhost:17527/<appCode>/#/login`。默认登录组件需要真实后端登录配置、账号和权限；本模板没有假登录。
+5. `npm run build:prod` 生成 `dist`，部署到 `/<appCode>/`。部署网关需提供 `/api` 转发，或构建时配置绝对 `VUE_APP_BASE_API`。
+
+不要同时运行占用 17527 的另一个子应用。模板不依赖 DLL，无需复制 std 的 DLL、呼叫中心或业务 public 目录。
+
+## 示例与菜单
+
+`src/views/demo/list.vue` 是内存列表，支持筛选、新增和编辑。`detail.vue` 是本地弹框编辑器；没有实现远程业务保存，刷新即恢复初始数据。它不是跨应用详情回调协议的完整示例。
+
+主应用逻辑参数 `micro_app_registry` 条目（替换 childapp）：
+
+```json
+[{ "appCode": "childapp", "appName": "业务子应用", "entry": "//child.example/childapp/", "enabled": true }]
+```
+
+为有权限的账号配置普通页面菜单，访问路径使用 `/micro/childapp/demo/list`，组件来源为子应用 `src/views/demo/list.vue`。包内页面使用 `/micro/childapp/base/user/user/list`。保留实际系统的菜单 ID、父节点、普通菜单类型和权限字段；此处不是可直接提交的完整菜单 API 请求。只有表单菜单使用 `type === 5`。
+
+联调需测试环境逻辑参数 `micro_debug_enabled=true`；访问主应用 `#/micro_debug/childapp/demo/list`，加载 `http://localhost:17527/`。注册表仍需包含该 appCode。
+
+## 文件与资源
+
+可选资源由 `core-resources.config.js` 声明，默认全部关闭。支持 Ace basic/full、TinyMCE full、Luckysheet full、Activiti full；安装独立资源制品并填写精确版本后启用。dev/build 自动准备、生产构建后自动校验。Activiti 仅支持主应用或非 qiankun 的同源页面，不支持 qiankun 菜单。详情见包内 `docs/child-app/` 的对应实施说明。
+
+- `src/settings.js`、`prefixConfig.js`、`corejsConfig.js`、`router/modules/customer.js` 是包需要的应用扩展点。
+- `src/layout/index.vue` 和 `src/views/user/login/index.vue` 转接包的默认布局、登录页。
+- `src/assets` 与 `src/resources` 内少量图片是从 kCode 复用的默认品牌/错误页资源；包的动态视图上下文编译仍会引用它们。即使自定义首页，也不能随意删掉这些文件。上线前替换为本应用品牌。
+- `src/icons` 存应用图标；Core 图标由包入口注册。
+- Ace、TinyMCE、Luckysheet、Activiti、打印平台 SDK 等可选功能需要额外静态资源与部署配置，详见包内 `docs/child-app/README.md`。它们不在本模板中。
+
+完整接入契约与生成提示词见 `node_modules/cloud-web-corejs/docs/child-app/`。
+
+## 验收
+
+- 干净安装、生产构建成功。
+- 独立打开登录页；接真实后端后登录并进入已授权菜单。
+- 主应用挂载、菜单切换保活、刷新、登出卸载、重新挂载。
+- API 请求目标与 token 正确，异步 chunk 无 404，Core/应用图标和样式可见。
+- 示例筛选和编辑正常；业务接口、上传及工作流按启用功能另行联调。
+
+没有真实后端/宿主时，只能确认构建和浏览器启动；不能据此声明生产接入已验收。

package/templates/child-app/app.config.js

@@ -0,0 +1,6 @@
+// appCode must match the host registry. Keep package.json#name unique too.
+module.exports = {
+  appCode: "childapp",
+  title: "业务子应用",
+  mainWebPrefix: "/sys"
+};

package/templates/child-app/babel.config.js

@@ -0,0 +1 @@
+module.exports = { presets: ["@vue/cli-plugin-babel/preset"] };

package/templates/child-app/core-resources.config.js

@@ -0,0 +1,15 @@
+module.exports = {
+  schemaVersion: 1,
+  features: {
+    // Install the independent resource artifact before enabling:
+    // codeEditor: { package: "cloud-web-corejs-resources-ace", version: "1.11.0-core.0", profile: "basic" },
+    codeEditor: false,
+    // richText: { package: "cloud-web-corejs-resources-tinymce", version: "4.9.2-core.0", profile: "full" },
+    richText: false,
+    // spreadsheet: { package: "cloud-web-corejs-resources-luckysheet", version: "2.1.13-core.1", profile: "full" },
+    spreadsheet: false,
+    // Main application or non-qiankun same-origin page only; qiankun is rejected.
+    // workflowDesigner: { package: "cloud-web-corejs-resources-activiti", version: "5.17.0-core.1", profile: "full" },
+    workflowDesigner: false
+  }
+};

package/templates/child-app/gitignore

@@ -0,0 +1,7 @@
+node_modules/
+.core-resources/
+dist/
+*.local
+*.log
+.DS_Store
+# Commit package-lock.json after the first install.

package/templates/child-app/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "corejs-child-starter",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "resources:prepare": "node node_modules/cloud-web-corejs/bin/core-resources.js prepare",
+    "resources:check": "node node_modules/cloud-web-corejs/bin/core-resources.js check",
+    "predev": "npm run resources:prepare",
+    "prebuild:prod": "npm run resources:prepare",
+    "postbuild:prod": "node node_modules/cloud-web-corejs/bin/core-resources.js check-dist",
+    "dev": "node --max-old-space-size=8192 node_modules/@vue/cli-service/bin/vue-cli-service.js serve",
+    "dev:micro": "npm run dev -- --port 17527",
+    "build:prod": "node --max-old-space-size=8192 node_modules/@vue/cli-service/bin/vue-cli-service.js build"
+  },
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "cloud-web-corejs": "1.1.0-dev.27",
+    "vue": "2.6.12",
+    "vue-router": "3.0.2",
+    "vuex": "3.1.0",
+    "element-ui": "2.15.14"
+  },
+  "devDependencies": {
+    "@vue/cli-service": "5.0.9",
+    "@vue/cli-plugin-babel": "5.0.9",
+    "@babel/core": "^7.12.16",
+    "vue-template-compiler": "2.6.12",
+    "sass": "1.77.8",
+    "sass-loader": "12.6.0",
+    "svg-sprite-loader": "6.0.11",
+    "node-polyfill-webpack-plugin": "4.0.0"
+  },
+  "browserslist": ["> 1%", "last 2 versions", "not dead"]
+}

package/templates/child-app/public/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title><%= htmlWebpackPlugin.options.title %></title>
+  </head>
+  <body>
+    <noscript>请启用 JavaScript。</noscript>
+    <div id="app"></div>
+  </body>
+</html>

package/templates/child-app/src/corejsConfig.js

@@ -0,0 +1,2 @@
+// Optional extensions; see docs/child-app/README.md in cloud-web-corejs.
+module.exports = {};

package/templates/child-app/src/icons/index.js

@@ -0,0 +1,2 @@
+const icons = require.context("./svg", false, /\.svg$/);
+icons.keys().forEach(icons);

package/templates/child-app/src/icons/svg/child-demo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 3h18v18H3zm2 2v4h14V5zm0 6v3h14v-3zm0 5v3h14v-3z"/></svg>

package/templates/child-app/src/layout/index.vue

@@ -0,0 +1,4 @@
+<script>
+import Layout from "@base/layout/defaultLayout.vue";
+export default Layout;
+</script>

package/templates/child-app/src/main.js

@@ -0,0 +1,5 @@
+// Core loads public-path before initialization, and exports all qiankun lifecycles.
+import "@base/index.next.js";
+import "./icons";
+import "./styles/app.scss";
+export * from "@base/index.next.js";

package/templates/child-app/src/prefixConfig.js

@@ -0,0 +1,13 @@
+const identity = require("../app.config");
+module.exports = {
+  MAIN_WEB_PREFIX: identity.mainWebPrefix,
+  WEB_PREFIX: "/" + identity.appCode,
+  USER_PREFIX: "/user", AGILEBPM_PREFIX: "/agilebpm",
+  MESSAGE_PREFIX: "/sf-cloud-message", BASE_FILEURL: "/user/common/fileurl",
+  BASIC_PREFIX: "/basic", CBASICS_PREFIX: "/cbasics",
+  YX_PREFIX: "/yx", TWS_PREFIX: "/tws", HWYX_PREFIX: "/hwyx",
+  FW_PREFIX: "/fw", HUB_PREFIX: "/hub", PMD_PREFIX: "/pmd",
+  SUPPORT_PREFIX: "/support", FINANCE_PREFIX: "/finance",
+  PCP_PREFIX: "/pcp", FSC_PREFIX: "/fsc", EC_PREFIX: "/ec",
+  BD_PREFIX: "/xbd", MMLG_PREFIX: "/mmlg"
+};

package/templates/child-app/src/resources/css/login.scss

@@ -0,0 +1,29 @@
+// Application-owned branding required by Core's default login view.
+.login-container {
+  min-height: 100vh;
+  background: url("~@/resources/images/bg-login5.jpg") center / cover no-repeat;
+}
+.login-main {
+  position: absolute;
+  right: 8%;
+  top: 50%;
+  transform: translateY(-50%);
+  width: 464px;
+  max-width: 90vw;
+  background: white;
+  border-radius: 8px;
+  box-shadow: 0 3px 22px #0002;
+  .box-form { padding: 32px; }
+  .txt { position: relative; }
+  .svg-container { display: none; }
+  .show-pwd { position: absolute; right: 12px; top: 0; cursor: pointer; }
+  .btn { width: 100%; margin-top: 20px; }
+}
+.copyright {
+  position: fixed;
+  bottom: 0;
+  width: 100%;
+  padding: 12px;
+  text-align: center;
+  color: #666;
+}

package/templates/child-app/src/router/modules/customer.js

@@ -0,0 +1,3 @@
+// Business routes come from authorized backend menus.
+// /demo/list is a private component path, not a public authentication bypass.
+export const constantRoutes = [];

package/templates/child-app/src/settings.js

@@ -0,0 +1,24 @@
+const identity = require("../app.config");
+module.exports = {
+  title: identity.title,
+  appCode: identity.appCode,
+  microMainEnabled: false,
+  i18nEnabled: true,
+  accessLogEnabled: false,
+  wfModel: 1,
+  defalutPrevMinX: 200,
+  defalutNextMinX: 550,
+  defalutPrevMinY: 180,
+  defalutNextMinY: 70,
+  defaultHomePage: "/demo/list.vue",
+  privateProfileCode: "private_profile",
+  uploadFileSize: 200,
+  base64Urls: [
+    "/user/common_script/save", "/user/common_script/update",
+    "/user/api_request/save", "/user/api_request/update",
+    "/user/export_template/save", "/user/export_template/update",
+    "/user/notify_template/save", "/user/notify_template/update",
+    "/user/push_setting/save", "/user/push_setting/update",
+    "/user/wf_diy_attribute/save", "/user/wf_diy_attribute/update"
+  ]
+};

package/templates/child-app/src/styles/app.scss

@@ -0,0 +1,2 @@
+.child-demo { padding: 24px; }
+.child-demo__toolbar { display: flex; gap: 12px; margin-bottom: 16px; }

package/templates/child-app/src/views/demo/detail.vue

@@ -0,0 +1,19 @@
+<template>
+  <el-form ref="form" :model="form" label-width="80px" @submit.native.prevent>
+    <el-form-item label="名称" prop="name" :rules="[{ required: true, whitespace: true, message: '请输入名称', trigger: 'blur' }]">
+      <el-input v-model="form.name" />
+    </el-form-item>
+    <el-form-item>
+      <el-button type="primary" @click="save">保存</el-button>
+      <el-button @click="$emit('close')">取消</el-button>
+    </el-form-item>
+  </el-form>
+</template>
+<script>
+export default {
+  name: "ChildDemoDetail",
+  props: { record: { type: Object, default: () => ({ name: "" }) } },
+  data() { return { form: { ...this.record } }; },
+  methods: { save() { this.$refs.form.validate(valid => { if (valid) this.$emit("save", { ...this.form }); }); } }
+};
+</script>

package/templates/child-app/src/views/demo/list.vue

@@ -0,0 +1,38 @@
+<template>
+  <section class="child-demo">
+    <h2><svg-icon icon-class="child-demo" /> 子应用示例</h2>
+    <el-alert title="本页使用内存数据，刷新后恢复；未接入业务后端。" type="info" :closable="false" />
+    <div class="child-demo__toolbar">
+      <el-input v-model="query" placeholder="按名称筛选" clearable />
+      <el-button type="primary" @click="edit(null)">新增</el-button>
+    </div>
+    <el-table :data="filteredRows" row-key="id" border>
+      <el-table-column prop="id" label="编号" />
+      <el-table-column prop="name" label="名称" />
+      <el-table-column label="操作">
+        <template slot-scope="scope"><el-button type="text" @click="edit(scope.row)">编辑</el-button></template>
+      </el-table-column>
+    </el-table>
+    <el-dialog title="编辑示例" :visible.sync="visible" append-to-body destroy-on-close>
+      <detail v-if="visible" :record="selected" @save="save" @close="visible = false" />
+    </el-dialog>
+  </section>
+</template>
+<script>
+import Detail from "./detail.vue";
+export default {
+  name: "ChildDemoList",
+  components: { Detail },
+  data: () => ({ query: "", rows: [{ id: 1, name: "示例记录" }], selected: null, visible: false, nextId: 2 }),
+  computed: { filteredRows() { return this.rows.filter(row => row.name.includes(this.query)); } },
+  methods: {
+    edit(row) { this.selected = row ? { ...row } : { name: "" }; this.visible = true; },
+    save(record) {
+      const index = this.rows.findIndex(row => row.id === record.id);
+      if (index < 0) this.rows.push({ ...record, id: this.nextId++ });
+      else this.$set(this.rows, index, { ...record });
+      this.visible = false;
+    }
+  }
+};
+</script>

package/templates/child-app/src/views/user/login/index.vue

@@ -0,0 +1,18 @@
+<script>
+import Login from "@base/views/user/login/default.vue";
+export default {
+  extends: Login,
+  methods: {
+    // Core's normal-login initializer redirects production children to MAIN_WEB_PREFIX.
+    // This standalone-capable template keeps the form here; authentication, SSO,
+    // validation and token handling still come from Core's Login component.
+    login() {
+      window.removeEventListener("keydown", this.keyDown, false);
+      window.addEventListener("keydown", this.keyDown, false);
+      this.changeBackground();
+      this.initPassword();
+      this.showView = true;
+    }
+  }
+};
+</script>

package/templates/child-app/vue.config.js

@@ -0,0 +1,107 @@
+const path = require("path");
+const NodePolyfillPlugin = require("node-polyfill-webpack-plugin");
+const { ResourcesPlugin } = require("cloud-web-corejs/resource-tools");
+const identity = require("./app.config");
+const packageName = require("./package.json").name;
+const coreSrc = path.dirname(require.resolve("cloud-web-corejs/src/index.next.js"));
+const appSrc = path.resolve(__dirname, "src");
+const coreIcons = path.join(coreSrc, "icons");
+const appIcons = path.join(appSrc, "icons");
+const base = "/" + identity.appCode;
+
+module.exports = {
+  publicPath: base + "/",
+  runtimeCompiler: true,
+  productionSourceMap: false,
+  transpileDependencies: ["cloud-web-corejs"],
+  devServer: {
+    port: 17527,
+    headers: { "Access-Control-Allow-Origin": "*" },
+    proxy: process.env.API_TARGET ? {
+      "/api": { target: process.env.API_TARGET, changeOrigin: true, pathRewrite: { "^/api": "" } }
+    } : {},
+    setupMiddlewares(middlewares) {
+      middlewares.unshift({
+        name: "child-root-alias",
+        middleware(req, res, next) {
+          const url = req.url || "/";
+          const pathname = url.split("?")[0];
+          const bypass = [base, "/api", "/ws", "/sockjs-node", "/webpack-dev-server", "/__webpack_dev_server__"];
+          if (!bypass.some(p => pathname === p || pathname.startsWith(p + "/"))) {
+            req.url = base + (url.startsWith("/") ? url : "/" + url);
+          }
+          next();
+        }
+      });
+      return middlewares;
+    }
+  },
+  configureWebpack: {
+    // Core's development view context is synchronous. Keep source maps external
+    // so the browser does not download/parse a ~100 MB inline-map vendor script.
+    devtool: process.env.NODE_ENV === "development" ? "cheap-module-source-map" : false,
+    resolve: {
+      alias: {
+        "@": appSrc,
+        "@base": coreSrc,
+        // The app and the source package must use the same Vue constructor.
+        "vue$": require.resolve("vue/dist/vue.esm.js")
+      }
+    },
+    output: {
+      library: `${packageName}-[name]`,
+      libraryTarget: "umd",
+      chunkLoadingGlobal: `webpackJsonp_${packageName}`
+    },
+    plugins: [new NodePolyfillPlugin(), new ResourcesPlugin(__dirname)]
+  },
+  chainWebpack(config) {
+    config.plugin("html").tap(args => {
+      Object.assign(args[0], { title: identity.title, inject: "body", scriptLoading: "blocking" });
+      return args;
+    });
+    config.plugin("define").tap(args => {
+      const raw = JSON.stringify(process.env.VUE_APP_BASE_API || "");
+      args[0]["process.env"].VUE_APP_BASE_API =
+        `(window.__resolveApiBase__ ? window.__resolveApiBase__(${raw}) : ${raw})`;
+      return args;
+    });
+    config.plugins.delete("prefetch");
+    config.plugins.delete("preload");
+    // Core exposes many lazy pages. Parallel minimizers duplicate their large module
+    // graph in worker processes and can exhaust an 8 GB CI/container build host.
+    if (process.env.NODE_ENV === "production") {
+      config.optimization.minimizer("terser").tap(args => {
+        args[0].parallel = false;
+        return args;
+      });
+      config.optimization.minimizer("css").tap(args => {
+        args[0].parallel = false;
+        return args;
+      });
+      // Vue 2's loader imports a default from every SFC style block.
+      // Match that contract instead of emitting empty ES modules after extraction.
+      ["css", "postcss", "scss", "sass", "less", "stylus"].forEach(type => {
+        config.module.rule(type).oneOfs.store.forEach(rule => {
+          if (rule.uses.has("extract-css-loader")) {
+            rule.use("extract-css-loader").tap(options => ({ ...options, esModule: false }));
+          }
+        });
+      });
+    }
+    // Preserve Core's :export { theme/menuBg/... } SCSS-to-JS values without
+    // renaming global classes. SFC module/scoped styles keep their own rules.
+    config.module.rule("scss").oneOf("normal").use("css-loader")
+      .tap(options => ({ ...options, modules: { mode: "icss" } }));
+    config.module.rule("svg").exclude.add(coreIcons).add(appIcons);
+    config.module.rule("icons").test(/\.svg$/)
+      .include.add(coreIcons).add(appIcons).end()
+      .use("svg-sprite-loader").loader("svg-sprite-loader")
+      .options({ symbolId: "icon-[name]" });
+  },
+  css: {
+    loaderOptions: {
+      sass: { additionalData: '@import "~@base/styles/theme-variables.scss";' }
+    }
+  }
+};