# big-data-platform

**Repository Path**: greatmax/big-data-platform

## Basic Information

- **Project Name**: big-data-platform
- **Description**: 大数据中台，go语言开发练手
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-06-16
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# big-data-platform

开源对标阿里云 **DataWorks** 的大数据开发治理平台（DataWorks-Go）。

| 模块 | 技术 |
|------|------|
| 后端 API | Go 1.22 · Gin · GORM |
| 前端控制台 | Vue 3 · TypeScript · Arco Design |
| 开发数据库 | SQLite（`data/platform.db`） |
| 生产规划 | PostgreSQL · Redis · Kafka · ClickHouse |

## 目录结构

```
big-data-platform/
├── cmd/server/          # API 服务入口
├── internal/            # 业务逻辑（handler / model / store / auth）
├── web/                 # 前端控制台（Vue3）
├── docs/                # 产品 & API & 库表文档
├── deploy/              # Docker Compose 与初始化 SQL
├── scripts/               # 开发脚本
└── data/                # 本地运行时数据（git 忽略）
```

## 快速开始

### 1. 启动后端

```powershell
$env:PORT="8082"
go run ./cmd/server
```

或使用脚本：

```powershell
.\scripts\restart.ps1
```

- API：`http://localhost:8082/api/v1/health`
- 默认账号：`admin` / `admin123`

### 2. 启动前端

```powershell
cd web
npm install
npm run dev
```

浏览器打开：**http://localhost:5173**

### 3. 生产构建

```powershell
cd web && npm run build
cd .. && $env:PORT="8082" && go run ./cmd/server
# 访问 http://localhost:8082
```

## 文档

| 文档 | 说明 |
|------|------|
| [docs/部署指南.md](docs/部署指南.md) | **部署指南（必读）** |
| [docs/开发进度.md](docs/开发进度.md) | 开发进度与完成状态 |
| [docs/业务功能说明.md](docs/业务功能说明.md) | 功能清单（对标 DataWorks） |
| [docs/API.md](docs/API.md) | 接口契约 |
| [docs/数据库设计.md](docs/数据库设计.md) | 库表设计 |
| [docs/落地方案.md](docs/落地方案.md) | 分期落地方案 |

## 中间件说明

**平台运行只需一个元数据库**：PostgreSQL（推荐）或 SQLite。  
Redis / Kafka / ClickHouse **不是启动必要条件**；`deploy/docker-compose.yml` 中的全套中间件仅作可选演示。

测试环境部署见 [docs/部署指南.md](docs/部署指南.md)。

## 环境变量

| 变量 | 默认 | 说明 |
|------|------|------|
| `PORT` | `8080` | HTTP 端口 |
| `DB_PATH` | `data/platform.db` | SQLite 路径 |
| `DATABASE_URL` | — | PostgreSQL 连接（设置后优先于 SQLite） |
| `APP_NAME` | `DataWorks-Go` | 产品名称 |
| `JWT_SECRET` | 内置开发密钥 | JWT 签名（生产必改） |
| `ENCRYPTION_KEY` | 内置开发密钥 | 数据源凭证加密（生产必改） |

## 仓库

- Gitee：https://gitee.com/greatmax/big-data-platform

## License

MIT