概述
本章以项目内置的 example（案例演示） 模块为例，从数据库建表到前端页面联调，手把手演示开发全流程。学完本章后，您将掌握新增业务模块的标准步骤。
┌──────────┐
│ 1. 建表 │ 创建数据库表（含公共字段）
└────┬─────┘
│
▼
┌──────────┐
│ 2. Model │ 创建数据模型（模型 Trait 复用）
└────┬─────┘
│
▼
┌──────────┐
│ 3. FormRequest │ 创建表单请求验证（BaseRequest）
└────┬─────┘
│
▼
┌──────────┐
│ 4. Service│ 创建业务服务（属性配置 + 钩子）
└────┬─────┘
│
▼
┌──────────┐
│ 5. Controller│ 创建控制器（注解 + 快捷方法）
└────┬─────┘
│
▼
┌──────────┐
│ 6. Route │ 注册路由（routes/api.php）
└────┬─────┘
│
▼
┌──────────┐
│ 7. Menu │ 配置菜单权限（可选）
└────┬─────┘
│
▼
┌──────────┐
│ 8. Frontend│ 前端 API + 页面（[详见第 9 章](/zh/frontend/overview.html)）
└──────────┘| 约定 | 说明 | 示例 |
|---|---|---|
| 表名 | 不含前缀，前缀由 DB_PREFIX 决定（默认 laravel_） | example → 实际 laravel_example |
| 字段名 | 小写下划线 | create_time、user_id |
| 主键 | 统一使用 id，INT 自增 | id INT PRIMARY KEY AUTO_INCREMENT |
| Model | 位于 app/Models/，$table 指定表名 | protected $table = 'example' |
| Service | 继承 BaseService 或 BaseTenantService | class ExampleService extends BaseService |
| Request | 继承 BaseRequest，rules() 声明规则 | class ExampleRequest extends BaseRequest |
| Controller | 位于 app/Http/Controllers/Api/，继承 Controller | class ExampleController extends Controller |
| 权限码 | sys:模块名:操作 | sys:example:add |
| 路由 | routes/api.php，RESTful 风格 | GET /api/example/page |
本章以项目内置的 example（案例演示） 模块为例，完整演示从建表到联调的全过程。该模块是代码生成器的参考模板，涵盖了标准 CRUD 的所有典型场景：
#[Permission] 注解）#[OperationLog] 注解）uniqueFields 属性声明）app/Models/Example.php # 数据模型
app/Http/Requests/ExampleRequest.php # 表单请求验证
app/Services/ExampleService.php # 业务服务
app/Http/Controllers/Api/ExampleController.php # 控制器
routes/api.php # 路由（example 模块 9 条）
# 前端（本仓库 ui/ 目录）：
# ui/src/api/tool/example.ts # 前端 API 模块
# ui/src/views/tool/example/ # 前端页面BaseService + 6 个 Trait 完成；