ホーム 全セッション S06

ユースケースが外部に要求する処理の型(port)

7 / 20 目安 1分

ページ一覧

事前知識: 時刻と ID をテストで固定するには、ユースケースが外部に要求する処理の型(port)を使い、本番の実装とテスト用の実装(fake)を差し替えます。

課題2を解決するには、時刻と ID を、テストで固定できる形で受け取ります。port は、ユースケースが外部に要求する処理の型です。修正前の deps.stateStore.save と deps.eventLog.append の2つを、deps.examinationStartedStore.store の1つに置き換えます。

  1. deps.resolver(S04)と deps.examinationStartedStore(S06)は、ユースケースが deps を通して外部に要求する処理です。ユースケースが外部に要求する処理の型を、port と呼びます。

  2. 時刻と ID の取得も外部の処理です。Clock は「現在の時刻を返す」処理の型、EventIdGenerator は「新しい ID を返す」処理の型で、どちらも port です。ユースケースは処理の型だけを参照します。

  3. 本番では、port に本番の実装を渡します。app.ts の createExaminationStartedStore は SQLite の resolver と store を作り、defaultEffects は new Date() を呼ぶ clock と randomUUID() を呼ぶ eventIdGenerator を作ります。

  4. テストでは、同じユースケースの port にテスト用の実装(fake)を渡します。メモリ上の store と、固定の時刻と ID を返す clock と eventIdGenerator を渡すため、ユースケースのコードを変更せずに結果を固定できます。

startExamination.tsS04
deps.resolver.resolveById(input.appointmentId),
startExamination.tsS06
.andThrough(deps.examinationStartedStore.store)
dependencies.tsS06
export type ExaminationStartedStore = Readonly<{
  store: (event: ExaminationStarted) => ResultAsync<void, AppointmentConflict>;
}>;
dependencies.ts
export type EventContextDependencies = Readonly<{
  clock: Clock;
  eventIdGenerator: EventIdGenerator;
}>;
clock.ts
export type Clock = Readonly<{
  now: () => string;
}>;
eventIdGenerator.ts
export type EventIdGenerator = Readonly<{
  generate: () => EventId;
}>;
app.ts
const store = createExaminationStartedStore(
  database,
  session06SolutionInitialAppointment,
);
app.ts
const defaultEffects: EventContextDependencies = {
  clock: { now: () => new Date().toISOString() },
  eventIdGenerator: { generate: () => EventId.parse(randomUUID()) },
};
in-memory-store.test.ts
const adapter = createInMemoryExaminationStartedStore([checkedIn]);
const result = await startExaminationWithEffects({
  resolver: adapter.resolver,
  examinationStartedStore: adapter.store,
  clock: { now: () => "2026-08-30T06:30:00.000Z" },
  eventIdGenerator: { generate: () => eventId },
})(input);
useCase 本番の実装 テスト用の実装(fake)

ユースケースのコードは、どちらでも同じです。

  • port deps.resolver 何もつながっていません SQLiteデータベースから予約を取得する fake の resolverメモリ上の予約を返す
  • port deps.examinationStartedStore 何もつながっていません SQLiteデータベースへ保存する fake の storeメモリ上に保存し、呼ばれた回数を数える
  • port deps.clock 何もつながっていません new Date()現在の時刻を返す 固定の時刻2026-08-30T06:30:00.000Z を返す
  • port deps.eventIdGenerator 何もつながっていません randomUUID()実行のたびに新しい ID を返す 固定の ID常に同じ ID を返す

本番では本番の実装を、テストでは fake(テストのために本番の実装の代わりに渡す実装)を渡します。