From 0877b1bb0ff45f3344c026a8f4dfa687eb82db40 Mon Sep 17 00:00:00 2001
From: Zhou Weidong <502333560@qq.com>
Date: Tue, 20 Oct 2026 12:02:36 +0800
Subject: [PATCH] =?UTF-8?q?docs(plans):=20=E7=95=99=E7=97=95=20K30-A=20?=
 =?UTF-8?q?=E8=AF=A6=E6=83=85=E4=BA=92=E5=8A=A8=E6=95=B0=E9=87=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/plans/INBOX.md    |  6 +++---
 docs/plans/PROGRESS.md | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 3 deletions(-)

diff --git a/docs/plans/INBOX.md b/docs/plans/INBOX.md
index 318d8c4..23d2d2f 100644
--- a/docs/plans/INBOX.md
+++ b/docs/plans/INBOX.md
@@ -1,4 +1,4 @@
-## [待处理] 2026-10-20 | K30-A 后端补互动数量字段（详情 VO）
+## [已处理] 2026-10-20 | K30-A 后端补互动数量字段（详情 VO）
 
 **用户指令（2026-10-20，原文）**：
 > 「现在改右侧的收藏 评论喜欢 都是显示数量 然后改评论面板 ui 不好看 间距太大 点击发送后要收回键盘」
@@ -36,7 +36,7 @@
 
 ---
 
-## [待处理] 2026-10-20 | K29.9 播放页底部细节调整
+## [已处理] 2026-10-20 | K29.9 播放页底部细节调整
 
 **用户指令（2026-10-20，原文）**：
 > 「现在改播放页底部 标题右边的箭头紧挨着不在最右侧 集数和简介上下对齐大小一致 紧挨着展开而不是下箭头 进度条宽度一致 下面的选集字体大小加大 圆角减小 清屏按钮整体大一些 注意益处隐藏」
@@ -57,7 +57,7 @@
 
 ---
 
-## [待处理] 2026-10-20 | K29.8 「更多」弹窗增加小窗播放
+## [已处理] 2026-10-20 | K29.8 「更多」弹窗增加小窗播放
 
 **用户指令（2026-10-20，原文）**：
 > 「再加上小窗播放」
diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md
index 3ef8edd..81232fe 100644
--- a/docs/plans/PROGRESS.md
+++ b/docs/plans/PROGRESS.md
@@ -19997,3 +19997,39 @@ Running Gradle task 'assembleDebug'...
 ```
 
 解读：静态检查零告警，390 条测试全部通过（较 K29.8 新增 2 条底部排版用例），debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。
+
+## 2026-10-20 FruitServer：K30-A 详情接口补互动数量
+
+- 分支：`feature/backend-drama-counts`
+- 功能提交：`671953b feat(app-api): 详情补充互动数量字段`
+- develop 合并提交：`f19d21e merge: 合并 K30-A 详情互动数量`，已推送。
+- 契约先行：先在 `docs/api-phase1.md` 的 1.3 内容浏览补上 `/app/dramas/{id}` 完整响应示例与互动数量字段表，再改代码；明确 `Long` 计数按全局约定以 JSON 字符串下发，与既有 `viewCount` 一致。
+- `AppDramaDetailVO` 新增 `likeCount`、`favoriteCount`、`commentCount`（Long），JSON 字段同名，既有字段语义未动。
+- `AppCatalogService.dramaDetail` 装配：`likeCount` 取 `drama.like_count`、`favoriteCount` 取 `drama.favorite_count`、`commentCount` 调互动域 `CommentService.countByDrama(dramaId)`。
+- `CommentService.countByDrama`：按 `drama_id` 统计 `content_comment`，排除 `status = 'deleted'`；数据库逻辑删除记录由 MyBatis-Plus `@TableLogic` 自动过滤；`dramaId` 为空直接返回 0，不查库。
+- 未改管理端接口与管理端 VO；未改表结构（`drama.like_count` / `drama.favorite_count` 原已存在）。
+
+测试补充：
+- `AppCatalogControllerContractTest` 详情用例新增 `viewCount/likeCount/favoriteCount/commentCount` 断言，验证契约里的字符串序列化形态。
+- 新增 `AppCatalogServiceTest`：用替身依赖验证详情 VO 三个数量来源正确、调用 `countByDrama`。
+- 新增 `CommentServiceCountTest`：捕获查询条件验证按剧过滤且排除 deleted，同时覆盖空剧 ID 不查库。
+
+门禁原始输出：
+
+```text
+$ mvn test
+[INFO] Reactor Summary for fruitshorts 1.0.0-SNAPSHOT:
+[INFO] fruitshorts-module-commerce ......................... SUCCESS
+[INFO] fruitshorts-admin-api .............................. SUCCESS  (Tests run: 21)
+[INFO] fruitshorts-app-api ................................ SUCCESS  (Tests run: 59)
+[INFO] fruitshorts-transcode-worker ....................... SUCCESS  (Tests run: 12)
+[INFO] BUILD SUCCESS
+[INFO] Total time:  11.338 s
+
+$ mvn -pl fruitshorts-app-api -am package -DskipTests
+[INFO] fruitshorts-app-api ................................ SUCCESS
+[INFO] BUILD SUCCESS
+[INFO] Total time:  5.545 s
+```
+
+解读：全量后端测试 125 条（commerce 33 + admin-api 21 + app-api 59 + worker 12）全部通过，0 失败 0 错误；app-api 及其依赖模块打包成功。管理端未改动，表结构未改动。