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

13 Commits

Author SHA1 Message Date
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 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 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 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 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 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