浅念
8be21b856b
P3 Task 3 移动端（对接 Task 2 api client + 本任务新增的后端契约）： - 登录页实装：账号/密码表单（空值客户端校验）→ api.login（会话自动 持久化）→ pushReplacement /home；错误码本地化（AUTH_INVALID_ CREDENTIALS / AUTH_RATE_LIMITED（含稍后再试文案）/ 网络 / 校验）； 提交加载态防重复提交。 - 修改密码页（设置页入口）：当前/新/确认三字段，客户端校验（≥8 位、 两次一致）→ api.changePassword → toast + pop；成功后本地会话不变 （服务端保留当前会话）；旧密码错误（401 AUTH_INVALID_CREDENTIALS） 显示「当前密码错误」且不触发 401 驱逐。 - 退出登录：设置页按钮 → api.logout 尽力而为 → 清会话 → 清栈回 /login；App 壳 initState 注册 onUnauthorized（业务 401 → 清栈 /login）， 根 navigatorKey 接线；password-change 的 401 豁免会话驱逐（拦截器 豁免集合与令牌附加分离）。 - l10n：新增 16 组 zh/en 文案；错误码 → 文案解析扩展 （core/error_l10n.dart，errorCode→AppLocalizations）。 - 测试：ApiClient.changePassword 单测 ×2（Bearer+请求体；旧密码 401 不驱逐）；widget 测试 ×12（登录 5：空值/成功跳转/凭据错误/限速文案/ 加载禁用；改密 4：过短/不一致/旧密码错误文案+会话保留/成功 toast+pop 且令牌不变；设置 2：改密入口跳转/登出清会话回登录；App 壳 1：401 清栈回 /login）。flutter analyze 0 issue；flutter test 81/81。 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）；移动端命令以上述手动方式执行。