# enterprise-nl2sql-platform

**Repository Path**: test-dev-qa/enterprise-nl2sql-platform

## Basic Information

- **Project Name**: enterprise-nl2sql-platform
- **Description**: 企业级NL2SQL项目：  
六大核心能力，覆盖数据分析全流程 1. 智能查询 —— NL2SQL 零代码交 2. 知识图谱 —— 让数据关系一目了然 3. 语义配置 —— 给 AI 装上《业务词典》 4. 记忆系统 —— AI 越用越懂你 5. 多数据源统一接入 —— 10+ 数据库即插即用 6. 数据可视化 —— 图表即所得
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业级 NL2SQL 智能数据分析平台

这是一个可部署的企业级 NL2SQL 项目原型，覆盖智能查询、知识图谱、语义配置、记忆系统、多数据源统一接入、数据可视化六大核心能力。

## 技术栈

- 前端：React 18、TypeScript、Vite、Recharts、Lucide Icons
- 后端：Node.js、Express
- 部署：单体部署，Express 托管 API 与前端构建产物

## 功能模块

- 工作台：核心 KPI、能力入口、最近问数、记忆与治理状态
- 智能查询：自然语言提问、SQL 生成、SQL 安全链路、表格与图表结果
- 问答库：团队高频问题、已验证问题复用
- 知识图谱：Schema 表关系、字段信息、指标血缘
- 语义配置：指标、维度、业务词典、SQL 模板
- 数据模型：主题域、质量健康度、核心指标血缘
- 数据源：10+ 数据库类型、连接测试、元数据同步入口
- 可视化：指标卡、趋势图、排行图、占比图、图表配置

## 本地开发

```bash
npm install
npm run dev
```

开发地址：

- 前端：http://localhost:5177
- API：http://localhost:4177/api/health

## 生产部署

```bash
npm install
npm run build
npm start
```

生产地址：

- http://localhost:4177

可通过环境变量指定端口：

```bash
PORT=8080 npm start
```

Windows PowerShell：

```powershell
$env:PORT=8080; npm start
```

## Docker 部署

```bash
docker build -t enterprise-nl2sql-platform .
docker run -p 4177:4177 enterprise-nl2sql-platform
```

## API 摘要

- `GET /api/overview` 工作台数据
- `POST /api/query` NL2SQL 查询
- `GET /api/query/history` 查询历史
- `GET /api/graph` 知识图谱
- `GET /api/semantic` 语义配置
- `POST /api/semantic/metrics` 新增指标
- `GET /api/data-sources` 数据源列表
- `POST /api/data-sources/test` 数据源连接测试
- `GET /api/data-model` 数据模型
- `GET /api/dashboard` 可视化数据

## 二次开发方向

- 将 `server/mockData.js` 替换为真实元数据库、图数据库和审计库
- 在 `server/index.js` 中接入企业 LLM、向量检索和真实数据库 Connector
- 增加 RBAC、行列级权限、SQL 成本预估和慢查询拦截
- 将语义配置持久化到 PostgreSQL 或 MySQL
- 将知识图谱关系存储到 Neo4j、NebulaGraph 或 JanusGraph