Recipes Core Pack · Backend

FastAPI 부트스트랩

FastAPI 기본 구조, 환경설정 분리, 테스트 시작점을 한 번에 생성하는 레시피입니다.

FastAPI 부트스트랩 프롬프트

복사해서 사용하세요

"FastAPI 백엔드를 빠르게 부트스트랩하고 싶어. 아래 조건에 맞춰 바로 실행 가능한 초기 구성을 만들어줘. [입력 정보] - Python 버전: [3.11/3.12] - 패키지 매니저: [pip/uv/poetry] - DB: [PostgreSQL/SQLite] - 인증: [none/jwt/session] - 배포 대상: [Cloud Run/Railway] [출력 요구사항] 1) 폴더 구조와 핵심 파일 2) /health 포함 기본 라우트 3) 설정 분리(.env, config) 4) pytest 기반 테스트 시작점 5) 로컬 실행 + 배포 전 점검 항목"

위 프롬프트를 복사하여 AI 채팅에 붙여넣으세요.

명령어 예시

terminal

python -m venv .venv
source .venv/bin/activate
pip install fastapi uvicorn pytest
uvicorn app.main:app --reload

실행 체크리스트

0/5 완료

프로젝트 초기화가상환경/의존성 설치

/health 라우트 구성기본 헬스체크 추가

환경설정 분리.env와 config 모듈 분리

테스트 템플릿 작성pytest 스모크 테스트 구성

실행 검증uvicorn 실행 및 API 응답 확인

TL;DR

FastAPI 부트스트랩 작업 시 필요한 최소 기준과 검증 포인트를 빠르게 확인합니다.
실제 프로젝트 환경값(브랜치, 시크릿, URL, 임계치)은 팀 기준에 맞게 치환하세요.

사전 준비 (Prerequisites)

대상 리포지토리와 실행 환경 접근 권한 확인
로컬/CI에서 사용할 기본 명령어(`install`, `build`, `test`) 점검
환경변수/시크릿/배포 대상 정보를 최신 상태로 정리

실행 순서 (Steps)

변경 목표와 범위를 한 줄로 고정한다.
핵심 변경(FastAPI 부트스트랩)을 최소 단위 커밋으로 적용한다.
검증 로그를 남기고 체크리스트/문서를 즉시 업데이트한다.

검증 (Validation)

빌드/테스트가 현재 브랜치에서 재현 가능하게 통과하는지 확인
핵심 경로(사용자 플로우 또는 운영 플로우)를 수동 샘플 점검
ko/en 문서와 링크가 동일 의도를 유지하는지 대조

문제 해결 (Troubleshooting)

오류 발생 시 로그/요청 본문/환경값을 먼저 캡처한다.
권한/환경변수/라우팅/빌드 산출물 순서로 원인을 좁힌다.
임시 조치와 근본 원인 수정을 분리해 기록한다.

FastAPI 부트스트랩