deepdata: core product code (backend, frontend, runtime, deepflow module)

2026-08-30 19:23:38 +08:00
commit bd3db30be9
1405 changed files with 271727 additions and 0 deletions
@@ -0,0 +1,112 @@
+# 主应用
+
+## 概述
+
+主应用是 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)