Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 22 additions & 8 deletions backend/openapi/specs/data-management.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,10 @@ tags:
description: 标签管理

paths:
/datasets:
/data-management/datasets:
get:
tags: [Dataset]
operationId: getDatasets
summary: 获取数据集列表
description: 分页查询数据集列表,支持按类型、标签等条件筛选
parameters:
Expand Down Expand Up @@ -82,6 +83,7 @@ paths:

post:
tags: [Dataset]
operationId: createDataset
summary: 创建数据集
description: 创建新的数据集
requestBody:
Expand All @@ -104,9 +106,10 @@ paths:
schema:
$ref: '#/components/schemas/ErrorResponse'

/datasets/{datasetId}:
/data-management/datasets/{datasetId}:
get:
tags: [Dataset]
operationId: getDatasetById
summary: 获取数据集详情
description: 根据ID获取数据集详细信息
parameters:
Expand All @@ -133,6 +136,7 @@ paths:
put:
tags: [Dataset]
summary: 更新数据集
operationId: updateDataset
description: 更新数据集信息
parameters:
- name: datasetId
Expand Down Expand Up @@ -163,6 +167,7 @@ paths:

delete:
tags: [Dataset]
operationId: deleteDataset
summary: 删除数据集
description: 删除指定的数据集
parameters:
Expand All @@ -182,10 +187,11 @@ paths:
schema:
$ref: '#/components/schemas/ErrorResponse'

/datasets/{datasetId}/files:
/data-management/datasets/{datasetId}/files:
get:
tags: [DatasetFile]
summary: 获取数据集文件列表
operationId: getDatasetFiles
description: 分页获取数据集中的文件列表
parameters:
- name: datasetId
Expand Down Expand Up @@ -228,6 +234,7 @@ paths:
post:
tags: [DatasetFile]
summary: 上传文件到数据集
operationId: uploadDatasetFile
description: 向指定数据集上传文件
parameters:
- name: datasetId
Expand Down Expand Up @@ -258,11 +265,12 @@ paths:
schema:
$ref: '#/components/schemas/DatasetFileResponse'

/datasets/{datasetId}/files/{fileId}:
/data-management/datasets/{datasetId}/files/{fileId}:
get:
tags: [DatasetFile]
summary: 获取文件详情
description: 获取数据集中指定文件的详细信息
operationId: getDatasetFileById
parameters:
- name: datasetId
in: path
Expand All @@ -287,6 +295,7 @@ paths:
delete:
tags: [DatasetFile]
summary: 删除文件
operationId: deleteDatasetFile
description: 从数据集中删除指定文件
parameters:
- name: datasetId
Expand All @@ -305,9 +314,10 @@ paths:
'204':
description: 删除成功

/datasets/{datasetId}/files/{fileId}/download:
/data-management/datasets/{datasetId}/files/{fileId}/download:
get:
tags: [DatasetFile]
operationId: downloadDatasetFile
summary: 下载文件
description: 下载数据集中的指定文件
parameters:
Expand All @@ -332,8 +342,9 @@ paths:
type: string
format: binary

/dataset-types:
/data-management/dataset-types:
get:
operationId: getDatasetTypes
tags: [DatasetType]
summary: 获取数据集类型列表
description: 获取所有支持的数据集类型
Expand All @@ -347,9 +358,10 @@ paths:
items:
$ref: '#/components/schemas/DatasetTypeResponse'

/tags:
/data-management/tags:
get:
tags: [Tag]
operationId: getTags
summary: 获取标签列表
description: 获取所有可用的标签
parameters:
Expand All @@ -370,6 +382,7 @@ paths:

post:
tags: [Tag]
operationId: createTag
summary: 创建标签
description: 创建新的标签
requestBody:
Expand All @@ -386,9 +399,10 @@ paths:
schema:
$ref: '#/components/schemas/TagResponse'

/datasets/{datasetId}/statistics:
/data-management/datasets/{datasetId}/statistics:
get:
tags: [Dataset]
operationId: getDatasetStatistics
summary: 获取数据集统计信息
description: 获取数据集的统计信息(文件数量、大小、完成度等)
parameters:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,8 @@ public DatasetController(DatasetApplicationService datasetApplicationService) {
}

@Override
public ResponseEntity<PagedDatasetResponse> datasetsGet(Integer page, Integer size, String type,
String tags, String keyword, String status) {
public ResponseEntity<PagedDatasetResponse> getDatasets(Integer page, Integer size, String type,
String tags, String keyword, String status) {
Pageable pageable = PageRequest.of(page != null ? page : 0, size != null ? size : 20);

List<String> tagList = null;
Expand All @@ -58,7 +58,7 @@ public ResponseEntity<PagedDatasetResponse> datasetsGet(Integer page, Integer si
}

@Override
public ResponseEntity<DatasetResponse> datasetsPost(CreateDatasetRequest createDatasetRequest) {
public ResponseEntity<DatasetResponse> createDataset(CreateDatasetRequest createDatasetRequest) {
try {
Long dataSourceId = null;
if (createDatasetRequest.getDataSource() != null) {
Expand All @@ -82,7 +82,7 @@ public ResponseEntity<DatasetResponse> datasetsPost(CreateDatasetRequest createD
}

@Override
public ResponseEntity<DatasetResponse> datasetsDatasetIdGet(String datasetId) {
public ResponseEntity<DatasetResponse> getDatasetById(String datasetId) {
try {
Dataset dataset = datasetApplicationService.getDataset(datasetId);
return ResponseEntity.ok(convertToResponse(dataset));
Expand All @@ -92,7 +92,7 @@ public ResponseEntity<DatasetResponse> datasetsDatasetIdGet(String datasetId) {
}

@Override
public ResponseEntity<DatasetResponse> datasetsDatasetIdPut(String datasetId, UpdateDatasetRequest updateDatasetRequest) {
public ResponseEntity<DatasetResponse> updateDataset(String datasetId, UpdateDatasetRequest updateDatasetRequest) {
try {
Dataset dataset = datasetApplicationService.updateDataset(
datasetId,
Expand All @@ -109,7 +109,7 @@ public ResponseEntity<DatasetResponse> datasetsDatasetIdPut(String datasetId, Up
}

@Override
public ResponseEntity<Void> datasetsDatasetIdDelete(String datasetId) {
public ResponseEntity<Void> deleteDataset(String datasetId) {
try {
datasetApplicationService.deleteDataset(datasetId);
return ResponseEntity.noContent().build();
Expand All @@ -119,7 +119,7 @@ public ResponseEntity<Void> datasetsDatasetIdDelete(String datasetId) {
}

@Override
public ResponseEntity<DatasetStatisticsResponse> datasetsDatasetIdStatisticsGet(String datasetId) {
public ResponseEntity<DatasetStatisticsResponse> getDatasetStatistics(String datasetId) {
try {
Map<String, Object> stats = datasetApplicationService.getDatasetStatistics(datasetId);

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ public DatasetFileController(DatasetFileApplicationService datasetFileApplicatio
}

@Override
public ResponseEntity<PagedDatasetFileResponse> datasetsDatasetIdFilesGet(String datasetId, Integer page, Integer size,
String fileType, String status) {
public ResponseEntity<PagedDatasetFileResponse> getDatasetFiles(String datasetId, Integer page, Integer size,
String fileType, String status) {
Pageable pageable = PageRequest.of(page != null ? page : 0, size != null ? size : 20);

Page<DatasetFile> filesPage = datasetFileApplicationService.getDatasetFiles(
Expand All @@ -56,7 +56,7 @@ public ResponseEntity<PagedDatasetFileResponse> datasetsDatasetIdFilesGet(String
}

@Override
public ResponseEntity<DatasetFileResponse> datasetsDatasetIdFilesPost(String datasetId, MultipartFile file, String description) {
public ResponseEntity<DatasetFileResponse> uploadDatasetFile(String datasetId, MultipartFile file, String description) {
try {
DatasetFile datasetFile = datasetFileApplicationService.uploadFile(
datasetId, file, description, "system");
Expand All @@ -70,7 +70,7 @@ public ResponseEntity<DatasetFileResponse> datasetsDatasetIdFilesPost(String dat
}

@Override
public ResponseEntity<DatasetFileResponse> datasetsDatasetIdFilesFileIdGet(String datasetId, String fileId) {
public ResponseEntity<DatasetFileResponse> getDatasetFileById(String datasetId, String fileId) {
try {
DatasetFile datasetFile = datasetFileApplicationService.getDatasetFile(datasetId, fileId);
return ResponseEntity.ok(convertToResponse(datasetFile));
Expand All @@ -80,7 +80,7 @@ public ResponseEntity<DatasetFileResponse> datasetsDatasetIdFilesFileIdGet(Strin
}

@Override
public ResponseEntity<Void> datasetsDatasetIdFilesFileIdDelete(String datasetId, String fileId) {
public ResponseEntity<Void> deleteDatasetFile(String datasetId, String fileId) {
try {
datasetFileApplicationService.deleteDatasetFile(datasetId, fileId);
return ResponseEntity.noContent().build();
Expand All @@ -90,7 +90,7 @@ public ResponseEntity<Void> datasetsDatasetIdFilesFileIdDelete(String datasetId,
}

@Override
public ResponseEntity<Resource> datasetsDatasetIdFilesFileIdDownloadGet(String datasetId, String fileId) {
public ResponseEntity<Resource> downloadDatasetFile(String datasetId, String fileId) {
try {
DatasetFile datasetFile = datasetFileApplicationService.getDatasetFile(datasetId, fileId);
Resource resource = datasetFileApplicationService.downloadFile(datasetId, fileId);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
public class DatasetTypeController implements DatasetTypeApi {

@Override
public ResponseEntity<List<DatasetTypeResponse>> datasetTypesGet() {
public ResponseEntity<List<DatasetTypeResponse>> getDatasetTypes() {
// 硬编码的数据集类型,实际应用中可以从数据库获取
List<DatasetTypeResponse> types = Arrays.asList(
createDatasetType("IMAGE", "图像数据集", "用于机器学习的图像数据集", Arrays.asList("jpg", "jpeg", "png", "bmp", "gif")),
Expand All @@ -24,7 +24,7 @@ public ResponseEntity<List<DatasetTypeResponse>> datasetTypesGet() {
createDatasetType("VIDEO", "视频数据集", "用于视频分析的视频数据集", Arrays.asList("mp4", "avi", "mov", "mkv")),
createDatasetType("MULTIMODAL", "多模态数据集", "包含多种数据类型的数据集", Arrays.asList("*"))
);

return ResponseEntity.ok(types);
}

Expand All @@ -35,7 +35,7 @@ private DatasetTypeResponse createDatasetType(String code, String name, String d
response.setDescription(description);
response.setSupportedFormats(supportedFormats);
response.setIcon(getIconForType(code));

return response;
}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ public TagController(TagApplicationService tagApplicationService) {
}

@Override
public ResponseEntity<List<TagResponse>> tagsGet(String keyword) {
public ResponseEntity<List<TagResponse>> getTags(String keyword) {
List<Tag> tags = tagApplicationService.searchTags(keyword);

List<TagResponse> response = tags.stream()
Expand All @@ -38,7 +38,7 @@ public ResponseEntity<List<TagResponse>> tagsGet(String keyword) {
}

@Override
public ResponseEntity<TagResponse> tagsPost(CreateTagRequest createTagRequest) {
public ResponseEntity<TagResponse> createTag(CreateTagRequest createTagRequest) {
try {
Tag tag = tagApplicationService.createTag(
createTagRequest.getName(),
Expand Down
Loading