create-tengits-app 1.1.10 → 1.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tengits-app",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "🚀 快速创建基于 React + Rsbuild + TypeScript + Tailwind CSS + Antd 的现代前端项目脚手架",
   "author": "",
   "license": "MIT",

package/packages/docs/DOCS_USAGE_RULES.md

@@ -0,0 +1,100 @@
+---
+title: 文档框架使用规范
+---
+
+# 文档框架使用规范
+
+本项目基于 **tengits-react-pages** 与 **tengits-theme-doc**，用于沉淀项目中的架构、需求、设计、数据建模、接口等文档。本文档说明如何正确在本仓库中维护文档。
+
+## 1. 目录结构约定
+
+- 所有文档页面放在 `pages/` 目录下，根据类别分目录：
+  - `pages/home`：首页与业务共识类说明
+  - `pages/architectures`：架构文档
+  - `pages/breakdowns`：功能分解
+  - `pages/plans`：计划文档
+  - `pages/reports`：报告文档
+  - `pages/requirements`：需求文档
+  - `pages/designs`：设计文档
+  - `pages/dataModel`：数据建模
+  - `pages/api`：接口文档
+  - `pages/develop`：开发文档
+  - `pages/test`：测试文档
+  - `pages/meetingNotes`：会议记录
+- 每个功能模块目录下**允许多层级子目录**，用于按业务线、子模块、场景进一步拆分。例如：
+  - `pages/requirements/miniApp/公共信息管理/列表/`
+  - `pages/requirements/web/公共信息管理/新增、编辑、详情/`
+- 如需新增一级导航：
+  - 在 [`pages/_theme.tsx`](file:///d:/reactwork/TengitsCLI/packages/docs/pages/_theme.tsx) 的 `topNavs` 中新增对应配置；
+  - 在 `pages/` 下创建同名目录，并在其中新增入口文档。
+
+## 2. Markdown 文档基本规则
+
+- 所有 `.md` / `.mdx` 文档 **必须** 在文件顶部包含 YAML 头（Front Matter）。
+- 必须字段：
+  - `title`：文档标题，将显示在侧边导航中。
+- 推荐字段：
+  - `order`：排序序号，数值越小越靠前，同一目录下多个文档时建议填写。
+
+示例：
+
+```yaml
+---
+title: 解决方案架构说明
+order: 1
+---
+```
+
+正文示例：
+
+```markdown
+---
+title: 4、功能概述
+---
+
+## 功能概述
+...
+```
+
+## 3. 文件命名与组织
+
+- 一般文档：
+  - 使用有含义的中文或拼音文件名，例如：`architectures.md`、`4功能概述.md`。
+  - 同一目录下可通过前缀数字（`1业务共识.md`、`2需求背景.md`...）配合 `order` 字段控制顺序。
+- 需求文档：
+  - 统一遵循 [`pages/requirements/a_requirements.md`](file:///d:/reactwork/TengitsCLI/packages/docs/pages/requirements/a_requirements.md) 中定义的规范；
+  - 文件名要求、章节模板、术语规范等以该文档为准。
+- 原型与交互稿：
+  - 交互原型页面可使用 `.tsx` / `.jsx` 文件，并以 `_原型` 等后缀区分，例如：`公告信息_公告列表_原型.jsx`；
+  - 原型文件应与对应需求文档放在相同目录下，便于关联维护。
+
+## 4. 新增文档的标准流程
+
+- 确定文档归属类别（如架构、需求、设计等），在对应 `pages/` 子目录下创建文件；
+- 在文件顶部添加 YAML 头，至少包含 `title` 字段，必要时增加 `order`；
+- 根据该类别既有文档的结构和写法进行复制与修改，保证章节结构统一；
+- 如果是需求文档，优先参考并遵循《需求文档规范》（`a_requirements.md`）；
+- 保存后通过 `npm run dev` 启动或刷新文档站点，校验导航展示和内容是否正确。
+
+## 5. 运行与构建
+
+- 安装依赖：
+
+```bash
+npm install
+```
+
+- 本地开发预览文档站点：
+
+```bash
+npm run dev
+```
+
+- 产出构建产物：
+
+```bash
+npm run build     # 构建 SPA 应用
+npm run ssr       # 构建静态站点（SSG）
+```
+
+开发同学在新增或调整文档时，请务必遵守以上规则，保持文档结构统一、导航清晰，方便团队协同与长期维护。

package/packages/docs/node_modules/.bin/vite-pages

@@ -6,9 +6,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules/tengits-react-pages/bin/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules/tengits-react-pages/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules/tengits-react-pages/bin/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules/tengits-react-pages/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules/tengits-react-pages/bin/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules/tengits-react-pages/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules/tengits-react-pages/bin/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules/tengits-react-pages/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../tengits-react-pages/bin/vite-pages.js" "$@"

package/packages/docs/node_modules/.bin/vite-pages.CMD

@@ -1,8 +1,8 @@
 @SETLOCAL
 @IF NOT DEFINED NODE_PATH (
-  @SET "NODE_PATH=D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules\tengits-react-pages\bin\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules\tengits-react-pages\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\node_modules"
+  @SET "NODE_PATH=D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules\tengits-react-pages\bin\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules\tengits-react-pages\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\node_modules"
 ) ELSE (
-  @SET "NODE_PATH=D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules\tengits-react-pages\bin\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules\tengits-react-pages\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\node_modules;%NODE_PATH%"
+  @SET "NODE_PATH=D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules\tengits-react-pages\bin\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules\tengits-react-pages\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\node_modules;%NODE_PATH%"
 )
 @IF EXIST "%~dp0\node.exe" (
   "%~dp0\node.exe"  "%~dp0\..\tengits-react-pages\bin\vite-pages.js" %*

package/packages/docs/node_modules/.bin/vite-pages.ps1

@@ -4,14 +4,14 @@ $basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
 $exe=""
 $pathsep=":"
 $env_node_path=$env:NODE_PATH
-$new_node_path="D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules\tengits-react-pages\bin\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules\tengits-react-pages\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\node_modules"
+$new_node_path="D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules\tengits-react-pages\bin\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules\tengits-react-pages\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe\node_modules;D:\reactwork\TengitsCLI\node_modules\.pnpm\node_modules"
 if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
   # Fix case when both the Windows and Linux builds of Node
   # are installed in the same directory
   $exe=".exe"
   $pathsep=";"
 } else {
-  $new_node_path="/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules/tengits-react-pages/bin/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules/tengits-react-pages/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.3_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_dxsk64ib23nvr6ox5tbuj4ul44/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/node_modules"
+  $new_node_path="/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules/tengits-react-pages/bin/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules/tengits-react-pages/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/tengits-react-pages@1.0.6_@babel+core@7.28.4_@babel+template@7.27.2_@types+react@18.3.18_reac_rioscrbvnnmj3kn5wf7ddlr6oe/node_modules:/mnt/d/reactwork/TengitsCLI/node_modules/.pnpm/node_modules"
 }
 if ([string]::IsNullOrEmpty($env_node_path)) {
   $env:NODE_PATH=$new_node_path

package/packages/docs/package.json

@@ -1,38 +1,39 @@
-{
-  "name": "docs",
-  "version": "1.0.2",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "start": "vite serve --host",
-    "build": "rimraf dist && vite build --outDir dist && serve -s dist",
-    "ssr": "rimraf dist && vite-pages ssr && serve dist"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "dependencies": {
-    "@vitejs/plugin-react-swc": "^4.1.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "react-router-dom": "^6.21.3",
-    "styled-components": "^6.1.8"
-  },
-  "devDependencies": {
-    "@mdx-js/react": "^3.0.0",
-    "@types/node": "^20.11.5",
-    "@types/react": "^18.2.48",
-    "@vitejs/plugin-react": "^4.2.1",
-    "rimraf": "^5.0.5",
-    "serve": "^14.2.1",
-    "vite": "^5.0.12",
-    "tengits-theme-doc": "1.0.4",
-    "tengits-react-pages": "1.0.3",
-    "vite-plugin-externals": "^0.6.2",
-    "postcss": "^8.5.3",
-    "tailwindcss": "^3.4.17",
-    "@tailwindcss/forms": "0.5.7",
-    "@tailwindcss/typography": "0.5.13",
-    "tailwindcss-animate": "1.0.7"
-  }
+{
+  "name": "docs",
+  "version": "1.0.2",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "vite serve --host",
+    "build": "rimraf dist && vite build --outDir dist && serve -s dist",
+    "ssr": "rimraf dist && vite-pages ssr && serve dist"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@ant-design/icons": "^6.1.1",
+    "@vitejs/plugin-react-swc": "^4.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-router-dom": "^6.21.3",
+    "styled-components": "^6.1.8"
+  },
+  "devDependencies": {
+    "@mdx-js/react": "^3.0.0",
+    "@tailwindcss/forms": "0.5.7",
+    "@tailwindcss/typography": "0.5.13",
+    "@types/node": "^20.11.5",
+    "@types/react": "^18.2.48",
+    "@vitejs/plugin-react": "^4.2.1",
+    "postcss": "^8.5.3",
+    "rimraf": "^5.0.5",
+    "serve": "^14.2.1",
+    "tailwindcss": "^3.4.17",
+    "tailwindcss-animate": "1.0.7",
+    "tengits-react-pages": "1.0.6",
+    "tengits-theme-doc": "1.0.5",
+    "vite": "^5.0.12",
+    "vite-plugin-externals": "^0.6.2"
+  }
 }

package/packages/docs/pages/_theme.tsx

@@ -8,8 +8,31 @@ export default createTheme({
   logo: <div style={{ fontSize: '20px' }}>{import.meta.env.VITE_PROJECT_NAME}</div>,
   topNavs: [
     { label: '首页', path: '/home', activeIfMatch: '/home' },
-    { label: '产品文档', path: '/projectManage', activeIfMatch: '/projectManage' },
-    { label: '需求文档', path: '/requirements', activeIfMatch: '/requirements' },
+    {
+      label: '架构文档',
+      path: '/architectures',
+      activeIfMatch: '/architectures',
+    },
+    {
+      label: '功能分解',
+      path: '/breakdowns',
+      activeIfMatch: '/breakdowns',
+    },
+    {
+      label: '计划文档',
+      path: '/plans',
+      activeIfMatch: '/plans',
+    },
+    {
+      label: '报告文档',
+      path: '/reports',
+      activeIfMatch: '/reports',
+    },
+    {
+      label: '需求文档',
+      path: '/requirements',
+      activeIfMatch: '/requirements'
+    },
     {
       label: '设计文档',
       path: '/designs',
@@ -39,12 +62,12 @@ export default createTheme({
       label: '会议记录',
       path: '/meetingNotes',
       activeIfMatch: '/meetingNotes',
-    }
+    },
   ],
   sideNavs: (ctx) => {
     return defaultSideNavs(ctx, {
       groupConfig: {
-       
+
       },
     })
   },

package/packages/docs/pages/dataModel/dataModel.md

@@ -102,12 +102,12 @@ order: 2
 ### 关系与约束（Relations & Constraints）
 - 主键：`users(id)`、`user_tags(id)`
 - 唯一约束：`uniq_users_email(email)`
-- 外键：`fk_user_tag_relations(user_id -> users.id, tag_id -> user_tags.id)`
+- 外键：`fk_user_tag_relations(user_id -) users.id, tag_id -) user_tags.id)`
 - 索引：`idx_users_created_at(created_at)`、`idx_users_email(email)`
 - 级联策略：删除用户时仅软删，不级联删除标签关系
 
 ## 索引与性能（Indexes & Performance）
-- 目标：用户列表查询 P95 < 300ms
+- 目标：用户列表查询 P95 ( 300ms
 - 方案：覆盖索引 `idx_users_email`，添加时间维度索引 `idx_users_created_at`
 - 评估：Explain 结果与基数估算、热路径分析
 
@@ -156,13 +156,13 @@ order: 2
 ### 表与字段
 - 表名：`lower_snake_case`，示例：`user_profile`、`order_item`
 - 主键：统一为 `id`
-- 外键：`<ref>_id`，示例：`user_id`
+- 外键：`(ref)_id`，示例：`user_id`
 - 时间：`created_at`、`updated_at`
 
 ### 约束与索引
-- 唯一约束：`uniq_<table>_<columns>`
-- 外键：`fk_<table>_<ref>`
-- 索引：`idx_<table>_<columns>`，覆盖/复合索引按查询设计
+- 唯一约束：`uniq_(table)_(columns)`
+- 外键：`fk_(table)_(ref)`
+- 索引：`idx_(table)_(columns)`，覆盖/复合索引按查询设计
 
 ## 类型与字段规范
 - 文本：优先 `varchar(N)`，避免无界 `text`
@@ -221,6 +221,4 @@ order: 2
   - A：关键字段关系化，非关键/可变字段 JSON 存储
 
 ## 特殊约定
-- 规范、说明、索引类文档文件名以 `$` 结尾
-- 示例：`dataModel$.md`（目录规范/入口文档）
 - 目的：与具体领域模型说明区分，便于路由与检索

package/packages/docs/CLAUDE.md

@@ -1,179 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## 项目概述
-
-这是一个基于 **Monorepo** 架构的 **React 文档站点项目**，专门用于"山西公众出行"项目管理文档。项目使用 `tengits-react-pages` 框架构建，支持 Markdown/MDX 文件自动生成文档页面。
-
-## 项目结构
-
-```
-/mnt/d/reactwork/shanxi/gongzhongchuxing/  # 根目录 (Monorepo)
-├── packages/                    # 包目录
-│   ├── docs/                   # 文档站点 (当前项目)
-│   │   ├── pages/             # 页面内容 (基于文件的路由)
-│   │   │   ├── home/         # 首页相关文档
-│   │   │   ├── requirements/ # 需求文档
-│   │   │   ├── designs/      # 设计文档
-│   │   │   ├── dataModel/    # 数据建模文档
-│   │   │   ├── api/          # 接口文档
-│   │   │   ├── develop/      # 开发文档
-│   │   │   ├── test/         # 测试文档
-│   │   │   ├── meetingNotes/ # 会议记录
-│   │   │   ├── assets/       # 静态资源
-│   │   │   └── logs/         # 日志
-│   │   ├── styles/           # 样式文件
-│   │   └── ...
-│   ├── client/               # 客户端应用 (另一个包)
-│   └── server/               # 服务器端应用 (另一个包)
-├── pnpm-workspace.yaml       # pnpm workspace 配置
-└── package.json              # 根项目配置
-```
-
-## 开发命令
-
-### 在 docs 包中运行
-```bash
-# 开发服务器 (等同于 npm run dev)
-npm start          # 或 pnpm start (运行 vite serve)
-
-# 构建项目
-npm run build      # 运行 vite build --outDir dist
-
-# SSR 构建
-npm run ssr        # 运行 vite-pages ssr
-```
-
-### 使用 pnpm workspace (从根目录)
-```bash
-# 安装所有依赖
-pnpm install
-
-# 启动 docs 开发服务器
-pnpm --filter docs start      # 等同于 pnpm --filter docs dev
-
-# 构建 docs 项目
-pnpm --filter docs build
-
-# SSR 构建 docs 项目
-pnpm --filter docs ssr
-```
-
-**注意**: 根目录 README.md 中提到 docs 项目使用 `pnpm dev` 命令，但在 `package.json` 中实际配置的是 `start` 脚本。两者都指向 `vite serve`。
-
-## 架构说明
-
-### 基于文件的页面路由
-- 使用 `tengits-react-pages` 框架
-- `pages/` 目录下的文件自动生成路由：
-  - `文件名$.md` → `/文件名` 路由
-  - 目录结构映射到 URL 路径
-- 支持 `.md`、`.mdx`、`.tsx` 文件混合使用
-
-### 外部依赖 (CDN)
-- **React 18.2.0**、**React DOM 18.2.0**、**React Router DOM 6.23.1**、**antd 5.25.3**、**tengits-ui5 2.0.0** 通过 CDN 引入
-- CDN 链接在 `index.html` 中定义
-- Vite 配置在 `vite.config.ts` 的 `viteExternalsPlugin` 中声明外部依赖
-- 减小打包体积，提高加载速度
-- 还包含 `dayjs` 和本地化脚本
-
-### 样式系统
-- **Tailwind CSS 3.4.17**:
-  - 配置文件: `tailwind.config.js`
-  - 扫描 `pages/**/*.{md,mdx,js,jsx,ts,tsx}` 文件中的类名
-  - 包含 `tailwindcss-animate`、`@tailwindcss/forms`、`@tailwindcss/typography` 插件
-  - 安全列表包含状态颜色和布局类名
-- **styled-components 6.1.8**: CSS-in-JS 解决方案
-- **PostCSS 8.5.3**: 配置在 `postcss.config.cjs` 中，包含 `tailwindcss` 和 `autoprefixer` 插件
-
-### 类型声明
-- 外部 CDN 依赖的类型声明在 `global.d.ts` 中
-- 声明了 `antd` 和 `tengits-ui5` 模块
-- 提供基本的 TypeScript 支持，避免类型错误
-
-### 主题和导航
-- 导航菜单在 `pages/_theme.tsx` 中配置
-- 顶部导航包含: 首页、需求文档、设计文档、数据建模、接口文档、开发文档、测试文档、会议记录
-- 侧边导航自动根据页面结构生成
-
-## 重要配置文件
-
-1. `package.json` - 项目依赖和脚本
-2. `vite.config.ts` - Vite 构建配置，包含：
-   - `tengits-react-pages` 插件配置
-   - 外部依赖配置 (CDN)
-   - 生产环境源映射启用
-3. `pages/_theme.tsx` - 主题和导航配置
-4. `tailwind.config.js` - Tailwind CSS 配置
-5. `tsconfig.json` - TypeScript 配置
-6. `pnpm-workspace.yaml` - Monorepo 工作区配置
-
-## 导航结构
-
-从 `_theme.tsx` 定义的顶部导航：
-- `/home` - 首页 (包含业务共识、需求背景、设计依据、功能概述等子页面)
-- `/requirements` - 需求文档
-- `/designs` - 设计文档
-- `/dataModel` - 数据建模
-- `/api` - 接口文档
-- `/develop` - 开发文档
-- `/test` - 测试文档
-- `/meetingNotes` - 会议记录
-
-## 文档组织
-
-文档按以下分类组织在 `pages/` 目录下：
-
-1. **首页文档** (`pages/home/`): 业务共识、需求背景、设计依据、功能概述、系统用户、专业名词说明、系统流程设计
-2. **需求文档** (`pages/requirements/`): 系统功能设计、PRD、需求文档
-3. **设计文档** (`pages/designs/`): 设计文档、页面设计
-4. **技术文档** (`pages/api/`, `pages/dataModel/`, `pages/develop/`, `pages/test/`): 接口、数据模型、开发、测试文档
-5. **管理文档** (`pages/meetingNotes/`): 会议记录
-
-## 构建优化
-
-- 生产环境生成源映射 (`sourcemap: true`)
-- 使用 SWC 进行 React 转换 (`@vitejs/plugin-react-swc`)
-- 外部依赖减少打包大小
-- 支持服务端渲染 (SSR) 构建
-
-## 开发注意事项
-
-1. **页面文件命名**: 使用 `文件名$.md` 格式生成路由
-   - `pages/home/1业务共识$.md` → `/home/1业务共识` 路由
-   - `pages/api/api$.md` → `/api` 路由
-   - 目录索引文件使用 `$.mdx` 或 `$.tsx` 作为目录首页
-
-2. **新页面添加**: 在 `pages/` 对应目录下创建 `.md` 或 `.mdx` 文件
-   ```bash
-   # 示例: 在 requirements 目录下添加新需求文档
-   touch "pages/requirements/新需求$.md"
-   ```
-
-3. **导航更新**: 修改 `pages/_theme.tsx` 中的 `topNavs` 数组来更新顶部导航
-
-4. **样式**: 使用 Tailwind CSS 类名或 styled-components
-   - 全局样式在 `styles/tailwind.css` 中定义
-   - Tailwind 配置在 `tailwind.config.js` 中
-
-5. **内容更新**: 直接编辑对应的 Markdown 文件，开发服务器支持热重载
-
-6. **MDX 支持**: 可以在 Markdown 中使用 React 组件
-   ```mdx
-   # 标题
-
-   这是 Markdown 内容
-
-   <MyComponent prop="value" />
-   ```
-
-7. **类型定义**: TypeScript 类型定义在 `global.d.ts` 中
-
-## Monorepo 上下文
-
-当前项目是 `packages/docs`，位于更大的 Monorepo 中：
-- `packages/client` - TTOS 客户端应用
-- `packages/server` - 服务器端应用
-
-使用 `pnpm --filter <包名>` 命令操作特定包。