revfactory Express API Design
프로젝트 구조
src/
app.js - Express 앱 설정, 미들웨어 등록, 라우트 마운트
routes/
{resource}Routes.js - 라우트 정의 (HTTP 메서드 + 경로)
controllers/
{resource}Controller.js - 비즈니스 로직
models/
{resource}Store.js - 데이터 모델 및 CRUD 연산
middleware/
validate.js - 입력 유효성 검사 미들웨어
errorHandler.js - 글로벌 에러 핸들링
REST 규칙
- GET /resources - 목록 조회 -> 200
- GET /resources/:id - 단건 조회 -> 200 / 404
- POST /resources - 생성 -> 201 / 400
- PUT /resources/:id - 수정 -> 200 / 400 / 404
- DELETE /resources/:id - 삭제 -> 200 / 404
핵심 원칙
- 모든 라우트는 controllers를 통해 처리
- 에러는 글로벌 에러 핸들러로 전파 (컨트롤러에서 throw)
- 입력 유효성 검사는 미들웨어에서 처리하여 재사용
- 일관된 에러 응답 형식:
{ error: "메시지" } - JSON 파싱 에러 별도 처리
- 데이터 모델은 클래스 기반 싱글턴 스토어로 구현
- 반환 시 스프레드 복사본 사용하여 불변성 보장
- 자동 ID 생성 (auto-increment) 및 createdAt 자동 설정
상세 코드 패턴은 references/patterns.md 참조.