docs(plans): 记录 K3 互动实施与验收回执
This commit is contained in:
1 parent
a0156ee946
commit
969538e6c9
3 files changed
+493
-1
No files matched your search
+110
-1
@@ -20,7 +20,7 @@
|
||||
|
||||
---
|
||||
|
||||
## [待处理] 2026-10-17 | K3 客户端第三批:互动(评论 + 点赞 + 举报 + 分享)
|
||||
## [已处理·待用户验收] 2026-10-17 | K3 客户端第三批:互动(评论 + 点赞 + 举报 + 分享)
|
||||
|
||||
**用户指令(2026-10-17)**:客户端继续对接接口及 UI,严格执行 specs。
|
||||
|
||||
@@ -127,6 +127,115 @@
|
||||
- 每步「叙述 + 命令 + 原始输出 + 解读」追加到 `docs/plans/PROGRESS.md`。
|
||||
- 做完停下写回执:真数据/本地数据页面清单、用户验证步骤与预期、门禁原始输出、提交号。
|
||||
|
||||
### 七、K3 完成回执(2026-10-17)
|
||||
|
||||
**结论**:K3-A 评论、K3-B 点赞、K3-C 举报、K3-D 分享回归均已完成并停止,
|
||||
未开始 K4。后端、`ReelShortWeb`、specs 均未修改。
|
||||
|
||||
#### 7.1 真数据 / 本地数据页面清单
|
||||
|
||||
真数据(走契约 §1.7):
|
||||
|
||||
- 播放页评论弹窗:匿名评论列表、游标加载更多、顶层评论、一层回复、
|
||||
BLOCK/REPLACE/REVIEW 结果、本人删除、评论点赞。
|
||||
- 播放页剧集点赞:`POST /app/likes/toggle` 切换,乐观更新与服务端状态校准;
|
||||
**不展示剧集点赞数字**。
|
||||
- 评论更多菜单与详情页更多菜单:评论/短剧举报,固定五项原因,可选描述。
|
||||
|
||||
本地/系统能力:
|
||||
|
||||
- 剧集 liked 仅保存在当前 App 会话内。因详情/卡片契约没有 `likeCount/liked`,
|
||||
App 重启或换账号后不展示服务端初始点赞状态。
|
||||
- 分享继续走 `PlatformShareService` 系统分享,不新增后端接口。
|
||||
- “我的 → 喜欢”只过滤当前 feed 的会话内 liked,没有契约外加“我的点赞列表”接口。
|
||||
|
||||
按降级方案未做:拉黑、举报用户、举报后台处理、无限嵌套、图片/表情/@、我的评论列表。
|
||||
|
||||
#### 7.2 门禁原始结果
|
||||
|
||||
```
|
||||
$ cd /Users/jianghaifeng/Desktop/ReelShort/ReelShort
|
||||
$ dart analyze lib test
|
||||
Analyzing lib, test...
|
||||
No issues found!
|
||||
|
||||
$ flutter test
|
||||
00:11 +241 ~1: All tests passed!
|
||||
|
||||
$ flutter build apk --debug
|
||||
Running Gradle task 'assembleDebug'... 6.8s
|
||||
✓ Built build/app/outputs/flutter-apk/app-debug.apk
|
||||
```
|
||||
|
||||
`~1` 是既有 `live_watch_flow_test` 在 8081 未启动时按测试机制跳过,不是失败。
|
||||
|
||||
#### 7.3 Git
|
||||
|
||||
- 功能提交:`d361034226ec2bc431548d45068dc60046e5e473`
|
||||
`feat(flutter): 接入互动评论点赞举报`
|
||||
- `--no-ff` 合并提交:`9db6935308e65342be46c81419c2992ed2df1df0`
|
||||
`merge: 合并 K3 客户端互动能力`
|
||||
- 已推送:`45f5f25..9db6935 develop -> develop`
|
||||
- author 与 committer 均为 `Zhou Weidong <502333560@qq.com>`;未操作 `main`。
|
||||
|
||||
#### 7.4 用户真机验证步骤与预期
|
||||
|
||||
前置:启动 8081 客户端接口服务,准备可登录测试账号;在 Android 设备安装
|
||||
`build/app/outputs/flutter-apk/app-debug.apk`,确认 App 使用设备可访问的后端地址。
|
||||
以下证据必须由用户在设备侧取得,Codex 未执行真机验证。
|
||||
|
||||
1. 未登录打开任意有评论的剧集,点播放页评论入口。
|
||||
|
||||
预期:评论列表正常加载;空列表显示“还没有评论”;断网后显示失败与重试,不白屏。
|
||||
|
||||
2. 未登录点发布、评论点赞或举报,再点剧集点赞。
|
||||
|
||||
预期:均先出现登录提示;关闭提示后不发业务请求;登录后可重试。
|
||||
|
||||
3. 登录后发表顶层评论,再输入命中 `REPLACE` 或 `REVIEW` 策略的词。
|
||||
|
||||
预期:顶层评论出现在列表;REPLACE 展示服务端替换后的内容;REVIEW 显示“审核中”;
|
||||
BLOCK 原样显示后端 message 且输入框内容保留。
|
||||
|
||||
4. 在顶层评论点“回复”并发布。
|
||||
|
||||
预期:请求带 `parentId`;回复归入该楼层,只做一层回复;点“查看回复”可展开。
|
||||
|
||||
5. 连续加载超过首屏 20 条的评论。
|
||||
|
||||
预期:按 `nextCursor` 续拉,不重复、不跳页;没有下一页时加载更多消失。
|
||||
|
||||
6. 点赞一条评论和当前剧集,再点一次取消。
|
||||
|
||||
预期:图标立即切换;评论计数在服务端响应后校准;断网时状态回滚并提示;
|
||||
剧集点赞不显示数字。
|
||||
|
||||
7. 删除自己的评论:更多 → 删除评论 → 二次确认。
|
||||
|
||||
预期:成功后从列表移除;制造断网/服务失败时恢复原位置并提示。其他人的评论不显示删除项。
|
||||
|
||||
8. 举报评论与短剧:更多 → 举报;分别选择 `SPAM/ABUSE/PORN/AD/OTHER` 和可选描述。
|
||||
|
||||
预期:成功后提示“举报已提交,感谢反馈。”;重复举报原样显示后端
|
||||
“你已举报过该内容,我们正在处理”;举报自己发布内容原样显示后端 message。
|
||||
|
||||
9. 点播放页分享。
|
||||
|
||||
预期:打开系统分享面板;文本顺序为标题、简介、`FruitShorts` footer;
|
||||
切换 en/zh/id 后三类文案同步切换。
|
||||
|
||||
10. 在 Android logcat 保存评论/点赞/举报请求与响应,并保留关键页面截图。
|
||||
|
||||
预期:可见 `/app/comments*`、`/app/likes/toggle`、`/app/reports` 的真实响应;
|
||||
设备侧取证由用户执行,开发机 `curl` 或本机返回 200 不替代本步骤。
|
||||
|
||||
#### 7.5 未验证与已知边界
|
||||
|
||||
- 真机、模拟器、设备日志、设备截图均未由 Codex 执行,状态为“设备侧取证待用户执行”。
|
||||
- 剧集点赞初始状态和数字因契约缺口无法展示,App 重启后当前会话状态丢失。
|
||||
- 敏感词具体词表、限流阈值、后台审核联动由后端/运营环境决定,本轮只做客户端透传与状态展示。
|
||||
- 拉黑与 K4 不在本轮范围。
|
||||
|
||||
---
|
||||
|
||||
## [已处理·待用户验收] 2026-10-17 | K2 客户端第二批:分类 + 观看记录 + 收藏列表 + 下载授权(A3/A5 剩余)+ UI
|
||||
|
||||
Reference in new issue
Block a user