113 lines
2.5 KiB
Markdown
113 lines
2.5 KiB
Markdown
# 主应用
|
|
|
|
## 概述
|
|
|
|
主应用是 DeepData 的核心 Spring Boot 服务，包含数据管理、数据清洗、算子市场、数据收集等主要功能模块。
|
|
|
|
## 架构
|
|
|
|
```
|
|
backend/services/main-application/
|
|
├── src/main/java/com/deepdata/main/
|
|
│ ├── interfaces/
|
|
│ │ ├── rest/ # Controllers
|
|
│ │ ├── dto/ # Request/Response DTOs
|
|
│ │ └── converter/ # MapStruct converters
|
|
│ ├── application/ # Application services
|
|
│ ├── domain/
|
|
│ │ ├── model/ # Entities
|
|
│ │ └── repository/ # Repository interfaces
|
|
│ └── infrastructure/
|
|
│ ├── persistence/ # Repository implementations
|
|
│ ├── client/ # External API clients
|
|
│ └── config/ # Service configuration
|
|
└── src/main/resources/
|
|
├── application.yml # 主配置
|
|
├── config/application-datamanagement.yml # 数据管理配置
|
|
└── config/application-datacollection.yml # 数据收集配置
|
|
```
|
|
|
|
## 模块
|
|
|
|
### 1. 数据管理
|
|
- 数据集 CRUD 操作
|
|
- 文件上传/下载
|
|
- 标签管理
|
|
- 数据集版本控制
|
|
|
|
### 2. 数据收集
|
|
- 数据源配置
|
|
- 定时数据收集任务
|
|
- 数据同步
|
|
- 数据导入/导出
|
|
|
|
## 配置
|
|
|
|
### 端口
|
|
- **默认**: 8080
|
|
- **上下文路径**: `/api`
|
|
|
|
### 关键配置
|
|
```yaml
|
|
server:
|
|
port: 8080
|
|
servlet:
|
|
context-path: /api
|
|
|
|
deepdata:
|
|
data-management:
|
|
base-path: /dataset
|
|
```
|
|
|
|
## 快速开始
|
|
|
|
### 前置条件
|
|
- JDK 21+
|
|
- Maven 3.8+
|
|
- PostgreSQL 12+
|
|
- Redis 6+
|
|
|
|
### 构建
|
|
```bash
|
|
cd backend/services/main-application
|
|
mvn clean install
|
|
```
|
|
|
|
### 运行
|
|
```bash
|
|
cd backend/services/main-application
|
|
mvn spring-boot:run
|
|
```
|
|
|
|
## 开发
|
|
|
|
### 添加新模块
|
|
1. 在 `domain/model/` 创建实体类
|
|
2. 在 `domain/repository/` 创建 repository 接口
|
|
3. 在 `infrastructure/persistence/` 实现 repository
|
|
4. 在 `application/` 创建 application service
|
|
5. 在 `interfaces/rest/` 创建 controller
|
|
|
|
## 测试
|
|
|
|
### 运行测试
|
|
```bash
|
|
cd backend/services/main-application
|
|
mvn test
|
|
```
|
|
|
|
### 运行特定测试
|
|
```bash
|
|
mvn test -Dtest=DatasetControllerTest
|
|
```
|
|
|
|
## 文档
|
|
|
|
- **Spring Boot 文档**: https://docs.spring.io/spring-boot/
|
|
- [AGENTS.md](../../shared/AGENTS.md)
|
|
|
|
## 相关链接
|
|
|
|
- [后端 README](../../README.md)
|
|
- [API Gateway README](../../api-gateway/README.md)
|