feat(app): block selecting already-uploaded photos at picker tap (double-tap to force)

方案 A(选图点选拦截):multiImagePickerProvider 经 wechat_assets_picker
10.1.3 官方钩子 AssetPickerConfig.selectPredicate 挂 PickerDuplicateGate——
点选「已上传到目标相册」的照片当场拦下(SnackBar 提示),再次点击同一张
强制选择(escape hatch)。

- MultiImagePicker typedef 增参 accountId/albumId(拦截判定范围=当前
  目标相册;相册详情/连拍页两处调用点传入);
- 判定口径同 checkDuplicatesUnified:本机 TaskStore(同账号+相册+
  completed,filename+bytes)∪ 服务器单项预检(bytes;本机命中短路
  服务器,点选延迟考量);任一半场异常按该半场无命中,fileSize 失败等
  整体异常直接放行——enqueue 弹窗 + init 409 兜底不变;
- per-asset 判定缓存(二次点击瞬回)+ 二次点击放行集;取消选择恒放行
  且不预热放行集;
- AssetEntity 事实适配(PickerAssetFact 测试接缝):fileSize 为
  photo_manager 3.12 的 Future<int> 平台通道 getter(entity.dart:778),
  惰性求值;title 为 String?(Android 恒有值;iOS 需 needTitle——null
  时本机半场跳过,服务器按 bytes 仍可判);
- l10n pickerDuplicateBlocked(zh/en);测试替身签名同步
  (album_detail/capture_page 页测 + integration_test app_boot),
  页测补 (accountId, albumId) 接线断言;gate 五态用例入 enqueue_test。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-29 10:10:49 +08:00
parent 2261b8aebc
commit 7e5c550fb3
13 changed files with 563 additions and 17 deletions
@@ -28,9 +28,9 @@
- Modify: `apps/mobile/lib/l10n/app_zh.arb`、`app_en.arb`(+pickerDuplicateBlocked)
- Test: `apps/mobile/test/features/uploads/enqueue_test.dart`(gate 用例)、`test/pages/{album_detail_page,capture_page}_test.dart`、`integration_test/helpers/app_boot.dart`(替身签名)
- [ ] **Step 1: 失败测试**(gate 五态:本机命中首次拒/二次放行;服务器单项命中拒;两路空放行;服务器异常放行;取消选择恒放行——用 ProviderScope override 注入 fake taskStore/apiClient)
- [ ] **Step 2: 确认失败 → 实现**(先查 photo_manager AssetEntity 文件大小 API 与 title 语义)
- [ ] **Step 3: 全绿**(flutter analyze + 全量 test)
- [ ] **Step 4: Commit** `feat(app): block selecting already-uploaded photos at picker tap (double-tap to force)`
- [x] **Step 1: 失败测试**(gate 五态:本机命中首次拒/二次放行;服务器单项命中拒;两路空放行;服务器异常放行;取消选择恒放行——用 ProviderScope override 注入 fake taskStore/apiClient)
- [x] **Step 2: 确认失败 → 实现**(先查 photo_manager AssetEntity 文件大小 API 与 title 语义)
- [x] **Step 3: 全绿**(flutter analyze + 全量 test)
- [x] **Step 4: Commit** `feat(app): block selecting already-uploaded photos at picker tap (double-tap to force)`
**风险与回退:** 谓词异步查询在点选瞬间有 ~100-300ms 延迟(有缓存后二次即瞬回);查询失败放行=最坏回到现状(弹窗+409 兜底);revert 单 commit 即回退。置灰视觉(方案 B)不在本次。