MySQL 8 CRM 数据库设计技能

一份面向生产环境的 MySQL 8 CRM（客户关系管理）系统数据库模式设计综合指南。本技能涵盖从核心实体设计到高级模式的全部内容，包括 EAV 自定义字段、多态活动、审计日志以及多租户架构等。

如何使用本技能

本技能由主指南（即本文档）和若干详细参考文档组成。在生成任何 SQL 语句或做出设计决策前，请务必先阅读对应的参考文档。

参考文档

按需查阅 references/ 目录下的以下文件：

核心设计原则

在 MySQL 8 上设计 CRM 数据库时，须始终遵循以下原则：

1. 关系完整性优先。 在数据库层面明确定义 FOREIGN KEY 约束。切勿仅依赖应用层代码来维护参照完整性。

2. 先规范化至第三范式（3NF），再有意识地反规范化。 起点应为第三范式；仅在具备实测性能证据的前提下进行反规范化操作，并须明确记录原因。

3. 统一命名规范。 所有标识符均采用 snake_case；表名使用复数形式（如 contacts、accounts）；外键命名遵循 {被引用单数表名}_id 模式（例如 account_id）；时间戳字段统一命名为 created_at、updated_at、deleted_at。

4. 每张表均需配备基础审计字段。 至少包含：id（BIGINT UNSIGNED AUTO_INCREMENT）、created_at、updated_at；大多数 CRM 表还应额外包含 created_by 和 updated_by。

5. 优先采用软删除而非硬删除。 CRM 数据具有法律效力、合规要求及历史报表价值；请使用 deleted_at（TIMESTAMP NULL）字段，避免直接执行 DELETE 语句。

6. 主键一律使用 BIGINT UNSIGNED。 INT 类型上限约为 21 亿；CRM 中的 activities 和 audit logs 等表增长迅速；BIGINT UNSIGNED 可提供高达 1840 万亿的容量余量。

7. 全局启用 UTF8MB4。 始终指定 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci；客户姓名、备注及通信内容常含国际字符与 emoji。

8. 仅使用 InnoDB 引擎。 所有表均须采用 InnoDB，以获得事务支持、行级锁、外键强制约束及崩溃恢复能力。

9. 时间戳类型选用 DATETIME(3) 或 TIMESTAMP。 对于 CRM 场景中的事件时间（如通话时间、任务截止时间），推荐使用 DATETIME(3)（与时区无关，精度达毫秒）；对于 created_at/updated_at，则推荐使用 TIMESTAMP 并配合 DEFAULT CURRENT_TIMESTAMP 与 ON UPDATE CURRENT_TIMESTAMP。

10. 面向集成而设计。 CRM 系统需对接邮件、营销、计费及客服等工具；对需与第三方系统同步的实体，应添加 external_id 或 external_source 字段。

标准表模板

所有 CRM 表均应遵循以下基础结构：

CREATE TABLE `table_name` (
    `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,

    -- 此处填写实体专属字段 --

    `created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    `deleted_at` TIMESTAMP NULL DEFAULT NULL,
    `created_by` BIGINT UNSIGNED NULL DEFAULT NULL,
    `updated_by` BIGINT UNSIGNED NULL DEFAULT NULL,

    PRIMARY KEY (`id`),
    INDEX `idx_table_name_deleted_at` (`deleted_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

CRM 模式设计工作流程

当用户提出设计 CRM 数据库需求时，请严格按以下顺序执行：

1. 明确范围。 确认所需 CRM 模块：联系人/客户账户、销售漏斗、营销/活动、客服/工单，或以上全部模块。

2. 阅读对应参考文档。 务必首先通读 core-entities.md；再根据已识别模块补充阅读其他相关文档。

3. 先设计实体，后定义关系。 先列出所有表及其字段，再定义外键与关联表。

4. 应用索引策略。 阅读 indexing-and-performance.md，为每个外键、WHERE/JOIN/ORDER BY 中涉及的字段、以及常见查询模式所需的组合索引添加索引。

5. 增加灵活性层。 若用户需要自定义字段功能，请阅读 custom-fields-and-flexibility.md，并从中选择 EAV、JSON 列或混合方案。

6. 添加审计与合规支持。 阅读 audit-and-soft-deletes.md，实施相应粒度的变更追踪机制。

7. 生成迁移脚本。 阅读 migrations-and-seeding.md，输出带版本号、幂等性的迁移 SQL。

8. 审查与验证。 全面检查模式：确认外键是否均已建立索引、NOT NULL 约束是否缺失、默认值是否完备、是否存在孤儿记录风险、是否存在导致全表扫描的查询模式。

值得利用的 MySQL 8 特性

以下 MySQL 8 特性对 CRM 模式设计尤为关键：

• JSON 列：用于存储半结构化数据（如自定义字段、元数据、集成载荷）。详见 custom-fields-and-flexibility.md。
• 生成列（VIRTUAL 或 STORED）：用于提取并索引 JSON 字段中的值。
• 函数索引（MySQL 8.0.13+）：无需显式定义生成列即可对表达式建立索引。
• 多值索引（MySQL 8.0.17+）：高效索引 JSON 数组。
• 通用表表达式（CTE）：适用于组织架构图、客户层级、嵌套分类等递归查询场景。
• 窗口函数：适用于销售漏斗分析（如滚动总计、排名、lead/lag 等）。
• CHECK 约束：在数据库层面执行数据校验。
• DEFAULT 表达式：支持计算型默认值。
• 不可见索引：安全测试索引移除效果。
• 降序索引：优化 ORDER BY ... DESC 查询性能。

快速决策指南