숲테이 산책

강원 양양 어성전계곡 앞, 건물 네 동짜리 옛 숙소를 숲테이 산책이라는 스테이로 다시 여는 준비를 하고 있습니다. 그 과정에 필요한 도구 두 가지를 만들었습니다. 하나는 운영자가 휴대폰으로 쓰는 관리 앱이고, 다른 하나는 손님이 보는 공개 홈페이지입니다.

관리 앱 화면은 할 일 내용, 금액, 계약·서류 정보, 연락처를 흐리게 처리했습니다. 도면 화면의 가구 배치는 시연용 예시입니다.

문제

숙박업을 열려면 할 일이 많습니다. 권리관계 확인, 현장 실사, 영업신고, 사업자등록, 보험, 온라인 판매, 시설 준비까지 이어지고, 순서도 중요합니다. 할 일은 기관 통화와 현장 확인에서 계속 새로 생깁니다. 현장에서 휴대폰으로 바로 남기지 않으면 금방 잊어버립니다. 운영자 여러 명이 같은 목록을 보면서 각자 고쳐야 하는 것도 문제였습니다.

관리 앱

휴대폰 홈 화면에 설치해 앱처럼 쓰는 PWA입니다. 하단 탭은 홈, 할 일, 시설, 자료, SNS, 지시로 나뉩니다.

9단계 체크리스트: 권리관계 확인부터 정기 의무까지 81개 항목. 선행 항목이 끝난 일만 "다음 할 일"로 올라오고, 기한은 달력으로도 봅니다.
말로 추가: 현장에서 말로 남기면 Claude가 오인식을 고치고 메모나 할 일(단계, 기한, 준비물)로 정리합니다. 사람이 확인한 뒤 저장합니다.
글로 지시: "이 항목 완료로 바꿔" 같은 요청은 공유 데이터에 바로 반영됩니다. 화면이나 기능을 바꿔 달라는 요청은 서버의 Claude가 브랜치에서 코드를 고치고 PR을 만듭니다. 앱에서 '적용'을 누르면 머지와 빌드가 진행되고, '거절'을 누르면 PR이 닫힙니다.
시설: 방 21개의 집기·상태·사진과 수리·교체 요청을 관리합니다. 방마다 평면도를 그리면 입체도가 자동으로 만들어집니다. 주방 인테리어 조합 미리보기와 보험용 집기 목록도 여기에 있습니다.
SNS 봇: 인스타그램과 Threads의 새 댓글에 Claude가 답변 초안을 만들고, 사람이 확인한 뒤 보냅니다. 게시물 승인·예약 게시와 지표 확인도 됩니다.
기한 알림 웹 푸시, 변경 기록, JSON 백업·복원

홈	할 일	달력

말로 추가·지시	시설	주방 인테리어

평면도 편집	자동 입체도

기술적으로 신경 쓴 점

여러 폰 동기화: 폰마다 전체 상태를 서버로 보내면, 서버가 항목 단위로 병합해 돌려줍니다.
- 추가된 항목은 합칩니다.
- 같은 항목을 고쳤으면 더 나중에 고친 쪽이 이깁니다.
- 삭제는 tombstone으로 남깁니다.
- 서버에 닿지 않으면 폰에 저장해 두었다가 다시 보냅니다.
Claude에게 코드 수정을 맡길 때의 안전장치: 허용 도구와 편집 가능한 경로를 제한했습니다. PR에 설정·데이터 파일이 섞이면 PR을 닫고 실패로 처리합니다. 사람이 '적용'을 눌러야 운영에 반영됩니다.
로그인 감시: Claude 로그인이 만료되면 장기 토큰으로 자동 전환합니다. 그래도 안 되면 앱과 텔레그램으로 알립니다.
VPS에서 systemd로 운영합니다. Cloudflare Access 뒤에 두었고, 매일 데이터를 백업합니다.
테스트 파일 80여 개 (Vitest + Testing Library)

공개 홈페이지 · soopstay.com

오픈 전부터 검색과 AI 답변에 숙소가 잡히도록 만든 정적 사이트입니다. 관리 앱과 같은 디자인 토큰(흰 바탕, 짙은 초록 강조 하나, 명조 제목)을 쓰고, 라이트·다크 모드를 지원합니다.

객실 7개 상세 페이지, FAQ, 주변 관광지 그림지도, 옛 블로그 후기
브랜드 작업: 로고, 앱 아이콘 3종, 장면 일러스트 6개
SEO · AEO · GEO: 페이지마다 메타·OG를 넣었고, JSON-LD로 LodgingBusiness, HotelRoom, FAQPage를 넣었습니다. robots.txt에서 AI 크롤러를 허용하고, /llms.txt에 숙소 핵심 사실을 요약했습니다.
빌드 뒤 검사 스크립트가 title, description, canonical, h1, JSON-LD, alt, 내부 링크를 확인합니다. 하나라도 빠지면 배포하지 않습니다.
Cloudflare Workers 정적 자산으로 배포했습니다. 서버 코드는 없습니다.

홈페이지 첫 화면

객실 선택

주변 관광지 그림지도

모바일 홈	객실 상세

숫자

항목	값
관리 앱 커밋	169건 (2026-10-05 ~)
홈페이지 커밋	28건 (2026-10-08 ~ 10-09)
체크리스트	9단계 81개 항목
관리하는 방	21개
공개 객실	7개