Skip to content

Latest commit

 

History

History
75 lines (51 loc) · 2.2 KB

File metadata and controls

75 lines (51 loc) · 2.2 KB

🍽️ FoodDiary Backend Overview

사진 한 장으로 완성되는 음식 기록 서비스의 백엔드 프로젝트

프로젝트 비전

"음식 기록의 번거로움을 없앤다"

사용자가 음식 사진 한 장만 올리면, 나머지는 시스템이 알아서 채워주는 경험을 제공합니다.

핵심 기능 (예정)

기능 설명 관련 기술
사진 업로드 음식 사진 저장 및 관리
음식 분석 이미지에서 음식 종류 추론
장소 추론 사진 메타데이터 기반 위치 추정 Kakao Map API
기록 자동화 추론 결과를 바탕으로 다이어리 자동 생성 비즈니스 로직

기술 스택

  • Language: Python 3.12
  • Framework: FastAPI
  • Validation: Pydantic v2
  • External APIs: Kakao Map, Gemini
  • Deployment:

프로젝트 원칙

1. 단순함 우선

MVP 단계에서는 완벽한 설계보다 동작하는 코드를 우선합니다.

❌ 미래를 위한 과도한 추상화
✅ 현재 필요한 최소한의 구현

2. 변경 가능성 전제

모든 설계는 바뀔 수 있다는 것을 전제로 합니다.

  • 인터페이스는 단순하게
  • 의존성은 느슨하게
  • 문서는 최신 상태로

3. 실패 허용

AI 기반 추론은 실패할 수 있습니다.

  • 추론 실패 시 사용자가 직접 입력할 수 있도록
  • 실패가 전체 시스템을 깨뜨리지 않도록

현재 상태

  • ✅ 프로젝트 기본 구조 설정
  • ✅ Health Check 엔드포인트
  • ✅ 코드 린팅/포맷팅 설정
  • ⏳ 인증 시스템
  • ⏳ 음식 다이어리 CRUD
  • ⏳ 사진 업로드
  • ⏳ AI 분석 연동

다음 단계

  1. 인증 시스템 구현 (OAuth 또는 간단한 토큰 기반)
  2. 다이어리 CRUD API 개발
  3. 사진 업로드 기능 구현
  4. AI 분석 서비스 연동

관련 문서