deepdata/backend/services/main-application/README-zh.md

主应用

概述

主应用是 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

关键配置

server:
  port: 8080
  servlet:
    context-path: /api

deepdata:
  data-management:
    base-path: /dataset

快速开始

前置条件

• JDK 21+
• Maven 3.8+
• PostgreSQL 12+
• Redis 6+

构建

cd backend/services/main-application
mvn clean install

运行

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

测试

运行测试

cd backend/services/main-application
mvn test

运行特定测试

mvn test -Dtest=DatasetControllerTest

文档

• Spring Boot 文档: https://docs.spring.io/spring-boot/
• AGENTS.md

相关链接

• 后端 README
• API Gateway README