- 21~26 Flutter 社区接入五单 + 字典 v3 白名单（flutter 286→502、api 325→334） - 27 收口总表：社区 demo 三页消亡、M3 四条验收标准逐条取证、 乐观更新与媒体链路端到端、实现期修正记录 - device-verification.md 的 M3 四项真机步骤已由各单收口补全 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -111,10 +111,57 @@ _（待真机到位后填写：日期、设备型号/Android 版本、两项结
|
||||
|
||||
以下为 M3 交付过程中预计产生的真机专属验证项，**各工单收口时在此补全具体步骤与通过标准**：
|
||||
|
||||
1. **媒体上传弱网表现**：真机蜂窝/弱 Wi-Fi 下选图→压缩→预签名直传→确认全链路；中断重试不产生孤儿 asset（对应 T3-13 验收的真机侧）。
|
||||
2. **乐观更新真机手感**：点赞/收藏快速连点的防抖与回滚动画在真机帧率下的表现（对应 T3-15/16）。
|
||||
3. **Feed 图片加载**：真机上滚动 Feed 的图片加载/缓存/占位表现；MinIO 经局域网/公网访问 URL 的可达性差异。
|
||||
4. **社区事件落库**：community 域 v3 事件（platform=android）落库观察（沿 M2 验证一的方法，事件名换 v3 增量）。
|
||||
1. **媒体上传弱网表现**（T3-13 收口补全，2026-09-09）：真机蜂窝/弱 Wi-Fi 下选图→压缩→预签名直传→确认全链路；中断重试不产生孤儿 asset。
|
||||
|
||||
**前置**：通用前置准备的后端六容器在位；`PATBOND_MINIO_PUBLIC_ENDPOINT` 必须配置为手机可达地址（工作机局域网 IP:9000，.env 覆盖后重启 compose）——预签名直传 URL 直指 MinIO，漏配则手机端 PUT 必然连不上；`flutter run` 时四个 base URL 全传（含 `PATBOND_COMMUNITY_API_BASE_URL`），media 上传走 user 服务 :8082（`PATBOND_USER_API_BASE_URL`）。入口：发布页（T3-17 落地后）九宫格选图。
|
||||
|
||||
**步骤与通过标准**：
|
||||
- （a）**蜂窝正常网**：相册多选 3 张 12MP 大图 → 逐格出现进度环且百分比递增（非一跳 100%）→ 全部转 ready；后端 `media.assets` 对应 3 行 `status='ready'`。压缩耗时中端机单张 ≤2s（超出记录机型上报）。
|
||||
- （b）**弱网中断重试**：开发者选项限速或电梯/地库弱网，上传中开飞行模式掐断直传 → 该格转失败态（红色蒙层 + 重试通栏），其余图不受影响；恢复网络点格内重试 → 转 ready。
|
||||
- （c）**孤儿不引用**：在（b）失败态与上传中态各尝试一次发布 → 发布钮 gating 拦截（全部 ready 前不可提交）；发帖成功后 psql 核对 `community.post_media` 引用的 assetId 全部 `status='ready'`，且不含（b）中断产生的旧 assetId（该行保持 `uploading`，属服务端超时清理范围，不算失败）。
|
||||
- （d）**凭据过期**：选一张图后挂起 App >10 分钟再恢复触发重试 → 客户端自动换新凭据完成上传（用户无感知，不弹「签名过期」类错误）。
|
||||
- （e）**HEIC/方向**：iPhone 传输的 HEIC 图与横拍竖拍各一张 → 压缩层统一出 jpeg 且方向正确（服务端 mime 白名单不收 HEIC，此项只能真机验证原生编解码）。
|
||||
2. **乐观更新真机手感**（T3-15/16 收口补全，2026-09-09）：点赞/收藏快速连点的合并与回滚动画在真机帧率下的表现；Feed 卡片与详情页跨页状态一致。
|
||||
|
||||
**前置**：通用前置准备的后端六容器在位；`flutter run` 时四个 base URL 全传（含 `PATBOND_COMMUNITY_API_BASE_URL=http://<局域网IP>:8084`）。数据：Feed 内至少一条他人发布的帖子（可按 iteration-3 24 号报告 §5（a）种子方式造）。
|
||||
|
||||
**步骤与通过标准**：
|
||||
- （a）**激活动画帧率**：Feed 卡片与详情页各点赞一次 → 图标同帧翻转 + 240ms 弹性缩放（1→1.25→1）+ 计数即时 ±1；中低端机无可见掉帧或延迟出现的「二次跳动」。取消点赞仅颜色渐出、无缩放。
|
||||
- （b）**快速连点合并**：同一帖 1 秒内连点点赞 5~6 次 → 视觉每次即时翻转；抓包或服务端访问日志核对该帖 like 端点请求 ≤2 个（单飞 + 最终意图补发）；停点后终态与最后一次点击一致，计数与 `GET /api/v1/posts/{id}` 权威值相符。
|
||||
- （c）**断网回滚**：开飞行模式后点赞 → 图标即时翻转，数秒内**零动画直接跳回**原状态（不得出现「心已灭计数未减」的中间帧或回弹动画）+ SnackBar「操作失败，请重试」恰一条；恢复网络重点 → 正常收敛。
|
||||
- （d）**跨页一致**：Feed 卡片点赞 → 进详情页应已是激活态；详情页取消收藏 → 返回 Feed 卡片同步取消（同一 ToggleSync 实例，无需刷新）。
|
||||
- （e）**减弱动态**：系统开启「移除/减弱动画」后点赞 → 状态瞬变、无缩放动画，功能不受影响。
|
||||
3. **Feed 图片加载**（T3-14 收口补全，2026-09-09）：真机上滚动 Feed 的图片加载/缓存/占位表现；MinIO 经局域网/公网访问 URL 的可达性差异。
|
||||
|
||||
**前置**：通用前置准备的后端六容器在位；`PATBOND_MINIO_PUBLIC_ENDPOINT` 必须配置为手机可达地址（工作机局域网 IP:9000，.env 覆盖后重启 compose）——Feed 卡片封面 URL 是服务端现签的预签名 GET、直指 MinIO，漏配则真机图片全部走失败兜底（`surfaceTint` 底 + pets 图标）；`flutter run` 时四个 base URL 全传（含 `PATBOND_COMMUNITY_API_BASE_URL=http://<局域网IP>:8084`）。数据：桌面/工作机先按 iteration-3 24 号报告 §5（a）的种子方式发 ≥26 帖（含单图/多图），保证两页以上可翻。
|
||||
|
||||
**步骤与通过标准**：
|
||||
- （a）**首屏与占位**：登录进 Feed → 图片卡先出 `surfaceTint` 加载块（无白闪/布局跳动），随后出图；多图卡右下「+N」角标可读（ink 80% 胶囊白字）。
|
||||
- （b）**滚动加载**：连续滚到列表底再回顶 → 中低端机不掉帧卡死；回滚经过已看过的图**不重新转圈**（缓存 key 已剥签名参数，同图不同签名命中同一内存缓存——若出现「每次刷新同图重新下载」即为缓存 key 回归，判失败）。
|
||||
- （c）**下拉刷新后的缓存命中**：下拉刷新（服务端对同一批图重新现签、URL 必然变化）→ 已展示过的封面应即时出图不过转圈；抓包或 MinIO 访问日志核对同对象未重复 GET。
|
||||
- （d）**过期 URL 重取**：Feed 停留 >1 小时（预签名 TTL）后滚到未加载过的卡 → 旧 URL 过期图走失败兜底属预期，下拉刷新取新签 URL 后恢复出图，无崩溃。
|
||||
- （e）**可达性差异**：Wi-Fi（局域网 IP）与蜂窝（若 MinIO 未公网暴露）各滚一遍——蜂窝下连不上 MinIO 时应稳定显示失败兜底图标而非无限转圈；记录两种网络的首图出图耗时。
|
||||
4. **社区事件落库**（T3-17 收口补全，2026-09-10）：community 域 v3 事件（platform=android）落库观察（沿 M2 验证一的方法，事件名换 v3 增量）。**桌面端不可替代**：Linux 桌面的 `platform=linux` 不在契约枚举内，整批 400 被拒（`analytics_service.dart` 既有预期行为），故 v3 事件的**落库**只能在 Android 上验证；键集与形态的落库正确性已在工作机以 curl 造真实 payload 验证（iteration-3/26 §5c 发布/媒体 8 事件、iteration-3/25 §5c 互动 8 事件）。
|
||||
|
||||
**前置**：通用前置准备的后端六容器在位；`flutter run` 时四个 base URL 全传（含 `PATBOND_COMMUNITY_API_BASE_URL`）；`PATBOND_MINIO_PUBLIC_ENDPOINT` 配为手机可达地址（媒体三段需真实直传）。可与第 1、2 项同一轮操作合并执行。
|
||||
|
||||
**步骤**：登录 → 首页 Feed 滚两屏并下拉刷新一次 → 进一条帖详情点赞/收藏/评论一次 → 返回 → 创作 Tab「发布动态」→ 输入正文 + 选 2 张图 → 「存草稿」一次 → 「发布」→ 回 Feed 确认新帖 → **退到后台等 5 秒**（触发冲刷）→ 工作机查库：
|
||||
|
||||
```bash
|
||||
docker exec patbond-postgres-1 psql -U patbond -d patbond -c \
|
||||
"SELECT event_name, platform, props FROM platform.product_events
|
||||
WHERE event_name LIKE 'post\_%' OR event_name LIKE 'feed\_%'
|
||||
OR event_name LIKE 'comment\_%' OR event_name LIKE 'user\_%'
|
||||
ORDER BY client_ts DESC LIMIT 40;"
|
||||
```
|
||||
|
||||
**通过标准**：
|
||||
- [ ] （a）**发布漏斗成链**：`post_create_started`(entryPoint=create_tab) → `post_draft_saved`(trigger=manual, mediaCount=2) → `post_publish_succeeded`(fromDraft=true、mediaCount=2、topicCount=0、textLengthBucket、durationMs>0) 三条齐全且 `platform=android`；无 `post_publish_failed`（顺利路径）。
|
||||
- [ ] （b）**媒体三段逐文件成对**：`post_media_upload_started` / `_succeeded` 各 **2** 条（每张图一条），`sizeBucket` 同一张图的 started/succeeded 取值一致，`durationMs` 为真实上传耗时（非 0）；中断重试的那张（与第 1 项（b）合并执行时）另有 `post_media_upload_failed`(failureReason=network_error, attemptSeq=1) + 重试后 started 的 `attemptSeq` 递进。
|
||||
- [ ] （c）**隐私红线**：上述 props 中**不含** postId / assetId / commentId / 文件名 / 本地路径 / URL / 精确字数（`textLength`）/ 精确字节数（`byteSize`）——出现任一即验收失败（红线 1/2/4）。
|
||||
- [ ] （d）**互动与 Feed**：`post_liked`/`post_favorited`(source=feed 或 post_detail)、`comment_create_succeeded`、`feed_viewed`（离开 Feed 时一条，impressionCount>0、refreshCount=1）落库；**无** `post_impression`/`post_viewed`（字典锁死为 unknown，若出现即客户端违规）。
|
||||
- [ ] （e）**页名归一化**：`page_viewed` 出现 `pageName='post_form'`（发布页）与 `'post_detail'`，且 pageName/referrer 中**不含 UUID**。
|
||||
- [ ] （f）拒绝计数为 0：查 app 日志无 `Analytics batch permanently rejected`，或服务端响应 `rejected=0`（有 rejected 说明事件名/键集与字典不符，属回归）。
|
||||
|
||||
## 执行记录（M3）
|
||||
|
||||
|
||||
Reference in New Issue
Block a user