Data Space

面向团队协作的 MySQL 查询工作台，强调 SQL 资产沉淀、参数化复用、执行审计，以及更接近编辑器的使用体验。

Overview

Data Space 试图把团队内零散的 SQL 操作沉淀为可复用、可共享、可追踪的查询资产。

它面向的不是一次性脚本执行，而是更长期的团队协作场景：

• 把 SQL 文件沉淀为长期维护的查询资产
• 通过参数化查询降低重复写 SQL 的成本
• 对查询执行历史和结果快照进行留痕
• 提供接近 IDE 的工作台体验，而不是传统表单式后台

Highlights

• 多用户登录与角色管理
• VS Code 风格 SQL 工作台与多标签编辑
• 数据源结构浏览、SQL 自动补全与参数化执行
• SQL 文件管理、查询器导出、查询市场共享
• 查询历史审计、结果回放、收藏与热门查询沉淀
• 系统管理、数据源管理、用户管理

Tech Stack

• Backend: Java 17, Spring Boot 3.3, MyBatis-Plus, JDBC
• Frontend: React 19, TypeScript, Vite, Ant Design 5, Tailwind CSS, Monaco Editor
• Database: MySQL 8
• Desktop: Electron

Repository Layout

• backend: Spring Boot backend modules
• frontend: React web application
• electron: Electron desktop shell
• idea-plugin: IntelliJ IDEA metadata export plugin
• docs: technical design and user guide

Getting Started

Requirements

• JDK 17+
• Node.js 18+
• MySQL 8
• Maven 3.9+

Run backend

在启动前，请先准备好 MySQL 和后端配置。

cd backend
mvn spring-boot:run

默认端口：8089

Run frontend

cd frontend
npm install
npm run dev

默认端口：5173，通过 Vite 代理访问 /api。

Build

Build web app and runnable server jar

bash build.sh

该脚本会构建前端、同步静态资源，并生成可运行的服务端 JAR。

Build Electron app

cd electron
npm install
npm run dist:mac
npm run dist:win

桌面版作为服务端页面的桌面壳使用。请以 electron/config.example.json 为模板创建本地 config.json。

Documentation

• docs/TECHNICAL_DESIGN.md
• docs/USER_GUIDE.md

Project Status

这是当前项目的首个公开版本。部分部署流程、初始化脚本和更完整的外部文档仍在整理中。

如果你对查询资产管理、团队 SQL 协作或桌面数据库工作台这类方向感兴趣，欢迎关注后续演进。

Verification

• Frontend: cd frontend && npm run build
• Backend: cd backend && mvn -q -DskipTests compile
• Electron main process: node -c electron/main.cjs

License

本项目基于 MIT License 开源。