テスト前提で設計したWebアプリのハンズオン - 読書管理アプリその4

Thu, 05 Mar 2026 00:50:00 +0900

はじめに

Part1 でValueObject・Policy・Entityを作り、Part2 でServiceをDI＋Mockテストで固めた。 Part3 でPrismaを繋ぎ、GET /api/books と POST /api/books を動かした。

Part4では残りのエンドポイントを実装する。やることは3つ。

カスタム例外クラスの導入
PATCH /api/books/:id/start と PATCH /api/books/:id/complete の実装
DELETE /api/books/:id の実装

そして「エラー種別ごとにHTTPステータスを整理する」という設計判断を掘り下げる。

また、Part3でPrisma v7特有のセットアップをしたが、v6以前と何が変わったのかをここで整理しておく。

0. Prisma v7で何が変わったか

Part3でPrismaをセットアップしたとき、v6以前と比べていくつか「見慣れない書き方」が必要だった。 v7は破壊的変更が多く、ネット上のv6時代の記事を参考にすると詰まる箇所がある。ここで整理しておく。

参考: Upgrade to Prisma ORM 7 | Prisma Documentation

generator の変更

// ❌ v6以前
generator client {
  provider = "prisma-client-js"
}

// ✅ v7
generator client {
  provider = "prisma-client"
  output   = "../src/generated/prisma"
}

v7では prisma-client-js が廃止され prisma-client に変わった。 Rustベースのエンジンを廃止しTypeScriptネイティブになったことに伴う変更だ。また output が必須になり、node_modules への自動生成はなくなった。

テスト前提で設計したWebアプリのハンズオン - 読書管理アプリその3

Wed, 04 Mar 2026 17:50:00 +0900

はじめに

Part1 でValueObject・Policy・Entityを作り、Part2 でServiceをDI＋Mockテストで固めた。累計13テスト、全パスの状態だ。

Part3ではいよいよDBを繋ぐ。やることは3つ。

Prismaセットアップ＋スキーマ定義
PrismaBookRepository 実装（ドメインオブジェクトへの変換）
Route HandlerでDIを組み立てる

そして最後に「テストを書かない層を意図的に決める」という話をする。

1. Prismaセットアップ

npm install prisma @prisma/client
npx prisma init --datasource-provider sqlite

prisma/schema.prisma に Bookモデルを定義する。

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "sqlite"
  url      = env("DATABASE_URL")
}

model Book {
  id     String  @id
  title  String
  isbn   String
  status String
  rating Int?
}

User と Review はまだDBに持たない。Book の CRUD が動けば Part3 のゴール。

なぜ `status` を String で持つのか

Prismaは SQLiteで enum をネイティブサポートしていない。そのため status String で持ち、取り出し時に as ReadingStatus でキャストする。

テスト設計 on 怠惰技術ブログ

テスト前提で設計したWebアプリのハンズオン - 読書管理アプリ その4

はじめに

0. Prisma v7で何が変わったか

generator の変更

テスト前提で設計したWebアプリのハンズオン - 読書管理アプリ その3

はじめに

1. Prismaセットアップ

なぜ status を String で持つのか

テスト前提で設計したWebアプリのハンズオン - 読書管理アプリその4

テスト前提で設計したWebアプリのハンズオン - 読書管理アプリその3

なぜ `status` を String で持つのか