签入版本

EasyGoAdmin_Gin_Layui/zh/generator/demo.md

@@ -0,0 +1,74 @@
+# 10.8 实战案例
+
+:::tip 概述
+以「案例演示」模块为例，演示代码生成器的完整使用流程。
+:::
+
+## 第 1 步：建表
+
+```sql
+CREATE TABLE think_example (
+    id INT PRIMARY KEY AUTO_INCREMENT,
+    name VARCHAR(200) NOT NULL COMMENT '案例名称',
+    type TINYINT(1) DEFAULT 0 COMMENT '案例类型',
+    status TINYINT(1) DEFAULT 0 COMMENT '案例状态',
+    sort INT DEFAULT 0 COMMENT '排序',
+    avatar VARCHAR(500) DEFAULT '' COMMENT '头像',
+    is_delete TINYINT(1) DEFAULT 0,
+    create_user VARCHAR(50) DEFAULT '',
+    create_time DATETIME,
+    update_user VARCHAR(50) DEFAULT '',
+    update_time DATETIME
+);
+```
+
+## 第 2 步：代码生成器操作
+
+1. 进入「工具管理 → 代码生成」
+2. 找到 `think_example` 表
+3. 配置：
+   - 模块名：`example`
+   - 功能名：`案例演示`
+   - 作者：`admin`
+   - 是否导入导出：是
+4. 点击「预览」查看生成代码
+5. 点击「生成」创建文件
+
+## 第 3 步：生成的文件
+
+```text
+app/controller/ExampleController.php    # 控制器
+app/logic/ExampleLogic.php              # 业务逻辑
+app/model/Example.php                   # 数据模型
+app/validate/ExampleValidate.php        # 验证器
+ui/src/api/tool/example.ts              # 前端 API
+ui/src/views/tool/example/index.vue     # 列表页
+ui/src/views/tool/example/edit.vue      # 编辑弹窗
+ui/src/views/tool/example/detail.vue    # 详情弹窗
+ui/src/views/tool/example/columns.ts    # 表格列配置
+ui/src/views/tool/example/querySchemas.ts # 查询表单配置
+```
+
+## 第 4 步：后续操作
+
+生成完成后，以下内容已自动创建：
+
+| 项目 | 状态 | 说明 |
+|------|------|------|
+| 路由 | ✅ 自动注册 | `route/app.php` 中已插入 CRUD 路由组 |
+| 菜单 | ✅ 自动创建 | 主菜单和权限节点已创建 |
+| 字典 | ✅ 自动创建 | 带选项的字段已创建字典和字典项 |
+
+通常还需要手动调整：
+
+1. 根据业务需求调整 Logic 属性配置（如 `pageLikeFields`、`pageEqFields`）
+2. 补充自定义钩子（如 `beforeDelete`、`afterDetail` 等）
+3. 在菜单管理中调整菜单排序和图标
+
+:::tip 生成后调整
+生成的代码是基础骨架，通常需要：
+- 调整 Logic 的查询条件配置
+- 添加删除前校验（beforeDelete）
+- 补充详情后的关联数据（afterDetail）
+- 配置文件字段和富文本字段
+:::