課題2を解決します。EventContext は、イベントに記録する ID と時刻の組です。時刻と ID は直接生成せず、port の Clock と EventIdGenerator から受け取ります。createEventContext は1回の実行で1度だけ呼び出し、状態と監査記録の時刻を同じ値にします。
-
修正前:
new Date().toISOString()とcrypto.randomUUID()は、呼び出すたびに別の値を返します。実行のたびに時刻と ID が変わるため、テストで値を固定できません。 -
修正後: 時刻は
deps.clock.now()、ID はdeps.eventIdGenerator.generate()から受け取ります。テストで固定のclockとeventIdGeneratorを渡せば、毎回同じ値になります。 -
誤った例:
clockを2回取得すると、状態と監査記録の時刻が食い違います。1回目の時刻は予約の状態(aggregateState)に記録され、2回目の時刻だけがイベントのoccurredAtに記録されるためです。 -
修正後:
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-30
ID"e-1"
2回目の実行
時刻"2026-08-30
ID"e-2"
✗ 毎回違う値テストで値を固定できない
値は説明用の例です。「1回目」「2回目」は、同じ処理を2回実行した結果です。
1回目の実行
時刻"2026-08-30
ID"e-1"
2回目の実行
時刻"2026-08-30
ID"e-1"
✓ 毎回同じ値テストで固定の clock と eventIdGenerator を渡した場合
値は説明用の例です。「1回目」「2回目」は、同じ処理を2回実行した結果です。
clock を2回取得1回目の時刻は予約の状態、2回目の時刻は監査記録に記録されます
予約の状態
examinationStartedAt
"2026-08-30
監査記録
occurredAt
"2026-08-30
✗ 時刻が食い違う診察を開始した時刻を、状態と監査記録から1つに確定できない
1回の実行createEventContext(deps) を1度だけ呼ぶ
{ eventId: "e-1", occurredAt: "2026-08-30T06:30:00.000Z" }
予約の状態
examinationStartedAt
"2026-08-30
監査記録
occurredAt
"2026-08-30
✓ 同じ時刻2つの時刻は、同じ1回の値です
時刻と ID の取得も副作用です。S05 と同じく、domain/ の業務ロジックの外で取得します(S05 の説明)。ユースケースが port を通して取得するため、業務ロジックは時計と乱数に依存せず、テストでは値を固定できます。イベントの生成に必要であるため、予約の確認が通った後で1回だけ取得します。