유성지구 호텔 · 연박 정규화 시스템

Multi-Night Stay Normalization Engine v3.1-otafix

정규화 숙박 ADR

—

점유율

—

연박 비율

—

평균 투숙일수

—

정규화된 일별 투숙 현황

객실	예약ID	투숙구분	고객유형	박수	정규화 ADR	정규화 매출	원본 총액	입실시간	비고
날짜를 선택하고 조회하세요

고객 세그먼트 분포

투숙 구분 비율

PMS DB 기반

오늘 작업대

DB에 저장된 PMS 예약을 운영 기준일로 확인합니다. cancelled 예약은 기본 제외됩니다.

오늘 기준

DB 예약 로딩 전

상태	고객명	예약 객실타입	객실번호	채널	체크인일	박수	warning
DB 예약을 불러오면 오늘 작업대가 표시됩니다.

PMS 장부형 보기

엑셀처럼 간단하게 확인하고, 주요 칸을 클릭해 바로 수정합니다. cancelled 예약은 기본 제외됩니다.

DB 예약 로딩 전

채널

객실타입

검색

대실

0건 · 0원

상태	객실	고객명	시간/날짜	금액	결제	메모
DB 예약을 불러오면 대실 장부가 표시됩니다.

숙박

0건 · 0원

상태	객실	고객명	객실타입	체크인	박수	체크아웃	금액	결제	메모
DB 예약을 불러오면 숙박 장부가 표시됩니다.

PMS 객실 현황판

rooms 테이블의 현재 객실 상태를 기준으로 보고, 예약/입실예정/퇴실예정만 운영 기준일로 보조 표시합니다.

운영 기준일

PMS 객실 상태는 현재 상태 화면입니다. 과거 객실 상태 이력은 이 화면에서 재현하지 않습니다.

입실 예정 예약 카드

카드를 청소완료 공실 객실로 드래그하면 배정 후 체크인을 한 번에 처리합니다.

드래그 체크인 대기

아직 갱신 전

객실 현황을 불러오는 중...

PMS 수동 예약 등록

프론트 운영용 간편 예약 등록입니다. 저장 후 오늘 작업대, 장부형 보기, 객실 보드가 자동 갱신됩니다.

고객명

객실번호 (선택)

체크인일

박수

체크아웃일

객실타입

금액

예약채널

결제수단

메모

프론트 직원이 바로 입력하는 PMS 예약입니다. 등록 즉시 저장 예약 화면과 객실 보드에 반영됩니다.

배정 후 체크인 확인

예약 카드를 객실에 배정하고 체크인 상태로 변경합니다. 저장 후 오늘 작업대, 장부형 보기, 객실 보드가 자동 갱신됩니다.

사유

PMS 바로 체크인

프론트 운영용 바로 체크인입니다. PMS 예약 row를 자동 생성하고 장부형 보기와 객실 보드를 즉시 갱신합니다.

고객명

금액

객실번호

객실타입

체크인일

박수

체크아웃일

결제수단

메모

바로 체크인을 누르면 예약 생성, 객실 배정, 체크인이 한 번에 처리되고 오늘 작업대 / 장부형 보기 / 객실 보드가 자동 반영됩니다.

예약 등록

객실

체크인일

체크아웃일

숙박수

금액 (원)

예약 출처

고객 구분

메모

등록 즉시 체크인 처리

객실 이동

현재 객실

이동할 객실

이동 사유

이동 후: 현재 객실 청소 대기 자동 등록 / 새 객실 즉시 입실 처리

객실 블록 등록

대상 객실

블록 종류

시작일

종료일

사유

메모

OOO: 판매 불가 + 정비중 / OOS: 판매 중지 + 점검중 / 등록 즉시 객실 상태 반영

장부/RMS 업로드

장부/RMS 저장 전용

매출 장부 분석, RMS 정규화, 공식 합계 저장 후보를 확인합니다. PMS 예약 후보 생성/저장은 아래 별도 섹션에서 진행하세요.

⚠️ 연박 비율 0% 감지 — 엑셀 컬럼 구조를 확인하세요!

D열(4번째)에 "4박", "3박" 같은 박수 텍스트가 있어야 합니다. 컬럼이 다르면 위의 초기화 버튼으로 데이터를 지우고 올바른 파일을 다시 업로드하세요.

장부/RMS 엑셀을 드래그하거나 클릭해서 업로드

지원 형식: .xlsx, .xls · 매출/RMS 분석 및 정규화 전용

엑셀 숙박 시트 지원 형식 (헤더 자동 감지)

형식A (기존 고정) A=NO B=객실번호 C=성명 D=박수("4박") E=법인 F=비고 G=현금 H=계좌 I=카드

형식B (헤더 자동감지) 헤더행에 객실·박수·현금/카드/계좌 키워드가 있으면 자동 매핑

• 체크인일 = 파일명(YYYYMMDD) 또는 시트명에서 자동 추출, 없으면 입력값 사용

• 금액 범위: 5,000 ~ 2,000,000원 (객실번호·날짜 숫자 자동 차단)

• 박수 형식: "4박", "3박" 또는 숫자 "4" 모두 지원 (최대 30박)

파싱 결과 미리보기

reservation_id	checkin	checkout	nights	room	total_revenue	normalized_adr	segment	source	notes	raw_nights_value	explicit_nights	inferred_nights	nights_status	nights_review_reason	inferred_match_basis	inferred_candidate_count	inferred_candidate_dates	inferred_trace_summary	conflict_candidate_flag

PMS 예약 업로드

예약 후보 생성/저장 전용

엑셀에서 PMS 예약 후보를 만들고, critical 후보와 오늘 이전 체크인 예약을 제외한 뒤 PMS 장부에 저장합니다. 장부/RMS DB 저장과 분리됩니다.

PMS 예약 업로드 가이드

지원되는 예약 정보 예시

고객명	객실번호	객실타입	체크인	박수	금액	채널
홍길동	303	스탠	2025-07-01	1박	80,000	야놀자
김예약	미배정	비즈니스	2025-07-02	2박	180,000	직접

제외되는 row 예시

• 3.매출현황, 요약, 합계 성격의 시트/행
• 고객명과 객실번호/객실타입이 모두 없는 행
• 박수가 0이거나 체크인 후보로 볼 수 없는 행
• 일별/월별 총액처럼 PMS 단일 예약으로 보기 어려운 큰 금액 행
• 오늘 이전 체크인 예약은 PMS 후보에서 자동 제외

warning 의미

• 기간 겹침: 같은 객실 active 예약과 투숙 기간이 겹침
• 미배정: 객실번호 없이 저장 가능하지만 객실 배정 필요
• 객실타입 확인: 원본 타입을 표준 타입으로 확정하기 어려움
• 금액/채널 확인: 예약 금액 또는 유입 채널이 모호함

기간 겹침 정책

checkout 당일 새 checkin은 허용합니다. reserved/assigned/checked_in 예약끼리만 겹침을 확인하고, checked_out/cancelled 예약은 제외합니다.

운영 순서

업로드 → 후보 확인 → warning 확인 → 저장 → 객실 배정 → 체크인 → 체크아웃 → 청소 완료

당일/미래 예약만 저장

오늘 이전 체크인 예약은 PMS 후보에서 자동 제외됩니다. 당일 및 미래 예약만 preview와 저장 대상에 포함됩니다.

업로드 체크리스트

PMS 예약용 장부인지 확인 요약/합계 시트가 후보로 뜨지 않는지 확인 오늘 이전 체크인 예약 제외 여부 확인 객실번호 또는 객실타입 포함 여부 확인 체크인 날짜와 박수 확인 기간 겹침/중복 예약 warning 확인 critical 제외 후 저장 예정 수 확인

PMS 예약용 엑셀을 드래그하거나 클릭해서 업로드

지원 형식: .xlsx, .xls · PMS 예약 후보 생성 및 저장 전용

PMS 예약 후보 저장 기준

• 정상/warning/미배정 후보는 저장 대상입니다.

• critical 후보와 요약/합계행은 저장 대상에서 제외합니다.

• 오늘 이전 체크인 예약은 PMS 후보에서 자동 제외합니다.

• 기간 겹침, 미배정, 객실타입 확인 항목은 preview에서 먼저 확인합니다.

• 실제 저장은 “PMS 예약 저장” 버튼과 확인 절차 후에만 실행됩니다.

PMS 예약 후보

저장 대상: 정상/미배정/warning 포함, critical 제외

처리그룹/상태	체크인일	고객명	예약 객실타입	객실번호	박수	checkout confidence	채널	결제	금액	warning/critical	memo/source

정규화 전후 비교 분석

원본 기록 (체크인일 기준)

예약ID	객실	박수	체크인	체크아웃	총금액	1박환산 ADR	출처

정규화 결과 (일별 분산)

날짜	예약ID	객실	투숙구분	일별 ADR	일별 매출	요일

예약 수동 입력

예약 ID

객실 번호

체크인 날짜

박수

체크아웃 (자동)

총 금액 (원)

고객 유형

예약 출처

입실 시간

비고

정규화 미리보기: 박수와 금액을 입력하면 자동 계산됩니다.

시작일

종료일

날짜	요일	숙박판매	대실	체크인	연속투숙	정규화 ADR	점유율	연박비율	평균 LOS	총매출

결제수단별 매출

OTA/채널별 매출

결제수단	매출	비율	건수

OTA/채널	매출	비율	숙박	대실

월별 성과 비교 분석 (엑셀 실데이터 기반)

로딩 중...

지표	월	추세
로딩 중...

📈 월별 매출 구성

📊 요일별 숙박 ADR 비교

📅 요일별 평균 숙박 ADR 비교

요일	월별 ADR/OCC	ADR 변화
로딩 중...

AI 객단가 추천

가중치 v1 적용 중

분석 날짜

기준 ADR (원)

현재 예약률 (%)

월 선택 월 버튼은 읽기 전용 추천을 바로 표시합니다

AI 분석 근거

날짜와 조건을 입력 후 분석을 실행하세요

GPT-4o mini 분석 AI

OpenAI 연동 준비됨: 환경변수 OPENAI_API_KEY를 설정하면 GPT-4o mini 기반 심화 분석이 활성화됩니다.

이 가격으로 실제 운영했나요? 결과를 저장하면 AI가 학습합니다

실제 ADR (원)

실제 점유율 (%)

AI 예측 백테스팅

규칙 기반 엔진 v1.0

과거 데이터로 예측 정확도를 검증합니다. 나중에 AI 모델과 성능을 비교할 수 있는 기준선(Baseline)이 됩니다.

예측 공식 (규칙 기반)

예측 ADR = 요일평균ADR × 온천계절계수 × (1 + 연박비율 × 0.1)

요일평균ADR
3개월 DB 실측값 기반

온천계절계수
3-4월:×1.08 / 5-6월:×1.02
7-8월:×0.88 / 11-1월:×1.05

연박 보정
연박비율↑ → ADR 안정성↑

분석 월 선택

분석 중...

예측 등급 분포

S: ≤5% / A: ≤10% / B: ≤20% / C: >20% 오차

일별 ADR 비교

최대 오차 발생일 TOP 3

요일별 예측 정확도

요일	샘플	실제 ADR	예측 ADR	평균 오차	정확도

일별 상세 결과

S ≤5% A ≤10% B ≤20% C >20% 🎌 공휴일

날짜	요일	점유율	실제 ADR	예측 ADR	오차(원)	오차율	등급

AI 모델 비교 준비 완료

이 백테스트 결과가 AI 모델(GPT/커스텀)의 성능 비교 기준선(Baseline)이 됩니다.
OPENAI_API_KEY 설정 후 AI 추천 탭에서 GPT 예측값을 가져오면 정확도를 직접 비교할 수 있습니다.

규칙 기반 RMSE: —원 AI 모델 RMSE: 연동 대기

로딩 중...

현재 가중치 현황

가중치 항목	현재 버전	이전 버전	변화
로딩 중...

요일별 예측 성능

요일	평균 오차율	학습 일수	상태
백테스팅 실행 후 표시됩니다

백테스팅 실행 가중치 적용 검증

예측ADR = 요일평균ADR × 계절계수 × 요일가중치(w_xxx) × (1 + 연박보정)

분석 월

날짜	요일	실제ADR	예측ADR	오차율	평가	조정 필요

가중치 자동 조정

백테스팅 오차 패턴을 분석해 가중치를 자동으로 미세조정합니다. 한 번에 최대 ±10%, 누적 최대 ±50% 범위 내에서 안전하게 조정됩니다.

📋 조정 내역 미리보기

월별 예측 정확도 개요 가중치 소스 포함

백테스트 실행 후 자동 갱신됩니다

가중치 버전 히스토리

로딩 중...

관리자/검증

운영 데이터 보호를 위해 이 화면에는 삭제/초기화 버튼을 두지 않습니다. 검증과 rebuild는 필요 시 관리자 토큰과 별도 승인 절차로만 실행하세요.

검증 API

/api/admin/validate?month=YYYY-MM
RMS 업로드 후 매출 합계, ADR, 점유율, 연박률을 확인하는 읽기 중심 검증입니다.

rebuild 주의

/api/admin/rebuild-dss, /api/admin/rebuild-daily는 RMS 집계 테이블을 다시 씁니다. 운영 중에는 반드시 백업과 명시 승인을 먼저 확보하세요.

데이터 품질 검증

공식 총액과 객실 상세 신뢰도를 함께 확인하는 읽기 전용 점검 대시보드입니다.

시작일

종료일

로딩 전

관리자/검증 탭을 열면 자동으로 점검합니다.

날짜	심각도	사유	총매출	LOS	연박비율	room_detail_reliable	영향 지표	권장 조치
점검 결과가 없습니다.