キャンセルは、実行者(操作する受付担当者)の確認、予約の確認、結果を作る、記録して返す、の4つの工程に分かれます。図で、各工程の入力、出力、失敗を確認します。
-
入力
URL から渡される。形式を検査する
appointmentId: "11111111-…"認証の middleware がログイン情報から作成した値
actorUserId: "(受付担当者の ID)"フォームから渡されるキャンセル理由。空でないことを検査する
reason: "owner request"境界 入力を検査する
useCase の手前の境界
examples/ final/ src/ adaptor/ primary/ web/ routes/ appointmentRoutes.ts:74-76 const CancelSchema = z.object({ reason: CancellationReason.schema, });失敗: 予約 ID の形式が不正なときは 404 を返し、理由が空のときは入力エラーの画面を返す。どちらも useCase は呼ばない
出力
useCase へ渡す入力
{ actorUserId: "(受付担当者の ID)", appointmentId: "11111111-…", reason: "owner request", }最初の検査は、useCase の手前の境界で行います。外部から渡される予約 ID(URL)とキャンセル理由(フォーム)を検査します。実行者は、認証の middleware がログイン情報から作成した値を使います。コードは理由の検査です。
-
入力
入力の actorUserId
"(受付担当者の ID)"工程 実行者の確認
useCase の1つ目の工程
userResolver.resolveByIdensureUserFoundensureCanManageClinic
失敗: 実行者が存在しない、または管理する権限がない場合
Unauthorized出力
実行者
{ kind: "Receptionist", userId: "(受付担当者の ID)", }1つ目の工程は、実行者をデータベースから取得し、権限を検証します。受付担当者には権限があるため、実行者の値を次へ渡します。
-
入力
入力の appointmentId
"11111111-…"工程 予約の確認
useCase の2つ目の工程
appointmentResolver.resolveByIdensureAppointmentFoundensureCancellable
失敗: 予約が存在しない、または診察開始前(Scheduled と CheckedIn)ではない場合
AppointmentNotFoundInvalidAppointmentState出力
診察開始前の予約
{ kind: "Scheduled", appointmentId: "11111111-…", reason: "skin check", }2つ目の工程は、予約を取得し、診察開始前かどうかを検証します。Scheduled の予約は、診察開始前であるため次へ進みます。
-
入力
前の工程の予約
{ kind: "Scheduled", … }入力のキャンセル理由 reason
"owner request"時計 clock の時刻
"2026-08-30T05:00:00.000Z"ID の生成器 eventIdGenerator の ID
"(新しいイベントの ID)"工程 結果を作る
useCase の3つ目の工程
createEventAppointment.cancel
この工程に業務の失敗はない
出力
AppointmentCanceled
{ kind: "AppointmentCanceled", aggregateState: { kind: "Canceled", reason: "skin check", cancellationReason: "owner request", canceledAt: "2026-08-30T05:00:00.000Z", … }, }aggregateState は、イベントに含まれる、キャンセル後の予約です。背景で見た3項目が変わります。
3つ目の工程は、createEvent が時計から時刻と ID を取得し、業務ロジックの Appointment.cancel がイベント AppointmentCanceled を作ります。イベントは、誰がいつキャンセルしたかを履歴として記録するデータです。
-
入力
前の工程のイベント
{ kind: "AppointmentCanceled", … }工程 記録して返す
useCase の4つ目の工程
andThrough(appointmentCanceledStore.store)map((event) => …)
失敗: 記録が別のリクエストと競合した場合
AppointmentConflict競合は、利用者が最新の内容を確認して操作をやり直せる(次の操作を選べる)ため Err です。接続断は、利用者が次の操作を選べない障害であるため例外です。出力
呼び出し側が受け取る値
{ appointment: { kind: "Canceled", … }, }4つ目の工程は、andThrough でイベントを記録し、元のイベントを次へ渡します。続く map が、キャンセル後の予約を取り出して返します。