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

10 Commits

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