SMS Valet 문서

SMS Valet(로봇 발레파킹)의 사용자·관리자 매뉴얼과 API 레퍼런스를 한 곳에 모았습니다.

구성

섹션	대상	내용
사용자 매뉴얼	일반 이용자	주차 예약·등록, 마이페이지, 차량 등록
관리자 매뉴얼	운영 관리자	주차장 관리, 홈 화면 디자인, 예약/등록 관리
API 레퍼런스	개발/연동	백엔드 OpenAPI(REST) 전체 명세

서비스 한눈에 보기

• 예약제 주차장: 날짜·입출차 시간을 미리 예약한 뒤 이용합니다.
• 등록제 주차장: 차량을 등록해 두고, 승인 후 상시 이용합니다.
• 로봇 발레파킹 흐름: 사전 예약/등록 → 입차 구역 이동 → 로봇 발레파킹 → (이용) → 출차 구역 이동 → 출차 완료.
• 서브도메인 홈: 특정 주차장 전용 도메인(예: gpa.robotvalet.io)으로 들어오면 그 주차장에 맞춘 홈 화면이 표시되고, 예약 흐름이 휴대폰 인증부터 시작됩니다.

인증 방식

본인 확인 인증번호는 문자(SMS) 로 발송됩니다.

API 레퍼런스 갱신

API 명세(openapi.json)는 백엔드 FastAPI에서 자동 생성됩니다. 백엔드가 바뀌면 아래로 갱신하세요.

cd docs
npm run gen:openapi   # ../backend 의 app.openapi() 추출 → docs/openapi.json