📚 课程目录第1章边界定义与设计原则

边界定义与设计原则

边界（Boundary）是架构设计的核心杠杆。一个系统是否优雅、可维护、可扩展，往往在边界划分的那一刻就已经决定了。本章旨在为整个课程奠定方法论基础：厘清边界是什么、为什么必须主动划分边界，以及三条不可动摇的核心设计原则。

1.1 边界概念：系统内的显式分隔线

在架构语境中，边界是组件、模块、层或服务之间的一组显式契约和隔离规则。它既包含物理边界（如进程、容器、网络分区），也包含逻辑边界（如接口、命名空间、数据所有权）。边界不是障碍，而是结构化的通信窗口——通过窄化连接来降低认知负荷。

维度	含义	示例
逻辑边界	模块、类的职责区域	Java package、Go internal 目录
进程边界	独立运行单元	微服务进程、Sidecar
数据边界	数据所有权与存储范围	每个服务拥有自己的 DB Schema
信任边界	安全权限的跃迁点	VPN 出口、 Token 校验点

关键认知： 边界是成本与收益的均衡点。太粗的边界让系统变成“大泥球”，太细的边界让分布式复杂性问题失控。合理边界的判断标准是：边界内部可以独立决策，边界之间只通过契约通信。

1.2 为什么需要边界

没有边界的系统会快速熵增。主动设计边界的目标可归纳为四点：

控制复杂度： 将大问题分解为可独立理解的小块，每个小块内部复杂度可控。
隔离变更： 一处改动不会通过隐式耦合扩散到整个系统。
支持并行： 不同团队可以基于稳定的边界契约并行开发和测试。
防御退化： 通过边界上的显式校验（输入验证、权限检查）防止错误扩散。

实践案例： 在电商系统中，将“库存扣减”封装为一个独立的领域服务，对外只暴露 ReserveStock(orderId, skuId, qty) → (ok|fail) 接口。内部的并发锁、数据库回滚、超卖判断完全被边界隐藏。这个边界使得库存逻辑可以在不改动订单主流程的前提下独立演进。

1.3 核心设计原则

三条原则是所有边界设计的底层逻辑。它们没有优先级之分，在大多数场景下需要同时应用。

原则	核心思想	衡量标准	常见反例
高内聚低耦合	内部紧密协作，外部松散依赖	模块内部方法调用密度 > 模块间调用密度	一个类同时处理订单验证和物流发货
单一职责	每个边界只对一个变更原因负责	修改A需求不需要修改B边界	“公共工具类”被十几个模块依赖
信息隐藏	内部实现细节对边界外不可见	外部只通过接口/契约交互	直接暴露数据库字段或内部数据结构

以订单服务为例，一段伪代码展示信息隐藏与单一职责如何协作：

// 订单服务对外接口
service OrderService {
    // 外部调用者只需要知道订单ID
    CreateOrder(CreateOrderRequest) → OrderID
    
    // 内部实现对外部完全隐藏
    // - 使用了什么数据库？
    // - 是否缓存了商品信息？
    // - 扣减库存的时机？
}

// 内部模块职责独立
struct InventoryReservation {
    // 只负责扣减库存，不关心订单状态
    bool Reserve(string skuId, int qty)
}

struct OrderPersistence {
    // 只负责存储，不关心业务规则
    void Save(Order order)
}

1.4 边界关系的全景视角

下图将本章的三条原则与边界的识别、分层、职责和组织落地关联起来，形成后续29章的知识骨架。

1.5 边界设计的风险意识

原则在应用时存在三种典型误判，直接导致不合理边界：

过度抽象： 为了“通用性”将不同职责的代码合并到一个接口背后，违背单一职责。
泄漏实现： 在接口返回值中包含内部数据结构（如 ORM 实体），破坏信息隐藏。
粘合代码： 为了绕过边界，在两个模块之间增加“临时”共享状态或全局变量，迅速降低内聚性。

决策检查表： 每当你定义一个模块、服务或层的边界时，问自己三个问题——
1. 边界外的人需要知道边界内的哪些细节？（信息隐藏检查）
2. 这个模块被修改的理由是否唯一？（单一职责检查）
3. 模块内部元素之间的调用是否显著多于模块之间的调用？（高内聚低耦合检查）

1.6 落地起点：用原则指导边界识别

接下来的章节将逐一展开从边界识别到验收的完整路径。在开始之前，请记住一条行动准则：用原则做判断，用契约做表达，用测试做护城河。 下面是一个可直接应用到项目中的初始检查框架：

活动	输入	原则校验标准
划定模块边界	业务用例与子域拆分	每个子域对应一个变更原点（单一职责）
设计模块接口	跨模块通信场景列表	接口只暴露必要数据，隐藏存储、缓存、算法细节（信息隐藏）
评审模块内聚性	模块内部依赖图	内部直接依赖远多于外部间接依赖（高内聚低耦合）

第1章到此。边界不是凝固的墙壁，而是演进的结构。从第2章开始，我们将深入边界识别的方法论，使用事件风暴和领域分析来找出系统里的“天然裂缝”。