ストーリー

C4 Level 1: System Context Diagram

NexPayのシステムコンテキスト

graph TD
    USER["エンドユーザー<br/>(1,000万人)"] -->|"HTTPS/TLS 1.3"| NEXPAY["NexPay<br/>Super App Platform<br/>(設計対象)"]
    MERCHANT["加盟店<br/>(200万店舗)<br/>POS/SDK"] --> NEXPAY
    ADMIN["加盟店管理者"] --> NEXPAY
    OPS["社内運用者<br/>(CS/運用)"] --> NEXPAY
    NEXPAY <-->|"全銀プロトコル"| BANK["銀行API<br/>(全銀ネット)"]
    NEXPAY --> CARD["カードネットワーク<br/>(VISA/MC/JCB)"]
    NEXPAY --> STOCK["証券取引所API<br/>(東証/SBI等)"]
    NEXPAY --> GOV["監督官庁<br/>報告システム<br/>(金融庁等)"]

    classDef actor fill:#3498db,stroke:#2980b9,color:#fff
    classDef system fill:#27ae60,stroke:#1e8449,color:#fff
    classDef external fill:#e67e22,stroke:#d35400,color:#fff
    class USER,MERCHANT,ADMIN,OPS actor
    class NEXPAY system
    class BANK,CARD,STOCK,GOV external

外部システム一覧

信頼境界の定義

// 信頼境界の定義
interface TrustBoundary {
  name: string;
  level: "HIGH" | "MEDIUM" | "LOW";
  description: string;
  controls: string[];
}

const trustBoundaries: TrustBoundary[] = [
  {
    name: "外部ユーザー境界",
    level: "LOW",
    description: "エンドユーザー・加盟店からのリクエスト",
    controls: [
      "WAF（Web Application Firewall）",
      "DDoS防御（AWS Shield）",
      "レート制限",
      "OAuth 2.0 / OpenID Connect認証",
      "入力バリデーション",
    ],
  },
  {
    name: "外部パートナー境界",
    level: "MEDIUM",
    description: "銀行API、証券API等の外部金融システム",
    controls: [
      "mTLS（相互TLS認証）",
      "IP制限（ホワイトリスト）",
      "API署名検証",
      "リクエスト/レスポンスの暗号化",
    ],
  },
  {
    name: "CDE境界",
    level: "HIGH",
    description: "カード会員データ環境の内部境界",
    controls: [
      "ネットワークセグメンテーション（専用VPC）",
      "すべての通信をmTLS",
      "アクセスログの完全記録",
      "HSMによる暗号鍵管理",
      "特権アクセス管理（PAM）",
    ],
  },
  {
    name: "内部サービス境界",
    level: "MEDIUM",
    description: "マイクロサービス間の通信",
    controls: [
      "サービスメッシュ（mTLS）",
      "JWTトークンによるサービス間認証",
      "ネットワークポリシー（K8s NetworkPolicy）",
    ],
  },
];

外部システム連携の設計パターン

Anti-Corruption Layer（防腐層）

外部システムのデータモデルやプロトコルが内部設計を汚染しないよう、防腐層を設けます。

// 外部銀行APIとの連携に防腐層を適用
// 外部の全銀プロトコルのデータ構造
interface ZenginTransferRequest {
  kinyuKikanCode: string;  // 金融機関コード（4桁）
  shitenCode: string;       // 支店コード（3桁）
  yokinShubetsu: string;    // 預金種別コード
  kozaBango: string;        // 口座番号（7桁）
  jukyuninshaName: string;  // 受取人名（カタカナ）
  kingaku: number;          // 金額
}

// 内部ドメインモデル（防腐層で変換）
interface TransferRequest {
  recipientAccount: BankAccount;
  amount: Money;
  memo?: string;
  requestedAt: Date;
}

// Anti-Corruption Layer
class BankApiAdapter implements BankTransferPort {
  async transfer(request: TransferRequest): Promise<TransferResult> {
    // 内部モデル → 外部プロトコルに変換
    const zenginRequest: ZenginTransferRequest = {
      kinyuKikanCode: request.recipientAccount.bankCode,
      shitenCode: request.recipientAccount.branchCode,
      yokinShubetsu: this.mapAccountType(request.recipientAccount.type),
      kozaBango: request.recipientAccount.number,
      jukyuninshaName: this.toKatakana(request.recipientAccount.holderName),
      kingaku: request.amount.value,
    };

    const response = await this.zenginClient.send(zenginRequest);

    // 外部レスポンス → 内部モデルに変換
    return this.mapToTransferResult(response);
  }
}

外部システム障害への対策

「外部システムはこちらが制御できない。だからこそ、障害を前提とした設計が必要だ。サーキットブレーカー、リトライ、キューイング — これらを組み合わせて、外部障害がシステム全体に波及しないようにする」 — 佐藤CTO

コンテキストマップ（DDD）

境界づけられたコンテキスト

C4のSystem Contextに加え、DDDのコンテキストマップでドメイン間の関係を明確にします。

graph TD
    subgraph Platform["NexPay Platform"]
        PAY["Payment<br/>Context"] <-->|"SC"| ACC["Account<br/>Context"]
        ACC <-->|"SC"| TRF["Transfer<br/>Context"]
        PAY -->|"ACL"| CARD["Card Network<br/>(外部)"]
        TRF -->|"ACL"| BANK["Bank Network<br/>(外部)"]
        INV["Investment<br/>Context"] <-->|"SC"| BANK
        INV -->|"ACL"| EX["Exchange<br/>(外部)"]
        KYC["KYC/AML<br/>Context"]
    end

    NOTE["SC = Shared Kernel / Customer-Supplier<br/>ACL = Anti-Corruption Layer"]

    classDef internal fill:#3498db,stroke:#2980b9,color:#fff
    classDef external fill:#e67e22,stroke:#d35400,color:#fff
    classDef note fill:#ecf0f1,stroke:#bdc3c7,color:#2c3e50
    class PAY,ACC,TRF,INV,KYC internal
    class CARD,BANK,EX external
    class NOTE note

コンテキスト間の関係

まとめ

チェックリスト

• C4 Level 1のSystem Context Diagramを理解した
• 外部システム一覧と連携方式を把握した
• 4層の信頼境界とそのセキュリティ制御を理解した
• Anti-Corruption Layerの役割と適用箇所を把握した
• DDDコンテキストマップでドメイン間の関係を理解した

次のステップへ

次は「サービス分解設計」に進みます。System Context内部をDDDに基づいて分解し、決済・送金・投資・共通基盤の各サービスの境界と責務を定義しましょう。

推定読了時間: 40分