从业务实体、关系和访问需求形成可评审的表结构，所有新字段必须有详细中文注释。
## 任务目标 请完成 MySQL 业务建模和详细字段设计。 交付能用于评审或后续实施的具体方案、规则与样例；未要求实施的部分不声称已经落地。 ## 输入信息（选填） 两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。 建模业务：从当前需求、页面字段和现有实体识别需要新增或整理的数据对象；留空时优先补齐已有业务表的实体关系与字段字典，不凭空设计新的业务模块。 需求与表结构资料：读取当前工程的实体、DTO、Mapper、迁移 DDL、表注释、查询样例和状态定义，自动确认 MySQL 版本、字符集与迁移方式。 ## 信息不完整时 先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。 ### 优先确认 - 将业务实体、关系、当前状态和历史明细对应到现有表与写入路径。 - 核对主要查询、唯一性、租户或组织范围以及删除和保留行为。 - 读取字段单位、精度、空值、默认值、状态枚举和历史数据兼容约定。 - 从项目配置与迁移脚本确认方言、字符集、排序规则及结构变更方式。 ### 可采用的默认处理 - 默认交付设计与 DDL，不在数据库执行结构变更。 - 复用现有命名、主键、字符集与迁移约定；未确认的唯一性和必填关系不写成生效约束。 - 金额、累计量和未知值保留真实语义；新表和新字段均提供详细中文注释，容量未知用估算条件表达。 ### 必须有依据的事项 - 实体之间的基数、业务唯一性、状态含义或删除保留规则无法确定时，不擅自固化唯一键与约束。 - 金额单位、精度边界或实际存在的租户权限归属不明时，不给可直接落库且可能改变业务含义的字段定义。 只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。 ### 资料仍不足时的交付 - 缺需求细节时先从已有 DDL 交付字段字典、关系疑点与注释补全建议，未确认关系保持候选。 - 既无工程也无业务材料时交付带详细注释的独立建模示例及实体到查询的设计表，注明不是实际业务结构。 ## 执行要求 适用范围：MySQL业务库设计；目标版本、字符集及部署方式以输入为准。DMS流程仅供有相应产品条件的项目采用，自建库可使用现有迁移工具。 上线前审核 SQL；使用 DMS 结构设计时，核对多环境结构一致性。 检查步骤： 1. 先梳理业务实体、实体关系、生命周期和唯一性，区分当前状态、明细记录和历史事实，明确哪些数据必须长期保留，哪些可以归档。 2. 根据真实查询和写入路径确定表的边界，列出需要联查的对象以及是否存在租户或组织隔离；未确认的业务关系不能直接写成唯一键或非空约束。 3. 建立字段字典，说明业务含义、类型长度、单位、精度、是否为空、默认值和枚举值；金额、比例和累计量按业务范围计算精度，未知值不能随意填零。 4. 生成DDL时为每张表写中文注释，并为所有新字段写详细中文COMMENT，包含含义、单位或枚举、空值与默认值语义；禁止只重复字段名充当注释。 5. 把主键、唯一约束及索引分别关联到业务规则和代表性SQL，评估写入成本、历史重复数据及兼容性；不要仅凭字段名称批量添加索引。 6. 给出开发、测试、生产的结构比对与变更顺序，列出旧数据填充、约束生效和回退条件；用新增、修改、删除及边界值样例核对业务能否完整表达。 ## 交付与验收 输出要求：交付实体关系的文字说明、字段字典、带详细中文注释的DDL、索引与查询映射、迁移步骤及验收用例。字段字典与DDL必须逐项对应，资料不足的字段保留待确认说明。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。 ### 本条完成检查 - 实体关系、字段字典和 DDL 逐项一致，全部新字段注释解释含义、单位或编码、空值及默认值。 - 主键、唯一约束和索引分别有业务规则或代表性 SQL 依据。 - 迁移说明历史值填充、约束生效和兼容顺序，新增、修改、删除及边界样例能表达业务。 按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。 ## 参考资料与适用边界 来源（核验日期：2026-09-08）： [腾讯云《云数据库 MySQL 使用规范》](https://intl.cloud.tencent.com/zh/document/product/236/13390?lang=zh) [阿里云《数据管理 DMS：结构设计》](https://help.aliyun.com/zh/dms/design-schemas) 整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。
