ホーム 全セッション S06

1回の実行で一度だけ生成する時刻と ID

11 / 20 目安 1分

ページ一覧

解決策: 時刻と ID を port から受け取ります。clock を2回取得すると状態と監査記録の時刻が食い違うため、createEventContext は1回だけ呼びます。

課題2を解決します。EventContext は、イベントに記録する ID と時刻の組です。時刻と ID は直接生成せず、port の Clock と EventIdGenerator から受け取ります。createEventContext は1回の実行で1度だけ呼び出し、状態と監査記録の時刻を同じ値にします。

  1. 修正前: new Date().toISOString() と crypto.randomUUID() は、呼び出すたびに別の値を返します。実行のたびに時刻と ID が変わるため、テストで値を固定できません。

  2. 修正後: 時刻は deps.clock.now()、ID は deps.eventIdGenerator.generate() から受け取ります。テストで固定の clock と eventIdGenerator を渡せば、毎回同じ値になります。

  3. 誤った例: clock を2回取得すると、状態と監査記録の時刻が食い違います。1回目の時刻は予約の状態(aggregateState)に記録され、2回目の時刻だけがイベントの occurredAt に記録されるためです。

  4. 修正後: createEventContext は、eventId と occurredAt を1回ずつ作ります。この1つの値から、予約の状態と監査記録の両方を作るため、2つの時刻は同じです。

修正前examples/session-06/src/useCase/startExamination.ts:51, 63
const occurredAt = new Date().toISOString();
eventId: EventId.parse(crypto.randomUUID()),
修正後examples/session-06-solution/src/useCase/startExamination.ts:55-56
eventId: deps.eventIdGenerator.generate(),
occurredAt: deps.clock.now(),
誤った例(説明用)
.map(startExaminationEvent(deps, input.veterinarianId))
.map((event) => ({ ...event, occurredAt: deps.clock.now() }))
.andThrough(deps.examinationStartedStore.store)
修正後examples/session-06-solution/src/useCase/startExamination.ts:52-57
export const createEventContext = (
  deps: EventContextDependencies,
): EventContext => ({
  eventId: deps.eventIdGenerator.generate(),
  occurredAt: deps.clock.now(),
});

1回目の実行

時刻"2026-08-30T06:30:00.123Z"

ID"e-1"

2回目の実行

時刻"2026-08-30T06:30:07.456Z"

ID"e-2"

✗ 毎回違う値テストで値を固定できない

値は説明用の例です。「1回目」「2回目」は、同じ処理を2回実行した結果です。

1回目の実行

時刻"2026-08-30T06:30:00.000Z"

ID"e-1"

2回目の実行

時刻"2026-08-30T06:30:00.000Z"

ID"e-1"

✓ 毎回同じ値テストで固定の clock と eventIdGenerator を渡した場合

値は説明用の例です。「1回目」「2回目」は、同じ処理を2回実行した結果です。

clock を2回取得1回目の時刻は予約の状態、2回目の時刻は監査記録に記録されます

予約の状態

examinationStartedAt

"2026-08-30T06:30:00.000Z"

監査記録

occurredAt

"2026-08-30T06:30:01.000Z"

✗ 時刻が食い違う診察を開始した時刻を、状態と監査記録から1つに確定できない

1回の実行createEventContext(deps) を1度だけ呼ぶ

{ eventId: "e-1", occurredAt: "2026-08-30T06:30:00.000Z" }

予約の状態

examinationStartedAt

"2026-08-30T06:30:00.000Z"

監査記録

occurredAt

"2026-08-30T06:30:00.000Z"

✓ 同じ時刻2つの時刻は、同じ1回の値です

時刻と ID の取得も副作用です。S05 と同じく、domain/ の業務ロジックの外で取得します(S05 の説明)。ユースケースが port を通して取得するため、業務ロジックは時計と乱数に依存せず、テストでは値を固定できます。イベントの生成に必要であるため、予約の確認が通った後で1回だけ取得します。