定义模型并生成页面

从零到一套可用的系统页面——定义模型的完整路径：字段、类型、关联、DDL 预览、发布。

本文说明什么

本文完整走一遍「定义模型 → 生成页面 → 成为可用的真实系统」的路径。具体按钮名、菜单位置以实际实例界面为准——重点说明每一步在确认什么，避免在「影响真实数据」的环节出现误操作。

进入模型的创建入口，命名模型（如「商品」「订单」）。平台通常要求给模型起内部标识（code）与对外名称，并选择它归属于哪个业务。

逐个添加字段，每个字段要回答三件事：

关联引用是另一张表（例如订单引用客户）。建议在模型阶段就声明，后面做列表、详情时平台才能自动翻译成名称显示。

提交前，平台先生成一份建表结构预览——只读展示「如果正式创建，会生成什么样的数据表」。这一步不落库、完全可逆。

确认无误后发布。发布 = 模型真正落库，它会直接变更数据库结构——涉及删除字段 / 修改字段类型等破坏性变更时，请先在预览充分验证；正式发布需管理员权限并二次确认。

⚠️ 要点：预览与发布是两回事。只有「发布」会真正改变系统结构，操作前务必先完成预览确认。 ⚠️ 破坏性变更：删除字段会把该字段的历史数据一并移除且不可恢复；正式环境执行删除类操作前，请先确认范围并做好备份。

发布后，该模型的列表、查询、表单、详情基本自动可用。回到配置一个通用管理列表按业务调：列、搜索、操作按钮、必填校验。

造一条真实样例数据走一遍「新增 → 搜索 → 详情 → 编辑」，确认字段显示、校验、关联翻译都符合预期，再交付给业务使用。

字段类型还能不能改？ 越小越早的改动越容易；涉及数据迁移的大改动（换类型、拆列）成本高。所以「第 3 步预览」反复看，比发布后反复改划算。

能直接从一张 Excel / 现有表导入吗？ 面向已有数据起步时，平台支持从外部结构引导建模型，避免把已有字段手工重敲一遍（具体以实例能力为准）。

模型和视图一定要分开配吗？ 发布后的默认视图足够常规使用；要做得更好用，再按管理列表配置细化。先跑通，再打磨。