課題2を解決するには、業務ロジックの外に I/O を配置します。I/O は、データベースの読み書きや現在時刻の取得のように、関数の外部とやり取りする処理です。業務ロジックは、結果を作る Appointment.cancel と、条件を判定する ensureCancellable です。Appointment.cancel は domain にあります。ensureCancellable は、S04 の ensureCheckedIn と同じく、1つの useCase だけが使う判定であるため useCase/ に置いています。「結果を作る」工程の createEvent(時刻と ID の取得)は I/O です。
副作用がなく、同じ入力から必ず同じ結果を返す関数を純粋関数と呼びます(S01 の説明)。ensureCancellable は予約の値だけで ok か err を返します。右は演習のコードの cancel で、予約、キャンセル理由、時刻の値だけで Canceled の予約を返します。
取得、保存、時刻の取得を、Resolver、Store、時計として引数で渡すため、テストでは代替の実装を useCase に渡して、条件の検証をデータベースなしで確認できます(演習の Paid のテスト)。ensureCancellable は純粋関数ですが、外部に公開していないため、直接は呼ばず useCase 経由でテストします。
参照実装の Appointment.cancel との差分
参照実装の Appointment.cancel は、petId と ownerId も保持し、次の2点も異なります。
- 結果を
Canceledの予約だけではなく、イベントAppointmentCanceledで包んで返します。 - 時刻を引数の
canceledAtではなく、context(eventId、occurredAt、actorUserIdをまとめた値)で受け取ります。createEventが、時計と ID の生成器から取得して渡します。
export const cancel = (
appointment: Scheduled | CheckedIn,
cancellationReason: CancellationReason,
canceledAt: Date,
): Canceled => ({
kind: "Canceled",
appointmentId: appointment.appointmentId,
scheduledAt: appointment.scheduledAt,
reason: appointment.reason,
cancellationReason,
canceledAt,
});