签入版本

RXThinkCMF_Laravel13_AntdVue/zh/guide/code-list.md

@@ -8,13 +8,13 @@
 
 | 文件路径 | 说明 | 核心内容 |
 |----------|------|----------|
-| `app/model/Example.php` | 数据模型 | 继承 BaseModel，声明表名 `example` |
-| `app/validate/ExampleValidate.php` | 验证器 | name 字段必填，add/update 场景 |
-| `app/logic/ExampleLogic.php` | 业务逻辑 | 属性配置 + import/export 方法 |
-| `app/controller/ExampleController.php` | 控制器 | 9 个接口（page/list/detail/add/update/delete/batchDelete/import/export） |
-| `route/app.php` | 路由 | 第 371~383 行，9 条路由 |
+| `app/Models/Example.php` | 数据模型 | `$table='example'` + `HasAuditColumns` / `SoftDeletesByFlag` Trait |
+| `app/Http/Requests/ExampleRequest.php` | 表单请求验证 | name 必填等格式规则 + 中文错误消息 |
+| `app/Services/ExampleService.php` | 业务服务 | 属性配置（查询/唯一/字典）+ 4 个 Trait + import/export |
+| `app/Http/Controllers/Api/ExampleController.php` | 控制器 | 9 个接口（page/list/detail/add/update/delete/batchDelete/export/import） |
+| `routes/api.php` | 路由 | example 模块 9 条路由（认证中间件组内） |
 
-## 前端文件清单
+## 前端文件清单（本仓库 `ui/` 目录）
 
 | 文件路径 | 说明 |
 |----------|------|
@@ -29,16 +29,19 @@
 
 | 对象 | 说明 |
 |------|------|
-| `think_example` 表 | 案例演示数据表 |
+| `laravel_example` 表 | 案例演示数据表（模型 `$table='example'`，前缀由 `DB_PREFIX` 拼接） |
 
 ## 权限节点
 
 | 权限码 | 说明 |
 |--------|------|
 | `sys:example:page` | 案例演示分页列表 |
+| `sys:example:list` | 案例演示列表 |
+| `sys:example:detail` | 案例演示详情 |
 | `sys:example:add` | 添加案例演示 |
 | `sys:example:update` | 修改案例演示 |
 | `sys:example:delete` | 删除案例演示 |
+| `sys:example:batchDelete` | 批量删除案例演示 |
 | `sys:example:import` | 导入案例演示 |
 | `sys:example:export` | 导出案例演示 |
 
@@ -46,14 +49,40 @@
 
 | 字典编码 | 说明 | 字典项 |
 |---------|------|--------|
-| `example_type` | 案例类型 | 按实际配置 |
-| `example_status` | 案例状态 | 0=禁用, 1=启用 |
+| `example_type` | 案例类型 | 按实际配置（1-4） |
+| `example_status` | 案例状态 | 1=在用, 2=停用 |
+
+对应 Service 配置：
+
+```php
+protected array $serializeMaps = [
+    'status' => 'example_status',   // 读取时补 statusText
+];
+```
+
+## 涉及的基类与 Trait
+
+| 文件 | 作用 |
+|------|------|
+| `app/Http/Controllers/Controller.php` | 控制器基类（`_page` 等快捷方法 + 响应封装） |
+| `app/Http/Requests/BaseRequest.php` | 请求基类（统一失败响应） |
+| `app/Services/BaseService.php` | 服务基类（全部声明式属性 + 占位方法） |
+| `app/Services/Concerns/HasCrudOperations.php` | CRUD 主流程 + 钩子 + 事务 |
+| `app/Services/Concerns/HasQueryScopes.php` | 查询构建 + 排序白名单 |
+| `app/Services/Concerns/HasSerializeMaps.php` | 字典翻译 |
+| `app/Services/Concerns/HasUniqueCheck.php` | 唯一性校验 |
+| `app/Services/Concerns/HasConfigValueProcessing.php` | 配置项 value 按类型处理（文件迁移 / valueList） |
+| `app/Models/Concerns/SoftDeletesByFlag.php` | 软删除 |
+| `app/Models/Concerns/HasAuditColumns.php` | 审计字段 |
+| `app/Attributes/Permission.php` / `OperationLog.php` | 权限 / 日志注解 |
 
 ## 代码生成器替代方案
 
 example 模块本身就是代码生成器的参考模板。如果需要生成类似模块：
 
-1. 建好数据库表
-2. 访问代码生成器页面
-3. 选择表，点击生成
-4. 自动创建 Controller / Logic / Model / Validate / 前端文件
+1. 建好数据库表（见 [3.2 数据库建表](/zh/guide/database.html)）
+2. 访问「开发工具 → 代码生成」页面（父菜单 id=189），或执行 `php artisan generate:code {表名}`
+3. 选择表，配置菜单挂载点与应用名
+4. 自动创建 Model / FormRequest / Service / Controller / 路由 / 菜单权限 / 前端文件
+
+详见 [第 10 章 代码生成器](/zh/generator/overview.html)。