Claude Code로 호텔 예약 CSV 클라우드 전달 사전 점검 만들기
호텔 예약 CSV를 클라우드에 넘기기 전 개인정보, 동의, 객체 키, 승인 항목을 점검합니다.
주말 체크인을 앞두고 프런트가 예약 시스템에서 CSV를 내려받아 마케팅 대행사에 전달하려 한다. 업로드 직전, 공유할 클라우드 객체 키에 투숙객 이메일이 남아 있는 것을 발견한다. 다른 행의 취소 메모에는 건강과 가족 사정이 적혀 있고, 메일 발송용 폼에는 목적별 동의 항목이 없다. 문제는 업로드 기술이 아니라, 어떤 행을 넘겨도 되는지, 어떤 값을 지워야 하는지, 누가 승인했는지가 불분명하다는 점이다.
호텔과 관광 시설의 예약 데이터에는 이름, 이메일, 전화번호, 동반자, 숙박일, 객실 플랜, 금액, 식사 요청, 접근성 요청, 자유 메모가 섞인다. 클라우드 전달은 내부 또는 외부 담당자가 네트워크로 받을 수 있는 위치에 파일을 두는 일이다. 편리하지만 CSV 본문, 객체 키, 서명 URL, 전송 메일은 각각 다른 유출 지점이 된다.
이 글은 Claude Code로 호텔 예약 CSV를 클라우드에 올리기 전의 사전 계약 검사를 만드는 방법을 다룬다. 여기서 계약은 법률 계약이 아니라 필수 열, 허용 값, 객체 키 이름, 동의 필드, 삭제일, 사람의 확인 항목을 반복 가능하게 맞추는 기술적 약속이다. 제목은 라이브 연동이 아니라 사전 점검을 약속한다. 아래 코드는 로컬 고정 픽스처만 사용하며 AWS S3, Google Cloud Storage, Cloudflare R2 같은 실제 저장소를 호출하지 않는다.
핵심 요약
- 숙박 및 관광 팀이 예약 CSV를 클라우드에 두기 전 전달 가능한 형태로 정리하는 흐름이다.
- Claude Code는 열, 날짜, 동의, 객체 키, 익명화된 매니페스트 생성을 점검한다.
- 사람은 사용 목적, 공급사 범위, 보관 기한, 계약 조항, 민감 메모 공유 여부를 판단한다.
- 실제 검증 범위는 로컬 JavaScript 문법과 고정 픽스처 실행뿐이며 인증, 네트워크, 업로드, 권한, 삭제는 테스트하지 않았다.
- 단일 주요 CTA는 내부 규칙화를 위한 교육 및 상담이다.
업무 흐름: 예약 CSV를 클라우드 전달 매니페스트로 바꾸기
먼저 모을 산출물은 구체적이어야 한다. 예약 시스템에서 내보낸 CSV, 공급사에 전달하는 목적, 클라우드 객체 키 명명 규칙, 삭제 예정일, 담당자 확인 체크리스트다. 원본 CSV를 바로 이메일에 첨부하거나 공유 버킷에 넣지 말고, 로컬에서 열과 값을 검사한 뒤 투숙객 이름이 빠진 매니페스트를 만든다.
이 흐름은 AI 코딩 에이전트와 클라우드 저장소 사이에 있으므로 공식 문서를 확인해야 한다. Claude Code 쪽은 Anthropic의 권한 설정 문서를 읽고 파일 접근과 명령 실행을 사람이 통제한다. 저장소 설계는 AWS S3 보안 모범 사례와 Google Cloud Storage 서명 URL 문서를 참고해 짧은 만료 시간, 최소 권한, 접근 검토를 체크리스트로 만든다.
flowchart TD
A[예약 CSV를 로컬에 둔다] --> B[Claude Code로 열과 값을 검사]
B --> C[객체 키와 동의 필드를 검사]
C --> D[익명화 매니페스트 생성]
D --> E[사람이 목적과 공급사 범위 승인]
E --> F[승인 후 업로드]
관련 흐름은 여행사 업무 글과 관광 클라우드 이미지 메타데이터 글에서 다뤘다. 이 글은 그 사이의 단계, 즉 예약 CSV를 외부 공유로 넘기기 전 사고를 막는 데 집중한다.
Claude Code에 맡길 범위와 사람이 판단할 범위
Claude Code에 맡기기 좋은 것은 반복 가능한 입력 계약 검사다. 빠진 열, 체크아웃이 체크인보다 빠른 행, 숫자가 아닌 금액, yes가 아닌 동의, 이메일처럼 보이는 객체 키, 검토가 필요한 행을 기계적으로 찾을 수 있다. 또한 예약 ID, 객체 키, 체크인과 체크아웃, 삭제일, 검토 필요 여부를 담은 매니페스트를 만들 수 있다.
사람이 판단할 것은 전달의 타당성이다. 고객에게 어떤 설명을 했는지, 공급사 계약이 보관과 재위탁을 다루는지, 자유 메모가 꼭 필요한지, 건강, 종교, 가족 상황, 접근성 요청 같은 민감 정보가 섞였는지, 공급사가 행 단위 데이터를 받아야 하는지 확인해야 한다. Claude Code의 출력은 검토 자료일 뿐 법적 결론이나 개인정보 승인 결과가 아니다.
권한 측면에서는 사전 점검 단계에서 Claude Code에 업로드 자격 증명을 주지 않는다. 읽기 전용 로컬 폴더와 가상 또는 익명화 샘플로 시작한다. 업로드 명령, 클라우드 인증, 서명 URL 생성, 권한 변경은 별도의 사람 승인 단계로 분리한다. 거부 규칙과 좁은 작업 디렉터리를 사용하면 의도하지 않은 파일 읽기와 외부 명령 실행을 줄일 수 있다.
세 가지 사용 사례
사용 사례 1: OTA 예약 CSV의 빠진 열 찾기
입력: 예약 ID, 투숙객 이름, 이메일, 체크인, 체크아웃, 금액, 동의, 객체 키를 포함한 CSV다. OTA는 온라인 여행사를 뜻하며, 여러 판매 채널을 받는 시설에서는 열 이름과 날짜 형식이 흔히 흔들린다.
출력: 빠진 열, 빈 값, 잘못된 날짜, 숙박일 역전, 숫자가 아닌 금액의 표다. 담당자는 CSV를 다시 내보낼지, 로컬 샘플을 고칠지, 특정 행을 전달에서 제외할지 선택한다.
사람 확인: 각 예약 채널의 사용 목적이 같은지 확인한다. 숙박 안내 동의는 홍보 메일, 분석, 공급사 처리 동의와 같지 않다.
사용 사례 2: 객체 키에서 개인정보 제거하기
입력: hotel-a/2026-08/[email protected] 같은 객체 키 후보와 투숙객 이름, 이메일, 전화번호다. 객체 키는 클라우드 저장소의 파일 식별자이며 경로와 비슷하다.
출력: 이메일, 전화번호처럼 보이는 문자열, 이름 조각을 포함한 키를 오류로 표시한다. 더 안전한 키는 hotel-a/2026-08/booking-BK001.csv처럼 예약 ID만 사용한다.
사람 확인: 예약 ID 자체가 공급사에 전달해도 되는 식별자인지 본다. 예약 ID로 PMS나 숙박 대장을 조회할 수 있다면 별도 전달 ID가 필요할 수 있다.
사용 사례 3: 공급사 전달 매니페스트 만들기
입력: 점검된 CSV, 사용 목적, 삭제 예정일, 공급사명, 담당자 승인 체크다.
출력: 익명화된 전달 매니페스트, 삭제 기한, 검토 상태, 미해결 오류 수다. CSV 본문이 아니라 업로드 가능 여부를 판단하는 대장이다.
사람 확인: 보내기 전에 공급사 계약, 목적, 보관 기간, 문의 창구, 에스컬레이션 경로를 확인한다. 공급사가 모든 행을 필요로 하는지, 집계 보고서면 충분한지도 본다.
복사해 쓸 수 있는 프롬프트
숙박 시설의 예약 CSV를 클라우드에 전달하기 전 사전 점검 담당자로 작업하세요.
목표:
예약 CSV, 객체 키, 동의 필드, 삭제일을 확인하고 업로드 전 사람이 승인할 수 있는 매니페스트를 만든다.
입력:
- CSV 열 이름:
- 예약 CSV 샘플:
- 사용 목적:
- 공급사:
- 삭제일:
- 객체 키 명명 규칙:
- 사람 승인 기준:
출력:
1. 빠진 열과 잘못된 값
2. 객체 키에 개인정보처럼 보이는 값이 있는지
3. 동의가 부족한 행
4. 익명화된 전달 매니페스트
5. 사람이 판단해야 할 보류 사항
6. 업로드 전 체크리스트
제약:
- 실제 클라우드 서비스에 연결하지 않는다
- 예시에 개인정보를 남기지 않는다
- 법적 결론을 단정하지 않는다
- 생성물에 ClaudeCodeLab, /training/, 사이트 소유 CTA를 넣지 않는다
실행 가능한 확인 코드
저장한다면 독자의 저장소에서tools/hotel-booking-handoff-preflight.mjs 같은 경로를 사용한다. 이 저장소에 그 도우미 파일이 이미 있다는 뜻은 아니다. 코드는 고정 픽스처만 읽으며 클라우드 SDK, CLI, API, 자격 증명, 네트워크 요청을 사용하지 않는다.
const requiredColumns = [
"booking_id",
"guest_name",
"email",
"checkin",
"checkout",
"amount_jpy",
"consent",
"object_key"
];
const bookingCsv = `booking_id,guest_name,email,checkin,checkout,amount_jpy,consent,object_key
BK001,Aoi Sato,[email protected],2026-09-01,2026-09-03,42000,yes,hotel-a/2026-09/booking-BK001.csv
BK002,Ren Mori,[email protected],2026-09-05,2026-09-04,31000,yes,hotel-a/2026-09/booking-BK002.csv
BK003,Mika Ito,[email protected],2026-09-08,2026-09-10,not-a-number,no,hotel-a/2026-09/[email protected]`;
function parseCsv(text) {
const [headerLine, ...rows] = text.trim().split("\n");
const headers = headerLine.split(",");
return rows.map((line) => {
const values = line.split(",");
return Object.fromEntries(headers.map((header, index) => [header, values[index] ?? ""]));
});
}
function isIsoDate(value) {
return /^\d{4}-\d{2}-\d{2}$/.test(value) && !Number.isNaN(Date.parse(value));
}
function validateRows(rows) {
const errors = [];
const manifest = [];
for (const [index, row] of rows.entries()) {
for (const column of requiredColumns) {
if (!(column in row) || row[column].trim() === "") {
errors.push(`row ${index + 1}: missing ${column}`);
}
}
if (isIsoDate(row.checkin) && isIsoDate(row.checkout) && row.checkin >= row.checkout) {
errors.push(`row ${index + 1}: checkout must be after checkin`);
}
if (!Number.isFinite(Number(row.amount_jpy))) {
errors.push(`row ${index + 1}: amount_jpy must be numeric`);
}
if (row.consent !== "yes") {
errors.push(`row ${index + 1}: consent must be yes before handoff`);
}
const hasPersonalKeyPattern = /@|(?:^|[^\d])(?:\+?\d{2,}[- ]\d{2,}[- ]\d{3,})(?:[^\d]|$)/.test(row.object_key);
if (hasPersonalKeyPattern || row.object_key.includes(row.guest_name.split(" ")[0].toLowerCase())) {
errors.push(`row ${index + 1}: object_key may contain personal data`);
}
manifest.push({
booking_id: row.booking_id,
object_key: row.object_key,
checkin: row.checkin,
checkout: row.checkout,
delete_after: "2026-10-31",
reviewer_required: true
});
}
return { errors, manifest };
}
const rows = parseCsv(bookingCsv);
const result = validateRows(rows);
console.log(JSON.stringify(result, null, 2));
이 코드는 로컬 고정 픽스처의 열, 날짜, 금액, 동의, 객체 키 패턴을 점검할 수 있음을 증명할 뿐이다. 클라우드 권한, 서명 URL 발급, 업로드 성공, 공급사 수령, 보관 기한 실행, 삭제는 증명하지 않는다. 이 경계를 섞으면 팀은 “로컬에서 확인됨”과 “안전하게 공유됨”을 혼동한다.
Pitfall: 원인과 구체적인 수정
원인 1은 판매 채널마다 CSV 열 이름이 다른 것이다. 한 곳은guest_name, 다른 곳은name을 쓰고, 한 곳은arrival, 다른 곳은checkin을 쓴다. 매핑표 없이 Claude Code가 같은 의미라고 가정하면 위험하다. 수정은 한 장짜리 열 매핑표를 만들고 변환 전후를 검토하는 것이다.
원인 2는 객체 키를 사람이 읽기 좋게 만들려는 습관이다. 이름, 이메일, 전화, 객실 메모, 취소 이유가 경로에 들어가면 파일을 열지 않아도 개인정보가 보인다. 수정은 예약 ID와 월 폴더, 중립 파일명만 쓰고 매니페스트에도 이름을 남기지 않는 것이다.
원인 3은 동의를 하나의 체크박스로 합치는 것이다. 숙박 안내, 홍보 메일, 공급사 처리, 설문 재발송, 다중 시설 분석은 목적이 다르다. 수정은 목적별 동의 열을 나누고 맞지 않는 행은 멈추는 것이다.
원인 4는 업로드 성공을 안전 확인으로 오해하는 것이다. 업로드 성공은 저장소가 객체를 받았다는 뜻이지, 비공개인지, 링크가 빨리 만료되는지, 삭제가 실행되는지 증명하지 않는다. 수정은 로컬 사전 점검, 업로드 후 권한 검토, 보관 기한 검토를 분리하는 것이다.
작은 ROI 측정 방법
절감 효과를 만들지 않는다. 1주일 동안 CSV 재내보내기 횟수, 공급사 반려 메일 수, 업로드 전 수정 행 수, 담당자 확인에 걸린 분, 동의 부족으로 멈춘 행 수만 기록한다. 이것만으로도 재작업이 줄었는지 볼 수 있다.
ROI는 즉시 매출 증가가 아니라 재작업과 위험 감소로 본다. 전달 1회당 확인 분, 반려 파일 1개당 수정 분, 승인 시점의 미해결 행 수, 공급사가 보기 전에 잡은 문제 수를 나란히 둔다. 시설마다 규모가 다르므로 이 글은 벤치마크나 성과 수치를 주장하지 않는다.
자주 묻는 질문
Q. 실제 예약 CSV를 Claude Code에 그대로 붙여도 되나요.
A. 먼저 최소 익명화 샘플로 시작한다. 운영 데이터가 필요하다면 내부 규칙, 계약, 권한 경계, 로그, 보관 기한을 먼저 정한다.
Q. 서명 URL이면 기본적으로 안전한가요.
A. 서명 URL은 시간과 작업을 제한할 수 있지만 수신자, 만료, 권한, 전달 방식이 여전히 중요하다. 공식 저장소 문서를 읽고 짧은 만료와 최소 권한으로 설계한다.
Q. 어떤 클라우드 저장소를 선택해야 하나요.
A. 이 글은 제품 비교가 아니다. 조직 표준 플랫폼, 감사 로그, 권한 모델, 삭제 운영, 공급사의 파일 수신 방식에 맞춰 고른다.
Q. 언제 상담해야 하나요.
A. 예약 CSV를 외주, 캠페인, 분석, 다중 시설 공유에 쓰기 전이다. 직원들이 매주 같은 검사를 두고 고민한다면 교육 및 상담으로 흐름을 내부 규칙으로 만들 수 있다.
실제로 테스트한 결과
2026-08-21에 문서의 JavaScript 코드를node --input-type=module -e로 실행 가능한 형태로 유지하고, 고정 픽스처가 오류 목록과 매니페스트 JSON을 출력하는 것을 확인했다. 이는 문법과 로컬 실행 확인이며 클라우드 인증, 서명 URL 생성, 업로드, 권한 변경, 공급사 수령, 삭제는 테스트하지 않았다.
또한heroImage로/images/hero/hero-040.webp를 선택했고 이는site/public/images/hero/hero-040.webp에 대응한다. slug, frontmatter 날짜, 내부 링크, CTA, 공식 URL도 본문에서 확인했다. 다음 작업은 실제 CSV가 아니라 3행 익명화 샘플을 만들고 필수 열과 객체 키 규칙을 호텔의 명명 정책에 맞게 바꾸는 것이다.
관련 글
호텔 취소 답변을 Claude Code로 정리하기: 예약번호와 개인정보를 넘기지 않는 확인표
호텔 취소 및 일정 변경 답변에서 예약번호, 이름, 환불 판단을 AI에 넘기지 않는 점검 절차.
비즈니스호텔 프런트 업무를 Claude Code로 단축: 예약 확인·FAQ·리뷰 답글을 자동화하기
비즈니스호텔 지배인·프런트를 위한 가이드. Claude Code와 생성형 AI로 예약 확인, FAQ 응대, 리뷰 답글 초안을 단축하는 절차, 프롬프트 템플릿, 검증 스크립트, 개인정보 주의점까지 정리했습니다.
관광·체험 사업 다국어 플랜 소개문을 Claude Code로 대량 생산하는 실무 절차
도자기 체험·가이드 투어 소개문을 5개 언어로. 관광·체험 사업자가 Claude Code로 다국어 플랜 소개문을 만드는 실무 가이드. 프롬프트 템플릿과 검증 스크립트 포함.
무료 PDF: Claude Code 치트시트
이메일을 입력하면 명령, 리뷰 습관, 안전한 워크플로를 정리한 PDF를 받을 수 있습니다.
개인정보를 안전하게 관리하며 스팸을 보내지 않습니다.
작성자 소개
Masa
Claude Code 실무 워크플로와 팀 도입을 검증하는 엔지니어입니다.