ホーム 全セッション S05

キャンセル失敗時の流れ

9 / 14 目安 1.25分

ページ一覧

解決策: キャンセルが失敗する場合に、失敗の値がどこで切り替わりどこへ進むかを追跡します。

失敗する箇所は、工程では3か所、コードでは5か所です。「実行者の確認」は ensureUserFound と ensureCanManageClinic、「予約の確認」は ensureAppointmentFound と ensureCancellable、「記録して返す」は store です。図のタブは競合を含みません。競合(別のリクエストの先行更新)は、利用者が最新の内容を確認してやり直せるため Err です。接続断は、利用者が次の操作を選べない障害のため例外です。

説明用に項目を省略しています。
  1. このコマのコード cancellationReason.ts

    const CancellationReasonSchema = z
      .string()
      .trim()
      .min(1)
      .max(500)
      .brand<typeof CancellationReasonBrand>()
      .transform(Sensitive.of);

    受け取る値

    { reason: "" }

    返す値

    // 検査に失敗

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    useCase の手前の境界が、リクエストを検査します。理由が空であるため、.min(1) で失敗します。

  2. このコマのコード cancellationReason.ts

    const CancellationReasonSchema = z
      .string()
      .trim()
      .min(1)
      .max(500)
      .brand<typeof CancellationReasonBrand>()
      .transform(Sensitive.of);

    受け取る値

    // 検査に失敗

    返す値

    // 入力エラーの画面を返す

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    検査に失敗したリクエストは、useCase に渡されません。境界が入力エラーの画面を返し、レールの上の行は1行も実行しません。

  3. このコマのコード cancellationReason.ts

    const CancellationReasonSchema = z
      .string()
      .trim()
      .min(1)
      .max(500)
      .brand<typeof CancellationReasonBrand>()
      .transform(Sensitive.of);

    受け取る値

    { reason: "owner request" }

    返す値

    { …, reason: "owner request" }

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    useCase の手前の境界が、リクエストを検査します。ここはレールの外です。理由は空ではないため、.min(1) を通過します。

  4. このコマのコード userResolver.ts

    データベースから実行者を取得します。実装は省略します。

    受け取る値

    "(受付担当者の ID)"

    返す値

    Ok({ kind: "Receptionist", … })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. Ok 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    resolveById が、データベースから実行者を取得します。

  5. このコマのコード errors.ts

    export const ensureUserFound = (
      actorUserId: UserId,
    ) =>
      (user: User | undefined): Result<User, UnauthorizedError> =>
        user === undefined
          ? err({ kind: "Unauthorized", actorUserId })
          : ok(user);

    受け取る値

    { kind: "Receptionist", … }

    返す値

    Ok({ kind: "Receptionist", … })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. Ok ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    ensureUserFound は、実行者を取得できたため ok を返します。

  6. このコマのコード authorization.ts

    export const ensureCanManageClinic = (
      user: User,
    ): Result<User, UnauthorizedError> =>
      user.kind === "Admin" || user.kind === "Receptionist"
        ? ok(user)
        : err({ kind: "Unauthorized", actorUserId: user.userId });

    受け取る値

    { kind: "Receptionist", … }

    返す値

    Ok({ kind: "Receptionist", … })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. Ok ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    ensureCanManageClinic が、権限を検証します。Receptionist には権限があります。

  7. このコマのコード appointmentResolver.ts

    データベースから予約を取得します。実装は省略します。

    受け取る値

    "11111111-…"

    返す値

    Ok({ kind: "Paid", … })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. Ok 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    resolveById が、予約を取得します。値は実行者から予約へ変わります。

  8. このコマのコード errors.ts

    export const ensureAppointmentFound = (
      appointmentId: AppointmentId,
    ) =>
      (appointment: Appointment | undefined): Result<Appointment, AppointmentNotFound> =>
        appointment === undefined
          ? err({ kind: "AppointmentNotFound", appointmentId })
          : ok(appointment);

    受け取る値

    { kind: "Paid", … }

    返す値

    Ok({ kind: "Paid", … })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. Ok ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    ensureAppointmentFound は、予約を取得できたため ok を返します。

  9. このコマのコード cancelAppointmentUseCase.ts

    appointment.kind === "Scheduled" || appointment.kind === "CheckedIn"
      ? ok(appointment)
      : err({
          kind: "InvalidAppointmentState",
          appointmentId: appointment.appointmentId,
          expectedKind: "ScheduledOrCheckedIn",
          actualKind: appointment.kind,
        });

    受け取る値

    { kind: "Paid", … }

    返す値

    Err({ kind: "InvalidAppointmentState" })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable Err
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    ensureCancellable が、状態を検証します。Paid は診察開始前ではないため err を返し、値は失敗レールへ切り替わります。

  10. このコマのコード cancelAppointmentUseCase.ts(実行しません)

    const createEvent =
      (dependencies: Dependencies, input: UseCaseInput) =>
      (appointment: Scheduled | CheckedIn) =>
        ResultAsync.fromSafePromise(
          Promise.resolve().then(() =>
            Appointment.cancel({
              eventId: dependencies.eventIdGenerator.generate(),
              occurredAt: dependencies.clock.now(),
              actorUserId: input.actorUserId,
            })(appointment, input.reason),

    受け取る値

    Err({ kind: "InvalidAppointmentState" })

    返す値

    Err({ kind: "InvalidAppointmentState" })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent Err
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput

    失敗の値は、失敗レールを進みます。createEvent は実行しないため、Canceled は作られません。

  11. このコマのコード appointmentEventStore.ts(実行しません)

    予約の状態の更新と、イベントの追記を、1回の保存で行います。実装は省略します。

    受け取る値

    Err({ kind: "InvalidAppointmentState" })

    返す値

    Err({ kind: "InvalidAppointmentState" })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store) Err
    9. map
    10. 終点 UseCaseOutput

    記録も実行しません。キャンセルは記録に残りません。

  12. このコマのコード cancelAppointmentUseCase.ts(実行しません)

    .map((event) => ({ appointment: event.aggregateState }));

    受け取る値

    Err({ kind: "InvalidAppointmentState" })

    返す値

    Err({ kind: "InvalidAppointmentState" })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map Err
    10. 終点 UseCaseOutput

    結果の取り出しも実行しません。失敗の値は変わりません。

  13. このコマのコード cancelAppointmentUseCase.ts

    export type UseCaseError =
      | UnauthorizedError
      | AppointmentNotFound
      | InvalidAppointmentState
      | AppointmentConflict;
    export type UseCaseOutput = UseResultAsync<UseCaseOk, UseCaseError>;

    受け取る値

    Err({ kind: "InvalidAppointmentState" })

    返す値

    Err({ kind: "InvalidAppointmentState" })

    手前の境界: 入力を検査する レールには乗らない

    成功失敗
    1. 実行者の確認 resolveById
    2. ensureUserFound
    3. ensureCanManageClinic
    4. 予約の確認 resolveById
    5. ensureAppointmentFound
    6. ensureCancellable
    7. 結果を作る createEvent
    8. 記録して返す andThrough(store)
    9. map
    10. 終点 UseCaseOutput Err

    失敗の値は、失敗レールの終点に到達します。呼び出し側は、UseCaseError のうち InvalidAppointmentState を受け取ります。

確認の問い
  1. 問い: 会計済みの予約(kind: "Paid")が工程へ入ると、どの工程で失敗しますか。後ろの成功の処理は実行されますか。

    答え: 「予約の確認」の工程で失敗します。Paid は診察開始前の状態ではないためです。失敗の値は下のレールを終点まで進み、後ろの「結果を作る」と「記録して返す」は実行されません。

  2. 問い: キャンセル理由が空のリクエストは、どこで中断されますか。そのキャンセルは記録されますか。

    答え: useCase の手前の境界で中断されます。境界が入力エラーの画面を返して useCase を呼ばないため、理由のないキャンセルは記録されません。