Project brief
프로젝트 내용
[프로젝트 개요]
- 숙소 운영자가 여러 여행 예약 플랫폼의 예약, 객실 재고, 요금과 고객 메시지를 한곳에서 관리하는 기존 웹 서비스 '스테이플(Stayple)'의 개선 개발입니다.
- 사업 목표는 AI 숙소 메시지 구축이며, 정확한 예약 정보로 답변할 수 있도록 예약·재고 연계와 요금 설정·전송 안정화를 먼저 진행합니다. 개발 우선순위는 ① 예약·재고 안정화 ② 요금 설정·전송 안정화 ③ AI 답변 생성 및 단계적 자동발송입니다.
- 기존 소스와 Channex 연동을 인수·진단해 수정·확장하는 범위이며, 토스 월 구독 결제, 신규 모바일 앱, 전체 UI 개편, 숙소 분석 AI 확장, 숙박 결제·정산 기능은 제외합니다.
- 정부지원사업으로 진행하는 프로젝트로, 계약·수행·검수·완료보고 증빙이 필요합니다.
[프로젝트 배경 및 목표]
- 지금 상황: 예약 취소 후 판매 상태, 플랫폼 간 재고 일치, 여러 요금을 한 번에 변경할 때의 안정성에 문제가 있습니다. 예약·요금·메시지 기능은 구현되어 있으나 실제 운영 조건에서의 정확성과 예외 처리는 코드 진단과 테스트로 확인해야 합니다. 정부지원사업에 선정되어 요구사항을 정리하고 이번에 진행합니다.
- 끝나면 이렇게 되기를 바랍니다: 예약·재고가 각 플랫폼과 일치하고, 운영자가 목표 실수령액을 정하면 여러 숙소·객실·플랫폼에 요금을 한 번에 전송하며, AI가 검증된 예약·숙소 정보로 답변 초안을 만들고 검증된 문의 유형부터 자동발송하기를 바랍니다.
[필수 과업 범위와 결과물]
1. 수행 범위
- 상세 기획: 기존 소스와 Channex 연동 진단(현재 동작·남은 결함·추가 개발 구분), 대상 플랫폼·매핑·정책 확정
- 기획 및 디자인: 요구사항 정의서·화면설계서·메뉴구조도·프로토타입을 제공하며 기존 화면을 재사용합니다. 전면 UI 개편은 없습니다.
- SW 개발: 예약·재고 안정화, 요금 설정·전송, AI 숙소 메시지
- 테스트·QA: 통합·회귀 시험, 요구사항별 검수 근거 제출
2. 상세 기능 요구 사항
- 요구사항·화면 단위 상세 정의는 첨부된 요구사항 정의서, 화면설계서, 제안요청서, 메뉴구조도에 있습니다. 요구사항 ID와 화면 ID를 수행계획·견적·시험 결과에 동일하게 사용해 주세요.
2-1. 공통 Channex 연동 (CHX-01~05)
- 연결·매핑: 숙소·객실 유형·요금제와 플랫폼 대응 점검, 기능별 지원/미지원/미확인 정리
- 예약 수신: 웹훅·Booking Revisions Feed·예약 변경 ACK 점검, 누락 보충·복구
- 시험·운영: 운영/시험 계정·테스트 숙소 분리, 연결 장애·웹훅 중단·누락 감지
2-2. 예약 운영 (UI-01, RES-01~04)
- 예약 수신·조회: 신규·변경·취소 수신, 숙소·객실·요금제·일정·인원·상태·금액 연결, 필수 정보 누락 시 확인 대상 분류
- 변경·취소 처리: 변경 내역 저장 후 ACK, 중복·지연·역순 알림 처리
- 판매 상태 보존: 취소·일정 변경 구간만 재고 해제, 다른 예약·수동 판매중지 유지
- 불일치·복구: 연동 상태·마지막 확인 시각·실패 원인 표시, 원본 재조회, 실패 작업 재처리 및 이력
2-3. 요금 관리 (UI-02~03, RATE-01~04)
- 계산 조건 관리: 숙소·객실·요금제별 수수료, 할인 부담 주체·중복 적용, 포함/제외 비용 기준
- 등록 가격 계산: 평일·주말·지정 날짜 목표 실수령액 기준 플랫폼별 등록 가격·예상 실수령액 산출, 미확인 조건은 확인 필요 표시
- 일괄 변경: 숙소·객실·날짜·플랫폼·요금제 다중 선택, 전송 전 미리보기, 중복 실행 차단
- 결과·재처리: 내부 저장·Channex 접수·Channex 재조회·플랫폼 반영 확인 단계별 표시, 실패 항목만 재전송, 변경 이력
2-4. 메시지 관리 (UI-04, AI-01~03)
- 기존 메시지 점검: 메시지 조회·직접 답변·예약 관련 자동 안내 연동 상태 점검 및 개선
- AI 답변 초안: 연결 예약의 일정·인원·상태와 숙소 안내 검증 후 서버에서 초안 생성, 근거·확인 시각 기록
- 검토·자동발송: 운영자 확인·수정·발송, 문의 유형별 4주 연속 무수정 검증 후 허용 유형 자동발송, 운영자 중지 설정, 중복 발송 방지
- 미처리·통계: 정보 부족·예약 불일치·발송 실패·자동발송 제외(환불·금액·클레임) 문의 분류, 자동답변·수정·미처리·발송 실패 기본 통계
- 적용 채널: Channex 메시지 API가 지원하고 해당 계정에서 사용 가능한 채널부터 적용
2-5. 공통·인수 (COM-01~02)
- 접근 권한: 허용 숙소 범위 서버 확인(조회자·운영자·서비스 관리자), 개인정보 최소 노출, 비밀키 서버 관리
- 회귀 시험: 기존 예약·요금·메시지 기능 회귀 시험
3. 결과물
- 수정·신규 소스코드
- 환경·배포·복구 안내, 데이터·API 연동 및 요금 계산 명세
- Channex 채널별 지원표·매핑표·오류/복구 이력
- 요구사항별 테스트 결과서(연동 로그 등 검수 근거 포함)
- 운영 매뉴얼, 완료보고서
[계약 전 확정 항목]
- 아래 항목은 진단 후 계약 전에 발주자가 확정합니다.
1. 대상 플랫폼·숙소·객실·요금제 범위, 플랫폼별 예약·재고·요금·메시지 지원 및 시험 가능 범위
2. 목표 실수령액에 포함·제외할 비용과 지원할 할인 조건
3. 반영 지연 허용치, AI 자동발송 허용 유형과 관찰 일정
[기술 스택]
- 기존 환경: React·Vite, Firebase, Vercel
- 연동 구조: 스테이플 ↔ Channex API ↔ 여행 예약 플랫폼
[클라이언트 준비 사항]
- 준비된 것: 기존 웹 서비스 소스와 Channex 연동, 요구사항 정의서·화면설계서·제안요청서·메뉴구조도, 클릭 가능한 화면 프로토타입. 프로토타입은 가상 데이터로 만든 설명용 자료이며 실제 API 동작이나 개발 완료를 뜻하지 않습니다.
- 별도 협의: 상세 플랫폼 목록, 코드·로그, 테스트 계정 및 연동 권한은 업체 검토 단계에서 별도 협의합니다. 시험 환경에서 모든 채널의 실제 검증이 준비되어 있다고 전제하지 말아 주세요.
[오픈 시점과 예산]
- 목표 시점: 실제 계약·납품일과 지원금 인정 범위는 기관 확인 후 확정합니다.
- 예산: 1,000만원
[제안 포함 필수 사항]
- 지원 내용은 아래 기준으로 검토합니다.
1. 기존 React·Firebase·Vercel 구조와 Channex 연동을 어떤 방식으로 보강할지 이유와 함께 제안에 포함해 주세요. 플랫폼별 직접 연동, Channex 대체 또는 전면 재구축이 필요하다고 판단하시면 근거·비용·이관 영향을 별도로 적어 주세요.
2. 파트너님께서 판단하시기에 어떤 부분이 완료되어야 이 프로젝트가 성공적으로 마무리되었다고 보시는지 제안에 포함해 주세요. 전문가로서 이 프로젝트의 결과물에 대한 의견 부탁드립니다.
3. 위 '계약 전 확정 항목' 중 견적에 영향을 주는 부분은 어떤 가정으로 산정했는지 제안에 포함해 주세요.
4. 예약·요금·AI 영역별 비용·기간·담당 인력·포함/제외 범위와 기존 시스템 진단의 범위·비용, 검수 방법, 하자보수 조건을 제안에 포함해 주세요. 예산 안에서 실행 가능한 필수 범위를 먼저 제안하고 선택·추가 항목은 별도 견적으로 분리해 주세요. 외부 서비스 이용료는 개발비와 구분해 주세요.
5. AI 4주 검증 기간과 최종 검수·보고서 작성 기간을 포함한 단계별 일정을 제안에 포함해 주세요. 예약 데이터 검증을 통과한 범위부터 AI 시험을 병행하는 구성으로 부탁드립니다.
- 정부지원사업으로 세금계산서 발행이 가능한 사업자와 계약합니다.
- 기존 코드 유지보수, Channex 또는 숙박 채널 연동, 외부 API 장애 대응, LLM 답변 검증 경험이 있으면 함께 적어 주세요.
[기타 유의 사항]
- 업무 범위 변경으로 재등록되었습니다.
- 예전 프로젝트 : https://www.wishket.com/project/159105/