一、代码生成
菜单入口：基础设施 → 代码生成。
本章介绍代码生成器的使用，以及官方提供的 5 个代码生成案例页。代码生成器基于数据库表结构一键产出前后端代码，是 PointLion Cloud 二次开发提效的核心工具；代码生成案例则用于对照学习每种模板生成的页面形态。
1.1 代码生成
菜单入口：基础设施 → 代码生成。
基于数据库表结构生成前后端完整代码：后端 Controller/Service/Mapper、前端 Vue 页面，以及 SQL 菜单脚本，开发者解压后合入工程即可使用。
页面操作：
- 查询：支持按表名称、表描述、创建时间筛选已导入的表。
- 导入：选择数据源并列出该库中的表，勾选需要的表导入生成配置列表（导入前表需已在数据库建好，建议字段写好注释）。
- 编辑：打开后可配置生成信息与字段信息两大块：
- 生成信息：模块名、业务名、功能名、模板类型等；
- 字段信息：逐字段设置字段描述、Java 类型、是否查询、查询方式、表单展示组件等。
- 删除 / 批量删除：移除不再需要的生成配置（不影响数据库表本身）。
- 同步：数据库表结构变更（加字段、改注释）后，重新读取最新表结构刷新字段信息，避免生成代码与表不一致。
- 预览：不下载直接在线查看将生成的代码内容，用于确认配置是否正确。
- 生成代码：按当前配置打包生成，浏览器下载 zip 代码包。
模板类型说明：
| 模板类型 | 页面形态 | 适用场景 |
|---|---|---|
| 单表（增删改查） | 一张表的查询 + 弹窗表单维护 | 无层级、无明细的普通档案（联系人、台账） |
| 树表（增删改查） | 左侧树 + 列表 | 分类、部门、地区等层级数据 |
| 主子表（标准） | 主表弹窗编辑，子表在弹窗内维护 | 主从结构、子表字段较少 |
| 主子表（ERP） | 编辑页像 ERP 制单，行内编辑明细 | 订单、出入库单等单据类业务 |
| 主子表（内嵌） | 列表下方内嵌子表区域 | 需同时浏览主列表与明细 |
字段信息关键配置：
| 配置项 | 说明 |
|---|---|
| 字段描述 | 列表/表单中的显示名称，默认取数据库注释 |
| Java 类型 | 生成的实体属性类型（String/Integer/LocalDateTime 等） |
| 是否查询 / 查询方式 | 该字段是否作为搜索条件，以及匹配方式（=、LIKE、BETWEEN 等） |
| 表单展示组件 | 文本框、下拉框、单选框、复选框、日期选择、图片上传、富文本等 |
数据变动：数据库表 →（导入）→ 生成配置存储于 infra 模块表 →（生成代码）→ zip 代码包下载到开发者本地，不直接部署到运行环境；生成的菜单 SQL 需在数据库执行并刷新菜单缓存后，前端菜单才会显示。
1.2 代码生成案例
菜单入口：基础设施 → 代码生成案例。
官方使用代码生成器生成的 5 种模板示例页，作为每种模板的"样板间"，在选模板前先来这里看效果，再决定自己的表用哪种模板生成。
1.2.1 单表（增删改查）
菜单入口：基础设施 → 代码生成案例 → 单表（增删改查）。
示例联系人页面。一张表的完整增删改查：搜索、重置、新增、导出、批量删除，行内修改、删除，表单为弹窗。适合无层级、无明细的普通档案类功能。
1.2.2 树表（增删改查）
菜单入口：基础设施 → 代码生成案例 → 树表（增删改查）。
示例分类页面。列表以树形结构展示并支持展开/折叠，另有搜索、重置、新增、导出与行内修改、删除。适合分类、部门、地区等有父子层级的数据维护。
1.2.3 主子表（标准）
菜单入口：基础设施 → 代码生成案例 → 主子表（标准）。
示例学生（课程）页面。主表列表为标准增删改查（搜索、重置、新增、导出、批量删除），点击编辑弹窗内维护子表明细，可新增/删除明细行。适合主从结构、子表字段不多的业务。
1.2.4 主子表（ERP）
菜单入口：基础设施 → 代码生成案例 → 主子表（ERP）。
示例学生（班级）页面。编辑页类似 ERP 制单界面，子表明细在行内直接编辑（新增、批量删除、逐行填写），录单效率高。适合订单、采购/出入库单等单据类业务。
1.2.5 主子表（内嵌）
菜单入口：基础设施 → 代码生成案例 → 主子表（内嵌）。
示例学生（课程）页面。主表列表下方内嵌子表区域，选中主记录即在下方展开其明细。适合需要同时浏览主列表与明细数据的场景。
