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

6 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 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