浅念
4e35bdc0b2
Kotlin 侧（MethodChannel photolive/uploads + EventChannel photolive/uploads/events）：
- UploadPlugin：registerTask 入队 WorkManager OneTimeWorkRequest（unique
work=upload-task-{taskId}，expedited + OutOfQuotaPolicy 回退、CONNECTED
约束、指数退避 10s 起）、cancelTask / queryTask / ackEvents
- UploadWorker（CoroutineWorker）：dataSync 前台服务 + 进度通知，
OkHttp PUT（ETag 捕获、64KB 分片进度），结局分类：2xx→completed、
403→needsRenew、4xx→failed{HTTP_4XX}、网络/5xx→Result.retry（上限
5 次后 failed{NETWORK|SERVER_ERROR}）、缺文件→failed{SOURCE_MISSING}
- UploadEventBus：终态事件单调 seq + 未 ack 缓存重放（上限 200），
重注册/取消作废旧缓存——进程重启/切后台恢复不丢完成信号
- Manifest：FOREGROUND_SERVICE(_DATA_SYNC)/POST_NOTIFICATIONS 权限 +
SystemForegroundService tools:node=merge 补 dataSync 类型（已验证
合并产物）
Dart 侧：Transport 接口（init/complete/renew 留引擎，仅 PUT 委托）——
DartHttpTransport（Task 6 逻辑抽出，403→renew 异常归一）+ NativeTransport
（registerTask→事件流终态/进度映射、终态 ack、取消联动）；引擎传输选择：
Android 缺省原生，dart-define FORCE_DART_TRANSPORT=true 强制 Dart 路径；
失败分类与 dio 路径语义对齐（401 短退避/429 网络桶/SOURCE_MISSING 不
自动重试等）
测试：gradle testDebugUnitTest 29 例（executor MockWebServer 分类×10、
协议解析×11、事件总线×8）；flutter test 219 全绿（新增 NativeTransport
事件映射/取消/ack/并发路由、引擎×Transport 委托与 needsRenew 重注册、
传输选择矩阵）；flutter analyze 0；debug apk 构建通过
Co-Authored-By: Claude Code <noreply@anthropic.com>
photo_live（工作人员 App）
P3 Flutter App（Android 优先；iOS 目录已生成但本机不编译，见计划 G3 关口）。
环境
工具链不在 PATH，所有 Flutter/Dart 命令先 source 仓库根的环境脚本（Git Bash）：
source scripts/flutter-env.sh # 仓库根执行；含 PATH/JAVA_HOME/ANDROID_HOME 与国内 pub 镜像
常用命令
cd apps/mobile
flutter pub get # 依赖
flutter gen-l10n # l10n 生成（arb 在 lib/l10n/，模板 app_zh.arb）
flutter analyze # 静态检查（要求 0 issue）
flutter test # 单测 / widget 测试
flutter build apk --debug # 产物 build/app/outputs/flutter-apk/app-debug.apk
MuMu 模拟器联调：
adb connect 127.0.0.1:16384 # 失败再试 5555 / 7555 / 21503
adb devices
adb install -r build/app/outputs/flutter-apk/app-debug.apk
adb shell am start -n com.photolive.photo_live/.MainActivity
结构
lib/app/：根组件、主题（Material 3）、locale provider 脚手架（Task 10 完成切换）lib/pages/：login / home（相册、队列、设置三个 tab 的桩页面）lib/l10n/：arb 与生成的app_localizations*.dart（zh 模板 + en）- Android：minSdk 24 / targetSdk 36；INTERNET 权限在 main manifest（debug+release 生效）
- iOS：Info.plist 含本地网络 ATS 例外（联调宿主回环；Android 侧对应
10.0.2.2）与相册/相机用途说明（zh+en）
说明
sqlite3_flutter_libs解析到0.6.0+eol（官方弃用桩：sqlite33.x 起经 Dart 原生构建钩子自带 SQLite，无需该包）；Task 5 建 drift schema 时在模拟器上验证实际打包行为。- turbo/pnpm 天然不纳入本目录（无 package.json）；移动端命令以上述手动方式执行。