资源库（Repository）

用途：决定持久化接口该怎么定义、查询该写在哪一层时查阅

定义

资源库为聚合提供“集合式”的存取抽象：接口定义在领域层，语义是“按标识取回聚合”“把聚合存回去”；实现放在基础设施层，负责 ORM、SQL、缓存与事务细节。

它与 DAO 的区别在于抽象层次：DAO 面向表，Repository 面向聚合。

如果领域对象直接依赖表结构与 SQL 方言，业务模型就会被存储设计绑架：换存储、拆表、加分库分表都要改模型；单元测试必须起数据库。Repository 把存储细节隔离在边界外，让模型可以独立演进与测试。

Eric Evans 的原始定义强调“集合语义”：仓储表现得像内存中该类型聚合的集合，只是这个集合被持久化了。

规则	说明
一个聚合一个仓储	不为聚合内部对象单独建仓储
只按聚合根存取	`findById(id): Aggregate`，不返回部分对象图
返回领域模型	不返回 DTO、不返回持久化对象
查询方法克制	只保留领域真正需要的查找（`existsByX`、`findActiveByOwner`），复杂查询另设查询服务
不含业务规则	仓储里不写“状态为 X 才更新”这类判断
接口不泄漏技术细节	不出现分页 SQL 方言、事务注解、表名

开源参考：Spring Data JPA、MyBatis / MyBatis-Plus、JOOQ、Axon Framework（事件存储型仓储）、MongoDB 文档模型。

写路径通过聚合根与仓储保证不变式；读路径不需要聚合，应当用查询服务直接面向展示需求拼装数据（投影表、宽表、搜索引擎都可以是数据源）。把两者混在一个仓储里，会得到一堆“为某个页面定制的多表 join 方法”，仓储随即失去意义。

这一分工是 CQRS 的最小可用形态，不需要事件溯源也能落地。