10장: 실전 프로젝트 - 처음부터 끝까지 Claude Code로 개발하기

프로젝트 디렉토리를 만들고 CLAUDE.md를 먼저 작성해 줘.

프로젝트명: bookmark-api
기술 스택: Fastify 5, TypeScript strict, Drizzle ORM + SQLite, Zod, Vitest
패키지 매니저: pnpm

CLAUDE.md에 포함할 내용:
- 기술 스택 요약
- 디렉토리 구조 (src/routes, src/services, src/db, src/middleware)
- 개발 명령어
- 코딩 컨벤션 (에러 처리 패턴, 로깅 규칙, 네이밍 규칙)
- 커밋 규칙

CLAUDE.md의 기술 스택에 맞게 프로젝트를 초기화해 줘.
- pnpm init
- TypeScript, ESLint, Prettier 설정
- Fastify, Drizzle ORM, Zod 설치
- tsconfig.json (strict: true)
- src/ 디렉토리 구조 생성
- 기본 서버 진입점 (src/index.ts)

.claude/settings.json에 다음 훅을 설정해 줘:
- PostToolUse: TypeScript 파일 수정 시 ESLint 자동 실행
- Stop: 응답 완료 시 타입 검사 실행
- PreToolUse: DROP TABLE, DELETE FROM 등 위험 쿼리 차단

Drizzle ORM으로 다음 테이블을 src/db/schema.ts에 정의해 줘:

bookmarks:
- id (integer, primary key, auto increment)
- url (text, not null, unique)
- title (text, not null)
- description (text, nullable)
- userId (integer, foreign key)
- createdAt (integer, unix timestamp)
- updatedAt (integer, unix timestamp)

tags:
- id (integer, primary key, auto increment)
- name (text, not null, unique)

bookmarkTags (다대다 관계):
- bookmarkId (integer, foreign key)
- tagId (integer, foreign key)
- primary key (bookmarkId, tagId)

users:
- id (integer, primary key, auto increment)
- email (text, not null, unique)
- passwordHash (text, not null)
- createdAt (integer, unix timestamp)

src/db/connection.ts에 SQLite 연결을 설정하고,
src/db/index.ts에서 Drizzle 인스턴스를 내보내 줘.
개발 환경에서는 ./data/dev.db 파일을 사용해 줘.

다음 서비스를 구현해 줘:

src/services/bookmark.service.ts:
- create(userId, data): 북마크 생성 (태그 포함)
- findById(id): ID로 조회
- findByUser(userId, options): 사용자별 목록 (페이지네이션, 태그 필터)
- update(id, userId, data): 수정 (소유자 확인)
- delete(id, userId): 삭제 (소유자 확인)
- search(userId, query): 전문 검색

src/services/auth.service.ts:
- register(email, password): 회원가입
- login(email, password): 로그인 (JWT 반환)
- verifyToken(token): 토큰 검증

모든 서비스 함수는 에러 시 AppError를 throw해 줘.

서비스 레이어를 사용하는 Fastify 라우트를 구현해 줘:

src/routes/bookmarks.ts:
- GET /bookmarks - 목록 조회 (쿼리: page, limit, tag)
- GET /bookmarks/:id - 상세 조회
- POST /bookmarks - 생성
- PUT /bookmarks/:id - 수정
- DELETE /bookmarks/:id - 삭제
- GET /bookmarks/search?q= - 검색

src/routes/auth.ts:
- POST /auth/register - 회원가입
- POST /auth/login - 로그인

모든 라우트에 Zod 스키마 유효성 검사를 적용해 줘.
인증이 필요한 라우트는 JWT 미들웨어를 거치도록 해 줘.

서비스 레이어의 단위 테스트를 작성해 줘.

src/services/__tests__/bookmark.service.test.ts:
- 북마크 CRUD 정상 동작
- 다른 사용자의 북마크 수정/삭제 시 에러
- 존재하지 않는 북마크 조회 시 에러
- 태그 필터링 동작
- 페이지네이션 동작
- 검색 동작

src/services/__tests__/auth.service.test.ts:
- 정상 회원가입
- 중복 이메일 가입 시 에러
- 정상 로그인
- 잘못된 비밀번호 시 에러
- JWT 생성 및 검증

테스트용 SQLite DB는 인메모리(:memory:)를 사용해 줘.

API 엔드포인트의 통합 테스트를 작성해 줘.

src/routes/__tests__/bookmarks.test.ts:
- Fastify inject를 사용해서 HTTP 요청을 시뮬레이션
- 인증된 요청과 인증되지 않은 요청 모두 테스트
- 정상 응답 형식 확인
- 에러 응답 형식 확인

모든 테스트가 통과하는지 pnpm test로 확인해 줘.

다음 프로젝트 전용 스킬을 만들어 줘:

.claude/skills/add-endpoint/SKILL.md:
- 새 API 엔드포인트를 추가하는 스킬
- 라우트, 서비스, 타입, 테스트를 한 번에 생성
- 기존 패턴을 참고하여 일관된 코드 생성

.claude/skills/db-migrate/SKILL.md:
- 스키마 변경 후 마이그레이션을 생성하고 적용하는 스킬
- 변경 전후 스키마 비교
- 마이그레이션 파일 생성

GitHub Actions CI를 구성해 줘.

.github/workflows/ci.yml:
- PR과 main 브랜치 push에 트리거
- Node.js 20 설정
- pnpm 의존성 설치 (캐시 활용)
- 린트 실행
- 타입 검사
- 테스트 실행
- 빌드 확인

.github/workflows/claude-review.yml:
- PR 생성/업데이트 시 Claude Code 자동 리뷰

프로젝트 전체를 검증해 줘:

1. pnpm lint -- 린트 에러 없는지 확인
2. npx tsc --noEmit -- 타입 에러 없는지 확인  
3. pnpm test -- 모든 테스트 통과하는지 확인
4. pnpm build -- 빌드 성공하는지 확인
5. 개발 서버를 실행하고 주요 엔드포인트 수동 테스트

문제가 있으면 수정해 줘.