StartExaminationInput.parse は、schemaResult が schema から作った関数です。この schema は、ID の schema(AppointmentId.schema と VeterinarianId.schema)を z.object でまとめ、.readonly() で項目を読み取り専用にしたものです。
解決したこと: 不正な値を内側へ渡さないことです。この仕組みで解決しないこと: 利用者へ返す応答は未解決で、現在は route の例外により HTTP ステータス 500 になります。ID の実在は検証しません。データベースの値は、検査済みの値を保存している前提で検査しません。
{ veterinarianId: "night-shift" } {
appointmentId: "11111111-1111-4111-8111-111111111111",
veterinarianId: "night-shift",
} "11111111-1111-4111-8111-111111111111" "night-shift" Err() // なし { veterinarianId: "44444444-4444-4444-8444-444444444444" } {
appointmentId: "11111111-1111-4111-8111-111111111111",
veterinarianId: "44444444-4444-4444-8444-444444444444",
} "44444444-4444-4444-8444-444444444444" Ok({
appointmentId: "11111111-1111-4111-8111-111111111111", // AppointmentId
veterinarianId: "44444444-4444-4444-8444-444444444444", // VeterinarianId
}) {
veterinarianId: "44444444-4444-4444-8444-444444444444",
examinationStartedAt: "2026-08-30T06:30:00.000Z",
} veterinarianId: "44444444-4444-4444-8444-444444444444" // VeterinarianId { veterinarianId: "11111111-1111-4111-8111-111111111111" } {
appointmentId: "11111111-1111-4111-8111-111111111111",
veterinarianId: "11111111-1111-4111-8111-111111111111",
} Ok({
appointmentId: "11111111-1111-4111-8111-111111111111", // AppointmentId
veterinarianId: "11111111-1111-4111-8111-111111111111", // VeterinarianId
}) {
veterinarianId: "11111111-1111-4111-8111-111111111111",
examinationStartedAt: "2026-08-30T06:30:00.000Z",
} veterinarianId: "11111111-1111-4111-8111-111111111111" // VeterinarianId src/adaptor/primary/web/routes.ts app.post("/appointments/:appointmentId/start-examination", async (context) => {
const raw = await context.req.json<Readonly<{ veterinarianId?: unknown }>>();
const input = StartExaminationInput.parse({
appointmentId: context.req.param("appointmentId"),
veterinarianId: raw.veterinarianId,
})._unsafeUnwrap();
const current = appointmentOrThrow(repository, input.appointmentId);
if (current.kind !== "CheckedIn") throw new Error("Invalid appointment state");
saveAndAppendAudit(
repository,
startExamination(
current,
input.veterinarianId,
"2026-08-30T06:30:00.000Z",
),
"ExaminationStarted",
"2026-08-30T06:30:00.000Z",
);
return context.redirect("/", 303);
}); src/adaptor/primary/web/startExaminationInput.ts(修正後)import { z } from "zod";
import { AppointmentId } from "../../../domain/appointment/index.js";
import { VeterinarianId } from "../../../domain/appointment/index.js";
import { schemaResult } from "../../../domain/shared/schemaResult.js";
const schema = z.object({
appointmentId: AppointmentId.schema,
veterinarianId: VeterinarianId.schema,
}).readonly();
export type StartExaminationInput = z.infer<typeof schema>;
export const StartExaminationInput = {
schema,
parse: schemaResult(schema),
} as const; src/domain/shared/schemaResult.tsimport type { z } from "zod";
export type Result<T> = Readonly<{
isErr: () => boolean;
isOk: () => boolean;
_unsafeUnwrap: () => T;
}>;
export const ok = <T>(value: T): Result<T> => ({
isErr: () => false,
isOk: () => true,
_unsafeUnwrap: () => value,
});
export const err = <T>(): Result<T> => ({
isErr: () => true,
isOk: () => false,
_unsafeUnwrap: () => {
throw new Error("Cannot unwrap an invalid boundary value");
},
});
export const schemaResult = <T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>) =>
(raw: unknown): Result<T> => {
const parsed = schema.safeParse(raw);
return parsed.success ? ok(parsed.data) : err();
}; src/domain/appointment/appointmentId.tsimport { z } from "zod";
const schema = z.string().uuid().brand<"AppointmentId">();
export type AppointmentId = z.infer<typeof schema>;
export const AppointmentId = { schema, parse: schema.parse } as const; src/domain/appointment/veterinarianId.tsimport { z } from "zod";
const schema = z.string().uuid().brand<"VeterinarianId">();
export type VeterinarianId = z.infer<typeof schema>;
export const VeterinarianId = { schema, parse: schema.parse } as const; src/domain/appointment/transitions.tsexport const startExamination = (
appointment: CheckedIn,
veterinarianId: VeterinarianId,
examinationStartedAt: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt,
}) as const satisfies InExamination; 画面の不具合で「夜勤」が渡された(veterinarianId は "night-shift")
-
外側(parse の前): HTTPのリクエストを受け取ります。bodyの中身は未検査です。
src/adaptor/primary/web/routes.ts(request body){ veterinarianId: "night-shift" } -
外側(parse の前): routeは、URLの予約IDとbodyのveterinarianIdを1つのobjectにまとめ、parseへ渡します。
src/adaptor/primary/web/routes.ts(parse へ渡す値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "night-shift", } -
境界(parse): 入力全体の検査は、2つのIDのschemaを組み合わせたobject schemaで表します。
src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "night-shift", } -
境界(parse): parseの実体は、schemaResultがこのschemaから作った関数です。
src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "night-shift", } -
境界(parse): parseはunknownを受け取り、schemaのsafeParseで検査します。入力の形を仮定しません。
src/domain/shared/schemaResult.ts(safeParse へ渡す値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "night-shift", } -
境界(parse): 1つ目の項目です。予約IDはUUIDの形であるため検査を通過します。
src/domain/appointment/appointmentId.ts(appointmentId の検査: UUID の形であるため検査を通過)"11111111-1111-4111-8111-111111111111" -
境界(parse): 2つ目の項目です。UUIDの形ではないため検査を通過しません。
src/domain/appointment/veterinarianId.ts(veterinarianId の検査: UUID の形ではないため検査を通過しない)"night-shift" -
境界(parse): 検査を通過しない項目があるので、err()を呼びます。この場合、parseはStartExaminationInputを返しません。
src/domain/shared/schemaResult.ts(parse の結果)Err() -
境界(parse): errは値を持たないResultを返します。isErrはtrueを返します。
src/domain/shared/schemaResult.ts(parse の結果)Err() -
境界(parse): routeがErrに_unsafeUnwrapを呼びます。Errには内側へ渡す値がありません。
src/adaptor/primary/web/routes.ts(route が受け取った結果)Err() -
境界(parse): Errの_unsafeUnwrapは例外を投げ、startExaminationは呼ばれません。利用者へ返す応答は未解決で、現在はrouteの例外により500になります。
src/domain/shared/schemaResult.ts(内側に渡された値)// なし
獣医師が診察開始を送信した(veterinarianId は獣医師の UUID)
-
外側(parse の前): HTTPのリクエストを受け取ります。bodyの中身は未検査です。
src/adaptor/primary/web/routes.ts(request body){ veterinarianId: "44444444-4444-4444-8444-444444444444" } -
外側(parse の前): routeは、URLの予約IDとbodyのveterinarianIdを1つのobjectにまとめ、parseへ渡します。
src/adaptor/primary/web/routes.ts(parse へ渡す値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "44444444-4444-4444-8444-444444444444", } -
境界(parse): 入力全体の検査は、2つのIDのschemaを組み合わせたobject schemaで表します。
src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "44444444-4444-4444-8444-444444444444", } -
境界(parse): parseの実体は、schemaResultがこのschemaから作った関数です。
src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "44444444-4444-4444-8444-444444444444", } -
境界(parse): parseはunknownを受け取り、schemaのsafeParseで検査します。入力の形を仮定しません。
src/domain/shared/schemaResult.ts(safeParse へ渡す値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "44444444-4444-4444-8444-444444444444", } -
境界(parse): 1つ目の項目です。予約IDはUUIDの形であるため検査を通過します。
src/domain/appointment/appointmentId.ts(appointmentId の検査: UUID の形であるため検査を通過)"11111111-1111-4111-8111-111111111111" -
境界(parse): 2つ目の項目です。担当獣医師IDの欄の値もUUIDの形であるため検査を通過します。
src/domain/appointment/veterinarianId.ts(veterinarianId の検査: UUID の形であるため検査を通過)"44444444-4444-4444-8444-444444444444" -
境界(parse): 全項目が検査を通過したので、ok(parsed.data)を呼びます。型の上では、この値がStartExaminationInputになります。
src/domain/shared/schemaResult.ts(parse の結果)Ok({ appointmentId: "11111111-1111-4111-8111-111111111111", // AppointmentId veterinarianId: "44444444-4444-4444-8444-444444444444", // VeterinarianId }) -
境界(parse): okは値を持つResultを返します。_unsafeUnwrapを呼ぶと、その値が返ります。
src/domain/shared/schemaResult.ts(parse の結果)Ok({ appointmentId: "11111111-1111-4111-8111-111111111111", // AppointmentId veterinarianId: "44444444-4444-4444-8444-444444444444", // VeterinarianId }) -
内側(parse の後): routeはOkの中身を取り出します。ここから先が内側です。
src/adaptor/primary/web/routes.ts(input(StartExaminationInput)){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "44444444-4444-4444-8444-444444444444", } -
内側(parse の後): routeは、取り出したinputの獣医師IDと、固定の時刻を、startExaminationへ渡します。
src/adaptor/primary/web/routes.ts(startExamination へ渡す値){ veterinarianId: "44444444-4444-4444-8444-444444444444", examinationStartedAt: "2026-08-30T06:30:00.000Z", } -
内側(parse の後): startExaminationは、型がVeterinarianIdの値を受け取ります。HTTPで受け取る入力は境界で検査済みであるため、関数の中で同じ検査を繰り返しません。
src/domain/appointment/transitions.ts(startExamination の引数)veterinarianId: "44444444-4444-4444-8444-444444444444" // VeterinarianId
画面の不具合で予約の ID が渡された(veterinarianId は予約の UUID)
-
外側(parse の前): HTTPのリクエストを受け取ります。bodyの中身は未検査です。
src/adaptor/primary/web/routes.ts(request body){ veterinarianId: "11111111-1111-4111-8111-111111111111" } -
外側(parse の前): routeは、URLの予約IDとbodyのveterinarianIdを1つのobjectにまとめ、parseへ渡します。
src/adaptor/primary/web/routes.ts(parse へ渡す値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "11111111-1111-4111-8111-111111111111", } -
境界(parse): 入力全体の検査は、2つのIDのschemaを組み合わせたobject schemaで表します。
src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "11111111-1111-4111-8111-111111111111", } -
境界(parse): parseの実体は、schemaResultがこのschemaから作った関数です。
src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "11111111-1111-4111-8111-111111111111", } -
境界(parse): parseはunknownを受け取り、schemaのsafeParseで検査します。入力の形を仮定しません。
src/domain/shared/schemaResult.ts(safeParse へ渡す値){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "11111111-1111-4111-8111-111111111111", } -
境界(parse): 1つ目の項目です。予約IDはUUIDの形であるため検査を通過します。
src/domain/appointment/appointmentId.ts(appointmentId の検査: UUID の形であるため検査を通過)"11111111-1111-4111-8111-111111111111" -
境界(parse): 2つ目の項目です。担当獣医師IDの欄の値もUUIDの形であるため検査を通過します。
src/domain/appointment/veterinarianId.ts(veterinarianId の検査: UUID の形であるため検査を通過)"11111111-1111-4111-8111-111111111111" -
境界(parse): 全項目が検査を通過したので、ok(parsed.data)を呼びます。型の上では、この値がStartExaminationInputになります。
src/domain/shared/schemaResult.ts(parse の結果)Ok({ appointmentId: "11111111-1111-4111-8111-111111111111", // AppointmentId veterinarianId: "11111111-1111-4111-8111-111111111111", // VeterinarianId }) -
境界(parse): okは値を持つResultを返します。_unsafeUnwrapを呼ぶと、その値が返ります。
src/domain/shared/schemaResult.ts(parse の結果)Ok({ appointmentId: "11111111-1111-4111-8111-111111111111", // AppointmentId veterinarianId: "11111111-1111-4111-8111-111111111111", // VeterinarianId }) -
内側(parse の後): routeはOkの中身を取り出します。ここから先が内側です。
src/adaptor/primary/web/routes.ts(input(StartExaminationInput)){ appointmentId: "11111111-1111-4111-8111-111111111111", veterinarianId: "11111111-1111-4111-8111-111111111111", } -
内側(parse の後): routeは、取り出したinputの獣医師IDと、固定の時刻を、startExaminationへ渡します。
src/adaptor/primary/web/routes.ts(startExamination へ渡す値){ veterinarianId: "11111111-1111-4111-8111-111111111111", examinationStartedAt: "2026-08-30T06:30:00.000Z", } -
内側(parse の後): 形は正しいため内側まで渡されます。境界で検証できるのは形までで、実在の獣医師を指すかは判定できません。Branded Typeが検出するのはコードの誤りで、受け取った値の取り違えは検出しません。
src/domain/appointment/transitions.ts(startExamination の引数)veterinarianId: "11111111-1111-4111-8111-111111111111" // VeterinarianId