zhaoyuxi/patbond-flutter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
41 Commits 2 Branches 1 Tag
eff352684016bed1579369cee1037696a9228f47
Commit Graph

34 Commits

Author SHA1 Message Date
lixi eff3526840 新增：宠物头像接线——铅笔角标接上传、列表与详情展示真实头像（T3.5-09） 
- `Pet.avatarUrl` 入模型；列表卡与详情头像改用真实预签名 URL（无图仍回退
  爪印占位——服务端对非 ready 的 asset 直接给 null，客户端只有一种占位）。
- 详情页铅笔角标自此有功能：接 `MediaUploader`（purpose=pet_avatar）；已有
  头像时先给「更换 / 移除」二选一，移除即三态显式 null。
- 权限按 **WRITE 档**呈现（ADR-022 D3.5-3：owner + caregiver 可改头像，
  viewer 无入口），与资料编辑的 MANAGE 档刻意不同。因此纯头像 PATCH 只发
  `version` + `avatarAssetId`，**不夹带任何资料字段**——夹带会让服务端按更严
  的一半定档，caregiver 立刻 403。
- `UpdatePetRequest.avatarAssetId` 是该 schema 唯一的三态字段，其余字段保持
  M2 两态语义（它们的 CHECK 约束本就不允许空值，「清空」无意义）。
- 40902 冲突后重取档案让用户自行决定重来，不静默重放（头像是用户可见的
  覆盖操作，不该自动生效两次）。

测试 588 → 597（+9）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 15:37:25 +08:00
lixi a4a97c03c2 新增：资料页真实化 + 编辑页——/me 读写、PATCH 三态、获赞与作品统计（T3.5-08） 
资料页头部三项（展示名 / 头像 / 数字）自此全部来自服务端，176 行硬编码
demo（「萌宠新手（豆豆家长）」/ 24 / 1.8k / 2）退役。

- `PatchField<T>` 承载契约 v1.4.0 的 PATCH 三态（absent 不落键 / clear 落
  显式 null / value 落值）。三态必须由类型承载而非 `T?` 加约定：把「不改」
  也编码成 null，用户只改昵称就会连头像一起被服务端清掉。
- `UserProfile` 补 nickname / avatarUrl，展示回退 `nickname ?? username`
  **做在客户端展示层**——服务端 /me 刻意返回 DB 原值，编辑页因此只用原值
  预填，避免把展示约定固化成真实昵称。
- `ProfileController`：`/me` 主链路四态 + 两块统计独立三态（统计失败只降级
  这一块，不为两个数字丢掉整页）；登出 reset 防跨账号泄漏。
- 编辑页维护三态意图而非「当前值整体提交」：昵称 / 头像各有显式清除入口，
  未改字段的键根本不进 JSON；空 patch 直接短路（服务端对空 patch 答 400）。
- 昵称校验按**码点**计 1~32 且先 btrim，与 `ck_users_nickname` 对齐；
  纯空白是校验失败而非隐式清空。
- `MediaUploader` 的 purpose 参数化 + 复用其六态编排的 `AvatarUploadSheet`
  （单图、预览确认后才交付 ready assetId，孤儿防护不变）。
- 修复 `/api/v1/me` 端口线路：该端点由 user 服务（:8082）提供，`ApiAuthRepository`
  此前只挂 auth（:8081）会得到 404。此前无人消费 me()，故这条错线一直没被
  触发；本单是第一个真实消费者，桌面实测即暴露。

测试 526 → 588（+62）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 15:37:00 +08:00
lixi 7d5c84d06d 修复：花费卡展示实际月份 + 四张数据卡补可点提示（M3.5-03）
CI / flutter-gates (push) Successful in 3m24s
Details 
卡片标签硬编码「本月花费」，而服务端 summary.monthlyExpense 本就返回 month
（ISO year-month，按 tz 归月）。用户看不到实际月份，所以无法自证「我这条记录
到底落在哪个月」，把正确的 ¥0 当成统计故障。

已核实不改后端聚合：用户记录落在 2026-04-09、当天是 2026-09-10，
「本月花费 ¥0」是正确行为。本单只让客户端把口径亮出来。

- health_record_display 新增纯函数 monthlyExpenseCardLabel(month, {now})：
  同年「9 月花费」（窄卡一行放得下，故不取「2026-09 花费」）；跨年（服务端
  归月年份 ≠ 设备当前年份）「2026/12 花费」补年份消歧；串非法退回
  「本月花费」不崩不显示脏值。
- 可点提示：_SummaryCard 在 onTap 非空时右上角补 chevron_right。四张卡本都
  可点进明细页却无任何视觉提示（用户反馈不知道能点），提示形态沿用项目既有
  可点行/卡（宠物列表卡、健康提醒卡、资料页设置行）的 chevron_right，不自创。
- 整卡包 MergeSemantics：读屏一次读全「¥128.50，9 月花费，按钮」而非两段
  孤立文字。没有用 excludeSemantics——那会连带丢掉 InkWell 的可激活性。

既有测试口径调整：pet_detail_page_test 两处断言改为实际月份，且样本
monthlyExpense.month 改用当月串使断言不随年份漂移（跨年格式由纯函数单测覆盖）。

新增 integration_test/client_ux_live_test.dart（环境变量门控，默认 skip，
沿用 M3 既有 live 测试形态）：compose 六容器 + 真实 App 走完三项修复——
日期选择器全中文/品牌配色/手输录入/一键今天，以及花费卡实际月份 + chevron。
本机是 Wayland 会话、X11 import -window root 取不到根窗口，改为把整棵 App 包
一层 RepaintBoundary 后 toImage() 直出真实渲染像素落 build/ux-live/。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 18:00:21 +08:00
lixi 294fc4a781 修复：日期录入收口共享层——「今天」快捷键 + 品牌配色 datePickerTheme（M3.5-02） 
用户实测已因日期选择器误录：Flutter 原生日历只给年份网格、月份必须靠 < >
逐月点，从 9 月回 4 月要点 5 次，他把当月（2026-09）的就医记录记成了
2026-04-09，进而误判「本月花费 ¥0」是聚合坏了。

新增 lib/core/widgets/app_date_picker.dart，全仓 7 处裸 showDatePicker 收口
（改造后 lib/ 下 showDatePicker 只出现在该文件内部一次）：

- pickAppDate(...)：calendar 首屏 + 保留头部铅笔切手输；initialDate 自动夹进
  [firstDate, lastDate] 防原生越界断言（调用方常传「当前值 ?? 今天」，而
  「到期日期」的 firstDate 就是今天，历史值可能已越界）；返回值统一抹时分秒；
  中文文案一律交给 zh-CN 本地化，不硬编码，避免两处文案漂移。
- AppDateFieldTrailing(...)：7 处日期行统一「今天 + 日历图标」。今天越界自动
  隐藏按钮、提交中禁用、触控 44×44、primaryStrong 白底 4.49:1。

入口模式取舍：不用 calendarOnly——它恰好会砍掉手输按钮，把「录一个已知日期」
这条唯一快路堵死；也不用 input 首屏——「记今天」这类高频场景敲 8 个数字更慢。
两条路都留着最省事。

「今天」为何放表单行而非弹窗内：原生 showDatePicker 无法注入自定义动作
（builder 只能包裹整个 Dialog，拿不到内部选中态；塞进 Column 还会因 Dialog
在无界高度下贪心布局而溢出）。放表单行反而更快——一键落值连弹窗都不用开，
把容易走错的月份导航整段绕开，且一次实现 7 处形态完全一致。

各调用点原有的 firstDate/lastDate 业务约束原样传入、一字未改（健康事件
不许未来、到期日不许补记过去、疫苗 allowFuture 双态、生日不许未来），
并由 widget 测试直接断言 DatePickerDialog.firstDate/lastDate 防后续悄悄放宽。

顺带修配色：此前从未定制 datePickerTheme，选中日直接吃 ColorScheme.fromSeed
由珊瑚橙派生的暗红棕，与品牌脱节。新增 _datePickerTheme 只复用 05 号规范
（iteration-2/05、iteration-3/05）已审计的色对，不新造色值：头部
surfaceTint + primaryDark 7.98:1（选中 chip 同款）、选中日/年 primaryStrong
实底白字 4.49:1、今日 primaryStrong 1.5px 描边、星期表头 inkSoft 6.59:1、
越界日 muted（DEBT-2 允许的禁用态用途）。headerHeadlineStyle 取 22px
（默认 32）：中文「9月10日周四」在横屏侧栏头部 26px 起就折行。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 17:59:52 +08:00
lixi 6038901099 修复：Material 内置组件中文化——挂 zh-CN 三件套 delegate（M3.5-01） 
用户 Linux 桌面实测反馈「日期选择器全英文」。根因是 MaterialApp 从一迭代
建起就没配 localizationsDelegates/supportedLocales/locale，pubspec 也没有
flutter_localizations；Flutter 在缺 delegate 时静默回退内置的
DefaultMaterialLocalizations（只有英文），于是业务自绘文案全中文、Material
内置组件全英文，同一弹窗里中英混排：

  Select date → 选择日期
  OK / Cancel → 确定 / 取消
  Enter Date → 输入日期
  Switch to input → 切换到输入模式
  Invalid format. / Out of range. → 格式无效。/ 超出范围。
  mm/dd/yyyy → yyyy/mm/dd（zh 顺序年在前）
  September 2026 → 2026年9月

处置：

- pubspec 加 flutter_localizations（sdk）与 intl（日期符号底座，显式直接
  依赖以锁定与 SDK 一致的版本）。
- 新增 lib/app/app_localization.dart 把 Global{Material,Cupertino,Widgets}
  三件套 delegate、supportedLocales、locale 收在一处常量：widget 测试若只
  pumpWidget(MaterialApp(home: ...)) 而不挂 delegate，测到的「中文」是假的，
  测试直接引用同一份常量，生产与测试不会各配一套而漂移。
- 单语言 zh-CN，不列 en：避免设备语言为英文时回退英文，再造混排。
- pets 域三份 widget 测试的 MaterialApp 同步挂上 delegate，
  tap(find.text('OK')) 相应改 '确定'——让测试与生产一致，而不是在英文兜底下测。

新增 test/app/app_localization_test.dart 守住这一行不被回删：断言根
MaterialApp 实际挂上三件套 + locale zh-CN，并从运行期 MaterialLocalizations
取回中文文案。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 17:59:21 +08:00
lixi 9892b65a19 新增：发布页真实化——媒体九宫格编辑态 + 建草稿/迁移发布两步 + 发布漏斗与媒体三段埋点，create 页 demo 发布流退役（T3-17）
CI / flutter-gates (push) Successful in 3m9s
Details 
- 新增 PostComposePage（P3 发布页，push 路由 post_form）：正文/类目
  （general·help）/九宫格选图（组装 MediaUploader + UploadProgressOverlay，
  删格按列表序重发 position）/发布 gating（正文非空 + 在场媒体全 ready）
- 发布走「createPost(draft) → PATCH status=published」两步：迁移失败时草稿
  已在服务端，UI 明确提示「草稿已保存」；40905 重置幂等键、42203 提示等图、
  网络失败同键重放不重复建帖；40902 自动取新 version 重提一次
- 草稿：「存草稿」(manual) 与「取消 → 保留」(on_exit) 两路径 + 进页恢复最新
  一条草稿（提示条/清空）；「不保留」软删服务端草稿（post_deleted 触点）
- 埋点：新增 post_analytics.dart（发布漏斗五事件 + 媒体三段，键集对齐字典
  v3）；MediaUploader 挂接 started/succeeded/failed(含 cancelled) 与 attemptSeq；
  pageName 枚举补 post_form
- PostMediaEditGrid（同文件编辑态）：3 列九宫格 + 虚线「＋」格 + 删除角标 +
  进度覆盖层 + 失败整格重试；页级上传汇总条
- create 页只余 AI 生成模拟（M4 原样保留），demo 发布流与 AppState.posts /
  publishPost / updatePost 及其持久化一并退役；首页 story「发布」与 Feed 空态
  CTA 改为 push 真实发布页
- 测试 458 → 502（+44）：发布页 widget 22、发布埋点 11、媒体三段 7、编辑态
  九宫格 4、主壳发布闭环 1；另加桌面真链路 integration_test（env 门控）
- flutter analyze 0 问题、dart format 无 diff；compose 六容器真链路实测通过
  （选图上传 → 发布 → Feed 置顶 → 第二客户端可见）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 14:42:13 +08:00
lixi f873acf9a3 新增：帖子详情页真实数据整页替换——四态/真九宫格大图/评论区/关注双态，Feed 导航与互动全接线，demo 详情退役（T3-15/16）
CI / flutter-gates (push) Failing after 20s
Details 
- post_detail_page 整页重写：内存副本先渲染 + getPost 拉新、四态
 （loading/error+重试/ready/40403 提示后返回 Feed 并刷新）；媒体全量
  ——单图原比例（高度钳制 [0.75w,1.33w]）、多图真九宫格（D11 轮播
  弃用，本单裁定）+ InteractiveViewer 全屏大图（03 号拍板 E）
- 评论区：游标列表触底补页 + 底部输入条创建（幂等键在数据层）+
  仅本人评论渲染删除入口（40301/40404 服务端兜底）；成败埋点对
 （durationMs 取输入会话起点、attemptSeq 会话内递增）；CommentTile
  升共享组件（@ 回复前缀呈现、降级作者「宠友」占位）
- 关注双态钮（tonal ＋关注 / Outlined 已关注 + 取关确认）乐观翻转、
  回滚零动画 + SnackBar，user_followed/unfollowed(post_detail) 挂接；
  本人帖不渲染
- Feed 接通：整卡与评论钮导航详情（T3-14 占位提示移除）、点赞/收藏
  接共享 ToggleSync（详情与卡片同一实例跨页一致）、toggleError
  一次性 SnackBar 消费
- 主壳/装配：openPost 按 postId push；create demo 流不再导航已退役的
  demo 详情（发布页真实化留 T3-17）；AppState 在 post_detail/Feed 面
  消费清零
- compose 冒烟（env 门控默认跳过）：真链路发帖/点赞幂等/收藏/评论/
  删评一轮 + 断网点赞回滚（生产 ApiClient 异常链）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 13:39:10 +08:00
lixi 92524da8e2 新增：互动埋点与乐观更新视觉基建——字典 v3 互动八事件封装 + ToggleSync 成功上报与触点归因 + LikeButton 三层闪烁抑制动画（T3-16） 
- community_interaction_analytics：post_liked/unliked、post_favorited/unfavorited、
  comment_create_succeeded/failed、user_followed/unfollowed 强类型封装（22 号
  白名单键集逐一对齐；textLengthBucket 分桶、httpStatus 由五位码推导、
  会话失效不上报）；comment_create_started 锁死 unknown 不封装
- CommunityController：toggleLike/toggleBookmark 增 source 触点归因
 （feed / post_detail），成功响应后经注入的 interactionAnalytics 上报
 （乐观翻转与失败不报）；adjustCommentCount 评论计数同源写入
 （详情副本与 Feed 卡片一并更新）
- LikeButton 升 Stateful：点按激活 240ms 弹性缩放 + 120ms 图标淡入、
  取消仅颜色渐出；回滚/对账零动画直接跳变、计数与状态成对更新、
  激活动画未播完等播完再跳（05 号 §3.5/§4）；减弱动态设置降级瞬变

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 13:38:50 +08:00
lixi 8aac8c52cc 新增：首页 Feed 接入真实数据——四态/尾部三态/聚合曝光埋点，社区 demo 消亡第一页（T3-14）
CI / flutter-gates (push) Successful in 2m41s
Details 
- home_page Feed segment 改接 CommunityController：骨架屏首载、空态 CTA、
  错误横幅重试、下拉刷新（失败保留旧列表 + SnackBar）、触底游标翻页
  （失败态只走显式重试，不随滚动风暴自动重打）
- PostCard 三形态（单图通栏 4:3 / 多图折叠封面 +N 角标 / 纯文字 6 行）+
  PostMediaGrid（列数规则 + ink 80% scrim 精算）+ LikeButton（error 族修订
  Colors.red，T3-14 纯展示禁用态，ToggleSync 接线留 T3-15/16）+ FeedSkeleton
  （呼吸动效尊重减弱动态设置）；降级作者统一「宠友」占位
- SignedNetworkImage：预签名 URL 缓存 key 剥离 X-Amz-* 签名参数，
  RemoteImage 全仓换用（同图不同签名命中同一缓存条目）
- feed 域埋点：feed_viewed 聚合曝光（浏览段开/结算于切 Tab、切分段、
  退后台、销毁；≥50% 可见 ≥500ms 段内按帖去重，postId 不上报）+
  feed_load_failed（refresh/load_more 双路，会话失效不报）
- integration_test/feed_live_test.dart：compose 六容器 Linux 桌面真链路
  实测入口（PATBOND_FEED_LIVE=1 门控，默认跳过）
- 测试 379 → 421（+42）：四态/尾部三态/翻页不丢不重/降级作者/曝光结算
  时机/缓存 key/事件属性全覆盖；analyze 0，format 无 diff

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 13:01:43 +08:00
lixi 1441f0148f 新增：媒体上传客户端——MediaUploader 编排状态机 + 预签名直传 + 进度组件，修正 media 端点误挂 community 服务（T3-13）
CI / flutter-gates (push) Successful in 2m30s
Details 
- MediaUploader：选图→压缩（80→60 降质阶梯，10 MiB 超限拒绝）→createUpload
  →预签名 PUT 直传（进度回调）→confirm→ready assetId 交付；并发槽位 2、
  顺序即 position、单图失败不拖垮整批；凭据过期预检与存储侧 403 各自动
  换新凭据一次；失败重试复用压缩产物、从 createUpload 全新开始
- 孤儿防护：未 confirm 的 assetId 只以管线局部变量存在，快照 assetId 与
  ready 态断言绑定，buildAttachRequests 非全员 ready 即抛 StateError
- 线路修正：media 两步上传端点由 user 服务（:8082 MediaController）提供,
  T3-12 误挂 community 客户端（:8084 无 media 路由），补 mediaApi 分端口
  直连，compose 真链路实测证实
- UploadProgressOverlay 四态进度层（05 号规范 §3.3）；直传层本地
  HttpServer 三线路测试（200/403/断连）；compose 冒烟测试
  （PATBOND_MEDIA_SMOKE=1 启用，默认跳过）
- 新依赖：image_picker、flutter_image_compress（03 号评估选型）
- flutter test 379 全绿（基线 347，+32）、analyze 0、format 无 diff

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 12:21:20 +08:00
lixi 19bd8c1810 新增：community feature 数据层——契约 v1.3.0 十九操作全覆盖 + ToggleSync 乐观更新状态机（T3-12）
CI / flutter-gates (push) Successful in 2m26s
Details 
- community_models：community/media 域 DTO 逐字段照冻结契约手写 JSON 映射
  （Post/FeedCard/PostComment/AuthorSummary 降级形态/媒体两步上传凭据等），
  未知枚举抛 FormatException 暴露契约漂移；CursorPage 上移 core 复用
- community_repository：13 路径 19 操作全覆盖；createPost/createComment
  必带 Idempotency-Key（每次逻辑提交换新键、刷新重放同键）；点赞/收藏/
  关注走 PUT/DELETE 语义幂等
- community_exceptions：v1.3.0 新增 9 码 + 40902 共码类型化异常映射
- toggle_sync：乐观翻转 + 快照回滚 + 单飞合并最终意图 + 代次守卫，
  点赞/收藏共用一套参数化状态机，权威终态对账收敛
- community_controller：Feed 多页缓存 + 首屏四态 + 尾部加载三态 +
  游标拼接 + 刷新代次丢弃旧尾页；详情副本与卡片互动状态同源；reset 清态
- app.dart 装配：community 服务分端口直连（:8084），共享 TokenRefresher，
  登出同步 reset
- 测试 286 → 347（模型映射 / 19 操作线路 / 错误映射 / 竞态序列全覆盖）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 12:01:25 +08:00
lixi 4d40c38f06 新增：埋点队列三项完善——30 秒定时冲刷、失败指数退避、anonymousId 持久化（T3-19）
CI / flutter-gates (push) Successful in 2m15s
Details 
- 30 秒定时冲刷：AnalyticsService.startPeriodicFlush/stopPeriodicFlush，
  前台期间 Timer.periodic 周期冲刷；SessionTracker 新增 onEnterForeground
  回调，退后台停（并保留既有 flushNow 触发）、回前台恢复，App dispose 收尾。
- 失败退避：网络错误/5xx 后 30s→60s→120s 指数退避封顶 5 分钟，退避窗口
  只挡定时冲刷（flushNow/满 20/冷启动显式触发不受限），上传成功即重置；
  429 改按网络错误同路径保段重试（Retry-After 分支待后端限流落地）。
- anonymousId 持久化：restore 时从 shared_preferences 采用/落盘
  pb.analytics.anonymousId，首次生成后跨冷启动稳定；读取失败降级
  进程内临时 id 不崩溃。
- 测试 272 → 286（+14）：fakeAsync 定时/退避 8 个、anonymousId 4 个、
  429 保段 1 个、前后台回调成对 1 个；analyze 0 问题、format 无 diff。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 16:12:19 +08:00
lixi ba503327f5 新增：照护提醒接入与疫苗流转收尾（T2-14 提醒半边 + T2-13 遗留）
CI / flutter-gates (push) Successful in 2m12s
Details 
- 照护提醒页：status 过滤（服务端白名单视图）、due_at ASC、逾期红标
  双通道标识，四态齐备；创建表单（四类）+ 完成（completedAt 必带、
  支持补记）/ 忽略（禁带 completedAt）流转，42202/40902 兜底重拉
- 档案页：「健康提醒」卡改真实待办数据驱动（取代 demo 硬编码文案，
  最近到期一条 + 逾期警示形态），照护提醒导航入口带待办数副行
- 疫苗列表（25 号报告遗留①②）：scheduled 行「标记完成/取消登记」
  PATCH 流转；完成对话框补录厂商/批号（契约可选字段）；
  42201/40902/40402 兜底
- 埋点：create 三事件 + viewed（recordType=reminder）挂通；
  edit_succeeded/failed 挂 vaccine 流转（failureReason 含 conflict）；
  提醒完成/忽略按 06 §7 缺口 3 既定取舍不埋
- 测试 250 → 272 全绿（+22，较基线 +48）；analyze 0 问题；format 无 diff

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 14:01:17 +08:00
lixi e186ba3da9 新增：健康事件时间线接入真实数据（T2-14 时间线半边） 
- 时间线页：occurred_at DESC cursor 分页 + 月分组组头，四态齐备；
  六类事件经 RecordTypeDot 映射（增补喂养/洗护/测量三型，色族复用
  已审计色对），类型 TagPill 双通道
- 事件录入表单：六类类型选择器、金额以元录入/整数分传输（money.dart
  换算）、UTC 时间戳约定与体重表单一致
- 事件编辑页：顶层 PATCH 差量提交（title/notes/amountCents + version），
  40902 照 T2-12 模式自动经时间线检索取新 version 重提（保留输入）
- 档案页：月度花费卡接 summary.monthlyExpense（分→元展示）、tz 透传
  设备时区固定偏移（T2-13 遗留③）、健康时间线导航入口
- 埋点：health_record 域 create 三事件 + viewed（recordType=health_event）
  挂通；新增 edit_succeeded/failed 封装（failureReason 含 conflict）
- 测试 224 → 250 全绿（+26）；analyze 0 问题；format 无 diff

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 13:49:48 +08:00
lixi c91f18a845 新增：疫苗登记/记录列表与档案页摘要卡接入（T2-13 疫苗半边）
CI / flutter-gates (push) Successful in 1m49s
Details 
- VaccinationFormPage：目录按宠物物种过滤（四态）、seriesKey 目录 code
  预填、scheduled/completed 状态-日期规则结构化 + 纯函数双重前端拦截，
  42201/40904 后端兜底横幅（均有测试）
- VaccinationRecordsPage：按系列分组、三态 TagPill（含 cancelled 留痕）、
  四态齐备；viewer 隐藏登记入口
- 档案页数据卡行接 GET /pets/{id}/summary 实时聚合：最新体重/疫苗进度/
  下一针三卡，null 语义为空态文案而非 0/0；从记录页返回即重拉摘要
- health_record 埋点装配（app→shell→pets→detail→记录页面族）
- 测试 205 → 224（+19）全绿；analyze 0 问题；format 无 diff

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 13:20:04 +08:00
lixi 5b34fa336b 新增：体重录入与历史列表接入真实数据（T2-13 体重半边） 
- WeightRecordsPage：cursor 分页（加载更多/末页收起/翻页失败保留重试）、
  loading/empty/error/retry 四态、下拉刷新；viewer 隐藏录入入口
- WeightFormPage：weightKg 契约区间 (0,500] 与两位小数前端校验 + 40000
  兜底；称重时间转 UTC 上送；错误三层分层沿用登录纵切
- health_record 域埋点强类型封装（06 §1.4：create_started/succeeded/
  failed + viewed，httpStatus 由业务码推导；viewed 按工单口径取列表曝光）
- health_record_display 纯函数（体重解析/展示、疫苗状态映射、42201
  规则前端拦截函数）；PetsController 暴露 repository（22 号 §7 交接）
- 测试 177 → 205（+28）全绿

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 13:17:17 +08:00
lixi 97a1f46e3f 重构：宠物列表/详情/编辑页接入真实数据（T2-12，四态齐备）
CI / flutter-gates (push) Successful in 1m31s
Details 
- 档案 Tab 替换为真实宠物列表（05 号规范 P1）：PetsController 四态
  驱动（loading/empty/error+重试/ready），空态插画 + 建档 CTA，
  下拉刷新，虚线添加卡；页面一律走 T2-11 数据层、不直连 ApiClient
- 新增 PetDetailPage（P2 档案信息部分）：内存副本首屏 + getPet 刷新，
  40401 防枚举 → 不存在态返回列表并刷新；仅 owner 显示编辑入口
  （40300 语义）；体重/疫苗/时间线区块留待 T2-13/14 接摘要与记录接口
- 新增 PetFormPage（建档/编辑）：品种目录接口 + 自定义品种互斥
  （目录失败回落自定义 + 重试）、性别契约必填、生日+估算、芯片号；
  失焦+提交双校验、错误三层模型沿用登录纵切
- 40902 版本冲突：明确提示 + 自动拉取最新 version 重提路径（有测试）；
  40903 芯片号冲突字段级报错（有测试）
- 埋点挂接：pet_create_started（表单首次输入、每次进入一次）/
  succeeded / failed 三事件接线；建宠表单路由名 pet_form、详情页
  pet_detail 进入既有 RouteObserver 采集；档案 Tab 页名 pet_archive
  改报 pet_list（字典 v2）；编辑表单不带路由名（漏斗到达段不掺编辑）
- app.dart 装配：pet 服务 ApiClient（:8083）共享 TokenRefresher；
  登出 reset 控制器防跨账号泄漏；PetsController.loadBreeds 按物种缓存
- AppState 清理：pets 页原 demo 消费方移除，vaccines 及其模型/持久化
  删除；pet demo 仅存首页问候/创作页/主壳头像（后续工单收敛）
- 头像按 ADR-010 本地占位，不做上传
- 测试 145 → 177 全绿（列表/详情/表单四态与冲突路径 widget 测试、
  控制器 loadBreeds/reset、展示纯函数）；analyze 0；format 无 diff

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 12:15:32 +08:00
lixi c0a8a56e91 新增：pet 域埋点强类型封装（06 号规划字典 v2 三事件） 
- pet_create_started / succeeded / failed 三事件（13 号规范 §3.1
  强类型惯例：枚举编译期锁死，业务代码禁止手拼事件名与属性）
- entryPoint 三枚举（post_register_guide 预留）；failureReason 四枚举
  （pet_limit_reached 因产品未设上限未纳入；5xx 与断网/超时客户端
  不可区分，并入 network_error）
- errorCode 携带业务码并推导 httpStatus（code ~/ 100）；attemptSeq
  记录表单会话内提交序号
- 单元测试 4 个（属性齐备、可空属性缺席语义）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 11:59:32 +08:00
lixi 3179528c57 新增：档案页共享组件三件 + TagPill 深变体映射（DEBT-1 偿还） 
- PetAvatar 四尺寸档（96/64/44/32）收敛头像重复实现：3px 白描边 +
  轻投影，编辑徽标底改 primaryStrong（白图标 4.49:1 达非文字 3:1），
  M2 无上传（ADR-010），url 缺省渲染本地占位形态
- RecordTypeDot 三尺寸档 + 五类记录类型的图标/三色映射唯一出口
  （05 号规范 §2 表，供 T2-13/14 时间线复用）
- EmptyStateIllustration 空态插画区（112 圆 + 标题 + 说明 + 可选 CTA）
- TagPill 增可选 inkColor，缺省按 color 查深变体映射
  （primary→primaryDark 8.74:1 / success→successInk 7.39:1 /
  accent→accentDark 7.07:1 / error→errorDark 5.78:1 / 未命中→ink），
  既有调用零参数回归
- AppColors 新增 errorDark #B02C25、inkSoft #6B5A4A（05 号规范 D8）

flutter test 141/141 全绿；analyze 0 问题（T2-12 第一部分）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 11:57:31 +08:00
lixi 7fb9031f8d 新增：pets feature 数据层（T2-11，契约 v1.2.0 全 18 操作）
CI / flutter-gates (push) Successful in 1m12s
Details 
- pet_models.dart：pets 域 DTO 逐字段对齐冻结契约（宠物/品种/体重/
  疫苗目录/疫苗/健康事件/照护提醒/聚合摘要 + cursor 分页信封），
  枚举严格解析，请求体部分更新语义（缺席字段不出现）
- pets_repository.dart：PetsRepository 抽象 + ApiPetsRepository，
  12 路径 18 操作全覆盖；四个 POST 携带 Idempotency-Key；
  复用既有 ApiClient token 拦截与单飞刷新重放
- pet_exceptions.dart：新 8 错误码映射为类型化异常
  （40300/40401/40402/40902/40903/40904/42201/42202），
  仍可按 ApiBusinessException 基类捕获
- pets_controller.dart：宠物档案状态自 AppState 拆出
  （Controller → Repository → API Client 分层，四态就绪供 T2-12）
- money.dart：元/分换算工具（DTO 层保持整数分，UI 层 T2-14 使用）
- api_client.dart：新增 patbondPetApiBaseUrl（:8083，--dart-define
  可覆盖）与 query 参数支持；api_exception.dart 补 pets 域错误码
- 测试 64 → 126：DTO 映射、错误类型化映射、请求线路
  （路径/方法/鉴权/分页/幂等键/tz）、控制器状态机、金额换算

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 11:22:24 +08:00
lixi 33b993ca0c 新增：埋点分段持久化队列（13 号规范 §3.3，M2 第二波）
CI / flutter-gates (push) Successful in 1m6s
Details 
- AnalyticsEventStore：shared_preferences 分段存储（每段 ≤20 条、
  总上限 500 超限丢最旧整段）、冷启动恢复、损坏段/损坏索引容错、
  droppedCount 丢弃诊断计数
- AnalyticsService 接入持久化队列：上传拿到终态（202/4xx）才删段
  实现 at-least-once；冲刷按段拼批 ≤50 条循环上传（契约单批上限）；
  取批即封段，冲刷在途新事件写入新开放段不丢
- app.dart 冷启动 restore() 恢复离线积压并冲刷（13 号 §3.4 触发点）
- 保留第一波语义：flushNow()、4xx 毒丸丢弃、满 20 条冲刷触发
- 新增 13 个单测（恢复/上限淘汰/损坏容错/202 清段/flushNow 协同/
  分批上传），全套 64 测试全绿

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 17:04:16 +08:00
lixi 1afec6aad1 fix: 埋点上传链路三处修复 + 注册手机号 +86 前缀
CI / flutter-gates (push) Successful in 1m3s
Details 
- events 上传地址接错：AnalyticsService 误用 auth(8081)，实际端点在
  user 服务(8082)，新增 patbondUserApiBaseUrl 并接线
- 冲刷时机：新增 flushNow()，SessionTracker 首次离开前台触发，
  修复低活跃用户凑不满 20 条事件永不上传
- 毒丸批次：4xx 永久性拒绝不再重回队列无限重试，丢弃并打日志
- Web/桌面 Platform API 降级（kIsWeb + _platformName）
- 注册手机号 UI 固定 +86 前缀、提交拼 E.164；AppTextField 支持 prefixText

51 测试全绿、analyze 0 问题；Linux 桌面实测注册成功，
curl 实测后端 /api/v1/events 校验行为符合契约。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 16:48:36 +08:00
lixi 8ea6265046 fix: Web 平台 Platform.operatingSystemVersion 不支持降级处理
CI / flutter-gates (push) Successful in 1m5s
Details 
AnalyticsService._defaultOsVersion() 在 Web 平台调用 Platform.operatingSystemVersion
会抛 UnsupportedError，导致 flutter run -d chrome 启动崩溃。加 kIsWeb 判断，
Web 平台降级为 'web-unknown'，Android/iOS 保持动态读取不变。

复现：flutter run -d chrome → 报错 analytics_service.dart:53
修复后：Web 平台正常启动；51 测试全绿、flutter analyze 0 问题。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 15:44:17 +08:00
lixi 6fef0db009 新增：page_viewed 集中式路由埋点（NavigatorObserver）
CI / flutter-gates (push) Successful in 1m3s
Details 
- AnalyticsRouteObserver：didPush/didReplace/didPop 集中捕获，页面零侵入
- AnalyticsPageName 枚举：pageName 编译期锁死（字典 v2 九个初始值 + 客户端现存 create/pet_archive/services/post_detail），字典外路由不上报
- PageViewTracker：page_viewed 单一上报出口，维护 referrer 链（栈底/冷启动首页为 null）与去重（Tab 重复点选）
- 三类非路由曝光手动补点：主壳 Tab 切换（IndexedStack）、认证状态机切页（AnimatedSwitcher）、回栈到无名根路由（resolveRootPage）
- 既有 Navigator.push 挂 RouteSettings.name：login_page（register）、main_shell_page（post_detail）；fade_route 签名扩展可选 settings
- M2 健康档案页面（pet_list/pet_detail/pet_form/record_form/record_detail）先留枚举定义，待功能落地接线

测试新增 8 例（analytics_route_observer_test）：push 上报/push 两页 referrer 链正确 + pop 补报/根路由 resolveRootPage 补报/枚举外不报/dialog 不报/Tab 去重/referrer 连贯/reportTab。

验收对照（06 号报告 §5.2 六条）：1✓ observer 注册、2✓ pageName 枚举含 pet_form、3✓ referrer 链、4✓ 字典外不报、5✓ 单测 push/pop/referrer、6✓ M1 存量四页接全。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 14:50:04 +08:00
lixi 4c2f839a01 修复：埋点接线与三处偏差（sessionId/eventId/设备信息） 
- 生产接线修复：app.dart 组装时传 analytics 实例给 ApiAuthRepository（_buildRepository），修复 M1 遗留的「生产环境 _analytics 恒为 null、挂接点空转」问题
- sessionId 生命周期：新建 SessionTracker (WidgetsBindingObserver)，冷启动生成 UUIDv7、后台超 30 分钟换新、未超阈值沿用原值，不再每事件随机生成
- eventId 改 UUIDv7：对齐 13 号规范（uuid 包已在依赖，直接用 v7()），保留插入时间局部性
- appVersion 动态注入：package_info_plus（新增依赖）异步读取后 setAppVersion，不再硬编码 '1.0.0+1'
- osVersion 动态读取：Platform.operatingSystemVersion 正则提取主版本（如 android-14），不再硬编码
- 队列顺手加固：上传失败批次重回队首而非整批丢弃（一行级缓解，分段持久化属 M2 第二波）

测试新增 9 例：session_tracker_test（5 例：冷启动/短后台/长后台/级联状态/连续幂等），analytics_service_test 补强 4 例（UUIDv7/sessionId 不再逐事件生成/appVersion 可注入/失败重回队列）。

验收对照（06 号报告 §5.1 六条）：1✓ SessionTracker 新建、2✓ 三条语义、3✓ 同会话 sessionId 一致、4✓ sessionId 为 UUID 不持久化、5✓ 单测 3 例（实际 5 例）、6✓ 真机脚本（开发者手测）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 14:49:24 +08:00
lixi 3f8388e5d4 fix: 清零 flutter analyze 问题并修复隐私红线正则缺陷（CI 门禁）
CI / flutter-gates (push) Successful in 50s
Details 
- 修复真实缺陷：隐私红线 RegExp 使用 Dart 不支持的 (?i) 内联标志，构造即抛异常
  导致带 props 的事件被静默丢弃；改为 caseSensitive: false
- 清理埋点模块未用 import/字段/变量（4 warning）
- 构造函数改用初始化形参（含 Dart 3.12 私有具名参数）
- E2E 手动脚本声明 ignore avoid_print + library 指令
- 门禁：format 0 changed / analyze No issues / flutter test 34 passed
 2026-09-04 19:44:46 +08:00
lixi 45f94d2558 style: dart format analytics_service（CI 门禁要求）
CI / flutter-gates (push) Failing after 22s
Details
2026-09-04 18:31:04 +08:00
lixi 60d67a355b feat: 埋点采集模块落地——AnalyticsService + 登录/注册/退出三事件（M0 简化版，报告 13） 
- AnalyticsService：trackEvent(name, props?)/identify(userId)/reset()；隐私红线本地校验（password/token/phone 等模式拒绝）；匿名 ID 持久化复用 session deviceId；sessionId 简化为每事件生成（M0）；网络失败静默丢弃（无重试，按规范）
- 登录/注册成功挂接 auth_login_succeeded / auth_register_succeeded（durationMs）；失败挂接 _failed（failureReason）；退出挂接 auth_logout
- TODO（工单允许部分挂接）：page_viewed（登录/注册/首页/个人中心各一次，M0 无路由埋点基础）；health_record_action（M2 档案实现后挂接）；auth_session_restore_*（Splash 恢复流程待完善）；队列持久化到 shared_preferences 分段（当前内存队列 max 500，满 20 触发上传）
- 测试：flutter test → 34 passed（30→34，新增 analytics_service_test 4 例：字段/隐私拒绝/identify/reset）；flutter analyze → 86 issues（与上一波同源）；dart format → 1 changed

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-04 17:14:20 +08:00
lixi 845e92fa7d fix: UserProfile.phone 改为可空，消除非空强转崩溃点 
- 跨端契约核对发现（功能清单「跨端核对发现」项）：服务端 phone 可返回 null
- 门禁：format 0 changed / analyze 0 issues / flutter test 30 passed
 2026-09-04 14:55:40 +08:00
lixi da25804a06 fix: 登录页补充 42300 账号锁定错误码映射 
- 对齐后端 T4 新增的登录锁定契约（openapi.yaml），锁定时展示明确横幅而非通用兜底
- 门禁：format 0 changed / analyze 0 issues / flutter test 30 passed
 2026-09-04 12:17:25 +08:00
lixi 8d890c0424 feat: 落地登录纵切——网络层、认证会话与登录/注册/Splash 三页（ADR-003/ADR-004） 
- 新增 lib/core/network/：ApiClient（dio 封装，错误信封→类型化异常，base URL 经 --dart-define=PATBOND_API_BASE_URL 注入）、AuthInterceptor（Bearer + 设备标识）、TokenRefresher（单飞刷新，401/40101 重放一次，仅 40102/再 401 清会话）
- 新增 lib/features/auth/：SessionManager（token 只进 flutter_secure_storage）、AuthRepository（login/register/refresh/logout/me，注册带 Idempotency-Key）、Splash（500ms 最短停留/5s 超时/错误态重试+改用账号登录）、登录页与注册页（照 12 号组装稿，错误三层映射，预留区不渲染）
- App 根组件改为认证状态机驱动（Splash↔登录↔主壳 300ms fade）；个人中心退出登录接入真实 logout
- 顺带修复：FIX-1 促销卡渐变改 [primaryStrong, primary]、FIX-2 补 helperStyle: muted、README dart format 命令补 --output=none
- 新增依赖：dio ^5.11.1、flutter_secure_storage ^11.0.0、uuid ^4.6.0
- 门禁：dart format（0 changed）/ flutter analyze（No issues）/ flutter test（30 passed，其中新增 23：TokenRefresher 5 + AuthRepository 10 + 登录页 4 + 注册页 4）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-04 11:52:51 +08:00
lixi af002edde3 feat: 迁移珊瑚橙主题体系并新增认证基础组件（ADR-005） 
- app_theme.dart 重写为语义 token（AppColors/AppRadius），落地 primaryStrong/error 等 AA 对比度色
- 五个页面与公共组件的旧靛蓝硬编码色值全部替换为 token，仅换色不动布局
- 新增 BrandMark/AppTextField/PrimaryButton/InlineErrorBanner/AuthScaffold 及 6 个 widget 测试
- 门禁：dart format（0 changed）/ flutter analyze（0 issues）/ flutter test（7 passed）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-04 10:34:18 +08:00
lixi b9d7c9f2ee 新增静态演示界面 2026-07-21 17:41:01 +08:00
nmbh1122@126.com 120525741d Initial Flutter project structure、 2026-07-15 12:01:04 +08:00