docs: 批量更新历史文档中的 backend-single 引用为 server
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** 为 backend-single 下全部 39 个 Controller 及其关联 Request DTO 补全 OpenAPI 中文注解（@Tag/@Operation/@Parameter/@Schema），使接口文档页面可通过清晰的中文描述理解每个接口的作用和参数含义。
|
||||
**Goal:** 为 server 下全部 39 个 Controller 及其关联 Request DTO 补全 OpenAPI 中文注解（@Tag/@Operation/@Parameter/@Schema），使接口文档页面可通过清晰的中文描述理解每个接口的作用和参数含义。
|
||||
|
||||
**Architecture:** 在不改变现有代码结构和业务逻辑的前提下，为每个 Controller 类添加 `@Tag` 注解、为每个 public 方法添加 `@Operation` 注解、为 `@RequestParam`/`@PathVariable` 参数添加 `@Parameter` 注解、为被 Controller 直接引用的 Request DTO 字段添加 `@Schema` 注解。分 3 批实施，每批完成后编译验证。
|
||||
|
||||
@@ -25,12 +25,12 @@
|
||||
### Task 1.1: AiChatController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/AiChatController.java`
|
||||
- Modify: `backend-single/src/main/java/com/com/emotion/dto/request/AiChatRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/AiSummaryRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/GuestChatRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/ConversationCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/ChatStatsRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/AiChatController.java`
|
||||
- Modify: `server/src/main/java/com/com/emotion/dto/request/AiChatRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/AiSummaryRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/GuestChatRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/ConversationCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/ChatStatsRequest.java`
|
||||
|
||||
- [ ] **Step 1: 为 AiChatController 添加 @Tag 和 @Operation 注解**
|
||||
|
||||
@@ -162,8 +162,8 @@ public class ChatStatsRequest extends BaseRequest {
|
||||
### Task 1.2: AiRoutingController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/AiRoutingController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/ai/AiRuntimeRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/AiRoutingController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/ai/AiRuntimeRequest.java`
|
||||
|
||||
- [ ] **Step 1: 为 AiRoutingController 添加注解**
|
||||
|
||||
@@ -215,10 +215,10 @@ public class AiRuntimeRequest {
|
||||
### Task 1.3: CozeApiCallController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/CozeApiCallController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/coze/CozeApiCallPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/coze/CozeApiCallCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/coze/CozeApiCallUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/CozeApiCallController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/coze/CozeApiCallPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/coze/CozeApiCallCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/coze/CozeApiCallUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: 为 CozeApiCallController 添加 @Tag 注解**
|
||||
|
||||
@@ -339,10 +339,10 @@ public class CozeApiCallUpdateRequest {
|
||||
### Task 1.4: CommunityPostController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/CommunityPostController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/community/CommunityPostCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/community/CommunityPostUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/community/CommunityPostPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/CommunityPostController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/community/CommunityPostCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/community/CommunityPostUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/community/CommunityPostPageRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -387,10 +387,10 @@ CommunityPostPageRequest 各字段加 @Schema(description = "页码")、@Schema(
|
||||
### Task 1.5: CommentController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/CommentController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/comment/CommentCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/comment/CommentUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/comment/CommentPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/CommentController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/comment/CommentCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/comment/CommentUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/comment/CommentPageRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -429,10 +429,10 @@ public class CommentController {
|
||||
### Task 1.6: SocialContentController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/SocialContentController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/social/SocialContentManualImportRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/social/SocialContentLinkImportRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/social/SocialContentApprovalRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/SocialContentController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/social/SocialContentManualImportRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/social/SocialContentLinkImportRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/social/SocialContentApprovalRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -476,9 +476,9 @@ public class SocialContentController {
|
||||
### Task 1.7: SocialInsightController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/SocialInsightController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/social/SocialInsightGenerateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/social/SocialInsightUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/SocialInsightController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/social/SocialInsightGenerateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/social/SocialInsightUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -514,8 +514,8 @@ public class SocialInsightController {
|
||||
- [ ] **Step 1: 编译验证**
|
||||
|
||||
```bash
|
||||
cd backend-single
|
||||
mvn clean install -pl :backend-single -am -DskipTests
|
||||
cd server
|
||||
mvn clean install -pl :server -am -DskipTests
|
||||
```
|
||||
|
||||
Expected: BUILD SUCCESS，无编译错误。
|
||||
@@ -523,8 +523,8 @@ Expected: BUILD SUCCESS，无编译错误。
|
||||
- [ ] **Step 2: 提交 Batch 1 改动**
|
||||
|
||||
```bash
|
||||
git add backend-single/src/main/java/com/emotion/controller/AiChatController.java
|
||||
git add backend-single/src/main/java/com/emotion/controller/AiRoutingController.java
|
||||
git add server/src/main/java/com/emotion/controller/AiChatController.java
|
||||
git add server/src/main/java/com/emotion/controller/AiRoutingController.java
|
||||
# ... 添加 Batch 1 所有修改的文件
|
||||
git commit -m "feat: Batch 1 — AI + 社区 Controller 中文注解补全"
|
||||
```
|
||||
@@ -536,10 +536,10 @@ git commit -m "feat: Batch 1 — AI + 社区 Controller 中文注解补全"
|
||||
### Task 2.1: EmotionAnalysisController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/EmotionAnalysisController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionAnalysisCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionAnalysisPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionAnalysisUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/EmotionAnalysisController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionAnalysisCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionAnalysisPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionAnalysisUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -578,10 +578,10 @@ public class EmotionAnalysisController {
|
||||
### Task 2.2: EmotionRecordController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/EmotionRecordController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionRecordCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionRecordPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionRecordUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/EmotionRecordController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionRecordCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionRecordPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionRecordUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -625,9 +625,9 @@ public class EmotionRecordController {
|
||||
### Task 2.3: EmotionSummaryController 补充注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/EmotionSummaryController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionSummaryGenerateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EmotionSummaryStatusRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/EmotionSummaryController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionSummaryGenerateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EmotionSummaryStatusRequest.java`
|
||||
|
||||
- [ ] **Step 1: 补充缺失的 @Operation 注解**
|
||||
|
||||
@@ -646,10 +646,10 @@ public class EmotionRecordController {
|
||||
### Task 2.4: DiaryPostController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/DiaryPostController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/DiaryPostCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/DiaryPostPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/DiaryPostUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/DiaryPostController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/DiaryPostCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/DiaryPostPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/DiaryPostUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -706,9 +706,9 @@ public class DiaryPostController {
|
||||
### Task 2.5: DiaryCommentController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/DiaryCommentController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/DiaryCommentCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/DiaryCommentPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/DiaryCommentController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/DiaryCommentCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/DiaryCommentPageRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -759,10 +759,10 @@ public class DiaryCommentController {
|
||||
### Task 2.6: GrowthTopicController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/GrowthTopicController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/growth/GrowthTopicCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/growth/GrowthTopicPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/growth/GrowthTopicUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/GrowthTopicController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/growth/GrowthTopicCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/growth/GrowthTopicPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/growth/GrowthTopicUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -793,10 +793,10 @@ public class GrowthTopicController {
|
||||
### Task 2.7: TopicInteractionController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/TopicInteractionController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/TopicInteractionCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/TopicInteractionPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/TopicInteractionUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/TopicInteractionController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/TopicInteractionCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/TopicInteractionPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/TopicInteractionUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -829,8 +829,8 @@ public class TopicInteractionController {
|
||||
### Task 2.8: ConversationController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/ConversationController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/ConversationPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/ConversationController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/ConversationPageRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -872,11 +872,11 @@ public class ConversationController {
|
||||
### Task 2.9: MessageController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/MessageController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/MessageCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/MessagePageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/MessageSearchRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/MessageRecentRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/MessageController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/MessageCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/MessagePageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/MessageSearchRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/MessageRecentRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -915,10 +915,10 @@ public class MessageController {
|
||||
### Task 2.10: UserProfileController 补充注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/UserProfileController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/userprofile/UserProfileCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/userprofile/UserProfileUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/userprofile/UserProfilePageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/UserProfileController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/userprofile/UserProfileCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/userprofile/UserProfileUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/userprofile/UserProfilePageRequest.java`
|
||||
|
||||
- [ ] **Step 1: 补充 @Operation 注解（该 Controller 已有 @Tag 但方法级注解缺失）**
|
||||
|
||||
@@ -951,12 +951,12 @@ public class MessageController {
|
||||
### Task 2.11: AchievementController 补充注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/AchievementController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/achievement/AchievementCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/achievement/AchievementPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/achievement/AchievementUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/achievement/AchievementProgressUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/achievement/AchievementUnlockRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/AchievementController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/achievement/AchievementCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/achievement/AchievementPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/achievement/AchievementUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/achievement/AchievementProgressUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/achievement/AchievementUnlockRequest.java`
|
||||
|
||||
- [ ] **Step 1: 补充 @Parameter 注解（已有 @Tag 和 @Operation，但缺少 @RequestParam 的 @Parameter）**
|
||||
|
||||
@@ -1042,8 +1042,8 @@ public class MessageController {
|
||||
- [ ] **Step 1: 编译验证**
|
||||
|
||||
```bash
|
||||
cd backend-single
|
||||
mvn clean install -pl :backend-single -am -DskipTests
|
||||
cd server
|
||||
mvn clean install -pl :server -am -DskipTests
|
||||
```
|
||||
|
||||
Expected: BUILD SUCCESS
|
||||
@@ -1051,7 +1051,7 @@ Expected: BUILD SUCCESS
|
||||
- [ ] **Step 2: 提交 Batch 2 改动**
|
||||
|
||||
```bash
|
||||
git add backend-single/src/main/java/com/emotion/controller/EmotionAnalysisController.java
|
||||
git add server/src/main/java/com/emotion/controller/EmotionAnalysisController.java
|
||||
# ... 添加 Batch 2 所有修改的文件
|
||||
git commit -m "feat: Batch 2 — 情绪 + 日记 + 互动 Controller 中文注解补全"
|
||||
```
|
||||
@@ -1063,10 +1063,10 @@ git commit -m "feat: Batch 2 — 情绪 + 日记 + 互动 Controller 中文注
|
||||
### Task 3.1: LifePathController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/LifePathController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/LifePathCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/LifePathPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/LifePathUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/LifePathController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/LifePathCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/LifePathPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/LifePathUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1113,10 +1113,10 @@ public class LifePathController {
|
||||
### Task 3.2: RewardController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/RewardController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/reward/RewardCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/reward/RewardPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/reward/RewardUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/RewardController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/reward/RewardCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/reward/RewardPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/reward/RewardUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1149,11 +1149,11 @@ public class RewardController {
|
||||
### Task 3.3: UserStatsController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/UserStatsController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/UserStatsCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/UserStatsIncrementRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/UserStatsPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/UserStatsUpdateValueRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/UserStatsController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/UserStatsCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/UserStatsIncrementRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/UserStatsPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/UserStatsUpdateValueRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1194,11 +1194,11 @@ public class UserStatsController {
|
||||
### Task 3.4: EpicScriptController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/EpicScriptController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EpicScriptCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EpicScriptUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EpicScriptPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/EpicScriptInspirationRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/EpicScriptController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EpicScriptCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EpicScriptUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EpicScriptPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/EpicScriptInspirationRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1247,10 +1247,10 @@ public class EpicScriptController {
|
||||
### Task 3.5: DictionaryController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/DictionaryController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/dictionary/DictionaryCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/dictionary/DictionaryPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/dictionary/DictionaryUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/DictionaryController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/dictionary/DictionaryCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/dictionary/DictionaryPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/dictionary/DictionaryUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1266,10 +1266,10 @@ public class DictionaryController {
|
||||
### Task 3.6: GuestUserController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/GuestUserController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/guest/GuestUserCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/guest/GuestUserPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/guest/GuestUserUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/GuestUserController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/guest/GuestUserCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/guest/GuestUserPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/guest/GuestUserUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1285,8 +1285,8 @@ public class GuestUserController {
|
||||
### Task 3.7: TtsController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/TtsController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/tts/TtsTaskCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/TtsController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/tts/TtsTaskCreateRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1302,7 +1302,7 @@ public class TtsController {
|
||||
### Task 3.8: AsrController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/AsrController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/AsrController.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1318,7 +1318,7 @@ public class AsrController {
|
||||
### Task 3.9: HealthController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/HealthController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/HealthController.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1334,10 +1334,10 @@ public class HealthController {
|
||||
### Task 3.10: LifeEventController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/LifeEventController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/LifeEventCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/LifeEventUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/LifeEventPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/LifeEventController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/LifeEventCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/LifeEventUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/LifeEventPageRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1353,8 +1353,8 @@ public class LifeEventController {
|
||||
### Task 3.11: ChatWebSocketController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/ChatWebSocketController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/WebSocketRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/ChatWebSocketController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/WebSocketRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1370,8 +1370,8 @@ public class ChatWebSocketController {
|
||||
### Task 3.12: AnalyticsController 注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/AnalyticsController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/analytics/AnalyticsEventBatchRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/AnalyticsController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/analytics/AnalyticsEventBatchRequest.java`
|
||||
|
||||
- [ ] **Step 1: Controller 注解**
|
||||
|
||||
@@ -1387,13 +1387,13 @@ public class AnalyticsController {
|
||||
### Task 3.13: AiConfigController 补充注解
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend-single/src/main/java/com/emotion/controller/AiConfigController.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/aiconfig/AiConfigCreateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/aiconfig/AiConfigUpdateRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/aiconfig/AiConfigPageRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/aiconfig/AiConfigEnableRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/aiconfig/AiConfigDefaultRequest.java`
|
||||
- Modify: `backend-single/src/main/java/com/emotion/dto/request/aiconfig/AiConfigTestUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/controller/AiConfigController.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/aiconfig/AiConfigCreateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/aiconfig/AiConfigUpdateRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/aiconfig/AiConfigPageRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/aiconfig/AiConfigEnableRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/aiconfig/AiConfigDefaultRequest.java`
|
||||
- Modify: `server/src/main/java/com/emotion/dto/request/aiconfig/AiConfigTestUpdateRequest.java`
|
||||
|
||||
- [ ] **Step 1: 补充缺失的 @Operation 注解（已有 @Tag 但方法级注解不全）**
|
||||
|
||||
@@ -1404,8 +1404,8 @@ public class AnalyticsController {
|
||||
- [ ] **Step 1: 编译验证**
|
||||
|
||||
```bash
|
||||
cd backend-single
|
||||
mvn clean install -pl :backend-single -am -DskipTests
|
||||
cd server
|
||||
mvn clean install -pl :server -am -DskipTests
|
||||
```
|
||||
|
||||
Expected: BUILD SUCCESS
|
||||
@@ -1413,7 +1413,7 @@ Expected: BUILD SUCCESS
|
||||
- [ ] **Step 2: 提交 Batch 3 改动**
|
||||
|
||||
```bash
|
||||
git add backend-single/src/main/java/com/emotion/controller/LifePathController.java
|
||||
git add server/src/main/java/com/emotion/controller/LifePathController.java
|
||||
# ... 添加 Batch 3 所有修改的文件
|
||||
git commit -m "feat: Batch 3 — 其他 Controller 中文注解补全"
|
||||
```
|
||||
@@ -1559,8 +1559,8 @@ private String fieldName;
|
||||
- [ ] **Step 1: 全量编译**
|
||||
|
||||
```bash
|
||||
cd backend-single
|
||||
mvn clean install -pl :backend-single -am -DskipTests
|
||||
cd server
|
||||
mvn clean install -pl :server -am -DskipTests
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 启动服务验证 OpenAPI 同步**
|
||||
|
||||
Reference in New Issue
Block a user