# ldesign-database-designer

**Repository Path**: ldesign-v1/ldesign-database-designer

## Basic Information

- **Project Name**: ldesign-database-designer
- **Description**: ????????? - ER????SQL????
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @ldesign/database-designer

数据库可视化设计器，支持 ER 图编辑、表结构设计、SQL 查询构建和数据模型管理。

## ✨ 特性

- 📊 **ER 图编辑** - 拖拽式实体关系图绘制，支持一对一/一对多/多对多关系
- 🗃️ **表结构设计** - 可视化建表：字段名、类型、长度、约束、默认值、注释
- 🔗 **外键关系** - 可视化外键关联线，自动路由避免交叉
- 🔍 **SQL 查询构建器** - 拖拽式 SQL 查询编排，支持 JOIN/WHERE/GROUP BY/ORDER BY
- 📐 **自动布局** - 智能表位置排列，最小化关系线交叉
- 🔄 **正向工程** - 从 ER 图生成 DDL 建表语句（MySQL/PostgreSQL/SQLite/Oracle）
- 🔃 **逆向工程** - 从 DDL/SQL 文件解析生成 ER 图
- 📋 **表结构对比** - 两个数据库 Schema 的 Diff 对比，生成迁移脚本
- 📝 **数据字典** - 自动生成数据字典文档（Markdown/HTML/PDF）
- 🎨 **主题分组** - 表按模块/业务域颜色分组
- 📏 **索引管理** - 可视化索引配置（主键/唯一/普通/全文）
- 💾 **导入导出** - 支持 JSON Schema、DBdiagram、PDManer 等格式互转
- 🖨️ **导出图片** - 导出 SVG/PNG/PDF 格式 ER 图
- ⌨️ **快捷键** - 高效键盘操作
- 🌓 **主题切换** - 亮色/暗色主题

---

## 📦 安装

```bash
pnpm add @ldesign/database-designer
```

## 🚀 快速开始

```typescript
import { DatabaseDesigner } from '@ldesign/database-designer';

const designer = new DatabaseDesigner({
  container: '#designer-container',
  dialect: 'mysql',  // 'mysql' | 'postgresql' | 'sqlite' | 'oracle'
});

// 添加表
designer.addTable({
  name: 'users',
  columns: [
    { name: 'id', type: 'BIGINT', primaryKey: true, autoIncrement: true },
    { name: 'username', type: 'VARCHAR(50)', nullable: false, unique: true },
    { name: 'email', type: 'VARCHAR(100)', nullable: false },
    { name: 'created_at', type: 'DATETIME', default: 'CURRENT_TIMESTAMP' },
  ],
});
```

---

## 📁 项目结构

```
database-designer/
├── packages/
│   ├── core/          # 核心库 @ldesign/database-designer
│   │   └── src/
│   │       ├── core/       # 设计器引擎
│   │       ├── dialects/   # SQL 方言适配（MySQL/PG/SQLite/Oracle）
│   │       ├── layouts/    # ER 图布局算法
│   │       ├── parsers/    # DDL 解析器
│   │       ├── generators/ # SQL/文档生成器
│   │       ├── utils/      # 工具函数
│   │       └── types/      # TypeScript 类型
│   └── vue/           # Vue 组件 @ldesign/database-designer-vue
├── playground/        # 演示应用
└── README.md
```

## 📄 License

MIT