第18章：ユースケース実装①（作成系）🆕✨

この章でやること（ゴール）🎯😊

「作成系ユースケース」を、イベントソーシングの王道パターンでちゃんと動かします✨ 今回は Create コマンド → Created イベント → 復元できる までを一気に通します🔁✅

ちなみにいまは、Microsoft の Visual Studio 2026 で .NET 10 / C# 14 が素直に使えるので、最新の言語機能を気持ちよく使えます🪟✨ (Microsoft Learn)

18.1 今日の題材：ショッピングカートを「作成」する🧺🆕

ここから先、例として ShoppingCart（カート） を使います😊 「カートを作る」は作成系の代表なので、イベントソーシングの最初の成功体験にちょうどいいです🎉

使うもの（今回の最小セット）🧩

コマンド：CreateCart（作って！）📮
イベント：CartCreated（作られた！）📜
集約：ShoppingCart（状態を持つやつ）🧠
EventStore：Append / ReadStream（前章までの最小実装）📦

18.2 作成系の「設計の型」🧠✨

作成フロー

作成系でも、基本パターンは同じです👇😊

Load：過去イベントを読む（新規なら空）📚
Rehydrate：イベントを Apply して現在状態にする🔁
Decide：コマンドを見て、新イベントを決める（不変条件チェックもここ）🛡️
Append：新イベントを保存する📦✅

この「Load → Decide → Append」が固定できると、迷子になりません🧭💕

18.3 イベント設計：CartCreated は何を持つ？🍱🏷️

✅ CartCreated に入れる（payload）

CartId：どのカート？
CustomerId：誰のカート？
CreatedAt：いつ作られた？（例：UTC）⏰

💡イベントは「事実」なので、命令っぽい情報（例：CreateReason みたいな“気持ち”）は入れすぎ注意です🙅‍♀️✨

なお、今の .NET 10 の System.Text.Json は予約っぽい名前（$type / $id / $ref など）と衝突するプロパティ名を早めにエラーにする挙動があるので、イベント payload の命名でそこは避けるのが安全です⚠️ (Microsoft Learn)

18.4 実装：まずは「イベント」と「集約」から🧱✨

18.4.1 イベント定義（record でOK）📜

namespace MyEs.Domain;

public interface IDomainEvent;

public sealed record CartCreated(
    Guid CartId,
    Guid CustomerId,
    DateTimeOffset CreatedAtUtc
) : IDomainEvent;

18.4.2 集約（ShoppingCart）🧺🧠

ポイントはこれだけ👇😊

Apply(CartCreated) で状態が変わる
Create コマンドが来たら、Created イベントを返す
「すでに作成済み」を不変条件として弾く🛡️🚧

namespace MyEs.Domain;

public sealed class ShoppingCart
{
    public Guid CartId { get; private set; }
    public Guid CustomerId { get; private set; }
    public bool IsCreated { get; private set; }

    private ShoppingCart() { }

    // Rehydrate 用：イベント列から復元する
    public static ShoppingCart Rehydrate(IEnumerable<IDomainEvent> history)
    {
        var cart = new ShoppingCart();
        foreach (var e in history)
        {
            cart.Apply(e);
        }
        return cart;
    }

    // Decide：コマンドを見て、新イベントを決める（ここがドメインの心臓💓）
    public IReadOnlyList<IDomainEvent> DecideCreate(Guid cartId, Guid customerId, DateTimeOffset nowUtc)
    {
        if (IsCreated)
        {
            // 例外にせず「ドメインエラーで返す」方式は次章以降で強化するよ😊
            // 今回は最小のため、空リストで「何も起きない」を表現（後で Result 型に置き換え推奨）
            return Array.Empty<IDomainEvent>();
        }

        return new IDomainEvent[]
        {
            new CartCreated(cartId, customerId, nowUtc)
        };
    }

    // Apply：イベントを状態に反映
    private void Apply(IDomainEvent e)
    {
        switch (e)
        {
            case CartCreated created:
                CartId = created.CartId;
                CustomerId = created.CustomerId;
                IsCreated = true;
                break;
        }
    }
}

✅ これで「イベントが状態を作る」骨格は完成です🎉

18.5 実装：ユースケース（CreateCart）を通す📮➡️📜➡️📦

ここは「アプリ層（UseCase）」の仕事です😊 集約はルールを守るだけ、永続化は EventStore がやるだけ、に分けるとスッキリします✨

18.5.1 コマンド定義📮

namespace MyEs.Application;

public sealed record CreateCart(
    Guid CartId,
    Guid CustomerId
);

18.5.2 EventStore（前章までの最小）との接続イメージ📦

前章の実装に合わせて、必要な形だけ置きます（中身はあなたの実装に合わせてOK）😊

namespace MyEs.Infrastructure;

public sealed record StoredEvent(long Version, MyEs.Domain.IDomainEvent Event);

public interface IEventStore
{
    IReadOnlyList<StoredEvent> ReadStream(string streamId);
    void AppendToStream(string streamId, long expectedVersion, IReadOnlyList<MyEs.Domain.IDomainEvent> newEvents);
}

18.5.3 UseCase（Load → Decide → Append を固定）✅

using MyEs.Domain;
using MyEs.Infrastructure;

namespace MyEs.Application;

public sealed class CartUseCase
{
    private readonly IEventStore _store;

    public CartUseCase(IEventStore store)
    {
        _store = store;
    }

    public void Handle(CreateCart command, DateTimeOffset nowUtc)
    {
        var streamId = StreamIdOf(command.CartId);

        // 1) Load
        var stored = _store.ReadStream(streamId);

        // 2) Rehydrate
        var history = stored.Select(x => x.Event);
        var cart = ShoppingCart.Rehydrate(history);

        // 3) Decide
        var newEvents = cart.DecideCreate(command.CartId, command.CustomerId, nowUtc);
        if (newEvents.Count == 0)
        {
            // 本当は「すでに作成済み」などのエラーにしたい（次の章で強化💪）
            return;
        }

        // 4) Append（新規作成なので expectedVersion は 0 を想定）
        var expectedVersion = stored.Count; // 空なら 0
        _store.AppendToStream(streamId, expectedVersion, newEvents);
    }

    private static string StreamIdOf(Guid cartId) => $"cart-{cartId:N}";
}

🎉 これで、CreateCart を投げたら CartCreated が保存されます！

18.6 動作確認：作成 → 読み → 復元 🔁✅

「ほんとに復元できる？」をここで必ず確認します😊✨ （テストは次の章でちゃんとやるけど、今は目で見て安心するのが大事💖）

確認用コード（例：簡易コンソール）👀

using MyEs.Application;
using MyEs.Infrastructure;

var store = new InMemoryEventStore(); // あなたの実装
var useCase = new CartUseCase(store);

var cartId = Guid.NewGuid();
var customerId = Guid.NewGuid();

useCase.Handle(new CreateCart(cartId, customerId), DateTimeOffset.UtcNow);

// いったんイベントを読む
var streamId = $"cart-{cartId:N}";
var stored = store.ReadStream(streamId);
Console.WriteLine($"events: {stored.Count}");
Console.WriteLine(stored[0].Event.GetType().Name);

// 復元してみる
var history = stored.Select(x => x.Event);
var cart = MyEs.Domain.ShoppingCart.Rehydrate(history);
Console.WriteLine($"IsCreated: {cart.IsCreated}");
Console.WriteLine($"CartId: {cart.CartId}");

期待する出力イメージ👇✨

events: 1
CartCreated
IsCreated: True

18.7 よくあるミス集（ここで潰す）💥😵‍💫➡️😊

ミス1：作成なのに「更新っぽいイベント名」にしちゃう

例：CartCreateRequested（命令っぽい）🙅‍♀️
正：CartCreated（起きた事実）✅

ミス2：イベントに余計な情報を詰めすぎる🍱💦

画面表示用の合成値、将来変わる分類名、などを payload に入れると破壊力が高い😇
迷ったら「事実だけ」に寄せるのが安全✨

ミス3：Apply の書き忘れ（復元でバグる）🫠

Decide でイベントを作ったら、Apply に必ず対応を作る✅
Apply 漏れは「イベントはあるのに状態が変わらない」地獄🥶

18.8 ミニ演習（今日のゴール）📝🎀

演習A：作成系をもう1個増やす🆕

例：CartOwnerChanged を作ってみる（※本当は作成直後に固定でもOK）
または、別ドメイン（ToDoListCreated など）でもOK😊

演習B：不変条件を1つ追加する🛡️

例：CustomerId が空なら作成できない
例：CartId が空なら作成できない

18.9 AI拡張（GitHub Copilot / OpenAI Codex）で速く作るコツ🤖✨

使いやすいお願いテンプレ（コピペ用）📌

「C# で ShoppingCart 集約を作りたい。CartCreated イベント、Rehydrate、DecideCreate、Apply を含めて。イベントは record、集約は状態と不変条件（作成済み禁止）を持つ。無駄な責務を入れないで。短く、読みやすく。」

AIにやらせてから、人間が必ず見る場所👀✅

イベント名が過去形になってる？
payload が “事実” だけ？
Apply が漏れてない？
UseCase が Load → Decide → Append の順番を守ってる？

18.10 まとめ（この章で手に入れた型）🎁😊✨

Created 系イベントを作って、作成ユースケースが通った🎉
イベントが積まれ、そこから 復元できる ことを確認できた🔁✅
「Load → Decide → Append」の型が、作成でもブレないと分かった📮📜📦

参考（最新ドキュメント）📚✨

C# 14 の新機能まとめ（公式） (Microsoft Learn)
.NET 10 の新機能（公式） (Microsoft Learn)
Visual Studio 2026 の .NET 10 / C# 14 サポート（公式） (Microsoft Learn)
System.Text.Json の .NET 10 互換性変更（予約名チェック） (Microsoft Learn)

この章でやること（ゴール）🎯😊​

18.1 今日の題材：ショッピングカートを「作成」する🧺🆕

使うもの（今回の最小セット）🧩​

18.2 作成系の「設計の型」🧠✨

18.3 イベント設計：CartCreated は何を持つ？🍱🏷️

✅ CartCreated に入れる（payload）​

18.4 実装：まずは「イベント」と「集約」から🧱✨

18.4.1 イベント定義（record でOK）📜​

18.4.2 集約（ShoppingCart）🧺🧠​

18.5 実装：ユースケース（CreateCart）を通す📮➡️📜➡️📦

18.5.1 コマンド定義📮​

18.5.2 EventStore（前章までの最小）との接続イメージ📦​

18.5.3 UseCase（Load → Decide → Append を固定）✅​