表单、字段、选项与数据映射

从真实定义开始

修改表单或读写字段前先确认租户、应用、formId、字段 ID、物理列和选项。使用 Discovery 读取定义，不能从页面标题、历史样例或实体建议反推物理协议。

关键类型

类型	使用规则
单选、多选	提交真实选项 field，展示 label 只用于界面
开关	使用真实 activeId/inactiveId；元数据采用数值型开关值
关联	传真实目标记录 ID，按当前合同构造数组或关联结构
上传	完成业务文件上传后使用正式文件结构，单文件也遵循数组协议
系统字段	由平台保护，不用前端伪造创建者、归属和审计值

undefined、省略字段与显式 null 的语义不同。修改映射时保留“未修改”与“明确清空”的区别，不用全量空值覆盖已有记录。

治理与接入步骤

1. 读取表单定义和组件模板，记录版本与现有稳定 ID。
2. 增量合并需要调整的组件，保留未涉及组件和选项 field。
3. 写前执行严格合同校验，结构变更走聚合表单治理入口。
4. 写后回读定义及物理合同，核对数量、ID、标题与选项。
5. 在 repository/mapper 中统一映射页面模型，action 按真实协议写入并回读。

已有外部表的元数据修补与新字段创建不是同一操作；不直接 SQL 修改 Duogex 元数据，也不在页面做猜测性字段降级。