patbond-api

zhaoyuxi/patbond-api

Fork 0

Commit Graph

Author	SHA1	Message	Date
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	8fbf44472d	feat: 宠物 CRUD 与 pet_owners 三角色权限框架（T2-03） CI / backend-test (push) Successful in 7m22s Details - GET/POST /api/v1/pets、GET/PATCH /api/v1/pets/{petId}、GET /api/v1/breeds （species 过滤）；创建者自动写入 pet_owners primary owner（同事务） - PetAccessService 统一权限闸口（READ/WRITE/MANAGE 三档 × owner/caregiver/ viewer 三角色，ADR-015）：无关系一律 404/40401 防枚举，可见越权 403/40300；每请求实时查库无缓存，撤销关系即时生效；T2-04~07 复用同一入口 - PATCH version 乐观锁（40902）；部分更新语义；status 白名单排除 deleted，软删除不可经 PATCH 绕过 ck_pets_deleted - ck_pets_breed 互斥 + 字典品种存在/物种匹配应用层先行校验（40000）；芯片号唯一冲突新错误码 40903 MICROCHIP_EXISTS - pet 模块接入 RS256 bearer 鉴权（与 user 同一公钥约定），compose 挂载公钥 - 测试基建：test classpath 引入 patbond-user + Flyway，Testcontainers 上跑完整 V1..V4 迁移链；三角色以测试数据直写 pet_owners 构造（T2-10） - 集成测试覆盖六类路径 23 例；全套 118 测试全绿（基线 95） Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-09-07 17:27:44 +08:00
lixi	0eae1c9bec	feat: 新建 patbond-pet 模块骨架（ADR-009，T2-02 前置） - 新 Maven 模块挂入父 pom，依赖/插件管理对齐既有 user/auth 模式（common 依赖、starter-web/validation/jdbc、exec classifier repackage） - 骨架内容：PetApplication、/health 探活端点（含 DB 连通检查）、 GlobalExceptionHandler（同一 {code,message,data} 信封契约） - 与 user 共库只读写 pet_health schema；不携带 Flyway——单一迁移链（V1..V4）仍由 patbond-user 启动时统一执行，flyway_schema_history 不拆 - 配置走 .sample 模式（默认端口 8083，敏感信息经环境变量注入不入库） - compose 编排纳入 pet 服务（依赖 postgres 健康 + user 先起保证迁移就绪）； Dockerfile 与既有服务同模式；Readme 模块清单同步 - 测试：Testcontainers postgres:18 上下文启动冒烟 + /health 探活断言 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-09-07 14:34:52 +08:00

Author

SHA1

Message

Date

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

8fbf44472d

feat: 宠物 CRUD 与 pet_owners 三角色权限框架（T2-03）

CI / backend-test (push) Successful in 7m22s

Details

- GET/POST /api/v1/pets、GET/PATCH /api/v1/pets/{petId}、GET /api/v1/breeds
  （species 过滤）；创建者自动写入 pet_owners primary owner（同事务）
- PetAccessService 统一权限闸口（READ/WRITE/MANAGE 三档 × owner/caregiver/
  viewer 三角色，ADR-015）：无关系一律 404/40401 防枚举，可见越权 403/40300；
  每请求实时查库无缓存，撤销关系即时生效；T2-04~07 复用同一入口
- PATCH version 乐观锁（40902）；部分更新语义；status 白名单排除 deleted，
  软删除不可经 PATCH 绕过 ck_pets_deleted
- ck_pets_breed 互斥 + 字典品种存在/物种匹配应用层先行校验（40000）；
  芯片号唯一冲突新错误码 40903 MICROCHIP_EXISTS
- pet 模块接入 RS256 bearer 鉴权（与 user 同一公钥约定），compose 挂载公钥
- 测试基建：test classpath 引入 patbond-user + Flyway，Testcontainers 上跑
  完整 V1..V4 迁移链；三角色以测试数据直写 pet_owners 构造（T2-10）
- 集成测试覆盖六类路径 23 例；全套 118 测试全绿（基线 95）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-09-07 17:27:44 +08:00

lixi

0eae1c9bec

feat: 新建 patbond-pet 模块骨架（ADR-009，T2-02 前置）

- 新 Maven 模块挂入父 pom，依赖/插件管理对齐既有 user/auth 模式
  （common 依赖、starter-web/validation/jdbc、exec classifier repackage）
- 骨架内容：PetApplication、/health 探活端点（含 DB 连通检查）、
  GlobalExceptionHandler（同一 {code,message,data} 信封契约）
- 与 user 共库只读写 pet_health schema；不携带 Flyway——单一迁移链
  （V1..V4）仍由 patbond-user 启动时统一执行，flyway_schema_history 不拆
- 配置走 .sample 模式（默认端口 8083，敏感信息经环境变量注入不入库）
- compose 编排纳入 pet 服务（依赖 postgres 健康 + user 先起保证迁移就绪）；
  Dockerfile 与既有服务同模式；Readme 模块清单同步
- 测试：Testcontainers postgres:18 上下文启动冒烟 + /health 探活断言

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-09-07 14:34:52 +08:00

3 Commits