ホーム 全セッション S05

キャンセルの4つの工程への分割

5 / 14 目安 0.75分

ページ一覧

解決策: 各工程が失敗を Result で返せるように、キャンセルを入力と出力を持つ4つの工程に分割します。

キャンセルは、実行者(操作する受付担当者)の確認、予約の確認、結果を作る、記録して返す、の4つの工程に分かれます。図で、各工程の入力、出力、失敗を確認します。

  1. 入力

    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 がログイン情報から作成した値を使います。コードは理由の検査です。

  2. 入力

    入力の actorUserId

    "(受付担当者の ID)"

    工程 実行者の確認

    useCase の1つ目の工程

    1. userResolver.resolveById
    2. ensureUserFound
    3. ensureCanManageClinic

    失敗: 実行者が存在しない、または管理する権限がない場合 Unauthorized

    出力

    実行者

    {
      kind: "Receptionist",
      userId: "(受付担当者の ID)",
    }

    1つ目の工程は、実行者をデータベースから取得し、権限を検証します。受付担当者には権限があるため、実行者の値を次へ渡します。

  3. 入力

    入力の appointmentId

    "11111111-…"

    工程 予約の確認

    useCase の2つ目の工程

    1. appointmentResolver.resolveById
    2. ensureAppointmentFound
    3. ensureCancellable

    失敗: 予約が存在しない、または診察開始前(Scheduled と CheckedIn)ではない場合 AppointmentNotFoundInvalidAppointmentState

    出力

    診察開始前の予約

    {
      kind: "Scheduled",
      appointmentId: "11111111-…",
      reason: "skin check",
    }

    2つ目の工程は、予約を取得し、診察開始前かどうかを検証します。Scheduled の予約は、診察開始前であるため次へ進みます。

  4. 入力

    前の工程の予約

    { kind: "Scheduled", … }

    入力のキャンセル理由 reason

    "owner request"

    時計 clock の時刻

    "2026-08-30T05:00:00.000Z"

    ID の生成器 eventIdGenerator の ID

    "(新しいイベントの ID)"

    工程 結果を作る

    useCase の3つ目の工程

    1. createEvent
    2. Appointment.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 を作ります。イベントは、誰がいつキャンセルしたかを履歴として記録するデータです。

  5. 入力

    前の工程のイベント

    { kind: "AppointmentCanceled", … }

    工程 記録して返す

    useCase の4つ目の工程

    1. andThrough(appointmentCanceledStore.store)
    2. map((event) => …)

    失敗: 記録が別のリクエストと競合した場合 AppointmentConflict 競合は、利用者が最新の内容を確認して操作をやり直せる(次の操作を選べる)ため Err です。接続断は、利用者が次の操作を選べない障害であるため例外です。

    出力

    呼び出し側が受け取る値

    {
      appointment: {
        kind: "Canceled",
        …
      },
    }

    4つ目の工程は、andThrough でイベントを記録し、元のイベントを次へ渡します。続く map が、キャンセル後の予約を取り出して返します。