提交swagger 对象接口补充

This commit is contained in:
wh
2026-04-15 15:28:11 +08:00
parent 73a13fd16d
commit f6ba09521a
41 changed files with 674 additions and 139 deletions

View File

@@ -30,7 +30,6 @@
- `src/main/java/com/label/dto/SysConfigUpdateRequest.java`
- `src/main/java/com/label/dto/SysConfigItemResponse.java`
- `src/main/java/com/label/dto/DynamicJsonResponse.java`
- `src/main/java/com/label/dto/RawJsonUpdateRequest.java`
- `src/main/java/com/label/dto/FinetuneJobResponse.java`
### Modify
@@ -142,7 +141,6 @@ private static final List<Class<?>> DTOS = List.of(
SysConfigUpdateRequest.class,
SysConfigItemResponse.class,
DynamicJsonResponse.class,
RawJsonUpdateRequest.class,
FinetuneJobResponse.class
);
@@ -302,14 +300,6 @@ public class RejectRequest {
```java
@Data
@Schema(description = "原始 JSON 更新请求")
public class RawJsonUpdateRequest {
@Schema(description = "完整 JSON 字符串;用于整体覆盖提取或问答标注结果", example = "{\"items\":[]}")
private String body;
}
```
```java
@Data
@Schema(description = "动态业务 JSON 响应")
public class DynamicJsonResponse {
@@ -710,7 +700,7 @@ return Result.success(response);
Use the same pattern for QA.
- [ ] **Step 3: Use `RawJsonUpdateRequest` for raw JSON update bodies only if existing clients can send `{"body":"..."}`**
- [ ] **Step 3: Keep raw JSON update request bodies as raw strings**
Do not change `PUT /api/extraction/{taskId}` or `PUT /api/qa/{taskId}` from raw string request body unless compatibility is explicitly approved.
@@ -805,13 +795,14 @@ git diff -- src/main/java src/test/java README.md docs/superpowers
Expected: diff only contains Swagger annotations, DTO additions, DTO request binding updates, and matching tests.
- [ ] **Step 4: Commit implementation**
- [ ] **Step 4: Keep implementation uncommitted for review**
Do not commit unless the user explicitly asks for it.
Run:
```bash
git add src/main/java src/test/java README.md docs/superpowers
git commit -m "docs: document backend api parameters in swagger"
git status --short
```
Expected: commit succeeds.
Expected: implementation remains available in the worktree for review.