- 09 V5+community 骨架(191→206)、10 埋点队列三项(272→286)、 11 契约草案(13 路径/19 操作)、12 防泄漏三仓落地、 13 media MinIO 闭环 + auth 契约测试(→226,抓修 1 漂移)、14 收口总表 - backend-modules.md 更新五模块/六容器口径 - 媒体凭据形态已定型(契约冻结输入),剩余待定型点在 T3-04/05 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
> 本页是后端结构的**唯一权威速览**:模块怎么划分、各自负责什么、端口与依赖关系。
|
||||
> 结构性变更(新增/拆分模块)须经 ADR 决策并同步更新本页。
|
||||
> 最后更新:2026-09-07(M2 第二波,T2-03 进行中)。
|
||||
> 最后更新:2026-09-08(M3 第一波,T3-02 骨架落地)。
|
||||
|
||||
## 一图速览
|
||||
|
||||
@@ -11,10 +11,11 @@ patbond-api(Maven 多模块,Spring Boot 3.5 + JDK 17)
|
||||
├── patbond-common 公共库(无端口,被其余模块依赖)
|
||||
├── patbond-auth 认证服务 :8081
|
||||
├── patbond-user 用户服务 + 埋点 :8082 ← Flyway 迁移链唯一持有者
|
||||
└── patbond-pet 宠物健康档案服务 :8083 ← M2 新增(ADR-009)
|
||||
├── patbond-pet 宠物健康档案服务 :8083 ← M2 新增(ADR-009)
|
||||
└── patbond-community 社区服务 :8084 ← M3 新增(ADR-017)
|
||||
```
|
||||
|
||||
部署形态:docker compose 四容器(postgres:18 + auth + user + pet),应用容器无状态(ADR-007)。
|
||||
部署形态:docker compose 五容器(postgres:18 + auth + user + pet + community),应用容器无状态(ADR-007)。
|
||||
|
||||
## 模块职责
|
||||
|
||||
@@ -22,7 +23,7 @@ patbond-api(Maven 多模块,Spring Boot 3.5 + JDK 17)
|
||||
|
||||
- 统一错误信封与业务错误码体系(`code`/`message`/`data` 结构,稳定错误码契约)
|
||||
- 共享异常类型与基础组件
|
||||
- **不含业务逻辑、不起服务**;其余三个模块都依赖它
|
||||
- **不含业务逻辑、不起服务**;其余四个服务模块都依赖它
|
||||
|
||||
### patbond-auth(认证域,:8081)
|
||||
|
||||
@@ -47,6 +48,14 @@ patbond-api(Maven 多模块,Spring Boot 3.5 + JDK 17)
|
||||
- 照片/附件本迭代不做(ADR-010,media 域待对象存储选型)
|
||||
- **当前状态**:模块骨架 + T2-03(CRUD + 权限框架)施工中;数据表已由 V3 建好
|
||||
|
||||
### patbond-community(社区域,:8084,M3 新增)
|
||||
|
||||
- 社区 Feed / 帖子 / 单层评论 / 点赞收藏 / 关注(ADR-018 的 M3 MVP 范围;话题表已建但功能首版剪出)
|
||||
- 只读写 `community` schema(数据表由 V5 建);作者公开资料按 D3-9 方案 B 经 patbond-user 的 /internal 批量接口取数(后续波次落地)
|
||||
- `/api/v1/**` 自骨架起即接 RS256 资源侧校验(与 user/pet 同一公钥约定);`/health` 探活在 /api/v1 之外
|
||||
- media 上传流程不在本模块(ADR-017:实现在 patbond-user,社区侧只做 asset 只读校验)
|
||||
- **当前状态**:第一波骨架(T3-02)已落地;业务端点随 M3 后续波次按契约实现
|
||||
|
||||
## 关键纪律
|
||||
|
||||
1. **契约先行**:所有对外端点以 `patbond-doc/docs/api/openapi.yaml` 为唯一事实源,新接口先冻结契约再实现(M2 起)。
|
||||
|
||||
Reference in New Issue
Block a user