领域战略建模：解密上下文映射图（Context Map）的设计规约与流程

在开展中大型复杂系统的限界上下文（Bounded Context）拆分后，系统被划分为了数十个微服务。如果不同上下文之间依然存在无规则的强依赖，或者团队之间缺乏对彼此协作关系的统一认知，微服务架构很快就会退化为混乱的“大泥潭（Big Ball of Mud）”。

为了将各个上下文之间的技术协作与政治话语权（Power Relationship）彻底具象化，防范过度耦合，领域驱动设计（DDD）提出了核心战略治理工具——**上下文映射图（Context Map）**。

本文将系统拆解上下文映射图的绘制规约、核心依赖方向标识（U/D）、以及标准的协作模式拓扑表达。

一、 限界上下文协作方向的核心标识：U 与 D

在上下文映射图中，限界上下文之间通过带箭头的连线相连。箭头的两端分别标记为 **U（Upstream - 上游）** 与 **D（Downstream - 下游）**。这一对标识承载着严格的战略指向：

二、 典型上下文映射关系拓扑设计

我们以电商系统中的“用户”、“订单”、“支付”、“外部遗留 CRM”四个上下文为例，其上下文映射图的拓扑流转关系绘制如下：

┌──────────────────────────────┐              ┌──────────────────────────────┐
│  会员上下文 (Member Context)  │              │  订单上下文 (Order Context)   │
│                              │              │                              │
│       [ OHS / PL ]           │ ── (U)──> ── │         [ Client ]           │
└──────────────────────────────┘              └──────────────┬───────────────┘
                                                             │
                                                             │ (D)
                                                             │
                                                             ▼ (U)
┌──────────────────────────────┐              ┌──────────────┴───────────────┐
│ 遗留系统 (Legacy CRM System)  │ ◄─ (D)── (U)─ │  支付上下文 (Payment Context) │
│                              │  (ACL防腐防守)│                              │
│         [ Legacy ]           │              │         [ Facade ]           │
└──────────────────────────────┘              └──────────────────────────────┘

三、 上下文映射的代码结构表达规约

虽然上下文映射图主要是战略分析工具，但它在团队的 Java 包结构 and 模块划分上有着强硬的契约体现。例如，通过在下游工程引入防腐层适配器包，显式声明对上游接口的映射防守：

package com.company.sales.infra.gateway.impl;

import com.company.sales.domain.gateway.MemberGateway;
import com.company.sales.domain.model.Buyer;
import com.company.sales.infra.acl.MemberTranslator;
import com.company.sales.infra.client.MemberHttpClient; // 上游 HTTP 客户端

/**
 * 对应 Context Map 中的 (D) 下游防腐层实现
 * 规约：此实现属于 Order 限界上下文，负责将上游 Member(U) 的 DTO 过滤并翻译为 Buyer 实体
 */
public class MemberGatewayImpl implements MemberGateway {

    private final MemberHttpClient memberHttpClient; // 依赖上游的 OHS 开放主机服务

    public MemberGatewayImpl(MemberHttpClient client) {
        this.memberHttpClient = client;
    }

    @Override
    public Buyer getBuyerDetails(String buyerId) {
        // 1. 调用上游接口，拉取符合上游 Published Language（发布语言）的 JSON 报文
        Object rawPayload = memberHttpClient.fetchMemberInfo(buyerId);
        
        // 2. 本地执行防腐翻译，彻底切断下游对上游类库的直接依赖
        return MemberTranslator.toBuyer(rawPayload);
    }
}

四、 总结

上下文映射图（Context Map）是治理微服务星状缠绕、确立开发组织边界的“战略蓝图”。

它通过**对等双向箭头的 U（上游）与 D（下游）语义标识，将微服务之间的协作关系与团队间的政治话语权进行了彻底的图纸化公开，消灭了无序依赖；并结合防腐层 ACL 与共享内核等技术方案的精准标注，指引了微服务底层代码结构的设计**。掌握这套上下文映射图的设计规约与防腐层工程表达，是主导多团队大型协作项目、保证微服务演进不失控的核心看家基本功！