Python Backend Development Guide (FastAPI)
Python FastAPI 백엔드 개발을 위한 종합 가이드.
적용 시점
다음 작업 시 이 가이드를 참조:
- Python 파일 생성/수정
- FastAPI 엔드포인트 작성
- Pydantic 스키마 정의
- 데이터베이스 모델 설계
- 비동기 함수 작성
핵심 원칙
1. 파일/모듈 책임 분리 ⚠️ CRITICAL
- 하드 제한 줄 수가 아니라 기능/책임 단위로 모듈을 나눈다
- 한 파일이 여러 유스케이스, 계층, 엔티티 책임을 섞으면 분리한다
- 대형 파일은 자동 실패가 아니라 분리 검토 신호로만 사용한다
2. 함수 크기 제한
- 최대 50줄
- 권장 20줄 이하
- 하나의 함수는 하나의 작업만
3. 모듈화 & 재사용성
- 공통 로직은
utils/또는core/로 분리 - 비즈니스 로직은 서비스 레이어에
- 데이터 접
[Description truncada. Veja o README completo no GitHub.]