模块、表单、虚拟表

这是 xly 元数据模型中的三个核心名词。理解它们，就能读懂框架其余部分。代码库中的词汇并不总是一致：同一概念在不同文件里有不同名字；本页的一部分工作就是统一这些同义词。

模块

系统中“一个可配置对象”的单位。

• gdsmodule 中每个模块一行。
• 携带 URL 片段（sName）、显示名（sChinese、sEnglish、sBig5）、树位置（sParentId、sAllId）、产品版本（sVersionFlowId，见切片 2），以及可选 CRUD 存储过程名（sSaveProName、sDeleteProName、sProcName、sCalcProName、sSaveProNameBefore）。
• 当前实时 DB 中有 1,358 行。

Java 代码库把这个概念叫作 “module”、“model”、“models” 和 “modle”（常见拼写错误）。变量 sModelsId 和方法 getModelConfigByModleId 虽然命名如此，实际都接收模块 sId。见切片 1中的命名提醒。

表单

模块的屏幕布局：表头 + N 个字段定义。

• Master： gdsconfigformmaster 中每个表单一行。携带支撑对象（sTbName）、支撑对象类型（sType ∈ {table, view, proc}）、默认 SQL 片段（sSqlStr、sWhere、sOrder）、表格行为（bGrd、iPageSize）和权限列。
• Slave： gdsconfigformslave 中每个字段一行。携带字段名（sName，匹配支撑对象中的列）、控件类型（sControlName）、显示标签、校验规则、默认值、下拉 SQL、按钮指令。
• 模块通过 gdsconfigformmaster.sParentId = gdsmodule.sId 连接到表单，这是语义 FK，不强制。（注意：gdsmodule.sFormId 虽然存在，但多数模块为空，且不是规范连接。）
• 当前实时 DB 中有 2,022 个 master 行、159,371 个 slave 行。

表单是用户可见的产物：当 PM 在后台中“创建页面”时，实际是在 INSERT 一个 gdsconfigformmaster 行和 5 到 50 个 gdsconfigformslave 行。

虚拟表

xly 对“由元数据定义的表”的术语和表前缀。它不是 CREATE TABLE 语句创建的真实表，而是元数据声明的“表”。

• gdsconfigtbmaster 中每个虚拟表一行。
• gdsconfigtbslave 中每个虚拟列一行。
• 当前实时 DB 中有 307 个 master 行、14,385 个 slave 行。

虚拟表让 PM 能声明“我想要这种形状的东西”，不必直接找工程师。多数虚拟表最终映射到真实物理表（框架支持迁移步骤，或预创建通用“宽表”供 PM 填充），但运行时看到的抽象是元数据声明，而不是底层存储。

这不同于数据库视图：虚拟表是元数据；视图是 CREATE VIEW SQL 对象。两者都可以支撑表单（通过 gdsconfigformmaster.sType = 'table' 或 'view'）。视图支撑的情况见切片 3。

它们如何组合

gdsmodule  （模块，1 行）
   └── （通过 sParentId 连接）
       gdsconfigformmaster  （表单 master，每个表单 1 行）
          ├── gdsconfigformslave  （字段，N 行）
          ├── gdsconfigformcustomslave  （每租户字段，N 或 0）
          └── gdsconfigformuserslave    （每用户微调，N 或 0）

gdsmodule.sName   →  gdsroute 中注册的路由（URL 白名单）
gdsmodule.sFormId →  （大多为空，历史字段）

每个表单恰好有一个模块。每个模块应该最多有一个表单，但少数模块有多个 gdsconfigformmaster 行指向同一 sParentId，表示带多个面板或子 tab 的页面。

三个名词，一个引擎

运行时（BusinessBaseController 和 BusinessBaseServiceImpl，见切片 1）知道如何渲染任意模块 / 表单 / 虚拟表组合。不存在每模块专用 Java 代码。PM 创建新模块是在创建新行，不是在创建新代码路径。