- SAM API 페이지네이션 표준 응답 구조 정의 - data 배열 + pagination 객체 분리 구조 - 구현 가이드 및 TypeScript 타입 정의 포함
Standards (개발 표준)
코드 작성 방법에 대한 규칙 - "어떻게 코드를 작성할 것인가"
목적
- 일관된 코드 스타일 유지
- 팀 간 협업 효율성 향상
- 코드 리뷰 기준 명확화
문서 목록
| 문서 | 설명 | 필수 확인 시점 |
|---|---|---|
| api-rules.md | API 개발 규칙 (Service-First, FormRequest, i18n) | API 개발 전 |
| pagination-policy.md | 페이지네이션 정책 (응답 구조, 파라미터) | 목록 API 개발 전 |
| git-conventions.md | Git 커밋 메시지, 브랜치 전략 | 커밋 전 |
| quality-checklist.md | 코드 품질 체크리스트 | PR 전 |
관련 폴더
- architecture/ - 설계 원칙 (왜 이렇게 설계하는가)
- rules/ - 비즈니스 규칙 (무엇이 유효한 데이터인가)