create-lumfall 1.0.0 → 1.0.1

package/templates/document/docs/dsl/api-contract.md

@@ -1,88 +0,0 @@
-# 接口契约
-
-schema 模块对 `schemaConfig.api` 有**固定的调用方式**：`api` 是接口**基址**
-（不是完整列表地址），前端自动拼接出六个标准接口。后端按需实现即可。
-
-## 六个标准接口
-
-| 调用 | 方法 | 地址与入参 | 响应 | 调用方 |
-| --- | --- | --- | --- | --- |
-| 查询列表 | `GET` | `<api>/list`，query: 搜索字段 + `page` + `pageSize`（默认 50） | `{ success, data: [...], metadata: { total } }`，`total` 必须存在 | 表格 |
-| 单条查询 | `GET` | `<api>`，query: `{ [mainKey]: 值 }` | `{ success, data: {...} }` | 编辑/详情回显 |
-| 新增 | `POST` | `<api>`，body: 新增表单值 | `{ success }` | 新增表单 |
-| 更新 | `PUT` | `<api>`，body: `{ [mainKey]: 值, ...编辑表单值 }` | `{ success }` | 编辑表单 |
-| 删除 | `DELETE` | `<api>`，body: `{ <参数名>: <值> }` | `{ success }` | 删除按钮 |
-| 枚举选项 | `GET` | 搜索项 `dynamicSelect` 配置的 `api` 原样请求 | `{ success, data: [{label, value}] }` | 动态下拉 |
-
-::: warning api 是基址
-列表接口由前端自动拼接 `/list` 后缀（`GET <api>/list`），删除走
-`DELETE <api>`。写后端路由时按基址注册，不要在 `schemaConfig.api` 里
-写上 `/list`。
-:::
-
-搜索字段值原样并入 query：`dateRange` 拆为 `<field>_start` / `<field>_end`
-（见 [schema 模块](./schema.md)）；**空字符串参数表示「不过滤」**，
-后端要处理这个语义。
-
-## 响应包络
-
-所有接口遵循框架统一响应结构（controller 基类的 `this.success` /
-`this.fail`，前端 `$lumfallCurl` 按此消费，见[请求工具](../frontend/curl.md)）：
-
-```json
-{
-  "success": true,
-  "data": {},
-  "metadata": {}
-}
-```
-
-失败时 `success: false`，附 `code` 与 `message`：
-
-| code | 含义 | 来源 |
-| --- | --- | --- |
-| `442` | 参数校验失败（router-schema ajv 校验） | apiParamsVerify |
-| `445` | 非法请求：签名校验失败或时间戳超时 | apiSignVerify |
-| `446` | 缺少 `project_key` header | projectHandler |
-| `5000` | 服务端未捕获异常 | errorHandler |
-| `50000` | 业务错误（message 为具体文案） | `this.fail` 约定 |
-| `504` | 请求超时（>60s） | curl |
-
-## 后端登记步骤
-
-以商品管理为例，四个文件对齐契约（参考实现见 `lumfall-business/` 的
-`app/controller/business.js` 等四件套）：
-
-1. **service** 实现数据逻辑（分页查询单条增删改）
-2. **controller** 实现处理器，遵循 `this.success(ctx, data, { total })` /
-   `this.fail(ctx, message, code)`
-3. **router** 注册路由，与契约对齐：
-
-   ```js
-   router.get("/api/project/product/list", controller.getBusinessList.bind(controller));
-   router.get("/api/project/product", controller.getBusiness.bind(controller));
-   router.get("/api/project/productEnum/list", controller.getProductEnumList.bind(controller));
-   router.post("/api/project/product", controller.createBusiness.bind(controller));
-   router.put("/api/project/product", controller.updateBusiness.bind(controller));
-   router.delete("/api/project/product", controller.deleteBusinessList.bind(controller));
-   ```
-
-4. **router-schema** 登记参数校验 schema——key 必须与路由 path
-   **完全一致**，否则该校验**静默不生效**（无 schema 的 path 直接放行）。
-
-::: tip 路径写错的坑
-router-schema 的 path 与路由 path 不一致时**不会报错**，只是校验被跳过
-（如 schema 写了 `/api/product` 而路由是 `/api/project/product`）。
-排查用 `app.diagnostics.getManifest().routes` 对照。
-:::
-
-## Dashboard 数据接口
-
-除业务接口外，框架为 Dashboard 本身提供三个内置数据接口（消费链路见
-[Dashboard 与 Model 配置](../advanced/dashboard.md)）：
-
-| 接口 | 免 project_key | 说明 |
-| --- | --- | --- |
-| `GET /api/project/model_list` | ✓ | 全部 Model 与 Project 概要 |
-| `GET /api/project/list?projectKey=` | ✓ | 项目列表（可按 key 过滤） |
-| `GET /api/project?projectKey=` | ✗（需 `project_key` 头） | 合并后的完整项目配置（含 menu） |

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

@@ -1,311 +0,0 @@
-# 扩展 DSL
-
-DSL 不是封闭的。schema 模块的**搜索控件、表单控件、动态组件**以及
-Dashboard 的 **custom 路由**都留了业务侧扩展点：在业务项目的 `app/pages/`
-下创建与框架同名的配置文件，框架构建时通过 webpack 别名自动识别并
-**与默认实现合并**（同名覆盖、新名追加）。
-
-## 四个扩展点
-
-| 业务文件（`<app-root>/app/pages/` 下） | webpack 别名 | 作用 |
-| --- | --- | --- |
-| `widgets/schema-search-bar/complex-view/search-item-config.js` | `$businessSearchItemConfig` | 注册 / 覆盖搜索控件 `componentType` |
-| `widgets/schema-form/form-item-config.js` | `$businessFormItemConfig` | 注册 / 覆盖表单控件 `componentType` |
-| `dashboard/complex-view/schema-view/components/component-config.js` | `$businessComponentConfig` | 注册 / 覆盖 schema-view 动态组件 |
-| `dashboard/router.js` | `$businessDashboardRouterConfig` | 注册 `custom` 模块的前端路由 |
-
-合并规则（三个组件注册表）：
-
-```js
-// 框架内部实现：默认注册表与业务注册表展开合并，业务同名 key 覆盖默认
-export default {
-  ...DefaultConfig,
-  ...BusinessConfig,
-};
-```
-
-::: tip 不建文件也完全不影响
-这四个文件都是**可选**的：业务项目没创建时，别名指向框架的空模块，
-DSL 按内置能力工作。只有需要扩展时才创建对应文件。
-:::
-
-## 扩展搜索控件
-
-搜索项控件注册进 `search-item-config.js`，DSL 里通过
-`searchOption.componentType` 使用。
-
-**1. 写控件组件**——契约：props 收 `schemaKey` / `schema`，
-expose `getValue()` 与 `reset()`，动态拉取选项的控件在就绪后 emit `load`：
-
-```vue
-<!-- app/pages/widgets/schema-search-bar/complex-view/rate/rate.vue -->
-<template>
-  <a-rate v-model="dtoValue" v-bind="schema.option" allow-half />
-</template>
-
-<script setup>
-import { ref } from "vue";
-
-const { schemaKey, schema } = defineProps({
-  schemaKey: String,
-  schema: Object,
-});
-
-const emit = defineEmits(["load"]);
-const dtoValue = ref(0);
-
-// getValue 返回 { [字段名]: 值 }；值为 undefined 时返回 {}（不下发该参数）
-const getValue = () =>
-  dtoValue.value !== undefined ? { [schemaKey]: dtoValue.value } : {};
-
-// reset 恢复为 DSL 里配置的 option.default
-const reset = () => {
-  dtoValue.value = schema?.option?.default ?? 0;
-};
-
-defineExpose({ getValue, reset });
-</script>
-```
-
-**2. 注册**（新建配置文件，导出「componentType → { component }」映射）：
-
-```js
-// app/pages/widgets/schema-search-bar/complex-view/search-item-config.js
-import rate from "./rate/rate.vue";
-
-export default {
-  rate: { component: rate },
-};
-```
-
-**3. 在 DSL 里使用**：
-
-```js
-score: {
-  type: "number",
-  label: "评分",
-  searchOption: { componentType: "rate", default: 0 },
-},
-```
-
-内置的四种控件（`input` / `select` / `dynamicSelect` / `dateRange`）无需注册；
-业务注册**同名** `componentType`（如 `input`）会覆盖内置控件——覆盖会影响
-所有使用 SchemaSearchBar 的地方，谨慎操作。
-
-## 扩展表单控件
-
-表单控件注册进 `form-item-config.js`，供 `createFormOption` /
-`editFormOption` 的 `componentType` 使用。契约比搜索控件多一项校验：
-
-- props：`schemaKey` / `schema` / `model`（回显值）
-- 可 `inject("ajv")` 拿到校验器（schema-form 已 provide）
-- expose：`validate()`（返回布尔，失败时自行展示错误提示）、
-  `getValue()`（返回 `{ [schemaKey]: value }`）、`name`
-
-```vue
-<!-- app/pages/widgets/schema-form/complex-view/textarea/textarea.vue -->
-<template>
-  <a-row class="form-item" align="center" justify="space-between">
-    <a-row class="item-label" v-if="schema.label" justify="end">
-      <span v-if="schema.option?.required" class="required">*</span>
-      {{ schema.label }}
-    </a-row>
-    <a-row class="item-value" justify="start">
-      <a-textarea
-        v-model="dtoValue"
-        v-bind="schema.option"
-        :max-length="schema.maxLength"
-        :placeholder="`请输入${schema.label}`"
-      />
-    </a-row>
-  </a-row>
-</template>
-
-<script setup>
-import { ref, toRefs, watch, inject } from "vue";
-
-const ajv = inject("ajv");
-
-const props = defineProps({
-  schemaKey: String,
-  schema: Object,
-  model: String,
-});
-const { schemaKey } = props;
-const { schema, model } = toRefs(props);
-
-const dtoValue = ref("");
-
-watch([model, schema], () => {
-  dtoValue.value = model.value ?? schema.value.option?.default;
-}, { immediate: true, deep: true });
-
-const validate = () => {
-  // 必填 + 字段级 JSON-Schema 校验（与内置控件同一套 ajv 约定）
-  if (schema.value.option?.required && !dtoValue.value) return false;
-  if (dtoValue.value) {
-    return ajv.compile(schema.value)(dtoValue.value);
-  }
-  return true;
-};
-
-const getValue = () =>
-  dtoValue.value !== undefined ? { [schemaKey]: dtoValue.value } : {};
-
-defineExpose({ validate, getValue });
-</script>
-```
-
-```js
-// app/pages/widgets/schema-form/form-item-config.js
-import textarea from "./complex-view/textarea/textarea.vue";
-
-export default {
-  textarea: { component: textarea },
-};
-```
-
-```js
-// DSL：createFormOption.componentType: "textarea"
-remark: {
-  type: "string",
-  label: "备注",
-  maxLength: 200,
-  createFormOption: { componentType: "textarea" },
-},
-```
-
-## 扩展 schema-view 动态组件
-
-最强大的扩展点：给 schema 模块加**自定义抽屉 / 面板**（批量导入、
-审计日志、自定义向导……），与内置的新增 / 编辑 / 详情同一套触发与刷新机制。
-
-一个自定义动态组件要同时做两件事：
-
-1. **代码侧注册**（component-config.js）
-2. **DSL 侧声明**（`tableConfig.componentConfig` 写同名 key）——两者缺一不可，
-   schema-view 只渲染 DSL 里声明了的组件
-
-组件契约：
-
-| 成员 | 说明 |
-| --- | --- |
-| `inject("schemaViewData")` | 拿到 `api`、`components`（其中自己 comName 对应 `{ schema, config }`） |
-| expose `name` | 必须等于 componentConfig 的 key，schema-view 按它找组件 ref |
-| expose `show(rowData)` | 按钮触发时被调用；行按钮传行数据，**表头按钮不传** |
-| emit `command` | `{ event: "loadTableData" }` 让框架刷新表格 |
-
-```vue
-<!-- app/pages/dashboard/complex-view/schema-view/components/batch-import.vue -->
-<template>
-  <a-drawer v-model:visible="isShow" :title="config.title || '批量导入'" :width="550">
-    <!-- 自己的表单 / 上传逻辑；schema 来自 components.value.batchImport.schema -->
-    <a-button type="primary" @click="save">导入</a-button>
-  </a-drawer>
-</template>
-
-<script setup>
-import { ref, inject, defineEmits } from "vue";
-
-const { api, components } = inject("schemaViewData") || {};
-const emit = defineEmits(["command"]);
-
-const isShow = ref(false);
-const config = ref({});
-const name = ref("batchImport"); // 与 componentConfig 的 key 一致
-
-const show = (rowData) => {
-  // 表头按钮触发时 rowData 为 undefined
-  config.value = components.value?.batchImport?.config || {};
-  isShow.value = true;
-};
-
-const save = async () => {
-  // ...调用接口
-  isShow.value = false;
-  emit("command", { event: "loadTableData" }); // 保存成功后刷新表格
-};
-
-defineExpose({ name, show });
-</script>
-```
-
-```js
-// app/pages/dashboard/complex-view/schema-view/components/component-config.js
-import batchImport from "./batch-import.vue";
-
-export default {
-  batchImport: { component: batchImport },
-};
-```
-
-```js
-// DSL：componentConfig 声明 + 按钮触发
-tableConfig: {
-  headerButtons: [
-    { label: "批量导入", eventKey: "showComponent", type: "outline",
-      eventOption: { comName: "batchImport" } },
-  ],
-  componentConfig: {
-    batchImport: { title: "批量导入" },
-    // 与内置的 createForm / editForm / detailPanel 共存
-  },
-}
-```
-
-::: tip 自定义组件的字段 schema 自动派生
-`buildDtoSchema` 对 componentConfig 里的**任意** key 生效：DSL 字段里配置
-`batchImportOption: { ... }` 的字段会自动进入该组件的 schema
-（`components.value.batchImport.schema`），与内置表单同一套机制。
-:::
-
-## 注册 custom 模块路由
-
-`custom` 模块的 `customConfig.path` 指向的前端路由由业务注册。
-框架启动 Dashboard 时会调用业务的路由配置：
-
-```js
-// app/pages/dashboard/router.js
-module.exports = ({ routes, siderRoutes }) => {
-  // 顶层路由：customConfig.path: "/article-manage" 对应这里
-  routes.push({
-    path: "/view/dashboard/article-manage",
-    component: () => import("./article-manage/article-manage.vue"),
-  });
-
-  // sider 子路由：相对路径，最终挂到 /sider/<path>
-  siderRoutes.push({
-    path: "article-sider",
-    component: () => import("./article-manage/article-manage.vue"),
-  });
-};
-```
-
-- `routes` 是顶层路由数组（框架的 `/iframe`、`/schema`、`/sider` 已在里面），
-  path 写完整 `/view/dashboard/...`
-- `siderRoutes` 是 sider 的 children，path 写**相对路径**（不带前导 `/`），
-  最终路由为 `/view/dashboard/sider/<path>`
-- 业务路由注册发生在 sider 通配路由之前，同名时业务优先
-
-::: warning 与 menu DSL 的对应关系
-`custom` 模块的 `customConfig.path: "/article-manage"` 必须能在 `routes`
-里匹配到；sider 子菜单的 custom 项 `path` 必须以 `/` 开头且对应
-`siderRoutes` 注册的子路由（或框架已注册的 `/sider/iframe`、`/sider/schema`），
-否则点击后内容区为空。
-:::
-
-## 事件与行为的边界
-
-- 按钮内置行为只有两种：`showComponent`（打开动态组件）与 `delete`
-  （确认框 + `DELETE <api>` + 刷新）
-- 其他 `eventKey`（如 `edit`）会向上 emit `operate` 事件，但 schema-view
-  内置的处理器当前只响应 `showComponent`——**扩展新的按钮行为时，
-  优先用 `showComponent` + 自定义动态组件**，而不是自定义 eventKey
-- 需要完全自定义列表页交互（超出抽屉形态）时，直接用 `custom` 模块 +
-  自定义页面，页面里仍可独立使用 SchemaTable / SchemaSearchBar /
-  SchemaForm（见[内置组件](../frontend/widgets.md)）
-
-## 下一步
-
-- [内置组件](../frontend/widgets.md)：脱离 DSL 独立使用这些组件
-- [完整模板与注意事项](./reference.md)：DSL 全量避坑清单

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

@@ -1,101 +0,0 @@
-# 菜单项 DSL
-
-菜单项是 DSL 的骨架：定义 Dashboard 的导航结构与每个入口的页面形态。
-`menu[]` 中的每个元素就是一个菜单项。
-
-## 通用字段
-
-| 字段 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `key` | `string` | 是 | 菜单项唯一标识，**用于路由 query 参数 `?key=xxx`**，也是 Model/Project 合并的匹配键 |
-| `name` | `string` | 否 | 显示名称（Project 覆盖时可省略，继承 Model） |
-| `menuType` | `string` | 是* | `"module"` 普通模块 / `"group"` 分组 |
-| `moduleType` | `string` | — | `menuType: "module"` 时有效，见下表 |
-
-**默认行为**：不写 `menuType` 时，该菜单项是**仅覆盖属性的 module**——
-从 Model 继承 `menuType` / `moduleType` / 对应 config，只改 `name` 等字段。
-这是 Project 覆盖 Model 的最简形式。
-
-::: warning group 必须带 subMenu
-前端通过**是否含 `subMenu`** 决定渲染为下拉子菜单（`a-sub-menu`），
-所以 `menuType: "group"` 的菜单项必须同时包含 `subMenu` 数组才能正确渲染。
-:::
-
-## moduleType：四种模块形态
-
-| 值 | 前端路由 | 必填 config | 说明 |
-| --- | --- | --- | --- |
-| `custom` | `customConfig.path` | `customConfig` | 自定义页，跳到业务注册的前端路由 |
-| `sider` | `/view/dashboard/sider` | `siderConfig` | 侧边复合视图：左侧子菜单 + 右侧子页面 |
-| `iframe` | `/view/dashboard/iframe` | `iframeConfig` | iframe 嵌入页 |
-| `schema` | `/view/dashboard/schema` | `schemaConfig` | schema 驱动列表页（主要形态），见 [schema 模块 DSL](./schema.md) |
-
-```js
-// 四种形态的配置形状
-{
-  key: "home",      name: "首页",
-  menuType: "module", moduleType: "custom",
-  customConfig: { path: "/todo" },             // 页面内路由
-}
-{
-  key: "external",  name: "外部链接",
-  menuType: "module", moduleType: "iframe",
-  iframeConfig: { path: "https://example.com" }, // 完整 URL 或页面内路径
-}
-{
-  key: "management", name: "管理",
-  menuType: "module", moduleType: "sider",
-  siderConfig: { menu: [/* 子菜单，元素结构与 menu[] 一致 */] },
-}
-{
-  key: "product",   name: "商品管理",
-  menuType: "module", moduleType: "schema",
-  schemaConfig: { api: "...", schema: { /* ... */ } },
-}
-```
-
-- `iframe` 的 `path` 原样作为 `<iframe src>`：完整 URL 嵌第三方页面；
-  相对路径（如 `todo`）基于当前页面 URL 解析，落到服务端页面路由。未配置时显示空态
-- `siderConfig` 是**对象**（不是数组），其 `menu` 子菜单支持 custom / iframe /
-  schema，也支持嵌套 group（层级不宜过深）
-
-## 分组菜单（group + subMenu）
-
-```js
-{
-  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" } },
-  ],
-}
-```
-
-`subMenu` 中每一项的结构与顶层 `menu[]` 完全一致，支持任意嵌套；
-子项必须写 `menuType: "module"`。
-
-## 路由与 query 参数
-
-Dashboard 是 history 路由的单页，基址 `/view/dashboard`（与框架服务端
-`/view/:page/*` 路由前缀一致）。DSL 中的所有路径（`homePage`、
-`customConfig.path`）都写**不带基址**的页面内路由。
-
-| query 参数 | 说明 | 示例 |
-| --- | --- | --- |
-| `projectKey` | 当前项目标识（= Project 文件名） | `pdd` |
-| `key` | 当前选中的头部菜单项 key | `product` |
-| `siderKey` | 当前选中的 sider 子菜单项 key（仅 sider 模块） | `cpopon` |
-| 任意字段名 | 与 schema 字段同名时**预填该搜索项默认值**（仅 schema 模块） | `?productName=手机` |
-
-::: warning sider 子菜单 custom 路径必须以 / 开头
-sider 子菜单点击跳转 `/sider/<子模块路由>`，custom 子项的
-`customConfig.path` 会**原样拼接**到 `/sider` 后。不带前导斜杠的
-`path: "taobao/cpopon"` 会拼出非法路由 `/sidertaobao/cpopon`，
-点击无法跳转——必须写 `path: "/todo"` 这样以 `/` 开头的页面内路由。
-:::
-
-## 下一步
-
-- [schema 模块 DSL](./schema.md)：主要形态的完整配置

package/templates/document/docs/dsl/model-project.md

@@ -1,122 +0,0 @@
-# Model 与 Project
-
-DSL 的两层结构：**Model 定义公共默认**，**Project 定义差异化**，两者深度合并后
-就是前端拿到的最终项目配置。
-
-## Model 配置（`model/<modelKey>/model.js`）
-
-| 字段 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `model` | `string` | 是 | 模式类型标识，固定 `"dashboard"`（注意字段名是 `model`，不是 `mode`） |
-| `name` | `string` | 是 | Model 显示名称 |
-| `menu` | `array` | 是 | 默认菜单数组，该 Model 下所有 Project 共享的菜单骨架 |
-
-> `key` 由扫描器按**目录名**自动注入，不要手写。
-> `desc` / `icon` / `homePage` 是 Project 顶层字段，不属于 Model。
-
-## Project 配置（`model/<modelKey>/project/<projectKey>.js`）
-
-| 字段 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `name` | `string` | 是 | 项目显示名称 |
-| `desc` | `string` | 是 | 项目描述 |
-| `homePage` | `string` | 是 | 默认首页，**页面内路由**（如 `/schema?projectKey=pdd&key=product`，不带 `/view/dashboard` 前缀） |
-| `menu` | `array` | 是 | 项目菜单，与 Model 的 `menu` 深度合并 |
-| `icon` | `string` | 否 | 预留字段 |
-
-> `key`（= 文件名）与 `modelKey`（= 所属目录名）由扫描器自动注入。
-
-## 合并规则
-
-合并逻辑在框架 `model/index.js` 的 `projectExtendModel` 中，基于
-`lodash.mergeWith`，但对**数组有特殊的按 key 合并规则**：
-
-### 普通对象：深度合并
-
-Project 的同名属性覆盖 Model 的，Model 独有的属性保留：
-
-```js
-// Model:  { name: "商品管理", customConfig: { path: "/todo" } }
-// Project:{ name: "商品管理(pdd)" }
-// 结果:   { name: "商品管理(pdd)", customConfig: { path: "/todo" } }
-```
-
-### 数组：按元素 `key` 智能合并
-
-以 `menu` 为例，合并不是拼接或整体覆盖，而是：
-
-1. 遍历 Model 数组：每个元素去 Project 数组里找**同 `key`** 元素——
-   找到则递归深度合并，找不到则原样保留
-2. 遍历 Project 数组：Model 中没有的新 `key`，**追加到结果末尾**
-
-```text
-Model.menu   = [{ key: "product", name: "商品管理", moduleType: "custom", ... },
-                { key: "order",   name: "订单管理", ... }]
-Project.menu = [{ key: "product", name: "商品管理(pdd)" },
-                { key: "data",    name: "数据管理(pdd)", moduleType: "sider", ... }]
-
-结果          = [{ key: "product", name: "商品管理(pdd)", moduleType: "custom", ... },   ← 覆盖
-                 { key: "order",   name: "订单管理", ... },                              ← 保留
-                 { key: "data",    name: "数据管理(pdd)", moduleType: "sider", ... }]     ← 追加
-```
-
-### 递归生效
-
-合并是**递归**的：`siderConfig.menu`、`subMenu` 等嵌套数组里的元素同样按 `key`
-匹配合并，行为在所有层级一致。
-
-::: warning 数组元素必须带 key
-数组合并完全依赖 `key` 匹配——`menu`（以及需要被 Project 覆盖的嵌套数组）里
-**每个元素都必须写 `key`**，否则合并不生效。
-:::
-
-## 三种典型覆盖姿势
-
-```js
-// model/business/project/pdd.js
-module.exports = {
-  name: "拼多多",
-  desc: "拼多多电商项目",
-  homePage: "/schema?projectKey=pdd&key=product",
-  menu: [
-    // 1. 只覆盖属性：只写 key + 差异字段，其余从 Model 继承
-    { key: "product", name: "商品管理(pdd)" },
-
-    // 2. 覆盖并改变形态：从 custom 换成 schema 模块（要带全对应 config）
-    {
-      key: "client",
-      name: "客户管理(pdd)",
-      moduleType: "schema",
-      schemaConfig: { api: "/api/client", schema: {} },
-    },
-
-    // 3. 新增菜单项：Model 中不存在，追加到末尾
-    {
-      key: "data",
-      name: "数据管理(pdd)",
-      menuType: "module",
-      moduleType: "sider",
-      siderConfig: { menu: [/* ... */] },
-    },
-  ],
-};
-```
-
-::: warning 覆盖形态时要带全 config
-把某个菜单项的 `moduleType` 从 `custom` 改成 `iframe` 时，必须同时提供
-`iframeConfig`；改成 `schema` 时必须提供 `schemaConfig`，否则前端跳转失败。
-:::
-
-## 新增一套 DSL 的完整步骤
-
-1. 在 `model/` 下创建目录（目录名 = Model key），编写 `model.js`
-2. 在其 `project/` 子目录下创建文件（文件名 = Project key），编写 Project 配置
-3. 重启服务——扫描器自动发现，无需注册任何代码
-
-验证：`GET /api/project/list` 能看到新项目，
-`GET /api/project?projectKey=<key>` 返回合并后的完整配置
-（接口详情见 [Dashboard 数据接口](../advanced/dashboard.md)）。
-
-## 下一步
-
-- [菜单项 DSL](./menu.md)：菜单项的字段与四种模块形态