xinyouhe/photo-live
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
213 Commits 1 Branch 0 Tags
5a207b395e4e0a8b3e85938b2c7a79d0cac1b48a
Commit Graph

32 Commits

Author SHA1 Message Date
浅念 5a207b395e feat(app,viewer): WeChat card share + 'Share to...' label + site og tags 
- 按钮文字「分享到微信/其他应用」→「分享到...」（用户需求）
- 微信卡片分享（fluwx 6）：WECHAT_APPID 经 --dart-define 注入；已配置且
  装微信 → WXWebpage 卡片（标题=相册名、描述=日期·地点、缩略图=封面压缩
  240px PNG ≤32KB、点击进观众链接）；未配置/未装 → 回退系统分享面板
- viewer index.html 加站点级 og 标签（微信/QQ 抓取链接预览用；每相册动态
  og 需服务端注入，登记后续增强）
- 397/397 全绿、analyze 0

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 16:05:53 +08:00
浅念 e44b35db28 feat(albums): date-only pickers for start/end (create & edit, admin + app) 
- 管理后台：DatePicker type=datetime → date；提交归一（开始=当天 00:00、
  结束=当天 23:59 整天活动语义；契约仍 datetime 仅交互粒度）
- App：去掉时间选择步骤（选日期即定；同上归一）；表单显示只显 yyyy/M/d
- e2e 日期填入改 '2026-10-01'（date 格式）；widget 断言日期粒度
- admin 87/87 + build、app 397/397 全绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 14:13:58 +08:00
浅念 20321f1b93 fix(app): account-switch data residue + empty-albums pull-to-refresh 
- 换账号数据残留（用户报告）：albumListProvider 非 autoDispose 且首页
  IndexedStack 常驻——登出与登录成功两处显式 invalidate（任务库本就按账号
  隔离键隔离，不受影响）
- 空相册无法下拉刷新（用户报告）：空态原本直接 return EmptyState 无
  RefreshIndicator——被拉进相册后无法手动刷新；空态改入可滚动容器承载
  下拉刷新（保留新建入口）
- 397/397 全绿、analyze 0

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 12:05:25 +08:00
浅念 4d31eaf184 fix(app): poster sheet close button — header row with explicit close (drag-down not obvious on long sheet) 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 11:32:02 +08:00
浅念 df0c318599 feat(app): share redesign — card share (system), QR poster (banner+title+time+venue+QR, downloadable), copy link 
- 三方式（用户需求）：①卡片模式默认=系统分享面板（share_plus SharePlus.
  instance，微信/其他应用，文本=标题+链接）②生成二维码=海报弹层——顶部
  宣传图（banner→cover→品牌占位回退）+ 活动标题 + 时间 + 地址 + 二维码，
  「下载海报图」RepaintBoundary 3x 渲染 PNG → gal 存相册 ③复制链接
- 依赖 share_plus + gal；分享/保存均 Provider 注入（测试替身）
- 测试适配三方式结构 + 海报弹层断言（397/397 全绿、analyze 0）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 11:27:32 +08:00
浅念 c2143e1f94 feat(app): album banner picker in edit form — show current banner, pick & upload on save 
- api_client：uploadAlbumAssetFromFile 泛化（cover 为薄壳）+ fetchAlbumAssetUrl
  （GET /albums/{id}/assets → 指定 kind 全局行 URL）
- 编辑页 Details：封面下方新增「宣传图」3:1 选择器——编辑模式异步加载现有
  banner 预览（失败静默）；保存成功后上传（同封面：失败不阻塞表单结果）
- 未保存变更判断纳入 banner；l10n zh/en
- 测试适配：编辑用例 pumpForm 后清空 banner 现状预检请求（397/397 全绿）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 11:07:54 +08:00
浅念 8e674a902e feat(albums): soft-delete albums (admin+owner, hidden & irreversible, both app entries) 
契约 deleteAlbum（DELETE /albums/{albumId} → 204 幂等）+ status enum 'deleted'：
- 服务端：softDelete（canView 404→canManage 403 防枚举；乐观锁 claim +
  outbox album.updated priority=high + audit album.delete）；列表/详情/更新/
  成员/资产/分类/水印/照片/展示位绑定全部 deleted→404；公开端 cn
  （status!=='active'）与 ov（isAlbumVisibleOv）天然屏蔽；ov 副本经
  album.updated 载荷 status 直投自动下线
- Admin：列表表格操作「删除」+ 详情页头「删除相册」（确认含不可恢复说明）
- App：操作面板「删除相册」（红字、二次确认、成功退回列表并刷新）
- 验证：API 56/56、App 397/397（analyze 0）、admin typecheck/lint/test/build 绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 10:13:08 +08:00
浅念 6074fc8ed3 feat(ui06): App line A0-A7 — nav pill removal, light segments, bare summary, token alignment to app-preview 
- tokens：次文字 #69778E、soft/card-border/seg 色组、输入圆角 10（kRadiusField）
- theme：导航 indicatorColor 透明+显式选中蓝；卡片去阴影改 1px #EDF0F5 边框；输入边框同步
- 新组件 SegmentTabs（#EDF1F6 轨道/选中实蓝/light 浅蓝变体/null 无高亮）替换 M3 SegmentedButton
- 上传中心：摘要去白卡直排+主数字 32/40；completed 次级筛选无高亮语义保留
- 相册卡 scrim 30% 起 #0C1728E8；导航角标红底白字白边；登录主标题 27/700
- theme_test 三处旧规格断言随 UI06 值更新；397/397 全绿、analyze 0 issues
- 真机证据：MuMu + 测试服务器 API，登录/相册/详情/上传 4 页截图确认达标
- 登记偏差：语义色保持对比度合规深色版；视口矩阵随 G2；详见验收记录 §6

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 08:09:20 +08:00
浅念 b353a3de06 fix(viewer): replace text arrow share icon with SVG share glyph 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-22 13:55:37 +08:00
浅念 8ee69598bf feat(mobile): UI-03 photos and share pages (17-20) 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-22 02:45:34 +08:00
浅念 ab51616c70 feat(mobile): UI-03 capture and upload pages (13-16) 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-22 02:06:23 +08:00
浅念 8bd09eefb9 feat(mobile): UI-03 forms and collaboration pages (09-12) 
- Page 09 create: grouped form (Event details / Description & languages),
  required default-language selector, zh-CN/en tabs with per-locale
  title/description/venue/address, explicit timezone field, bottom save
  button kept keyboard-reachable, create mode has no Access tab
- Page 10 edit: Details/Access tabs sharing one draft; Access has four
  switches with explanations; original downloads constrained by downloads
  (disabled + forced off in PATCH); unsaved-changes PopScope confirm;
  save commits all changes in one minimal PATCH
- Page 11 members: Owner group + Collaborators list with initial avatars
  and per-row remove; full-width Invite colleague opens account-search
  bottom sheet (debounced prefix search, race guard, already-added state);
  remove confirm names the member
- Page 12 categories: extracted to standalone page with per-row edit/
  delete menu and New category sheet (language tabs + name + sort order);
  delete confirm mentions photo impact; collaborator browse-only; old
  inline section removed from album detail
- l10n: new form/members/categories keys both locales; regenerated
- tests: form 14, members 6, categories 7, detail nav 1; full suite green

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-22 01:23:02 +08:00
浅念 5715c608d8 feat(mobile): UI-03 album workspace pages (05-08) 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-22 00:57:59 +08:00
浅念 95e8417553 feat(mobile): UI-03 theme calibration and account pages (01-04) 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-22 00:28:39 +08:00
浅念 1f67b7c818 feat(mobile): UI-01 upload center, capture and auxiliary pages 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-21 17:20:43 +08:00
浅念 f6929ae18f feat(mobile): UI-01 album cards, photo grid and full viewer 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-21 15:55:44 +08:00
浅念 c94b9e5e58 feat(mobile): UI-01 theme system, shared components and navigation 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-21 14:55:29 +08:00
浅念 8f4ad11bd5 feat(contracts,api): UI-01 cover, preview, scope=own and embed config extensions 
契约扩展（全部可选/可空，旧客户端零感知）+ cn/ov 实现 + e2e 权限矩阵：
- AlbumSummary += cover（kind=cover state=effective 最新行的短期签名 URL，
  列表/详情按页批量组装非 N+1；未配置为 null）
- AdminPhoto += preview{thumb,browse}（变体齐备且未删除才签发；隐藏仅
  admin/owner；协作者仅自己上传，scope=own 服务端过滤 uploaderId，
  成员资格逐请求裁决）
- listAlbumPhotos += scope=all|own（缺省 all 行为不变：仅 owner/admin，
  协作者 403；own 任何有效成员）
- EmbedSlotSettings += imageFit/offsetX/offsetBottom/zIndex（cn PATCH 校验
  → slot-state 投影 → ov 公开回读；settings 为 Json 列免迁移，读侧
  normalizeStoredSettings 兜旧形状默认值）
- Flutter 模型同步（SignedUrl/PhotoPreview/AlbumPhotoScope，可空容错）

e2e：ui01-contracts 9 例（封面选取/字节取回/N+1 计数断言、preview 权限
矩阵、scope 过滤与 403/404/400）+ embed ⑨ 配置链路；全量 e2e 257 通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-21 14:09:35 +08:00
浅念 5cdf828ff5 docs: G1 gate closure recorded in master plan and P5 draft 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-21 10:17:16 +08:00
浅念 7385785504 feat(i18n): T15 full-stack language audit with coverage assertions 
- viewer/admin 错误码→文案映射按契约 ErrorCodes 枚举全集登记（机器守护
  spec 遍历枚举断言无缺漏 + 映射键在 zh/en 词条均存在 + locale 键集
  递归相等）；mobile 镜像补齐 DOWNLOAD_DISABLED（P4a 增补漏登）
- 漏译修复：viewer.photoRemoved en 侧缺失（审计测试捕获）；
  DOWNLOAD_DISABLED 观众侧专属文案 + useDownload 专属提示接线；
  admin apiMsg 增 RATE_LIMITED/ALBUM_NOT_PUBLIC/DOWNLOAD_DISABLED/
  SYNC_AUTH_FAILED 四码词条
- 运行时抽查：admin 主旅程 en 版 e2e（登录→相册管理全英文 + 偏好
  持久）；embed iframe lang=en 渲染与深链跟随 e2e（zh 侧既有用例覆盖）
- contracts 新增 ./errors 浏览器安全子路径（errors.ts 纯 TS）；
  admin 增 @photo/contracts devDep（仅测试消费）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-20 23:44:27 +08:00
浅念 d41be367f8 fix(mobile,it): integration suite stabilization on real device 
Root causes found & fixed across 29 phase-1 + 3 phase-2 runs:
- MSYS path mangling for adb shell device paths (per-command MSYS_NO_PATHCONV + winpath)
- adb reverse tcp:9000: presign URLs embed server-side localhost MinIO host,
  unreachable from emulator (uploads hung forever)
- compose --profile ov omitted: Docker restarts stranded ov side (ov-api 500s)
- soft keyboard occlusion on dialog buttons (dismissKeyboard + ensureVisible)
- stacked-route BackButton ambiguity (goBack must tap topmost hit-testable)
- bottom-sheet entrance animation race (wait for hit-testable option)
- language leg: drive LocaleSettings provider (sheet tap flaky, covered by unit tests)
- password page: self-pops on success (no extra goBack)
- bg verify: server-side authoritative assertion (fresh process = fresh memory DB)
- flutter test uninstall-reinstall wipes app data: image dir fallback to /data/local/tmp
- run-as cp failures no longer silently swallowed
- phase-2 missing IT_STAFF_ACCOUNT define

Phase 1: all 12 legs green (login→album→category→invite→3 uploads via native
WorkManager→server history→ov visible→hide sync→network fault/recovery→
password change→relogin→locale switch)
Phase 2: bg-home + kill-restart green (A04/A05 emulator-level)

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-20 15:03:17 +08:00
浅念 fb3c278e50 test(mobile): integration suite against real backend on mumu 
P3 Task 11 (WRITE & COMPILE phase; device run pending MuMu availability).

- integration_test/p3_flow_test.dart: login -> album (zh+en) -> category
  -> invite -> enqueue 3 real JPEGs -> queue completed -> server history
  (sourceDeviceId) -> ov public API sees 3 -> hide via API + UI sync ->
  DIO fault-gate offline (waitingNetwork -> retry -> 4 completed) ->
  password change (session kept) -> relogin -> in-app locale smoke.
- integration_test/p3_background_test.dart: IT_PHASE=prepare/verify spec
  for HOME-background continuation and force-stop kill-restart recovery
  (2 x ~14MB noise JPEGs give a deterministic mid-flight window).
- helpers: dart-define config, fault-injecting DIO adapter, app harness
  (picker/notification/locale provider overrides), UI step library with
  live-binding polling (no pumpAndSettle).
- scripts/run-mobile-it.sh: device detect (exit 2), backend ensure
  (compose + api/ov/worker/sync, exit 3), idempotent per-run user seed
  (no DB reset), APK build/install + adb push of testdata, phase 1 /
  --background phase 2 orchestration with server-side confirmed-count
  truth via curl.
- services/api seed:it script (create-if-absent staff accounts).
- debug-only network security config: cleartext HTTP permitted to
  10.0.2.2/127.0.0.1/localhost only (release unaffected).
- testdata: 3 x ~120KB + 2 x ~14MB generated JPEGs.

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 05:35:16 +08:00
浅念 8f3966d7b5 feat(mobile): in-app locale switching 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 05:00:11 +08:00
浅念 955f9b13c1 feat(mobile): upload queue ui and continuous capture page 
Task 9 (P3 plan): queue tab replaces the stub, continuous capture page
enqueues per shot, album detail gains an upload FAB, and the upload
engine lifecycle is now bound to the login session.

- Engine scope: session account drives UploadEngine start/stop; wired
  from app boot, login success, logout, and 401 eviction. Tasks stay in
  the store across logout (accountId hard isolation).
- Queue tab: album x state x time filter bar, task rows with thumbnail,
  state chip, localized error copy, attempt count, per-row progress via
  a broadcast progress hub, state-dependent actions (re-pick retry,
  retryNow, cancel, delete), batch retry bar, 200ms-debounced live
  refresh from drift table updates.
- Capture page: camera preview via injected CaptureSource, one enqueue
  per shutter press, persistent album/category/badges overlay with a
  switch-only-affects-new-shots hint, gallery multi-pick, exit confirm
  while uploads are pending, permission-denied and init-failure views.
- POST_NOTIFICATIONS runtime permission via a small MethodChannel
  (photolive/permissions) + PermissionPlugin.kt: single runtime
  permission need, avoids permission_handler dependency; requested once
  on first enqueue, silent degradation when denied or unavailable.
- Album detail FAB: capture-and-upload / pick-from-gallery sheet.
- l10n: ~50 new keys in zh/en arbs; tests: +45 (filter matrix, engine
  scope lifecycle, permission gate, queue tab, capture page, FAB entry);
  existing page tests updated to inject session/task-store fakes.

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 04:47:31 +08:00
浅念 42e1c2e34b feat(mobile): ios background upload bridge (compile-gated at G3) 
Swift 侧（协议与 Android UploadPlugin.kt 逐字一致，编译/真机留 G3）：
- UploadBridge.swift：通道/方法/事件/失败码常量 + registerTask 参数解析
  （镜像 UploadProtocol.kt）
- UploadEventBus.swift：单调 seq + 终态 ack 缓存重放（镜像
  UploadEventBus.kt），iOS 增强——未 ack 终态落盘（系统后台拉起投递的
  回调在进程重启后同样重放，技术方案 §6.2 持久化原生回调）
- UploadTaskStore.swift：taskId→URLSession taskIdentifier 映射 plist 持久化
  （Application Support；对应 Android WorkManager 自持映射）
- UploadPlugin.swift：URLSession background
  （com.photolive.photo_live.uploads）+ delegate 失败分类（2xx→completed+etag
  / 403→needsRenew / 4xx→HTTP_4XX / 网络→重试上限后 NETWORK，镜像
  UploadPutExecutor/UploadWorker）、原生重试（5 次上限、10s 指数退避）、
  进度 500ms 节流、queryTask/cancelTask/ackEvents、静默取消
- AppDelegate.swift：implicit engine 通道注册 + 启动重建会话 +
  handleEventsForBackgroundURLSession completionHandler 暂存
- Info.plist：UIBackgroundModes 有意不声明（background URLSession 无需；
  计划措辞按技术方案 §6.2 修正，见 README-ios.md）
- project.pbxproj 登记新 Swift 文件；README-ios.md（Xcode 步骤 + G3 验证
  清单：实际文件上传/持久化回调窗口/服务端补偿/重启重联校准/强制退出/
  低电量延迟/100 张批量）

Dart：NativeTransport 选择矩阵并入 iOS（Platform.isAndroid || isIOS，
FORCE_DART_TRANSPORT 覆盖不变）——协议两侧一致，无新通道代码。

flutter analyze 0 issue；flutter test 219 全绿。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 03:42:49 +08:00
浅念 4e35bdc0b2 feat(mobile): android background upload bridge via workmanager 
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>
 2026-09-19 03:22:42 +08:00
浅念 3ddb0ea2d4 feat(mobile): upload engine with preparation, batching states and retries 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 02:50:40 +08:00
浅念 d96e56f653 feat(mobile): drift upload task store with state machine 
- upload_tasks 表（accountId 隔离 + 三个复合索引）、状态列枚举转换器、
  datetime 文本落库（UTC 归一，亚秒精度）
- 纯状态机（task_state.dart）：合法迁移表 + canTransition/assertTransition，
  completed/cancelled 终态
- TaskStore 仓储：create（clientTaskId 同账号同相册应用侧唯一）、
  updateState（迁移守护+旁路字段）、账号隔离读路径（硬守护）、
  countsByState 徽章、cleanupCandidates/markCleanable（仅终态可清理——
  评审缺口 1 硬守护，未完成源文件永不清理）
- 测试 26 例（状态机表驱动全边 + 守护/隔离/筛选/保留策略）；
  sqlite3 3.x build hooks 在 flutter test 宿主与 Android APK 构建均验证
  （libsqlite3.so 已打包全 ABI，运行时验证留 Task 11）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 02:12:39 +08:00
浅念 bbea1dd364 feat(mobile): album management pages with qr share 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 01:56:38 +08:00
浅念 8be21b856b feat(mobile): login, password change and logout screens 
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>
 2026-09-19 01:19:57 +08:00
浅念 f975321b67 feat(mobile): api client, session storage and contract-aligned models 
P3 计划 Task 2（apps/mobile）：

- core/config.dart：API_BASE/VIEWER_BASE 经 --dart-define 覆盖，缺省
  10.0.2.2 模拟器宿主回环；viewer 相册链接构造 {VIEWER_BASE}/a/{token}。
- core/error_codes.dart：errors.ts 17 码 1:1 镜像（含注释），另设 4 个
  客户端本地伪码（NETWORK_ERROR/NETWORK_TIMEOUT/CANCELLED/HTTP_ERROR）。
- core/api_client.dart：dio 封装——Bearer 注入（登录端点豁免）、401
  驱逐（清会话 + onUnauthorized 回调去重，App 壳注册跳 /login）、
  DioException/错误体 {code,message,requestId} 归一 AppException、
  通用游标分页助手；auth/albums/members/categories/admin/uploads/photos
  全端点方法；riverpod provider 出口。
- core/session_store.dart：SessionStore 抽象 + flutter_secure_storage
  实现（token/expiresAt/account 三键，encode/decode 纯函数可测）。
- features/{auth,albums,uploads,photos}/models.dart：手写 fromJson/
  toJson，逐字段对齐 openapi.yaml（类注释标注契约 schema/operationId）；
  locale 按字符串透传（zh-CN 标识符不兼容），业务枚举 Dart 化并在
  未知值 fail-fast。
- 测试 66 项：17 码表驱动 + 网络/超时/取消 + 兜底映射、游标边界
  （含 CursorPageMeta 不变式违约容错）、模型往返（fixture 转写自
  openapi.yaml schema 与 api e2e 断言，来源在测试头注释）、拦截器
  行为（手写 FakeAdapter：Bearer 注入/401 驱逐/登录豁免/并发去重/
  尽力而为 logout/refresh 滑动续期）。flutter analyze 零告警。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 00:40:02 +08:00
浅念 8bc50e07ef feat(mobile): flutter scaffold with env script and baseline nav 
- scripts/flutter-env.sh: toolchain PATH/JAVA_HOME/ANDROID_HOME + pub 镜像 env
- apps/mobile: flutter create (com.photolive.photo_live, android+ios)
  - Android minSdk 24 / targetSdk 36；INTERNET 权限（main manifest，debug+release）
  - iOS Info.plist：本地网络 ATS 例外 + 相册/相机用途说明（zh+en）
- 依赖接入：riverpod / drift(+sqlite3_flutter_libs) / dio / secure_storage /
  image_picker / camera / qr_flutter / path_provider / path / intl
- l10n：l10n.yaml + app_zh/app_en arb（20 键），gen-l10n（zh 模板，非空 getter）
- 基线：Material 3 主题、/login→/home 命名路由、底部导航（相册/队列/设置桩）、
  locale provider 脚手架（Task 10 完成切换）
- flutter analyze 零问题；widget 测试通过；debug apk 构建成功
  （MuMu 冒烟因宿主 commit 内存耗尽未完成，Task 2 重试）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 00:22:04 +08:00