Files
photo-live/docs
浅念 7e5c550fb3 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>
2026-09-29 10:10:49 +08:00
..
2026-09-17 16:13:49 +08:00
2026-09-17 16:13:49 +08:00

图片直播项目文档

版本:V1.3 · 更新日期:2026-09-17

本目录包含第一版项目需求、计划、技术实施与优化方案。建议按以下顺序阅读:

  1. 需求说明书:范围、角色、流程、功能和验收标准。

  2. 项目计划:工作分解、依赖、相对周次、工作量和交付门槛。

  3. 技术实施方案:架构、数据模型、接口、OSS、后台上传、实时互动、嵌入组件和部署。

  4. 优化方案:12 项优化、需求任务验收映射、异常处理和排期影响。

  5. 项目思维导图与计划导图:项目全景、业务流程、工作分解、里程碑和任务依赖,共七张图。

已确认的核心选型为 Flutter 双平台 App 与现有国内阿里云 OSS、全球 CDN、国内管理与海外观众服务。首发语种、服务端框架、测试容量和工期属于建议基线;优化已同步到原三份文档。项目计划按三名开发及兼职支持估算,约 156 至 231 角色人日,以 16 周排期为工作基线,需结合真实人员与技术验证结果修订。

当前只完成文档编制,尚未创建业务工程、接入用户接口或 OSS,也未执行产品功能与容量测试。

V1.3:第一期后台与 App 仅账号密码登录,飞书暂不接入;用户信息由指定接口定期拉取,密码与项目权限由本地管理。