失敗する箇所は、工程では3か所、コードでは5か所です。「実行者の確認」は ensureUserFound と ensureCanManageClinic、「予約の確認」は ensureAppointmentFound と ensureCancellable、「記録して返す」は store です。図のタブは競合を含みません。競合(別のリクエストの先行更新)は、利用者が最新の内容を確認してやり直せるため Err です。接続断は、利用者が次の操作を選べない障害のため例外です。
-
このコマのコード
cancellationReason.tsconst CancellationReasonSchema = z .string() .trim() .min(1) .max(500) .brand<typeof CancellationReasonBrand>() .transform(Sensitive.of);受け取る値
{ reason: "" }返す値
// 検査に失敗手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
useCase の手前の境界が、リクエストを検査します。理由が空であるため、
.min(1)で失敗します。 - 実行者の確認
-
このコマのコード
cancellationReason.tsconst CancellationReasonSchema = z .string() .trim() .min(1) .max(500) .brand<typeof CancellationReasonBrand>() .transform(Sensitive.of);受け取る値
// 検査に失敗返す値
// 入力エラーの画面を返す手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
検査に失敗したリクエストは、useCase に渡されません。境界が入力エラーの画面を返し、レールの上の行は1行も実行しません。
- 実行者の確認
-
このコマのコード
cancellationReason.tsconst CancellationReasonSchema = z .string() .trim() .min(1) .max(500) .brand<typeof CancellationReasonBrand>() .transform(Sensitive.of);受け取る値
{ reason: "owner request" }返す値
{ …, reason: "owner request" }手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
useCase の手前の境界が、リクエストを検査します。ここはレールの外です。理由は空ではないため、
.min(1)を通過します。 - 実行者の確認
-
このコマのコード
userResolver.tsデータベースから実行者を取得します。実装は省略します。
受け取る値
"(受付担当者の ID)"返す値
Ok({ kind: "Receptionist", … })手前の境界: 入力を検査する レールには乗らない
成功失敗- Ok 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
resolveByIdが、データベースから実行者を取得します。 - Ok 実行者の確認
-
このコマのコード
errors.tsexport const ensureUserFound = ( actorUserId: UserId, ) => (user: User | undefined): Result<User, UnauthorizedError> => user === undefined ? err({ kind: "Unauthorized", actorUserId }) : ok(user);受け取る値
{ kind: "Receptionist", … }返す値
Ok({ kind: "Receptionist", … })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById - Ok
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
ensureUserFoundは、実行者を取得できたためokを返します。 - 実行者の確認
-
このコマのコード
authorization.tsexport 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", … })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound - Ok
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
ensureCanManageClinicが、権限を検証します。Receptionistには権限があります。 - 実行者の確認
-
このコマのコード
appointmentResolver.tsデータベースから予約を取得します。実装は省略します。
受け取る値
"11111111-…"返す値
Ok({ kind: "Paid", … })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - Ok 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
resolveByIdが、予約を取得します。値は実行者から予約へ変わります。 - 実行者の確認
-
このコマのコード
errors.tsexport const ensureAppointmentFound = ( appointmentId: AppointmentId, ) => (appointment: Appointment | undefined): Result<Appointment, AppointmentNotFound> => appointment === undefined ? err({ kind: "AppointmentNotFound", appointmentId }) : ok(appointment);受け取る値
{ kind: "Paid", … }返す値
Ok({ kind: "Paid", … })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById - Ok
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
ensureAppointmentFoundは、予約を取得できたためokを返します。 - 実行者の確認
-
このコマのコード
cancelAppointmentUseCase.tsappointment.kind === "Scheduled" || appointment.kind === "CheckedIn" ? ok(appointment) : err({ kind: "InvalidAppointmentState", appointmentId: appointment.appointmentId, expectedKind: "ScheduledOrCheckedIn", actualKind: appointment.kind, });受け取る値
{ kind: "Paid", … }返す値
Err({ kind: "InvalidAppointmentState" })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellableErr - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
ensureCancellableが、状態を検証します。Paidは診察開始前ではないためerrを返し、値は失敗レールへ切り替わります。 - 実行者の確認
-
このコマのコード
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" })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEventErr - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutput
失敗の値は、失敗レールを進みます。
createEventは実行しないため、Canceledは作られません。 - 実行者の確認
-
このコマのコード
appointmentEventStore.ts(実行しません)予約の状態の更新と、イベントの追記を、1回の保存で行います。実装は省略します。
受け取る値
Err({ kind: "InvalidAppointmentState" })返す値
Err({ kind: "InvalidAppointmentState" })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store)Err -
map - 終点
UseCaseOutput
記録も実行しません。キャンセルは記録に残りません。
- 実行者の確認
-
このコマのコード
cancelAppointmentUseCase.ts(実行しません).map((event) => ({ appointment: event.aggregateState }));受け取る値
Err({ kind: "InvalidAppointmentState" })返す値
Err({ kind: "InvalidAppointmentState" })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
mapErr - 終点
UseCaseOutput
結果の取り出しも実行しません。失敗の値は変わりません。
- 実行者の確認
-
このコマのコード
cancelAppointmentUseCase.tsexport type UseCaseError = | UnauthorizedError | AppointmentNotFound | InvalidAppointmentState | AppointmentConflict; export type UseCaseOutput = UseResultAsync<UseCaseOk, UseCaseError>;受け取る値
Err({ kind: "InvalidAppointmentState" })返す値
Err({ kind: "InvalidAppointmentState" })手前の境界: 入力を検査する レールには乗らない
成功失敗- 実行者の確認
resolveById -
ensureUserFound -
ensureCanManageClinic - 予約の確認
resolveById -
ensureAppointmentFound -
ensureCancellable - 結果を作る
createEvent - 記録して返す
andThrough(store) -
map - 終点
UseCaseOutputErr
失敗の値は、失敗レールの終点に到達します。呼び出し側は、
UseCaseErrorのうちInvalidAppointmentStateを受け取ります。 - 実行者の確認
確認の問い
問い: 会計済みの予約(
kind: "Paid")が工程へ入ると、どの工程で失敗しますか。後ろの成功の処理は実行されますか。答え: 「予約の確認」の工程で失敗します。
Paidは診察開始前の状態ではないためです。失敗の値は下のレールを終点まで進み、後ろの「結果を作る」と「記録して返す」は実行されません。問い: キャンセル理由が空のリクエストは、どこで中断されますか。そのキャンセルは記録されますか。
答え: useCase の手前の境界で中断されます。境界が入力エラーの画面を返して useCase を呼ばないため、理由のないキャンセルは記録されません。