Database Designer

🗄️ 数据库设计器

根据业务需求，生成规范的 MySQL ERD + DDL + Java Entity 代码

核心能力

工作流程

Step 1：收集业务信息

请提供以下信息（尽量完整，可以只有部分）：

业务模块：____
核心实体：____（如：用户、订单、商品）
主要关系：____（如：一个用户有多个订单）
查询场景：____（如：按时间查订单、按分类查商品）
数据量预估：____（如：订单表预估1000万条）
特殊需求：____（如：支持软删除、历史数据分区）

Step 2：生成 ERD（Mermaid 格式）

用户 → 订单（1对多）
用户 → 收货地址（1对多）
订单 → 订单明细（1对多）
商品 → 订单明细（多对多，通过中间表）

erDiagram
    USER {
        bigint id PK
        varchar username
        varchar phone
        varchar email
        tinyint status
        datetime create_time
        datetime update_time
    }
    ORDER {
        bigint id PK
        bigint user_id FK
        varchar order_no
        decimal total_amount
        tinyint status
        datetime create_time
    }
    USER ||--o{ ORDER : places
    ORDER }o--|| USER : belongs_to

Step 3：生成 MySQL DDL

-- 用户表
CREATE TABLE `sys_user` (
    `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',
    `username` VARCHAR(50) NOT NULL COMMENT '用户名',
    `phone` VARCHAR(20) DEFAULT NULL COMMENT '手机号',
    `email` VARCHAR(100) DEFAULT NULL COMMENT '邮箱',
    `status` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-禁用 1-正常',
    `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    PRIMARY KEY (`id`),
    UNIQUE KEY `uk_username` (`username`),
    KEY `idx_phone` (`phone`),
    KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

-- 订单表
CREATE TABLE `crm_order` (
    `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',
    `user_id` BIGINT UNSIGNED NOT NULL COMMENT '用户ID',
    `order_no` VARCHAR(32) NOT NULL COMMENT '订单号',
    `total_amount` DECIMAL(12,2) NOT NULL DEFAULT 0.00 COMMENT '订单总额',
    `status` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：1-待支付 2-已支付 3-已完成 4-已取消',
    `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    PRIMARY KEY (`id`),
    UNIQUE KEY `uk_order_no` (`order_no`),
    KEY `idx_user_id` (`user_id`),
    KEY `idx_status` (`status`),
    KEY `idx_create_time` (`create_time`),
    CONSTRAINT `fk_order_user` FOREIGN KEY (`user_id`) REFERENCES `sys_user` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单表';

Step 4：生成 Java Entity

package com.fehorizon.crm.entity;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;

@Data
@TableName("crm_order")
public class CrmOrder {

    @TableId(type = IdType.AUTO)
    private Long id;

    @TableField("user_id")
    private Long userId;

    @TableField("order_no")
    private String orderNo;

    @TableField("total_amount")
    private BigDecimal totalAmount;

    @TableField("status")
    private Integer status;

    @TableField(value = "create_time", fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

规范化检查清单

1NF - 原子性

2NF - 消除部分依赖

3NF - 消除传递依赖

BCNF - 主键分解

索引优化策略

组合索引列顺序规则

根据查询频率确定列顺序：
1. 等值查询的列 → 放最前面
2. 范围查询的列 → 放最后面
3. ORDER BY 的列 → 尽量包含

示例：

-- 常见查询：WHERE status = ? AND create_time > ? ORDER BY create_time
CREATE INDEX idx_status_time ON orders (status, create_time);
-- ✅ status 等值放前，create_time 范围+排序放后

索引类型选择

避免的索引陷阱

命名规范

表命名

字段命名

索引命名

idx_字段名1_字段名2    -- 普通索引
uk_字段名              -- 唯一索引
fk_附表_主表           -- 外键索引
pk_表名                -- 主键（一般用PRIMARY KEY）

零停机迁移（Expand-Contract）

场景：给 users 表加一个唯一字段 unique_code

Phase 1 - Expand（添加新结构）：

-- 1. 加一个新列（允许NULL）
ALTER TABLE users ADD COLUMN new_code VARCHAR(64) DEFAULT NULL COMMENT '唯一标识';

-- 2. 批量回填数据（分批，避免锁表）
UPDATE users SET new_code = UUID() WHERE id BETWEEN 1 AND 1000;
-- 重复分批直到全部完成

-- 3. 加唯一约束
ALTER TABLE users ADD UNIQUE KEY `uk_new_code` (`new_code`);

-- 4. 改为 NOT NULL（可选）
UPDATE users SET new_code = id WHERE new_code IS NULL;
ALTER TABLE users MODIFY COLUMN new_code VARCHAR(64) NOT NULL;

Phase 2 - Contract（切换并清理）：

-- 5. 确认应用已改完，开始使用 new_code

-- 6. 删除旧列（如需）
ALTER TABLE users DROP COLUMN old_code;

输出格式选项

使用提示

• 直接描述业务场景，如"设计一个客户管理模块，包含客户、商机、跟进记录"
• 可以粘贴现有表结构，让 AI 分析规范化问题和优化建议
• 可以指定数据库：MySQL / PostgreSQL / Oracle（MySQL 为默认）
• 需要生成 Java 代码时，加上"生成Entity"

一句话原则

好的数据库设计 = 业务清晰 + 结构规范 + 性能友好。 ERD 是给人类看的图，DDL 是给机器看的规则，Entity 是连接两者的桥梁。