create-lumfall 1.0.0 → 1.0.1

package/cli.js

@@ -26,8 +26,8 @@ const TEMPLATES = [
   {
     key: "document",
     alias: "d",
-    name: "技术文档站",
-    desc: "对标 VitePress 的文档站模板（导航/侧栏/搜索/暗色模式），内置 lumfall 文档内容",
+    name: "技术文档站（空模板）",
+    desc: "导航/侧栏/搜索/主题就绪，生成后放入自己的内容即可",
     selfName: "lumfall-document",
   },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lumfall",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "lumfall 应用脚手架：一条命令生成可运行的基础业务项目或技术文档站（pnpm create lumfall my-app）",
   "bin": {
     "create-lumfall": "cli.js"

package/templates/document/README.md

@@ -1,100 +1,29 @@
-# lumfall-document
+# lumfall-document（空模板）
 
-基于 [lumfall](https://www.npmjs.com/package/lumfall) 的技术文档站模板，
-对标 VitePress 的使用体验：顶部导航、侧边栏、页面目录（TOC）、
-站内搜索（Ctrl/Cmd+K）、代码高亮与复制、亮 / 暗主题、上一篇/下一篇、移动端适配。
+基于 [lumfall](https://www.npmjs.com/package/lumfall) 的技术文档站**空模板**：
+导航、侧边栏、页面目录（TOC）、站内搜索（Ctrl/Cmd+K）、代码高亮与复制、
+亮 / 暗主题、上一篇/下一篇、移动端适配全部就绪，生成后只需要写内容。
 
-模板本身是自举的：**内置内容就是 lumfall 框架的技术文档**，换掉内容即可为
-任何项目搭文档站。文档是纯前端渲染的 SPA，内容由构建期打进产物，无需后端 API。
+> 这个分支（`template/empty`）是 create-lumfall 脚手架 `document` 模板的来源；
+> `main` 分支是自举的完整示例（内置 lumfall 技术文档）。
 
-## 快速开始
+## 开始
 
 ```sh
 pnpm install
-pnpm start:dev                # 本地开发：webpack dev server + 服务
-# 打开 http://localhost:3000/view/docs
+pnpm start:dev                # http://localhost:3000/view/docs
 
-pnpm start:prod               # 生产构建 + 启动（Koa 服务）
+pnpm build:static             # 产出 dist-static/（Vercel 等静态托管可直接部署）
 ```
 
-环境变量 `_ENV`（local / beta / prod）与构建部署细节同 lumfall 基础工程，
-见[构建与部署文档](docs/guide/deployment.md)。
+## 写内容
 
-## 部署到 Vercel（静态托管）
-
-文档站是纯前端 SPA：markdown 在构建期全部打进 bundle，运行时不调用任何接口，
-因此**不需要 Node 进程**，可以直接以静态站点部署到 Vercel / Netlify / Nginx。
-
-```sh
-pnpm build:static             # 产出 dist-static/（index.html + app.html + vercel.json + dist/prod/）
-
-cd dist-static && vercel --prod   # CLI 部署
-```
-
-或使用 Git 集成：Vercel 项目设置 **Build Command** = `pnpm build:static`，
-**Output Directory** = `dist-static`，Framework Preset 选 Other。
-
-`dist-static/` 的组成：
-
-| 文件 | 作用 |
-| --- | --- |
-| `app.html` | 应用外壳（由框架页面模板转换，`window.__LUMFALL__` 替换为静态值） |
-| `index.html` | `/` 的重定向页（跳到 `/view/docs`，替代 Koa 的 302 兜底） |
-| `vercel.json` | SPA rewrite：`/view/docs/*` → `app.html`；`dist/prod/*` 长缓存头 |
-| `dist/prod/...` | 构建产物（保持 `/dist/prod/` 绝对路径可解析） |
-
-其他平台的等价配置：把 `/view/docs` 与 `/view/docs/:path*` rewrite 到
-`app.html`（Netlify 的 `_redirects`、Nginx 的 `try_files` 即可），`/` 指向
-`index.html`。深链接刷新、站内路由、客户端 404 页全部由前端自行处理。
-
-::: warning 静态模式的能力边界
-静态部署只有文档站页面：框架自带的 `/view/health`、`/view/dashboard`、
-`/health/*`、`/api/*` 都不存在；如果往文档站里加 curl 调接口的功能，
-需要回到 Koa 部署（或为接口单独部署服务）。
-:::
-
-## 目录结构
-
-```text
-lumfall-document/
-├── server.js                  # 服务端入口（homePath 指向 /view/docs）
-├── build.js                   # 前端构建入口
-├── scripts/build-static.js    # 静态站点构建（pnpm build:static → dist-static/）
-├── config/                    # 环境配置（同基础工程）
-├── docs/                      # ★ 文档内容：全部 markdown，目录结构随意
-│   ├── guide/
-│   ├── core/
-│   ├── dsl/                   # Dashboard DSL 章节（Model+Project、schema 模块、接口契约）
-│   ├── frontend/
-│   ├── advanced/
-│   └── reference/
-└── app/
-    ├── webpack.config.js      # 额外声明了 .md 的 asset/source 规则
-    └── pages/
-        └── docs/              # 文档站页面（单页 + 站内路由）
-            ├── entry.docs.js  # 页面入口：注册 /view/docs 两条路由
-            ├── docs-config.js # ★ 站点配置：导航、侧栏、首页 hero、页脚
-            ├── content.js     # 内容加载器：require.context 扫 docs/ 下所有 .md
-            ├── markdown/      # markdown-it 渲染器（锚点/TOC/代码块/提示块/链接）
-            ├── search.js      # 站内搜索索引
-            ├── theme.js       # 亮暗主题
-            ├── components/    # navbar / sidebar / toc / search / layout
-            ├── views/         # 首页（hero）与文档页
-            └── styles/        # 设计变量与排版样式（CSS 变量驱动双主题）
-```
-
-## 用它搭自己的文档站
-
-三步：
-
-1. **改内容**：把 `docs/` 下的 markdown 换成自己的（目录层级随意，
-   两级以内体验最佳）。文档里可以互相引用，支持相对链接：
+1. **内容**：`docs/` 下的 markdown 就是文档，目录结构随意（两级以内体验最佳）。
+   文档里可以互相引用，支持相对链接与锚点：
    ```markdown
-   [配置](./config.md)          → 同目录
-   [路由](../core/router-schema.md) → 上级目录
-   [某节](./config.md#读取配置)  → 带锚点
+   [其他页](./other.md)  [上级目录](../advanced/x.md)  [某节](./other.md#锚点)
    ```
-2. **改配置**：`app/pages/docs/docs-config.js` 是唯一需要动的配置文件——
+2. **站点配置**：`app/pages/docs/docs-config.js` 是唯一需要动的配置文件——
    站点名、导航、侧栏分组、首页 hero、页脚。侧栏条目的 `path` 对应
    `docs/` 下的文件路径（`/view/docs/<path>` ↔ `docs/<path>.md`）
 3. **可选**：改主题色（`app/pages/docs/styles/vars.less` 的 `--doc-brand`
@@ -109,37 +38,21 @@ lumfall-document/
 | 页面目录 | 正文右侧 TOC，滚动联动高亮（<1280px 隐藏） |
 | 站内搜索 | `Ctrl/Cmd + K` 或 `/` 唤起；标题 / 小节 / 正文加权匹配，关键词高亮摘要，键盘导航 |
 | 代码块 | highlight.js 按需注册语言、语言标签、一键复制、亮暗配色 |
-| markdown 扩展 | `::: tip / info / warning / danger <可选标题>` 提示块、标题锚点（悬停显示 #）、外链新窗口 |
+| markdown 扩展 | `::: tip / info / warning / danger <可选标题>` 提示块、标题锚点、外链新窗口 |
 | 主题 | 亮 / 暗（右上角切换），首次进站跟随系统，localStorage 记忆 |
 | 上一篇/下一篇 | 按侧边栏顺序自动生成 |
-| 路由 | `/view/docs` 首页，`/view/docs/<path>` 文档页，未知路径显示 404 引导 |
-| SEO 基础 | 每页动态 `document.title`；如需完整 SEO 需要额外的预渲染方案 |
+| 静态部署 | `pnpm build:static` 一键产出 `dist-static/`（vercel.json rewrite + 长缓存） |
 
 ## 写作约定
 
 - 每篇文档以 `# 一级标题` 开头（渲染为页面标题），章节用 `##` / `###`
   （自动进入右侧 TOC 与搜索索引）
 - 代码块标注语言（`js` / `vue` / `bash` / `json`…）才会高亮
-- 小节标题会被 slug 化为锚点 id（中文保留原文字符），可直接 `#锚点` 引用
-- 不支持的内容：数学公式、mermaid 图（markdown-it 未接插件，需要时可在
-  `app/pages/docs/markdown/index.js` 自行扩展）
-
-## 搜索原理
-
-构建时全部 markdown 以文本形式打进 bundle（`asset/source`），
-搜索在浏览器内存里做索引（标题 / 小节标题 / 正文三级加权，代码块不参与）。
-文档量在几百页以内体验良好；更大规模时建议接后端搜索或引入 lunr/minisearch。
-
-## 常见问题
-
-- **改了 docs/ 下的 md 没生效**：dev 模式需要重新触发编译（保存任意被引用的
-  文件）；生产模式需要重新 `pnpm build:prod`
-- **侧栏点进去 404**：`docs-config.js` 里的 path 与 `docs/` 实际文件不一致
-- **想改页面挂载路径（/view/docs）**：改 `docs-config.js` 的 `DOCS_BASE`
-  与 `entry.docs.js` 里的两条路由 path，三处保持一致
+- 不支持数学公式、mermaid 图（markdown-it 未接插件，需要时可在
+  `app/pages/docs/markdown/index.js` 扩展）
 
 ## 相关项目
 
-- `lumfall-basic-project/`：基础业务工程骨架（本模板的工程底座）
-- `lumfall-business/`：B 端全栈模板（Dashboard / schema 组件）
-- `lumfall/`：框架本体
+- `lumfall-basic-project/`：基础业务工程骨架
+- `lumfall-business/`：B 端全栈模板
+- `create-lumfall/`：应用脚手架（本模板通过它的 `-t document` 生成）

package/templates/document/app/pages/docs/docs-config.js

@@ -1,10 +1,9 @@
 /**
  * 文档站配置 —— 使用本模板时主要改这个文件。
  *
- * 换成自己的站点只需三步：
+ * 换成自己的站点只需两步：
  *   1. 改本文件的 site / nav / sidebar / hero / footer
- *   2. 把 docs/ 目录下的 markdown 换成自己的内容（目录结构随意，两层以内最佳）
- *   3. 想改页面挂载路径（/view/docs）时，改 DOCS_BASE 并同步 entry.docs.js 里的路由
+ *   2. 把 docs/ 目录下的 markdown 换成自己的内容（目录结构随意，两级以内最佳）
  */
 
 // 站内文档的 URL 前缀 = /view/<页面目录名>
@@ -15,140 +14,55 @@ const doc = (path) => `${DOCS_BASE}/${path}`;
 export default {
   // 站点信息
   site: {
-    title: "Lumfall",
-    description: "Lumfall 全栈框架开发文档",
+    title: "Your Docs",
+    description: "基于 lumfall 的技术文档站",
     // 右上角仓库链接，不需要就置空
-    repo: "https://github.com/ikun-Lg/lumfall",
+    repo: "",
   },
 
   // 顶部导航：path 为站内路由（高亮按第一级 section 匹配），link 为外链
-  nav: [
-    { text: "指南", path: doc("guide/introduction") },
-    { text: "核心概念", path: doc("core/app-instance") },
-    { text: "DSL", path: doc("dsl/overview") },
-    { text: "前端", path: doc("frontend/page") },
-    { text: "进阶", path: doc("advanced/security") },
-    { text: "参考", path: doc("reference/faq") },
-    { text: "GitHub", link: "https://github.com/ikun-Lg/lumfall" },
-  ],
+  nav: [{ text: "文档", path: doc("guide/introduction") }],
 
   // 侧边栏分组。items 的 path 必须对应 docs/ 下真实存在的 markdown 文件
   // （例如 doc("guide/introduction") 对应 docs/guide/introduction.md）
   sidebar: [
     {
-      text: "指南",
-      items: [
-        { text: "简介", path: doc("guide/introduction") },
-        { text: "快速开始", path: doc("guide/getting-started") },
-        { text: "目录结构与挂载点", path: doc("guide/structure") },
-        { text: "配置", path: doc("guide/config") },
-        { text: "构建与部署", path: doc("guide/deployment") },
-      ],
-    },
-    {
-      text: "核心概念",
-      items: [
-        { text: "app 对象与启动流程", path: doc("core/app-instance") },
-        { text: "Controller 与 Service", path: doc("core/controller-service") },
-        { text: "路由与参数校验", path: doc("core/router-schema") },
-        { text: "中间件", path: doc("core/middleware") },
-        { text: "生命周期", path: doc("core/lifecycle") },
-        { text: "插件", path: doc("core/plugins") },
-      ],
-    },
-    {
-      text: "DSL",
-      items: [
-        { text: "DSL 总览", path: doc("dsl/overview") },
-        { text: "Model 与 Project", path: doc("dsl/model-project") },
-        { text: "菜单项 DSL", path: doc("dsl/menu") },
-        { text: "schema 模块 DSL", path: doc("dsl/schema") },
-        { text: "按钮与动态表单", path: doc("dsl/schema-actions") },
-        { text: "接口契约", path: doc("dsl/api-contract") },
-        { text: "扩展 DSL", path: doc("dsl/extend") },
-        { text: "完整模板与注意事项", path: doc("dsl/reference") },
-      ],
-    },
-    {
-      text: "前端",
-      items: [
-        { text: "页面系统", path: doc("frontend/page") },
-        { text: "前端构建", path: doc("frontend/build") },
-        { text: "内置组件", path: doc("frontend/widgets") },
-        { text: "请求工具 curl", path: doc("frontend/curl") },
-      ],
-    },
-    {
-      text: "进阶",
+      text: "开始",
       items: [
-        { text: "安全策略", path: doc("advanced/security") },
-        { text: "健康检查", path: doc("advanced/health") },
-        { text: "请求观测 monitoring", path: doc("advanced/monitoring") },
-        { text: "Dashboard 与 Model 配置", path: doc("advanced/dashboard") },
-      ],
-    },
-    {
-      text: "参考",
-      items: [
-        { text: "常见错误自查", path: doc("reference/faq") },
-        { text: "命令与环境速查", path: doc("reference/commands") },
+        { text: "介绍", path: doc("guide/introduction") },
+        { text: "示例页面", path: doc("guide/example") },
       ],
     },
   ],
 
   // 首页 hero
   hero: {
-    name: "Lumfall",
-    tagline: "Koa + Vue 全栈框架，目录即约定，开箱即用",
-    text: "目录自动加载、四层配置合并、声明式 Dashboard DSL、页面与路由构建、安全策略、健康检查——写配置和业务代码，而不是搭工程。",
-    actions: [
-      { text: "快速开始", path: doc("guide/getting-started"), theme: "brand" },
-      { text: "DSL 设计", path: doc("dsl/overview"), theme: "brand-outline" },
-      { text: "GitHub", link: "https://github.com/ikun-Lg/lumfall" },
-    ],
+    name: "Your Docs",
+    tagline: "基于 lumfall 的技术文档站模板",
+    text: "把 docs/ 目录下的 markdown 换成你的内容，再修改本文件（app/pages/docs/docs-config.js），即可拥有完整的文档站点。",
+    actions: [{ text: "开始使用", path: doc("guide/introduction"), theme: "brand" }],
     features: [
       {
-        icon: "📐",
-        title: "声明式 Dashboard DSL",
-        details:
-          "Model + Project 两层 DSL 声明管理台；一份字段 schema 驱动搜索栏、表格、表单、详情四个视图，写配置不改代码。",
-      },
-      {
-        icon: "📁",
-        title: "目录即约定",
+        icon: "📝",
+        title: "Markdown 驱动",
         details:
-          "controller / service / router / middleware 按目录自动加载并挂载到 app，新建文件即生效，无需手动注册。",
+          "docs/ 目录即内容，支持相对链接、标题锚点、提示块、代码高亮与一键复制。",
       },
       {
-        icon: "⚙️",
-        title: "四层配置合并",
-        details:
-          "框架与业务的 config 按 _ENV 分层浅合并，支持 JSON Schema 强校验，环境切换只改一个变量。",
-      },
-      {
-        icon: "🧩",
-        title: "页面系统",
-        details:
-          "Vue 3 页面按 entry.<name>.js 自动发现，Webpack 5 多页构建，/view/<name> 直接访问，支持 HMR 热更新。",
+        icon: "🔍",
+        title: "站内搜索",
+        details: "Ctrl/Cmd + K 唤起，标题与正文加权匹配，纯前端实现无需后端。",
       },
       {
-        icon: "🛡️",
-        title: "内置安全策略",
-        details:
-          "接口签名校验与 project_key 校验开箱可用，参数校验基于 JSON Schema（Ajv），错误码统一。",
-      },
-      {
-        icon: "💚",
-        title: "健康检查与观测",
-        details:
-          "/health/live 与 /health/ready 内置探针机制；monitoring 提供请求级 trace 观测钩子；插件与生命周期覆盖启动退出。",
+        icon: "🌗",
+        title: "亮暗主题",
+        details: "跟随系统并支持手动切换，样式由 CSS 变量驱动，改一个变量即换主题色。",
       },
     ],
   },
 
   // 首页与文档页底部
   footer: {
-    text: "基于 lumfall 构建的文档站模板",
-    // copyright: "© 2026 Your Name",
+    text: "基于 lumfall-document 模板构建",
   },
 };

package/templates/document/docs/guide/example.md

@@ -0,0 +1,41 @@
+# 示例页面
+
+这个页面演示文档站支持的 markdown 能力，确认效果后可以删除本文件
+（记得同步删掉 `docs-config.js` 侧栏里的对应条目）。
+
+## 提示块
+
+::: tip 提示
+这是一个 tip 提示块，用于展示正向提示。
+:::
+
+::: warning 注意
+这是一个 warning 提示块，用于展示需要注意的内容。
+:::
+
+## 代码高亮
+
+标注语言即可高亮，右上角有一键复制：
+
+```js
+const { serviceStart } = require("lumfall");
+
+const app = serviceStart({
+  name: "my-docs",
+  homePath: "/view/docs",
+});
+```
+
+## 表格
+
+| 能力 | 说明 |
+| --- | --- |
+| 页面目录（TOC） | 正文 h2/h3 自动生成，滚动联动高亮 |
+| 站内搜索 | `Ctrl/Cmd + K` 或 `/` 唤起，标题与正文加权匹配，无需后端 |
+| 相对链接 | `[返回介绍](./introduction.md)` 自动转站内路由，支持锚点 |
+| 亮暗主题 | 跟随系统 + 手动切换，主题色由 CSS 变量驱动 |
+
+## 锚点
+
+每个标题悬停会出现 `#` 锚点链接，可以被其他文档引用：
+[跳到代码高亮](./example.md#代码高亮)。

package/templates/document/docs/guide/introduction.md

@@ -1,55 +1,31 @@
-# 简介
+# 开始使用
 
-**Lumfall** 是一个基于 Node.js 的全栈框架：服务端是 Koa 2，前端是 Vue 3 + Webpack 5，
-通过 **目录约定** 组织代码，按目录自动加载并挂载，开箱即用。
+这是由 create-lumfall 生成的**空文档站模板**——站点框架（导航、侧栏、目录、搜索、
+代码高亮、亮暗主题）已全部就绪，你只需要写内容。
 
-```sh
-pnpm add lumfall
-```
-
-服务端只需要一个入口文件（`serviceStart()`）；前端由 Webpack 按 `app/pages/` 下的页面入口
-自动多页打包，产物交给 Koa 渲染。业务代码写在自己的项目目录里，框架以 npm 包 `lumfall`
-的形式被依赖。
-
-## 它解决什么问题
+## 放入你的内容
 
-搭一个 Koa + Vue 的业务工程，通常要解决一串工程化问题：目录怎么组织、配置怎么分环境、
-路由和参数校验怎么管、前端怎么多页构建、接口安全怎么兜底……Lumfall 把这些固化为约定：
+1. 把 `docs/` 目录下的 markdown 换成你的文档（目录结构随意，两级以内体验最佳）
+2. 修改 `app/pages/docs/docs-config.js`：站点名、导航、侧栏、首页 hero、页脚
+3. 本地预览：`pnpm start:dev`，访问 <http://localhost:3000/view/docs>
 
-- **目录自动加载**：`app/controller`、`app/service`、`app/router`、`app/middleware`、
-  `app/extend` 下的文件自动扫描、按约定挂载到 `app` 对象上，新建文件即生效
-- **声明式 Dashboard DSL**：Model + Project 两层配置声明整个 B 端管理台；
-  一份字段 schema 驱动搜索栏 / 表格 / 表单 / 详情四个视图，写配置不改代码
-  （见 [DSL 章节](../dsl/overview.md)）
-- **四层配置合并**：框架配置与业务配置按 `_ENV` 环境分层浅合并，支持 JSON Schema 强校验
-- **页面系统**：`app/pages/<name>/entry.<name>.js` 自动发现为页面入口，
-  访问 `/view/<name>`，支持开发热更新（HMR）
-- **前端构建管线**：Webpack 5 多页构建、vendor/common 分包长缓存、
-  `webpack-dev-middleware` + HMR 的开发服务
-- **统一 API 形态**：controller / service 基类 + 统一响应结构 + 基于 JSON Schema 的参数校验
-- **安全策略**：接口签名校验、project_key 校验等内置中间件，配置即用
-- **可观测性**：`/health/live`、`/health/ready` 健康检查探针、请求级 monitoring 钩子、
-  启动产物诊断清单（路由 / 页面 / 探针一览）
-- **插件与生命周期**：数据库、缓存等前置能力以插件注册；启动 / 退出 hook 覆盖全流程
+## 侧边栏与文件对应
 
-## 适用场景
+侧边栏条目的 `path` 对应 `docs/` 下的 markdown 文件：
 
-- 中小型全栈业务系统：管理后台、内容系统、内部工具
-- B 端多项目（多租户）控制台：配合内置 Dashboard 与声明式 DSL，
-  用配置生成整站管理页
-- 需要快速起步、统一团队工程约定的全栈项目
+| 配置项 | 对应文件 |
+| --- | --- |
+| `doc("guide/introduction")` | `docs/guide/introduction.md` |
+| `doc("guide/example")` | `docs/guide/example.md` |
 
-不适合的场景：重 SSR / SEO 的 C 端站点（页面是客户端渲染的 SPA）。
+## 发布
 
-## 快速了解
-
-- 从零建一个项目，看 [快速开始](./getting-started.md)
-- 想直接抄目录骨架，用同工作区的 `lumfall-basic-project/`
-- 声明一个 B 端管理台，看 [DSL 总览](../dsl/overview.md)
-- B 端管理台完整参考（登录、Dashboard、schema 表格表单）看 `lumfall-business/`
-- 技术文档站模板参考 `lumfall-document/`（本站即由它构建）
+```sh
+pnpm build:static              # 产出 dist-static/（含 vercel.json）
+cd dist-static && vercel --prod
+```
 
 ## 下一步
 
-- [快速开始](./getting-started.md)：十分钟跑起第一个项目
-- [目录结构与挂载点](./structure.md)：框架的核心约定
+- 看 [示例页面](./example.md) 了解文档站支持的 markdown 能力，确认后可删除
+- 完整功能说明见 lumfall-document 项目 README

package/templates/document/docs/advanced/dashboard.md

@@ -1,66 +0,0 @@
-# Dashboard 与 Model 配置
-
-框架自带开箱即用的 B 端控制台页面 `/view/dashboard`。它本身**不含任何业务代码**：
-页面结构、菜单、每个入口的形态，全部由业务项目 `model/` 目录下的
-**Dashboard DSL** 声明，启动时自动扫描合并。
-
-::: tip 编写配置请看 DSL 章节
-本页讲 Dashboard 页面如何**消费** DSL；如何**编写** DSL（Model / Project /
-菜单 / schema 模块 / 接口契约）见 [DSL 章节](../dsl/overview.md)。
-:::
-
-## 前端消费链路
-
-```
-1. 浏览器访问 /view/dashboard/schema?projectKey=pdd&key=product
-   （history 模式，服务端由 /view/:page/* 兜底渲染）
-2. dashboard.vue 挂载：
-   ├── GET /api/project/list?projectKey=pdd  → 项目列表（头部项目切换）
-   └── GET /api/project?projectKey=pdd       → 合并后的完整项目配置（含 menu）
-3. menuStore.setMenuList(menu)               → 菜单存入 Pinia
-4. header-view 渲染菜单                      → 含 subMenu 的项渲染为下拉子菜单
-5. 点击菜单项 → 按 moduleType 决定路由跳转
-   ├── custom → dashboard 基址 + customConfig.path
-   ├── sider  → /sider（左侧子菜单，子项跳转带 siderKey）
-   ├── iframe → /iframe
-   └── schema → /schema → schema-view
-6. schema-view 内部：
-   useSchema() 按路由 query 的 key / siderKey 从 menuStore 找到菜单项
-   → buildDtoSchema 按 xxxOption 拆出表格 / 搜索 / 动态组件 schema
-   → 搜索栏 + 表格渲染，URL query 同名字段预填搜索默认值
-7. 动态组件（配置了 tableConfig.componentConfig 时）：
-   按钮 eventKey=showComponent 打开 createForm / editForm / detailPanel 抽屉
-   → 保存成功 emit loadTableData → 表格刷新
-```
-
-## Dashboard 前端路由
-
-| 路由（基址 `/view/dashboard`） | 组件 | 说明 |
-| --- | --- | --- |
-| `/sider` | sider-view | 侧边复合视图，含子路由 `/sider/iframe`、`/sider/schema` 等 |
-| `/iframe` | iframe-view | iframe 嵌入页 |
-| `/schema` | schema-view | schema 驱动页 |
-| `/sider/:chapters+` | sider-view | sider 多级路径兜底 |
-
-## 内置数据接口
-
-| 接口 | 免 project_key | 说明 |
-| --- | --- | --- |
-| `GET /api/project/model_list` | ✓ | 全部 Model 及其 Project 概要（DTO） |
-| `GET /api/project/list?projectKey=` | ✓ | 项目列表（可按 key 过滤） |
-| `GET /api/project?projectKey=` | ✗（需 `project_key` 头） | 合并后的完整项目配置（含 menu） |
-
-Dashboard 页面启动时用 `$lumfallCurl` 拉取这些接口渲染菜单；URL 带
-`?projectKey=xxx` 时 curl 自动带 `project_key` 头（见[请求工具](../frontend/curl.md)）。
-
-## 项目切换
-
-头部右上角的下拉会列出**同 Model 下的其他 Project**（来自
-`/api/project/list`），切换后以新项目的 `homePage` 作为落点——这就是
-Model + Project 两层 DSL 在体验上的意义：一套公共菜单骨架，多个项目按需覆盖。
-
-## 下一步
-
-- [DSL 总览](../dsl/overview.md)：从零声明一个管理台
-- [接口契约](../dsl/api-contract.md)：schema 模块的后端接口标准
-- [安全策略](./security.md)：`/api/project/*` 的 project_key 校验

package/templates/document/docs/advanced/health.md

@@ -1,72 +0,0 @@
-# 健康检查
-
-框架自带两个健康检查接口与一个探针注册器，用于容器编排 / 负载均衡的探活。
-
-## 内置接口
-
-| 接口 | 用途 | 行为 |
-| --- | --- | --- |
-| `GET /health/live` | 存活探针 | 进程能响应即 200 `{"status":"ok"}` |
-| `GET /health/ready` | 就绪探针 | 并行执行全部已注册探针，全部通过 200；任一抛错 / 超时 / 返回 `false` 则 503 |
-
-两个接口都带 `Cache-Control: no-store`。`/health/ready` 的响应只包含探针名与状态，
-不包含错误详情（避免泄露内部信息）：
-
-```json
-{
-  "status": "error",
-  "checks": [
-    { "name": "database", "status": "ok" },
-    { "name": "cache", "status": "error" }
-  ]
-}
-```
-
-`/view/health` 是框架自带的人工查看页面。
-
-## 注册业务探针
-
-通过 extend 把业务依赖（数据库、缓存、下游服务）注册为探针：
-
-```js
-// app/extend/health-check.js
-module.exports = (app) => {
-  app.health.register("database", async () => {
-    await app.services.db.ping(); // 抛错或返回 false 视为不健康
-  });
-
-  app.health.register("cache", async () => {
-    const ok = await redisClient.ping();
-    return ok === "PONG";
-  }, { timeoutMs: 1000 }); // 默认 3000ms
-
-  return {}; // extend 的返回值挂到 app.healthCheck（返回 {} 占位即可）
-};
-```
-
-探针要求：
-
-- `register(name, probe, { timeoutMs })`：name 唯一非空；probe 是返回
-  Promise / 布尔的函数；抛错、超时、返回 `false` 都判为不健康
-- 同名重复注册会启动失败
-- `app.health.list()` 查看已注册探针（也会出现在
-  `app.diagnostics.getManifest().healthChecks`）
-
-## 接入编排系统
-
-```yaml
-# Kubernetes 示例
-livenessProbe:
-  httpGet:
-    path: /health/live
-    port: 3000
-readinessProbe:
-  httpGet:
-    path: /health/ready
-    port: 3000
-```
-
-- 存活探针只证明进程能响应，不要挂重探针
-- 就绪探针反映真实依赖状态：依赖故障时摘除流量，但不重启进程
-- 文档站这类无外部依赖的纯静态项目，不注册探针即可，`/health/ready`
-  恒为 200（`checks` 为空）