列表分页与页面布局（代码生成）
适用范围
本文说明 mms-gen 代码生成 产出的管理端列表/树/单页表单在与 mms-admin + mms-ui 联调时的约定，尤其是 formLayout 与接口形态。实现细节以当前 mms 仓库生成模板与 Controller 为准。
列表分页
- 标准列表接口多为
POST …/list，响应为分页结构（如rows、total），与mms-ui表格组件的数据源约定一致。 - 具体路径与权限标识以生成物及菜单 SQL 中的
permission为准（常见模式：模块:资源:list、query、insert、edit、delete等）。
表单布局 formLayout
生成器在表配置中通过 formLayout 区分页面形态（数值以生成器/库表定义为准）：
| 值 | 形态 | 列表数据 | 单条查询 | 写操作要点 |
|---|---|---|---|---|
| 1 | 列表 + 弹窗/抽屉维护 | POST …/list（分页） | GET …/{id} | 常规 CRUD |
| 2 | 树表 | POST …/list（树形列表，非分页表格语义时以模板为准） | GET …/{id} | 同左，多在树节点上维护 |
| 3 | 单表单页（无独立列表） | 无 list | GET …/singleton | PUT …/singleton；不提供与 singleton 冲突的 GET /{id} 路由约定 |
单表单布局下，前端不应再请求不存在的 list；详情与保存均走 singleton 语义，避免路径与「按主键查单条」混淆。
联调注意
- Base URL：以
mms-ui环境变量VITE_APP_BASE_API为准。 - 权限：
@SaCheckPermission与菜单/按钮的permission字符串须一致。 - 字典与导出：列表字典翻译、导入导出行为见生成模块与站内 /mms-admin/import、/mms-admin/export 等专题（对应运行模块为
mms-admin）。
更多生成流程与排查步骤见主工程 MMS 开发规范（mms-kills / 代码生成章节）。