# data-portal

**Repository Path**: xmh3000/data-portal

## Basic Information

- **Project Name**: data-portal
- **Description**: 数据中台门户
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Data Portal Platform

数据门户平台 - 基于 Spring Boot + Vue 3 的企业级应用门户系统

## 项目简介

Data Portal Platform 是一个现代化的企业应用门户平台，提供统一的应用访问入口、用户权限管理和系统监控功能。

### 核心特性
- 🔐 统一身份认证（支持 Keycloak 集成）
- 🎯 应用集中管理
- 👥 角色权限控制
- 📊 系统状态监控
- 🌐 响应式前端界面

## 技术架构

### 后端 (portal-api)
- **框架**: Spring Boot 3.x
- **安全**: Spring Security + JWT
- **数据库**: PostgreSQL
- **构建工具**: Maven

### 前端 (portal-web)
- **框架**: Vue 3 + Vite
- **状态管理**: Pinia
- **路由**: Vue Router
- **UI组件**: Element Plus
- **构建工具**: Vite

## 快速开始

### 环境要求
- Java 17+
- Node.js 16+
- Docker & Docker Compose
- PostgreSQL 13+

### 启动步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd data-portal
```

2. **启动基础服务**
```bash
cd deploy
./start.sh
```

3. **启动后端服务**
```bash
cd ../portal-api
mvn spring-boot:run
```

4. **启动前端服务**
```bash
cd ../portal-web
npm install
npm run dev
```

### 访问地址
- 前端页面: http://localhost:5173
- 后端API: http://localhost:8080
- Keycloak: http://localhost:8081

## 项目结构

```
data-portal/
├── deploy/           # 部署配置
│   ├── 01-base/      # 基础服务
│   ├── 02-keycloak/  # 身份认证
│   └── 03-portal/    # 平台服务
├── portal-api/       # 后端服务
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/data/portal/
│   │   │   │   ├── controller/    # 控制器
│   │   │   │   ├── service/       # 业务逻辑
│   │   │   │   ├── repository/    # 数据访问
│   │   │   │   └── entity/        # 实体类
│   │   │   └── resources/
│   │   └── test/     # 测试代码
├── portal-web/       # 前端应用
│   ├── src/
│   │   ├── api/      # API接口
│   │   ├── components/ # 组件
│   │   ├── views/    # 页面视图
│   │   ├── router/   # 路由配置
│   │   └── stores/   # 状态管理
└── sql/             # 数据库脚本
```

## 开发指南

### 后端开发
```bash
# 运行测试
mvn test

# 打包构建
mvn clean package
```

### 前端开发
```bash
# 代码检查
npm run lint

# 构建生产版本
npm run build
```

## 部署说明

使用 Docker Compose 进行容器化部署：

```bash
# 生产环境部署
cd deploy
docker-compose -f docker-compose.yml up -d

# 开发环境部署
docker-compose -f docker-compose-dev.yml up -d
```

## 许可证

本项目采用 Apache License 2.0 许可证，详情请参见 [LICENSE](LICENSE) 文件。

## 贡献

欢迎提交 Issue 和 Pull Request 来改进项目。

## 联系方式

如有问题，请通过以下方式联系：
- 提交 GitHub Issue
- 发送邮件至项目维护者