# data2ontology

**Repository Path**: hgy2026/data2ontology

## Basic Information

- **Project Name**: data2ontology
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 11
- **Created**: 2026-03-03
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Data2Ontology 🚀

Data2Ontology 是一个智能化的数据管道构建与本体建模平台。它能够自动连接多种数据源，利用 LLM 进行语义分析，自动生成业务本体（Ontology）和知识图谱，并提供可视化的编辑与导出功能。

## ✨ 核心特性

- **🔌 多数据源支持**:
  - **PostgreSQL**: 完整支持 Schema 选择与元数据提取
  - **MySQL**: 支持 MySQL 8.0+
  - **SQL Server**: 支持企业级 SQL Server 数据库
  - **CSV**: 支持上传 CSV 文件进行快速分析

- **🧠 智能语义分析**:
  - 集成 **LLM (OpenAI/Compatible)** 对表结构和数据样本进行深度理解
  - 自动推断表和列的**业务含义**（即实体和属性的中文名称）
  - 智能识别表与表之间的**语义关系**

- **� 可视化建模与编辑**:
  - **Schema 视图**: 清晰展示实体类型定义，支持**在线编辑**（增删改节点/关系）
  - **知识图谱视图**: 预览生成的数据实例图谱
  - **实时交互**: 点击节点查看详情，右键修改颜色

- **⚡ 实时反馈**:
  - **异步任务处理**: 支持长时间运行的分析任务
  - **实时日志**: 界面实时回显分析进度和 LLM 推理过程

- **🕸️ Neo4j 集成**:
  - 一键连接 Neo4j 数据库
  - 将生成的本体和数据导入 Neo4j 图数据库

## �️ 安装指南

### 前置要求
- Python 3.8+
- Node.js 16+
- (可选) Neo4j Database

### 1. 后端安装

```bash
# 进入项目根目录
cd data2ontology

# 安装 Python 依赖
pip install -r requirements.txt
```

### 2. 前端安装

```bash
# 进入前端目录
cd web

# 安装 NPM 依赖
npm install
```

### 3. 配置环境变量 (LLM)

复制 `.env.example` 为 `.env` 并配置 LLM 信息（用于语义分析功能）：

```bash
cp .env.example .env
```

编辑 `.env` 文件：

```ini
# LLM 配置
OPENAI_API_KEY=sk-your-api-key
OPENAI_API_BASE=https://api.openai.com/v1
LLM_MODEL=gpt-4o-mini
LLM_TEMPERATURE=0.3
```

## 🚀 快速开始

### 1. 启动后端服务

```bash
# 在项目根目录
python server.py
# 服务将启动在 http://localhost:8000
```

### 2. 启动前端界面

```bash
# 在 web 目录
npm run dev
# 访问 http://localhost:5173
```

### 3. 使用流程

1.  **数据接入**: 在「数据接入」页面配置数据库连接或上传文件。
![数据接入](./assets/数据接入.png)
2.  **本体建模**:
    - 进入「本体建模」页面
    - 选择数据源和要分析的表
    - 点击 **「生成 Schema」**
    - 观察实时日志，等待分析完成
![本体建模](./assets/本体建模.png)
3.  **图谱编辑**:
    - 在生成的 Schema 视图中，使用右侧面板或上方按钮添加/修改节点和关系。
4.  **导出/集成**:
    - 查看生成的 JSON 定义
    - (后续支持) 导出到 Neo4j

## 📂 项目结构

```
data2ontology/
├── server.py              # FastAPI 后端入口
├── src/                   # 后端核心代码
│   ├── adapters/          # 数据库适配器
│   ├── models/            # Pydantic 数据模型
│   ├── semantic_analyzer.py # LLM 语义分析
│   └── ontology_generator.py # 本体生成逻辑
├── web/                   # React 前端项目
│   ├── src/
│   │   ├── pages/         # 页面组件
│   │   └── services/      # API 调用
│   └── vite.config.js     # 前端构建配置
├── requirements.txt       # Python 依赖
└── README.md              # 项目文档
```

## 📄 许可证

MIT License