zhaoyuxi/patbond-api
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.4.0 M3.5 体验补齐 #1

Merged
lixi merged 4 commits from dev into main 2026-09-14 11:14:55 +08:00
Conversation 0 Commits 4 Files Changed 41
+3595 -202

4 Commits

Author SHA1 Message Date
lixi 3cd8005577 test(contract): v1.4.0 快照四模块同步 + 用户资料与头像矩阵入场（T3.5-07）
CI / backend-test (push) Successful in 5m31s
Details
CI / backend-test (pull_request) Successful in 6m42s
Details 
doc 仓正典 main@5f02909 冻结 v1.4.0 后的 api 侧收尾：字节级同步快照、守卫
升版、新增/变更操作入契约一致性矩阵。**零生产代码改动**（只改契约快照与测试）。

快照同步（字节级，md5 与正典逐一比对一致 a7081fb84f1207eef579ab94025f5801）：
- 四模块 openapi-v1.3.0.yaml → openapi-v1.4.0.yaml，删旧文件（守卫只认一份，
  保留旧快照是死重；历史版本由 git 与 doc 仓承载，沿 T3-19 先例）
- 四份守卫期望升版：1.3.0/31/43/72 → 1.4.0/32/45/75

矩阵扩展（173 → 181 格，豁免仍为 1 格）：
- patbond-auth +5 格：PATCH /api/v1/me 全响应矩阵（200 设值 / 200 显式 null
  清空 / 400 空 patch / 401 / 404 双码 40400+40405 / 422 42203），并让 GET
  /api/v1/me 在 nickname 非空分支再走一遍严格校验。注意 /api/v1/me 的守卫与
  矩阵都在 auth 模块（实现在 user，契约测试跨服务发请求），扩契约易漏
- patbond-pet +1 格：PATCH /api/v1/pets/{petId} 新增 422/42203；404 单元格
  补 40405 第二种业务码（幽灵 asset 与用途不符 asset 合并同答），并补一格
  挂 ready 头像的 200
- patbond-community +2 格：GET /api/v1/me/community-stats 200（空数据零值与
  有数据 1 赞/2 作品两分支）+ 401（由全操作循环覆盖）
- patbond-user media 域 2 操作 8 格不变（v1.4.0 未触碰其冻结面）

T3.5-04/05/06 遗留的 11 格契约守卫红（auth 2 + pet 9，根因为新增字段未冻结）
全部转绿。测试 379 → 381（+2 个新增矩阵方法），根反应堆 clean test 全绿，
check-secrets.sh --all exit 0。

mutation 自证（三处定向注毒均红、还原即绿）：CommunityStats.required 注入
fakeStatsField → GET /me/community-stats 200 报漂移；Me.required 注入
fakeMeField → GET+PATCH /me 200 报漂移；Pet.required 注入 fakePetAvatarField
→ POST /pets 201 等 9 格报漂移。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-11 10:33:19 +08:00
lixi d98a400f47 feat: 获赞聚合——新增 GET /api/v1/me/community-stats 读侧实时聚合（T3.5-06，ADR-022）
CI / backend-test (push) Failing after 1s
Details 
- 新增 GET /api/v1/me/community-stats，返回
  {receivedLikeCount, publishedPostCount}：本人「已发布且未软删」帖的
  like_count 之和与帖子数
- 口径：草稿不计（尚非作品）、软删不计（删帖即撤回其数字）、运营态
  hidden/archived 不计（在 M3 契约里对所有人不可见）、他人帖不计；空数据答 0
  不答 null，任何已认证用户都有 stats，从不 404
- 走读侧实时聚合不引冗余列（ADR-022）：写侧无按人计数器，也就没有可漂移的
  副本；单次查询压在 ix_posts_author_created 的前导列上
- 端点独立而不并入 /users/{userId}/follow-stats（ADR-022 决策 A）：后者主体是
  「某用户的关注数」，混入「我的获赞」会让一个载荷有两个主体；且本端点主体
  恒为 token 里的自己，路径上没有可枚举的 userId
- 测试 +12（空数据零值/多帖求和/自赞与取消赞/草稿与软删与运营态排除/他人帖
  不串味/401 两态/无他人入口/并发与重复读幂等/载荷形态），community 模块
  94 → 106

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 10:03:07 +08:00
lixi 15c2e66519 feat: 宠物头像读写——PATCH 支持 avatarAssetId、详情与列表补 avatarUrl（T3.5-05，ADR-022） 
- PATCH /api/v1/pets/{petId} 支持 avatarAssetId 三态：缺省不改、显式 null
  清空、给值设置。这是 pets 域唯一的三态字段——M2 惯例「null 与缺省同义」
  无法表达「删掉头像」，而 name/species/sex 本就不允许为空，故差异刻意限定
  在本字段
- 权限按「本次请求碰了哪些字段」定档：仅改头像为 WRITE（owner+caregiver，
  ADR-022：头像属日常照护信息，与体重/疫苗同档），碰到任一资料字段仍是
  MANAGE（仅 owner），混合请求按更严的一半判；viewer 一律 403/40300
- 头像与资料共用同一把乐观锁：仅改头像也吃 version，旧版本必答 409/40902
- asset 校验复用 T3-03 引用侧协议 + purpose='pet_avatar'：不存在/非本人/
  已删/用途不符答 404/40405，本人未就绪答 422/42203（user_avatar 资源也不能
  当宠物头像）
- 详情与列表响应补 avatarUrl（本地 SigV4 现签预签名 GET，沿用 community 读侧
  先例）：仅当 asset 为 ready 才签，指针在而资源退出 ready 时降级为 null，
  不签一个下载必 404 的地址，也不隐式清理指针
- PetRepository 读改为返回 PetRow（含头像存储坐标），签名上移到 PetService，
  与 community 的 PostRow → PostResponse 装配同构——过期 URL 不下沉到仓储层
- pet 模块加入 aws-sdk s3（仅本地签名，不直连对象存储）与读侧 patbond.media
  配置；compose 补同一组 PATBOND_MINIO_* 环境变量
- 测试 +11（成功/清空/缺省保留/降级/caregiver 与 viewer 权限/防枚举 404/
  asset 五态/畸形入参/乐观锁与重放），pet 模块 89 → 100

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 10:02:50 +08:00
lixi a5634c5f85 feat: 用户资料读写——GET/PATCH /api/v1/me 补昵称与头像 URL（T3.5-04，ADR-022） 
- GET /api/v1/me 补 nickname 与 avatarUrl：nickname 为 DB 原值不做 username
  回退（/me 是本人编辑态，回退会让用户误以为已设过昵称；他人视角的回退仍在
  /internal/users/profiles 的 SQL 层，M3 T3-05 已交付）；avatarUrl 每次现签
  预签名 GET，非 ready 或存储未配置一律降级为 null 而非 500
- 新增 PATCH /api/v1/me：nickname 与 avatarAssetId 均为三态语义——键缺省即
  不改、显式 null 即清空、给值即设置；空 patch 答 400/40000 而非静默 200
- nickname 校验对齐 ck_users_nickname：btrim 后按码点计 1~32（PostgreSQL
  char_length 数码点，按 UTF-16 长度校验会误拒 32 个 emoji），纯空白答 40000
  而非隐式清空（清空只留显式 null 一种表达）
- avatarAssetId 沿用 T3-03 引用侧协议：不存在/非本人/已删/用途非
  user_avatar 均答 404/40405（防枚举合并），本人 user_avatar 未就绪答
  422/42203
- 写入走列级选择性 UPDATE 而非读-合并-写：并发的昵称与头像 PATCH 互不覆盖，
  故 /me 无需暴露版本号乐观锁
- MediaProperties.allowedPurposes 增 user_avatar/pet_avatar（ADR-022：purpose
  无 CHECK 约束，新用途只改配置，零 Flyway 迁移）
- 测试 +22（19 无存储降级路径 + 3 真实 MinIO 全链路签名/下载），user 模块
  100 → 131

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 10:02:26 +08:00