지금이니? API 설계 초안

1. 읽는 방법

API는 React가 FastAPI에 요청하는 약속이다. GET은 조회, POST는 생성·처리 요청, PATCH는 일부 수정, DELETE는 삭제에 사용한다. 경로의 중괄호는 실제 ID로 바꾸는 자리다.

필수 기능: 회원가입·개인 저장, 현재 위치와 집·회사, 환승, AI 도보 산정, 저장값 재사용, 초기 5분 여유, 실제 관측과 개인화, 품질 이력과 로깅.

확정: DB는 PostgreSQL, 로컬 개발 DB는 Docker Compose 컨테이너와 영속 볼륨으로 운영한다. React는 DB에 직접 접근하지 않고 FastAPI를 통한다.

인증 확정: 이메일·비밀번호. 소셜 로그인은 후속 검토.

확정: 지원 지역은 서울특별시·경기도, 카카오맵 사용. 미정: 메일·실시간 교통 공급자, 배포 주소. 최대 환승은 첫 출시 2회로 확정(20절). AI 공급자는 OpenAI, 모델은 GPT-5.6 Luna (gpt-5.6-luna)로 사용자 확정. 사용자가 승인한 커스텀 AI 서버로 최소 연결 확인 완료. 예산·데이터 전달 조건·실제 서비스 품질 검증은 미완료. 카카오맵 선정과 실시간 ID 매핑·저장/AI 전달·실호출 검증 완료는 구분하며 상세 상태는 18절을 따른다.

2. 공통 규칙