0.FastAPI 개요

• FastAPI는 Python 기반의 웹 프레임워크

• 핵심 특징

  • 비동기 지원을 통해 높은 성능 제공
  • 타입 힌트, 데이터유효성검사(Pydantic) 등 제공
  • DB관리, 인증 등 웹서버 기본 편의 제공
  • Swagger API 문서가 자동 제공

• Django/Flask와 비교

  	FastAPI	Flask	Django
  성능	매우 빠름	보통	보통
  비동기	기본제공	제한적	제한적
  자동 문서화	기본 제공	없음	없음
  학습 난이도	낮음	낮음	중간

1. 개발 환경 준비

• 파이썬 Python 3.12+ 설치

  • 공식 홈페이지의 download탭에서 운영체제에 맞게 설치

• vscode 다운로드 및 설치

• docker desktop 설치

  • window 유저의 경우 amd64 다운로드. mac도 칩에 맞게 다운로드
  • 모두 기본설정(default)로 설치

• postgresql db 구축

  • docker설치 명령어
    • docker run -d --name postgres-db-with-vector -e POSTGRES_USER=myuser -e POSTGRES_PASSWORD=mysecretpassword -p 5432:5432 pgvector/pgvector:pg16
  • 스키마 생성
    • create database ai_agent_db;

• datagrip 설치

  • data조회를 위한 datagrip 설치

• llm활용을 위한 openai 세팅

  • OpenAI platform에서 계정 생성
  • Home → Add Credits에서 결제 수단 등록 및 결제(최소 결제 금액)
  • API Key를 발급 및 API Key 환경변수(운영체제)로 주입
    • 윈도우
      • setx OPENAI_API_KEY "sk-xxxxx”
    • 맥북
      • nano ~/.zshrc
      • export OPENAI_API_KEY="sk-xxxxx”
      • source ~/.zshrc

• 수업 코드 clone

  • https://github.com/kimseonguk197/ai_agent_chatbot

• 가상환경세팅, 라이브러리 설치, 서버 실행

  py -3.12 -m venv .venv
  .venv/Scripts/activate #비활성화는 deactivate
  pip install -r requirements.txt
  uvicorn app.main:app --reload
  

2.프로젝트 구조

app/
├── main.py              # 프로젝트 진입점(앱 객체 생성 및 전역 설정 등)
├── models/              # DB ENTITY 모델 (member, order, product)
├── ai/                  # ai 모듈
├── routers/             # 라우터 (member, order, product 등으로 라우팅)
├── schemas/             # 데이터 검증 계층 (dto 계층)
├── services/            # 비즈니스 로직 계층 (핵심 연산 및 흐름 제어)
├── database.py          # database 연결
.env                     # 환경변수
requirements.txt         # 라이브러리 (의존성)

3.핵심기능

• 회원(member)
  • 회원가입(email, password, name, age)
  • 로그인 / 토큰 발급
  • 마이페이지 조회
• 상품(product)
  • 상품 등록(상품명, 카테고리, 재고수량, 가격, 등록자(member_id))
  • 상품 목록 조회
• 주문(order)
  • 주문 생성(주문자id, 상품id, 주문개수)
  • 나의 주문 내역 조회
• 챗봇(chat)
  • 자연어 챗봇 질의(message)