ホーム 全セッション S03

境界を通過した値だけを内側へ渡す構成

10 / 18 目安 2分

ページ一覧

解決策: ここまでの知識を組み合わせて、境界の検査を作成します。

StartExaminationInput.parse は、schemaResult が schema から作った関数です。この schema は、ID の schema(AppointmentId.schema と VeterinarianId.schema)を z.object でまとめ、.readonly() で項目を読み取り専用にしたものです。

解決したこと: 不正な値を内側へ渡さないことです。この仕組みで解決しないこと: 利用者へ返す応答は未解決で、現在は route の例外により HTTP ステータス 500 になります。ID の実在は検証しません。データベースの値は、検査済みの値を保存している前提で検査しません。

値が境界を通る様子 場面を選んで、コマを進めます。上の帯は、値が parse の前、parse の中、parse の後のどこにあるかを表します。下のコードは現在説明している行です。
外側(parse の前)
境界(parse)
内側(parse の後)

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.ts
import 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.ts
import { 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.ts
import { 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.ts
export const startExamination = (
  appointment: CheckedIn,
  veterinarianId: VeterinarianId,
  examinationStartedAt: string,
): InExamination =>
  ({
    ...appointment,
    kind: "InExamination",
    veterinarianId,
    examinationStartedAt,
  }) as const satisfies InExamination;

画面の不具合で「夜勤」が渡された(veterinarianId は "night-shift")

  1. 外側(parse の前): HTTPのリクエストを受け取ります。bodyの中身は未検査です。

    src/adaptor/primary/web/routes.ts(request body)

    { veterinarianId: "night-shift" }
  2. 外側(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",
    }
  3. 境界(parse): 入力全体の検査は、2つのIDのschemaを組み合わせたobject schemaで表します。

    src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "night-shift",
    }
  4. 境界(parse): parseの実体は、schemaResultがこのschemaから作った関数です。

    src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "night-shift",
    }
  5. 境界(parse): parseはunknownを受け取り、schemaのsafeParseで検査します。入力の形を仮定しません。

    src/domain/shared/schemaResult.ts(safeParse へ渡す値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "night-shift",
    }
  6. 境界(parse): 1つ目の項目です。予約IDはUUIDの形であるため検査を通過します。

    src/domain/appointment/appointmentId.ts(appointmentId の検査: UUID の形であるため検査を通過)

    "11111111-1111-4111-8111-111111111111"
  7. 境界(parse): 2つ目の項目です。UUIDの形ではないため検査を通過しません。

    src/domain/appointment/veterinarianId.ts(veterinarianId の検査: UUID の形ではないため検査を通過しない)

    "night-shift"
  8. 境界(parse): 検査を通過しない項目があるので、err()を呼びます。この場合、parseはStartExaminationInputを返しません。

    src/domain/shared/schemaResult.ts(parse の結果)

    Err()
  9. 境界(parse): errは値を持たないResultを返します。isErrはtrueを返します。

    src/domain/shared/schemaResult.ts(parse の結果)

    Err()
  10. 境界(parse): routeがErrに_unsafeUnwrapを呼びます。Errには内側へ渡す値がありません。

    src/adaptor/primary/web/routes.ts(route が受け取った結果)

    Err()
  11. 境界(parse): Errの_unsafeUnwrapは例外を投げ、startExaminationは呼ばれません。利用者へ返す応答は未解決で、現在はrouteの例外により500になります。

    src/domain/shared/schemaResult.ts(内側に渡された値)

    // なし

獣医師が診察開始を送信した(veterinarianId は獣医師の UUID)

  1. 外側(parse の前): HTTPのリクエストを受け取ります。bodyの中身は未検査です。

    src/adaptor/primary/web/routes.ts(request body)

    { veterinarianId: "44444444-4444-4444-8444-444444444444" }
  2. 外側(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",
    }
  3. 境界(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",
    }
  4. 境界(parse): parseの実体は、schemaResultがこのschemaから作った関数です。

    src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "44444444-4444-4444-8444-444444444444",
    }
  5. 境界(parse): parseはunknownを受け取り、schemaのsafeParseで検査します。入力の形を仮定しません。

    src/domain/shared/schemaResult.ts(safeParse へ渡す値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "44444444-4444-4444-8444-444444444444",
    }
  6. 境界(parse): 1つ目の項目です。予約IDはUUIDの形であるため検査を通過します。

    src/domain/appointment/appointmentId.ts(appointmentId の検査: UUID の形であるため検査を通過)

    "11111111-1111-4111-8111-111111111111"
  7. 境界(parse): 2つ目の項目です。担当獣医師IDの欄の値もUUIDの形であるため検査を通過します。

    src/domain/appointment/veterinarianId.ts(veterinarianId の検査: UUID の形であるため検査を通過)

    "44444444-4444-4444-8444-444444444444"
  8. 境界(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
    })
  9. 境界(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
    })
  10. 内側(parse の後): routeはOkの中身を取り出します。ここから先が内側です。

    src/adaptor/primary/web/routes.ts(input(StartExaminationInput))

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "44444444-4444-4444-8444-444444444444",
    }
  11. 内側(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",
    }
  12. 内側(parse の後): startExaminationは、型がVeterinarianIdの値を受け取ります。HTTPで受け取る入力は境界で検査済みであるため、関数の中で同じ検査を繰り返しません。

    src/domain/appointment/transitions.ts(startExamination の引数)

    veterinarianId: "44444444-4444-4444-8444-444444444444" // VeterinarianId

画面の不具合で予約の ID が渡された(veterinarianId は予約の UUID)

  1. 外側(parse の前): HTTPのリクエストを受け取ります。bodyの中身は未検査です。

    src/adaptor/primary/web/routes.ts(request body)

    { veterinarianId: "11111111-1111-4111-8111-111111111111" }
  2. 外側(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",
    }
  3. 境界(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",
    }
  4. 境界(parse): parseの実体は、schemaResultがこのschemaから作った関数です。

    src/adaptor/primary/web/startExaminationInput.ts(修正後)(parse へ渡された値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "11111111-1111-4111-8111-111111111111",
    }
  5. 境界(parse): parseはunknownを受け取り、schemaのsafeParseで検査します。入力の形を仮定しません。

    src/domain/shared/schemaResult.ts(safeParse へ渡す値)

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "11111111-1111-4111-8111-111111111111",
    }
  6. 境界(parse): 1つ目の項目です。予約IDはUUIDの形であるため検査を通過します。

    src/domain/appointment/appointmentId.ts(appointmentId の検査: UUID の形であるため検査を通過)

    "11111111-1111-4111-8111-111111111111"
  7. 境界(parse): 2つ目の項目です。担当獣医師IDの欄の値もUUIDの形であるため検査を通過します。

    src/domain/appointment/veterinarianId.ts(veterinarianId の検査: UUID の形であるため検査を通過)

    "11111111-1111-4111-8111-111111111111"
  8. 境界(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
    })
  9. 境界(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
    })
  10. 内側(parse の後): routeはOkの中身を取り出します。ここから先が内側です。

    src/adaptor/primary/web/routes.ts(input(StartExaminationInput))

    {
      appointmentId: "11111111-1111-4111-8111-111111111111",
      veterinarianId: "11111111-1111-4111-8111-111111111111",
    }
  11. 内側(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",
    }
  12. 内側(parse の後): 形は正しいため内側まで渡されます。境界で検証できるのは形までで、実在の獣医師を指すかは判定できません。Branded Typeが検出するのはコードの誤りで、受け取った値の取り違えは検出しません。

    src/domain/appointment/transitions.ts(startExamination の引数)

    veterinarianId: "11111111-1111-4111-8111-111111111111" // VeterinarianId