テンプレート一覧に戻る
Node.js + Express + TypeScript
Express 5 + TypeScript + Prisma のバックエンドAPI向けCLAUDE.md。シンプルで拡張しやすいAPIサーバー構築に最適です。
初級nodejsexpresstypescript
CLAUDE.md
# プロジェクト名
Express 5 + TypeScript で構築されたREST APIサーバー。
## 技術スタック
- **フレームワーク**: Express 5.x
- **言語**: TypeScript 5.x (strict mode)
- **ORM**: Prisma 6.x
- **バリデーション**: Zod
- **テスト**: Vitest + Supertest
- **パッケージマネージャ**: npm
## コマンド
| コマンド | 用途 |
|---------|------|
| `npm run dev` | 開発サーバー起動 (tsx --watch) |
| `npm run build` | TypeScriptビルド |
| `npm start` | プロダクション起動 |
| `npm test` | Vitest実行 |
| `npm run lint` | ESLint実行 |
| `npx prisma migrate dev` | マイグレーション適用 |
## ディレクトリ構造
| パス | 役割 |
|-----|------|
| `src/routes/` | ルート定義 |
| `src/controllers/` | コントローラー |
| `src/services/` | ビジネスロジック |
| `src/middleware/` | ミドルウェア |
| `src/types/` | TypeScript型定義 |
| `prisma/` | Prismaスキーマ・マイグレーション |
## コーディング規約
- Controller → Service → Repository のレイヤー構成
- リクエスト/レスポンスの型はZodスキーマで定義・バリデーション
- エラーはカスタムエラークラスで統一し、エラーハンドリングミドルウェアで処理
- 環境変数は dotenv + Zodバリデーションで管理
- async/awaitを使用、コールバックは使わない
## Git規約
- ブランチ: `feature/`, `fix/`, `chore/`
- コミットメッセージ: Conventional Commits形式