create-lumfall 1.0.0 → 1.0.1

package/templates/document/docs/dsl/overview.md

@@ -1,116 +0,0 @@
-# DSL 总览
-
-Lumfall 对 B 端管理台的核心设计是一套**声明式 DSL**：菜单结构、页面形态、
-列表页的搜索栏 / 表格 / 表单 / 详情，全部由 `model/` 目录下的配置文件描述，
-启动时自动扫描合并，前端 Dashboard 页面按配置渲染——**写配置，而不是写页面**。
-
-- 完整规则源文件：框架包内 `model/docs/dsl-guide.md`（编写规则）与
-  `model/docs/dashboard-model.md`（字段速查），本章节是其使用视角的展开
-- 参考实现：同工作区 `lumfall-business/`（两个 Model、多个 Project 的完整示例）
-
-## 两层 DSL：Model 与 Project
-
-```text
-Model（模型）    一个业务域的公共默认配置（菜单骨架），可被多个 Project 继承
-Project（项目）  一个具体项目的差异化配置，与所属 Model 深度合并
-```
-
-- DSL 以 CommonJS 模块存放在业务项目根目录 `model/` 下，**新增文件即生效，无需注册**
-- `key` / `modelKey` 由扫描器按目录名 / 文件名自动注入，不要手写
-- 合并规则：同 `key` 深度合并（Project 覆盖 Model），新 `key` 追加到末尾，
-  详见 [Model 与 Project](./model-project.md)
-
-```text
-model/
-├── index.js                  # 扫描器 + 合并引擎（框架自带，不要动）
-├── business/                 # ← Model：电商系统
-│   ├── model.js              #    公共默认配置
-│   └── project/
-│       ├── taobao.js         #    项目：淘宝
-│       └── jd.js             #    项目：京东
-└── course/                   # ← Model：课程系统
-    ├── model.js
-    └── project/
-        └── bilibili.js
-```
-
-## 四种页面形态
-
-页面渲染方式由菜单项的 `moduleType` 决定（详见[菜单项 DSL](./menu.md)）：
-
-| `moduleType` | 形态 | 说明 |
-| --- | --- | --- |
-| `schema` | 列表工作台 | **主要形态**：一份字段 schema 驱动搜索栏 + 表格 + 动态表单/详情抽屉，见 [schema 模块 DSL](./schema.md) |
-| `custom` | 自定义页 | 跳转到业务自己注册的前端路由 |
-| `sider` | 侧边复合视图 | 左侧二级菜单 + 右侧子页面 |
-| `iframe` | 嵌入页 | 内嵌外部 URL 或内部页面 |
-
-## 一个最小例子
-
-```js
-// model/business/model.js —— 公共默认
-module.exports = {
-  model: "dashboard",
-  name: "电商系统",
-  menu: [
-    {
-      key: "product",
-      name: "商品管理",
-      menuType: "module",
-      moduleType: "schema",
-      schemaConfig: {
-        api: "/api/project/product",   // 接口基址，见「接口契约」
-        schema: {
-          type: "object",
-          properties: {
-            productName: {
-              type: "string",
-              label: "商品名称",
-              tableOption: { width: 200 },                  // 进表格列
-              searchOption: { componentType: "input" },     // 进搜索栏
-              createFormOption: { componentType: "input" }, // 进新增表单
-            },
-            status: {
-              type: "string",
-              label: "上架状态",
-              tableOption: {
-                enumList: [
-                  { label: "上架", value: "1" },
-                  { label: "下架", value: "0" },
-                ],
-              },
-            },
-          },
-          required: ["productName"],
-        },
-      },
-    },
-  ],
-};
-```
-
-```js
-// model/business/project/taobao.js —— 只写差异
-module.exports = {
-  name: "淘宝",
-  desc: "淘宝电商项目",
-  homePage: "/schema?projectKey=taobao&key=product",
-  menu: [
-    // 只覆盖名称，其余（schemaConfig 等）全部继承 Model
-    { key: "product", name: "商品管理(淘宝)" },
-  ],
-};
-```
-
-重启服务后，`/view/dashboard?projectKey=taobao` 就是一个可用的商品管理页：
-搜索、分页、枚举标签、新增/编辑/详情抽屉全部由这份配置驱动。
-
-## 章节导航
-
-- [Model 与 Project](./model-project.md)：字段定义与合并规则
-- [菜单项 DSL](./menu.md)：menuType / moduleType / 分组 / 路由参数
-- [schema 模块](./schema.md)：字段 schema、表格列、搜索项
-- [按钮与动态表单](./schema-actions.md)：tableConfig、增删改查抽屉
-- [接口契约](./api-contract.md)：schema 模块的后端接口标准
-- [扩展 DSL](./extend.md)：业务侧自定义搜索 / 表单控件与动态组件
-- [完整模板与注意事项](./reference.md)：全量配置模板 + 20 条避坑清单

package/templates/document/docs/dsl/reference.md

@@ -1,175 +0,0 @@
-# 完整模板与注意事项
-
-## 全量配置模板
-
-包含所有菜单类型的项目级模板，可直接复制修改：
-
-```js
-module.exports = {
-  name: "示例项目",
-  desc: "展示所有菜单类型的示例",
-  homePage: "/schema?projectKey=demo&key=product",
-
-  menu: [
-    // ─── 1. custom 模块（自定义路由页面）───
-    {
-      key: "home",
-      name: "首页",
-      menuType: "module",
-      moduleType: "custom",
-      customConfig: { path: "/todo" },
-    },
-
-    // ─── 2. iframe 模块（嵌入外部页面）───
-    {
-      key: "external",
-      name: "外部链接",
-      menuType: "module",
-      moduleType: "iframe",
-      iframeConfig: { path: "https://example.com" },
-    },
-
-    // ─── 3. sider 模块（侧边栏复合视图）───
-    {
-      key: "management",
-      name: "管理",
-      menuType: "module",
-      moduleType: "sider",
-      siderConfig: {
-        menu: [
-          { key: "settings", name: "设置", menuType: "module", moduleType: "custom",
-            customConfig: { path: "/todo" } },
-          { key: "stats", name: "统计", menuType: "module", moduleType: "iframe",
-            iframeConfig: { path: "https://stats.example.com" } },
-        ],
-      },
-    },
-
-    // ─── 4. schema 模块（搜索栏 + 表格 + 动态表单）───
-    {
-      key: "product",
-      name: "商品管理",
-      menuType: "module",
-      moduleType: "schema",
-      schemaConfig: {
-        api: "/api/project/product",
-        schema: {
-          type: "object",
-          properties: {
-            productId: {
-              type: "string",
-              label: "商品ID",
-              tableOption: { width: 300, ellipsis: true, tooltip: true },
-              editFormOption: { componentType: "input", disabled: true },
-            },
-            productName: {
-              type: "string",
-              label: "商品名称",
-              minLength: 3,
-              maxLength: 10,
-              tableOption: { width: 200 },
-              searchOption: { componentType: "input", default: "",
-                placeholder: "请输入商品名称", allowClear: true },
-              createFormOption: { componentType: "input" },
-              editFormOption: { componentType: "input" },
-              detailPanelOption: {},
-            },
-            status: {
-              type: "string",
-              label: "上架状态",
-              tableOption: { width: 200, enumList: [
-                { label: "上架", value: "1" },
-                { label: "下架", value: "0" },
-              ] },
-              searchOption: { componentType: "select", default: "", enumList: [
-                { label: "上架", value: "1" },
-                { label: "下架", value: "0" },
-              ] },
-              detailPanelOption: {},
-            },
-            createTime: {
-              type: "string",
-              label: "创建时间",
-              tableOption: { width: 180 },
-              searchOption: { componentType: "dateRange", default: [],
-                showTime: true, valueFormat: "YYYY-MM-DD HH:mm:ss" },
-              detailPanelOption: {},
-            },
-          },
-          required: ["productName"],
-        },
-        tableConfig: {
-          headerButtons: [
-            { label: "新增商品", eventKey: "showComponent", type: "outline",
-              eventOption: { comName: "createForm" } },
-          ],
-          rowButtons: [
-            { label: "查看", eventKey: "showComponent", type: "primary",
-              eventOption: { comName: "detailPanel" } },
-            { label: "修改", eventKey: "showComponent", type: "warning",
-              eventOption: { comName: "editForm" } },
-            { label: "删除", eventKey: "delete", type: "danger",
-              eventOption: { params: { productId: "schema::productId" } } },
-          ],
-          componentConfig: {
-            createForm: { title: "新增商品", saveBtnText: "新增商品" },
-            editForm: { mainKey: "productId", title: "修改商品", saveBtnText: "修改商品" },
-            detailPanel: { mainKey: "productId", title: "商品详情" },
-          },
-        },
-      },
-    },
-
-    // ─── 5. group 分组（下拉子菜单）───
-    {
-      key: "system",
-      name: "系统管理",
-      menuType: "group",
-      subMenu: [
-        { key: "users", name: "用户管理", menuType: "module", moduleType: "custom",
-          customConfig: { path: "/todo" } },
-        { key: "roles", name: "角色管理", menuType: "module", moduleType: "custom",
-          customConfig: { path: "/todo" } },
-      ],
-    },
-
-    // ─── 6. 仅覆盖（从 Model 继承其余属性，只改 name）───
-    { key: "report", name: "报表(自定义名称)" },
-  ],
-};
-```
-
-## 注意事项（避坑清单）
-
-| # | 注意点 | 说明 |
-| --- | --- | --- |
-| 1 | **`key` 必填且同级唯一** | 菜单项合并、前端查找全部依赖 `key`，缺失会导致合并不生效、菜单点击无响应 |
-| 2 | **`homePage` 格式** | 写页面内路由 `/path?projectKey=xxx&key=xxx`（不带 `/view/dashboard` 前缀），`projectKey` 必须与文件名一致 |
-| 3 | **覆盖只需写 `key` + 差异字段** | `{ key: "product", name: "商品管理(pdd)" }` 即可覆盖名称，其余从 Model 继承 |
-| 4 | **不要手写 `key` / `modelKey`** | 扫描器自动注入，手动写无意义 |
-| 5 | **sider 子菜单支持任意 moduleType** | 也支持嵌套 group（层级不宜过深） |
-| 6 | **group 的 `subMenu` 子项必须写 `menuType: "module"`** | 否则前端无法正确渲染子菜单项 |
-| 7 | **iframe 的 `path` 可以是完整 URL 或页面内路径** | 原样作为 `<iframe src>`；未配置时显示空态 |
-| 8 | **新增 Model / Project 无需改代码** | 按目录约定放文件，重启即自动加载 |
-| 9 | **注意 `menuType` 拼写** | 拼写错误会导致菜单项无法识别为 module / group |
-| 10 | **sider 子菜单项的 `key` 同级唯一** | 路由 query 参数是 `siderKey`，但 key 匹配逻辑不变 |
-| 11 | **覆盖形态时带全对应 config** | 改 `moduleType` 为 `iframe` / `schema` 时必须同时提供 `iframeConfig` / `schemaConfig` |
-| 12 | **不配 `tableOption` / `searchOption` 就不显示** | 表格列与搜索栏互相独立，由各自 Option 的存在与否决定 |
-| 13 | **`api` 是基址，不是列表地址** | 前端自动请求 `GET <api>/list`，见[接口契约](./api-contract.md) |
-| 14 | **router-schema 的 path 必须与路由完全一致** | 不一致时校验**静默不生效**（不报错） |
-| 15 | **`dateRange` 搜索值拆为 `_start` / `_end`** | 固定 `YYYY-MM-DD HH:mm:ss`；未选值不下发；组件忽略 `default`，URL 预填对它无效 |
-| 16 | **sider 子项 custom 的 `path` 必须以 `/` 开头** | 否则拼出 `/sidertaobao/...` 之类的非法路由，无法跳转 |
-| 17 | **`componentConfig` 必须放在 `tableConfig` 下** | 写在 `schemaConfig` 顶层不生效 |
-| 18 | **`showComponent` 用 `eventOption.comName`** | 字段名是 `comName`（不是 `componentName`） |
-| 19 | **表单 `componentType` 当前仅支持 `input` / `inputNumber` / `select`** | `dynamicSelect` / `dateRange` 未在表单侧注册；`select` 未配 `default` 会回退第一个枚举值 |
-| 20 | **必填校验用顶层 `schema.required` 数组** | 自动注入对应 option 的 `required`（红星 + 校验），不要在每个 option 里手写 |
-
-## 字段速查卡
-
-完整的字段级结构速查（含每个子字段的语义）见框架包内
-`model/docs/dashboard-model.md`；本文档各页的表格已覆盖日常使用的全部字段。
-
-## 下一步
-
-- [Dashboard 与 Model 配置](../advanced/dashboard.md)：Dashboard 页面如何消费这份配置
-- [常见错误自查](../reference/faq.md)：启动与运行问题排查

package/templates/document/docs/dsl/schema-actions.md

@@ -1,135 +0,0 @@
-# 按钮与动态表单
-
-schema 模块的增删改查交互由两部分 DSL 驱动：`tableConfig` 里的**按钮**
-（表头按钮 / 行按钮）和**动态组件注册**（`componentConfig`）。
-动态组件以抽屉（`a-drawer`，宽 550）呈现，覆盖新增、编辑、详情三种形态。
-
-## 按钮配置
-
-按钮放在 `schemaConfig.tableConfig` 下，每项透传给 `<a-button>`：
-
-```js
-tableConfig: {
-  // 表头按钮：渲染在表格上方右侧，type 直接映射 a-button 的 type
-  headerButtons: [
-    { label: "新增商品", eventKey: "showComponent", type: "outline",
-      eventOption: { comName: "createForm" } },
-  ],
-  // 行按钮：渲染在最右侧固定的「操作」列（text 按钮，type 映射状态色）
-  rowButtons: [
-    { label: "查看", eventKey: "showComponent", type: "primary",
-      eventOption: { comName: "detailPanel" } },
-    { label: "修改", eventKey: "showComponent", type: "warning",
-      eventOption: { comName: "editForm" } },
-    { label: "删除", eventKey: "delete", type: "danger",
-      eventOption: { params: { productId: "schema::productId" } } },
-  ],
-}
-```
-
-操作列宽度自动估算（`30 + Σ(按钮字数 × 14 + 26)`），无需配置；
-未配置按钮时操作列不渲染。
-
-## eventKey：点击行为
-
-| `eventKey` | 内置行为 | `eventOption` |
-| --- | --- | --- |
-| `delete` | 确认框 → `DELETE <api>`（body 为参数对象）→ 成功后刷新表格 | `params`: 目前**只取第一组键值对**，取值语法 `"schema::<fieldKey>"` 表示从行数据取值 |
-| `showComponent` | 打开 `comName` 对应的动态组件抽屉 | `comName`: `createForm` / `editForm` / `detailPanel`（**字段名是 `comName`，不是 `componentName`**） |
-| 其他（如 `edit`） | 无内置行为，向上 emit `operate` 事件，可自行扩展 | — |
-
-::: warning componentConfig 必须放在 tableConfig 下
-框架读取的是 `schemaConfig.tableConfig.componentConfig`，
-写在 `schemaConfig` 顶层不生效。
-:::
-
-## componentConfig：动态组件注册
-
-key 固定为三个（前端组件注册表只有这三个，未注册的 key 不渲染）：
-
-```js
-tableConfig: {
-  componentConfig: {
-    createForm:  { title: "新增商品", saveBtnText: "新增商品" },
-    editForm:    { mainKey: "productId", title: "修改商品", saveBtnText: "修改商品" },
-    detailPanel: { mainKey: "productId", title: "商品详情" },
-  },
-}
-```
-
-| 组件 | 形态 | 数据流 | 必配 |
-| --- | --- | --- | --- |
-| `createForm` | 新增表单抽屉 | 直接打开，保存 `POST <api>` | 无 |
-| `editForm` | 编辑表单抽屉 | 先 `GET <api>?<mainKey>=<值>` 回显，保存 `PUT <api>`（body 带 `{ [mainKey]: 值 }`） | `mainKey` |
-| `detailPanel` | 详情抽屉（只读） | 先 `GET <api>?<mainKey>=<值>` 回显 | `mainKey` |
-
-- `title` 默认「创建」/「详情」，`saveBtnText` 默认「保存」
-- `mainKey` 是行数据主键字段名——**未配置时编辑 / 详情无法工作**
-- 表单字段由各字段的 `createFormOption` / `editFormOption` 决定（见下）
-- 保存 / 操作成功后组件 emit `command: loadTableData`，框架自动刷新表格
-
-## 动态表单与详情字段（xxxOption）
-
-字段配置了对应 Option 后进入同名动态组件的 schema：
-
-```js
-productName: {
-  type: "string",
-  label: "商品名称",
-  minLength: 3,                 // JSON-Schema 约束：表单 ajv 校验 + placeholder 提示
-  maxLength: 10,
-  createFormOption: {           // 新增表单项
-    componentType: "input",
-    default: "10086",
-  },
-  editFormOption: {             // 编辑表单项
-    componentType: "input",
-    disabled: true,             // 如主键字段编辑时禁用
-    // visible: false,          // 隐藏该项（v-show，字段仍随 getValue 提交）
-  },
-  detailPanelOption: {},        // 详情展示：配置即以「label: value」行展示该字段
-},
-```
-
-### 表单控件类型
-
-| `componentType` | arco 组件 | 说明 |
-| --- | --- | --- |
-| `input` | `a-input` | `placeholder` 等直接透传 |
-| `inputNumber` | `a-input-number` | 数值范围走 schema 的 `minimum` / `maximum` |
-| `select` | `a-select` | `enumList`: `[{label, value}]`，保存时按枚举值 ajv 校验 |
-
-> `dynamicSelect` / `dateRange` 尚未在表单侧注册；
-> `componentType` 未注册时该项不渲染。
-
-### 通用 option 字段
-
-- `required`：一般**不手写**——由顶层 `schema.required` 自动注入（红星 + 校验）
-- `visible: false`：隐藏表单项（`v-show`，字段仍随 `getValue()` 提交）
-- `disabled` / `default` / `placeholder`：透传给 arco 组件
-
-### 表单校验
-
-表单内置 ajv，每个表单项在 blur / 保存时按字段级 JSON-Schema
-（`type` / `minLength` / `maxLength` / `pattern` / `minimum` / `maximum` /
-`enum`）校验，错误文案显示在项下方；任一项失败则整个表单不提交。
-
-## 完整数据流
-
-```text
-点击按钮（eventKey=showComponent）
-  → schema-view 按 eventOption.comName 匹配动态组件，调用组件的 show(rowData)
-     ├── createForm：直接打开（不接收行数据）
-     └── editForm / detailPanel：先 GET <api>?<mainKey>=<值> 回显，再打开
-  → 保存成功 emit command: loadTableData → 表格刷新
-```
-
-::: tip 组件类型可以自己扩展
-表单控件（`componentType`）与动态组件都支持业务侧注册自定义实现——
-比如批量导入面板、自定义向导抽屉，与内置的新增/编辑/详情同一套触发机制，
-见[扩展 DSL](./extend.md)。
-:::
-
-## 下一步
-
-- [接口契约](./api-contract.md)：这些交互背后的后端接口标准

package/templates/document/docs/dsl/schema.md

@@ -1,121 +0,0 @@
-# schema 模块 DSL
-
-schema 模块（`moduleType: "schema"`）是 DSL 的主要形态：**一份字段 schema
-同时驱动搜索栏、表格列、新增/编辑表单、详情面板**。每个字段在哪个视图出现、
-以什么控件出现，由该字段是否配置对应的 `xxxOption` 决定。
-
-## schemaConfig 总览
-
-```js
-{
-  key: "product",
-  name: "商品管理",
-  menuType: "module",
-  moduleType: "schema",
-  schemaConfig: {
-    api: "/api/project/product",  // 接口基址（不是完整列表地址，见「接口契约」）
-    schema: { /* 字段 schema，本页重点 */ },
-    tableConfig: { /* 按钮与动态组件，见「按钮与动态表单」 */ },
-    searchConfig: {},             // 预留字段，前端暂未消费
-  },
-}
-```
-
-::: warning 不要手写 components 字段
-动态组件（表单/详情）的 schema 由框架根据 `tableConfig.componentConfig`
-自动派生，`schemaConfig` 顶层不要手写 `components` 字段。
-:::
-
-## 字段定义：一份 schema，四个视图
-
-```js
-schema: {
-  type: "object",
-  properties: {
-    productName: {
-      type: "string",          // JSON-Schema 类型（表单项按此做 ajv 校验）
-      label: "商品名称",        // 表格列标题 / 表单 label / 详情行 label
-      minLength: 3,            // 可选 JSON-Schema 约束：表单侧校验 + 提示
-      maxLength: 10,
-
-      tableOption:      { width: 200 },                    // 配了才进表格列
-      searchOption:     { componentType: "input" },        // 配了才进搜索栏
-      createFormOption: { componentType: "input" },        // 配了才进新增表单
-      editFormOption:   { componentType: "input" },        // 配了才进编辑表单
-      detailPanelOption: {},                               // 配了才进详情面板
-    },
-  },
-  required: ["productName"],
-}
-```
-
-**关键规则**（由前端 `buildDtoSchema` 按 `${comName}Option` 统一拆分实现）：
-
-- `tableOption` / `searchOption` / `createFormOption` / `editFormOption` /
-  `detailPanelOption` 走**同一套机制**，只是消费方不同
-- 配了哪个 Option 字段就进哪个视图，视图之间互相独立——同一字段可以只配其一
-- 合并后字段会挂到 `option` 属性上传给对应组件；`type` / `label` /
-  约束字段等非 `xxxOption` 键原样保留
-- **必填自动注入**：字段名出现在顶层 `required` 数组中，其表单 `option`
-  自动获得 `required: true`（红星 + 校验），**不要在各 option 里手写**
-
-## tableOption：表格列
-
-透传给 arco `<a-table-column>`（`v-bind`），`width` / `ellipsis` / `tooltip` /
-`align` / `fixed` 等标准配置均可直接使用。另有三个扩展字段：
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `enumList` | `array` | 枚举标签：`[{label, value}]`，命中枚举值的单元格渲染为彩色标签（颜色按索引循环） |
-| `toFixed` | `number` | 数字保留 N 位小数 |
-| `visible` | `boolean` | `false` 时该列不渲染（字段仍参与搜索 / 数据） |
-
-> 所有列默认带 `ellipsis: true, tooltip: true` 防止长文本撑破列宽，
-> `tableOption` 里的同名配置可覆盖默认值。
-
-## searchOption：搜索项
-
-控件类型由 `componentType` 选择（注册于框架 `schema-search-bar` 的
-search-item-config），其余配置透传给对应 arco 组件：
-
-| `componentType` | arco 组件 | 额外字段 | 搜索值下发形状 |
-| --- | --- | --- | --- |
-| `input` | `a-input` | 无（`placeholder`、`allowClear` 直接透传） | 标量 |
-| `select` | `a-select` | `enumList`: `[{label, value}]` | 标量 |
-| `dynamicSelect` | `a-select` | `api`: 选项接口，挂载后自动请求，响应 `data` 须为 `[{label, value}]` | 标量 |
-| `dateRange` | `a-range-picker` | `valueFormat`（建议配合 `showTime: true`） | 拆为 `<fieldKey>_start` / `<fieldKey>_end` 两个参数 |
-
-### default 与空值语义
-
-- `default` 是初始 / 重置值：`input` / `select` / `dynamicSelect` 用标量，
-  建议 `""` 表示不选
-- `select` / `dynamicSelect` **未配置 `default` 时会回退选中第一个枚举值**，
-  建议始终显式写 `default: ""`
-- `dateRange` 的重置值恒为 `[]`（组件忽略 `default`，URL 预填对它也无效）
-- **空字符串会原样下发**：`getValue()` 只在值为 `undefined` 时省略字段，
-  `""`（含 `default: ""`）会进入请求——**后端需把 `""` 视为「不过滤」**
-- `dateRange` 选中后固定拆成 `<field>_start` / `<field>_end` 两个参数，
-  值为 `YYYY-MM-DD HH:mm:ss` 字符串；未选值时两个参数都不下发
-
-## URL 预填搜索值
-
-路由 query 中存在与字段同名的参数时（如 `?productName=手机`），会覆盖该
-搜索项的 `option.default`——实现「从别处带着搜索条件跳转过来」。
-仅对标量控件（`input` / `select` / `dynamicSelect`）生效。
-
-## 搜索数据流
-
-```text
-schema-search-bar（收集各搜索项 getValue）
-  → search-panel（@load / @search / @reset 统一转为 search 事件）
-  → schema-view（apiParams = 搜索值，下发表格）
-  → schema-table（watch apiParams → 重置分页 → GET <api>/list）
-```
-
-- 首次挂载：全部搜索项就绪后**自动触发一次带默认值的查询**（含 URL 预填值）
-- 点「查询」：立即按当前值触发；点「重置」：恢复 `default` 后重新拉全量
-
-## 下一步
-
-- [按钮与动态表单](./schema-actions.md)：增删改查按钮与表单/详情抽屉
-- [接口契约](./api-contract.md)：后端需要实现的接口标准

package/templates/document/docs/frontend/build.md

@@ -1,118 +0,0 @@
-# 前端构建
-
-前端构建由框架内置的 Webpack 5 管线完成，业务项目一般**零配置**，
-特殊需求通过 `app/webpack.config.js` 扩展。
-
-## 构建模式
-
-`frontendBuild(_ENV)`（见[构建与部署](../guide/deployment.md)）：
-
-| 模式 | 说明 |
-| --- | --- |
-| `_ENV=local` | Webpack dev server（`127.0.0.1:9002`），HMR 热更新，模板写盘 |
-| `_ENV=prod` | 产物构建到 `app/public/dist/prod/`，CSS 抽离压缩、JS Terser 压缩（去 console）、构建前清空 dist |
-
-两种模式都会把页面模板写成 `app/public/dist/entry.<name>.tpl` 供 Koa 渲染。
-
-## 入口自动发现
-
-构建入口通过扫描得到（框架页面目录 + 业务 `app/pages/`），规则与页面系统一致：
-`**/entry.*.js`，业务同名覆盖框架。**新增 / 删除页面不需要改任何构建配置**。
-
-## 分包策略
-
-生产构建把 JS 拆成三类，配合浏览器长缓存：
-
-| chunk | 内容 | 变化频率 |
-| --- | --- | --- |
-| `vendor` | node_modules 第三方库 | 几乎不变 |
-| `common` | 被 ≥2 个入口引用的 common / widgets 业务代码 | 较少 |
-| `entry.<page>` | 页面自身代码 | 经常 |
-
-`runtime` 单独抽出；文件名带内容 hash，内容不变则文件名不变。
-
-## Webpack 别名
-
-页面代码里可用的框架别名：
-
-| 别名 | 指向 |
-| --- | --- |
-| `$lumfallBoot` | 页面启动器 |
-| `$lumfallPage` | 框架页面目录（框架的 app/pages） |
-| `$lumfallCommon` | 框架公共工具目录 |
-| `$lumfallCurl` | 请求工具 `curl.js` |
-| `$lumfallUtils` | 通用工具 `utils.js` |
-| `$lumfallWidgets` | 框架内置组件目录 |
-| `$lumfallStore` | Pinia store（`menu.js` / `project.js`） |
-| `$lumfallAssert` | 框架静态资源（logo / avatar / 公共样式） |
-| `$lumfallHeaderContainer` | 头部布局组件 |
-| `$lumfallSchemaForm` / `$lumfallSchemaSearchBar` / `$lumfallSchemaTable` | schema 三件套 |
-| `$lumfallSiderContainer` | 侧边布局组件 |
-
-另有四个「业务覆盖点」别名，业务项目里存在对应文件时指向业务文件，
-否则指向空模块（所以**业务可以不写这些文件**）。它们是 DSL 的业务侧
-扩展入口——注册自定义搜索 / 表单控件、schema-view 动态组件与 custom 路由，
-完整契约见[扩展 DSL](../dsl/extend.md)：
-
-| 别名 | 业务文件 |
-| --- | --- |
-| `$businessDashboardRouterConfig` | `app/pages/dashboard/router.js` |
-| `$businessComponentConfig` | `app/pages/dashboard/complex-view/schema-view/components/component-config.js` |
-| `$businessFormItemConfig` | `app/pages/widgets/schema-form/form-item-config.js` |
-| `$businessSearchItemConfig` | `app/pages/widgets/schema-search-bar/complex-view/search-item-config.js` |
-
-## 扩展 Webpack 配置
-
-`app/webpack.config.js` 导出配置对象，与框架配置 `webpack-merge` 的
-`merge.smart` 合并。常见场景：
-
-```js
-// 给 .md 文件加原文导入（本站就是这么做的）
-module.exports = {
-  module: {
-    rules: [{ test: /\.md$/, type: "asset/source" }],
-  },
-};
-```
-
-```js
-// 增加 resolve 别名
-const path = require("path");
-
-module.exports = {
-  resolve: {
-    alias: {
-      $business: path.resolve(__dirname, "pages/business"),
-    },
-  },
-};
-```
-
-## 依赖解析：框架共享依赖直接可用
-
-框架在 webpack.base 的 `resolve.alias` 里维护了一份**共享依赖白名单**
-（alias 指向包的真实目录，`require.resolve` 以框架自身为解析上下文），
-业务页面**可以直接 import 白名单里的库**，无需在业务 `package.json`
-里重复安装：
-
-- 当前白名单：`vue`、`vue-router`、`pinia`、`@arco-design/web-vue`、
-  `@babel/runtime`、`axios`、`lodash`、`moment`、`md5`
-- alias 指向包目录，所以子路径 import 全部可用
-  （`@arco-design/web-vue/es/icon`、`@babel/runtime/helpers/*`、`lodash/cloneDeep` 等）
-- 框架解析优先于业务 `node_modules`，运行时**只有一份实例**——
-  业务即使声明了同名库，构建时也解析到框架那份（不会出现双 Vue）
-- 需要暴露更多框架依赖时，在框架 `webpack.base.js` 的 `sharedDeps`
-  数组加一行包名；框架没有的库（如文档站的 `markdown-it`）仍需业务自己安装
-- 需要 lumfall ≥ 1.1.1；更早版本在 pnpm 下解析不到框架依赖，
-  需在业务 `package.json` 显式声明（显式声明在任意版本下都有效）
-
-`_` 与 `axios` 另有全局注入（ProvidePlugin），页面代码不 import 也能用。
-
-## loader 覆盖注意
-
-- 业务页面的 JS 默认由 babel-loader 处理（生产环境 preset-env +
-  transform-runtime，worker 并行）；`.vue` 由 vue-loader 处理
-- `.css` 走 style-loader（dev）/ MiniCssExtract（prod）；`.less` 额外经过
-  less-loader，页面里推荐 `lang="less"`
-- `merge.smart` 下相同 `test` 的规则会合并，`use` 数组会被生产配置覆盖——
-  想改某个 loader 的行为时优先用「新增规则」或换文件类型，避免整条覆盖