📚 课程目录第1章 Repository模式核心概念与离线场景适用性

1. Repository模式核心概念与离线场景适用性

定义：Repository 是在领域层定义的一种机制，负责封装存储、检索和检索行为，它模拟了一个集合（Collection）的概念。这是 Eric Evans 在《领域驱动设计》中提出的核心模式。

架构本质：Repository 并不是简单地与数据库交互，而是一种将领域实体与聚合根从具体的数据持久化技术（SQL、NoSQL、文件系统、缓存）中解耦的策略。这使得领域逻辑能够专注于业务规则，而不必关心数据在何处存储或如何读取。

离线关联：在离线环境下，数据源可能是本地的 SQLite、文件或内存缓存。Repository 就像一个统一的数据管理员，业务代码无需感知此刻数据是来自远程服务器还是本地缓存。

    核心价值： 引入抽象屏障，使得领域层无需依赖具体数据库驱动或网络框架。在线与离线数据源的切换对业务逻辑透明。

依赖倒置原则（DIP）：高层模块（领域）不应依赖于低层模块（数据基础设施）。两者都应依赖于抽象。Repository 模式正是这一原则的典型应用。

信任链路：领域层信任 Repository 接口定义的集合语义，数据层信任 Repository 实现规范。接口由领域层定义，由数据层遵守。

控制流与数据流：控制流从领域层流经 Repository 到达数据源，但依赖流方向相反（领域层定义接口，数据层实现接口）。这使得领域层完全独立于数据技术。

组件	核心职责	边界位置	数据流示例
领域实体/聚合	封装业务状态与行为。	纯内存对象，属于领域层。	向 Repository 发送 `save(user)` 或 `findById(id)`
Repository 接口	定义集合语义（CRUD 操作）。	属于领域层，不引用数据源 API。	`interface UserRepository { find, save, delete }`
Repository 实现	将接口调用路由到具体数据源。	属于数据基础设施层。	转发 `findById` 到 CacheDataSource 或 ApiDataSource
本地数据源	管理离线存储（SQLite, File, MMKV）。	数据层。	返回本地数据或缓存远程数据。
远程数据源	管理网络请求（REST, GraphQL）。	数据层。	用户在线时获取最新数据。

选型权衡：
- 纯粹的抽象会带来轻微的运行时调度开销。
- 维护多套实现（在线/离线）会增加前期开发成本。
- 接口粒度（粗粒度 vs. 细粒度）直接影响复杂性与灵活性。
风险点：
- 泄漏抽象：Repository 的实现细节泄漏到领域层。例如领域层需要关心 FetchPolicy.REMOTE_FIRST 或序列化方式。
- 过度设计：对于只有远程数据库且无离线需求的简单 CRUD 场景，强行引入多层抽象反而增加维护成本。
- 同步灾难：如果离线写入冲突未能妥善处理（如未使用冲突检测策略），会造成数据永久不一致。

架构警告： 不要为了让 Repository 模式工作而将领域实体退化为仅包含 Getter/Setter 的 DTO。领域实体应包含职责内聚的业务行为。Repository 的职责是返回领域对象，而不是原始数据集或数据行。

落地步骤：

验收标准：