課題2の前半です。予約が見つからない失敗と状態不正は、利用者が次の操作を選べます。予約を探し直す、現在の状態を確認する、のどちらかです。この Session では、このような失敗を業務の失敗と呼び、Err で返します。
獣医師が、存在しない予約IDで診察開始のリクエストを送ります。resolver.resolveById は予約を取得できず、undefined を返します。
ensureAppointmentFound は例外を投げず、AppointmentNotFound を Err として返します。
結果が Err であるため、後続の andThen と map は呼ばれません。状態遷移も保存も実行されません。
startExamination は Err を値として返します。戻り値の型 Result<InExamination, StartExaminationError> に、この失敗が含まれています。
route の match が失敗側で Err を受け取り、失敗の種類に対応する画面のお知らせを選択します。獣医師は予約を探し直せます。
startExamination破線の枠: Err の値として返る経路
ensureAppointmentFound(
deps.resolver.resolveById(input.appointmentId),
input.appointmentId,
)
.andThen(ensureCheckedIn)
.map((appointment) =>
transitionToInExamination(
appointment,
input.veterinarianId,
input.examinationStartedAt,
),
)
.map((appointment) => {
deps.store.save(appointment);
return appointment;
}); route の match → 画面のお知らせ
return result.match(
() => context.redirect("/", 303),
(error) =>
context.redirect(
`/?notice=${toStartExaminationNoticeCode(error)}`,
303,
),
); AppointmentNotFound 「予約が見つかりません」
startExamination の引用元: examples/session-04-solution/src/useCase/startExamination.ts:29-44route の match は、解答のコードから、S06 で扱う副作用と競合の分岐を省略した形です。解答のコードの route: examples/session-04-solution/src/adaptor/primary/web/routes.ts:130-137
Err で返すと、失敗が戻り値の型に現れ、工程の順序が上から読め、呼び出し側が失敗の種類を漏れなく扱えます。