하와이 숙박 예약 플랫폼 구축 (다국어 · 글로벌 결제 · 외부 채널 연동) 전문가

[프로젝트 개요]
미국 하와이에서 숙박업을 운영 중인 발주사의 자체 예약 플랫폼 신규 구축. 기존 홍보용 사이트를 대체해 직접 예약과 온라인 결제를 처리하고, 에어비앤비 등 외부 예약 채널과 재고를 실시간 동기화해 오버부킹을 차단한다. 반응형 웹 앱으로 구축하며 한국어 영어 일본어 3개 언어를 지원한다.

[비즈니스 목표 및 추진 배경]
- 같은 객실을 여러 외부 채널에 중복 노출 중이나 채널 간 재고가 동기화되지 않아 오버부킹 위험 상존
- 외부 채널 수수료 의존을 낮출 직접 예약 경로 확보
- 한국 미국 일본 고객 대상 다국어 다통화 예약 처리
- 객실 8실 규모 단일 숙소, 객실 추가 가능

[기대 효과]
- 오버부킹 및 그로 인한 현지 클레임 환불 제거
- 채널 수수료 절감
- 예약 재고 요금의 단일 관리 체계 확보

[과업 범위]
- 고객용 반응형 웹 예약 사이트 (한국어 영어 일본어) - 기획, 디자인, 개발 턴키
- Stripe 기반 온라인 결제 및 환불
- 실시간 재고 요금 관리 및 외부 채널 양방향 동기화
- 관리자 백오피스
- 배포 및 초기 안정화

[상세 기능 요구 사항]

숙박 상품 및 재고
- 객실 타입 등록 수정 (사진 편의시설 정원)
- 날짜별 재고 수량 관리
- 날짜별 요금 및 시즌 요금표
- 최소 숙박일 및 체크인 가능 요일 규칙
- 부가옵션 (조식 주차 청소비)

검색 및 예약
- 날짜 인원 기준 가능 객실 조회
- 날짜 범위 연속 재고 판정
- 재고 홀딩 만료 복원 (동시 결제 경합 제어)
- 예약 상태 전이 처리
- 타임존 변환 (하와이 한국 일본)
- 비회원 예약 조회 (예약번호 이메일)

채널 연동
- 채널 매니저 API 연동 기반 및 벤더 어댑터 계층
- 재고 요금 숙박규칙 실시간 송신
- 채널 예약 수신 및 내부 예약 생성
- 재고 단일 관리 및 채널 간 즉시 마감
- 객실 타입 대 채널 리스팅 매핑 (1대다 재고 풀 공유)
- 동기화 실패 재시도 큐 및 백오프
- 오버부킹 충돌 감지 및 즉시 알림
- 채널 예약 취소 변경 반영

결제 및 정산
- Stripe 결제 3DS 및 웹훅 수신
- 하와이 숙박세 소비세 계산
- 취소 환불 정책 엔진 (기한별 부분환불)
- Stripe 환불 연동
- 채널별 통화별 매출 정산 집계

회원 및 알림
- 이메일 가입 로그인 비밀번호 재설정
- 마이페이지 예약 목록 및 상세
- 다국어 트랜잭션 메일 (확정 변경 취소)
- 예약 확인서 바우처 발급
- 체크인 리마인더 스케줄러
- 동기화 실패 관리자 알림

관리자
- 예약 관리 목록 검색 필터 (출처 채널 표시)
- 예약 상세 상태 변경 메모
- 재고 요금 캘린더 일괄 수정
- 취소 환불 처리
- 회원 관리
- 예약 변경 이력 감사 로그

[요구사항 - 사용자 스토리 및 수용 기준]

- 스토리: 해외 투숙객으로서 내 언어와 통화로 객실을 예약하고 카드로 결제하고 싶다
수용 기준: 언어를 일본어로 바꾼 상태에서 예약하면 화면 요금 표기 확인 메일이 모두 일본어로 제공된다

- 스토리: 투숙객으로서 결제 직후 예약 확정 여부를 확인하고 싶다
수용 기준: 결제 승인 웹훅 수신 시 예약이 확정으로 전이되고 확인 메일과 바우처가 발송된다

- 스토리: 숙소 운영자로서 외부 채널 예약이 들어오면 자사 사이트 재고가 즉시 줄기를 원한다
수용 기준: 채널 예약 수신 후 60초 이내에 해당 날짜 재고가 차감되고 다른 모든 채널 리스팅이 마감된다

- 스토리: 숙소 운영자로서 동기화가 실패하면 즉시 알고 싶다
수용 기준: 송신 실패가 재시도 한도를 초과하면 관리자 알림이 발송되고 상태 화면에 오류로 표시된다

- 스토리: 숙소 운영자로서 성수기 요금과 최소 숙박일을 직접 조정하고 싶다
수용 기준: 캘린더에서 기간을 선택해 요금과 최소 숙박일을 일괄 저장하면 연동된 모든 채널에 반영된다

- 스토리: 투숙객으로서 규정에 따라 취소하고 환불받고 싶다
수용 기준: 무료 취소 기한 이전 취소 시 전액 환불이 자동 처리되고 기한 이후에는 규정 비율만 환불된다

[핵심 시나리오]
1. 직접 예약: 날짜 인원 입력 - 가능 객실 조회 - 객실 및 부가옵션 선택 - 투숙객 정보 입력 - 재고 홀딩 - Stripe 결제 - 웹훅 수신 - 예약 확정 - 재고 차감 - 전 채널 마감 송신 - 확인 메일 발송
2. 채널 예약 유입: 채널 매니저 예약 수신 - 매핑 확인 - 내부 예약 생성 - 재고 차감 - 나머지 채널 마감 송신 - 관리자 알림
3. 동시 예약 경합: 같은 날짜 마지막 1실에 직접 예약과 채널 예약 동시 발생 - 우선순위 정책에 따라 1건 확정 - 나머지 1건 충돌 처리 및 관리자 즉시 알림
4. 취소 및 환불: 취소 요청 - 정책 판정 - Stripe 환불 - 재고 복원 - 전 채널 개방 송신 - 취소 메일 발송

[데이터 주요 엔티티]
- 객실 타입: 판매 단위 및 정원 편의시설
- 재고 캘린더: 날짜별 판매 가능 수량
- 요금 캘린더: 날짜별 요금 및 최소 숙박일
- 예약: 투숙 기간 인원 금액 출처 채널 상태
- 결제: 승인 환불 내역 및 Stripe 식별자
- 회원: 예약자 계정 및 연락 정보
- 채널 계정: 연동 채널 인증 정보
- 리스팅 매핑: 객실 타입과 채널 리스팅의 대응 관계
- 동기화 로그: 송수신 이력 및 실패 사유

상세 데이터 구조는 착수 단계에서 확정한다.

[예약 상태 흐름]
- 홀딩 - 결제 승인 - 확정 - 체크인 완료 - 종료
- 홀딩 - 홀딩 만료 또는 결제 실패 - 취소 및 재고 복원
- 확정 - 변경 요청 - 확정 (변경 반영)
- 확정 - 취소 요청 - 정책 판정 - 환불 완료 및 재고 복원
- 확정 - 충돌 감지 - 관리자 개입

[화면 목록]

고객 10개
- 홈 및 검색 위젯
- 가능 객실 목록
- 객실 상세 및 요금 캘린더
- 예약 정보 입력
- 결제
- 예약 완료 및 확인서
- 로그인 회원가입
- 마이페이지 예약 목록
- 예약 상세 및 취소 요청
- 약관 취소정책 FAQ

관리자 11개
- 대시보드
- 예약 목록
- 예약 상세 및 상태 변경
- 객실 상품 관리
- 재고 요금 캘린더
- 취소 환불 처리
- 회원 관리
- 매출 정산 리포트
- 채널 연결 관리
- 객실 리스팅 매핑
- 동기화 상태 및 오류

[외부 연동 요건]
- Stripe: 결제 3DS 환불 웹훅. 다통화 표시 및 청구 통화 정책은 협의
- 채널 매니저: 재고 요금 실시간 송신 및 예약 수신. 벤더 미정이므로 어댑터 계층으로 교체 가능하게 구현
- 에어비앤비 부킹닷컴은 개별 개발사에 예약 API를 직접 개방하지 않으므로 채널 매니저 경유를 전제로 한다
- iCal 동기화는 갱신 지연으로 오버부킹을 막지 못하므로 주 연동 수단에서 제외한다
- 메일 발송 서비스: 다국어 트랜잭션 메일

[비기능 요구 사항]
- 재고 정합성: 동시 결제 경합 상황에서 초과 판매 발생 금지
- 채널 반영 지연: 예약 확정 후 60초 이내 전 채널 반영 목표
- 가용성: 24시간 예약 접수. 동기화 중단 시 관리자 알림
- 다국어: 한국어 영어 일본어. 언어별 날짜 시간 숫자 통화 형식 적용
- 타임존: 하와이 기준 운영. 한국 일본 접속자 기준 표시 및 날짜 경계 처리
- 접속 지역: 한국 미국 일본
- 보안: 결제 정보 비저장. 관리자 권한 분리 및 감사 로그

[스코프 밖]
- 렌터카 및 투어 상품 예약
- 채널 매니저 구독료 및 계정 개설
- 에어비앤비 부킹닷컴 파트너 인증 취득
- 네이티브 모바일 앱
- 기존 홍보 사이트 콘텐츠 이관

[제약 사항 및 확인 필요]
아래는 발주사 사업 정보 및 외부 계정 사안으로 착수 단계에서 확정한다. 제안 시 임의로 정하지 않는다.
- Stripe 계정 주체 (미국 법인 EIN 정산 계좌). 미확보 시 결제 구현 불가
- 채널 매니저 벤더 및 구독 주체
- 연동 대상 채널 목록
- 하와이 숙박세 소비세 세율 및 청소비 과세 여부
- 취소 환불 규정 원문
- 직접 예약과 채널 예약 동시 발생 시 우선순위 정책
- 결제 통화 정책 (단일 청구 또는 표시 통화 분리)
- 상세 데이터 구조

[기술 스택 제안]
- 반응형 웹 프론트엔드 및 백엔드 API. 스택은 협의 가능
- 데이터베이스 및 작업 큐 (재시도 백오프 용도). 협의 가능
- 클라우드 호스팅. 협의 가능

[투입 인력 기대]
- 기획 디자인 개발 QA PM 구성의 팀 단위 수행
- 채널 연동 및 동시성 처리 담당 인력 명시 요망


[제안 요청 사항]
- 예약 시스템 구축 실적 및 채널 매니저 연동 경험
- 제안 금액 기간 투입 인력 구성
- 재고 정합성 및 동시성 처리 방안
- 동기화 실패 감지 및 복구 방안
- 유지보수 범위 및 조건

[자격 및 우대 사항]
- 우대: 숙박 예약 시스템 구축 경험
- 우대: 채널 매니저 또는 OTA 연동 경험
- 우대: Stripe 등 해외 결제 연동 경험
- 우대: 다국어 다통화 서비스 구축 경험

[산출물]
- 동작하는 시스템 및 전체 소스 코드
- 화면 목록 및 기능 정의 문서
- 배포 및 운영 안내 문서
- 채널 연동 설정 안내

[계약 특이사항]
- 채널 매니저 구독료 호스팅 도메인 결제 수수료는 발주사 부담
- 채널 매니저 벤더 확정은 채널 연동 착수의 선결 조건
- 채널 실계정 연동 검증을 위한 계정 권한 위임 필요