문서 규칙
운영 문서는 역할이 갈린다. 섞지 않는다.
어디에 쓰나
| 위치 | 상태 | 쓰는 내용 |
|---|---|---|
| Facts | 정본 (초안) | 주소, 층, 시간, Wi-Fi, 출입 조건, 하우스 룰, 유실물, 발송 언제 |
| 손님 메시지 | 파생 초안 | 손님에게 보내는 문장. SSOT가 아님. facts와 어긋나면 facts |
| 현장 핸드북 | 파생 | 청소·배정 절차. 원자 값은 facts 링크 |
| 손님 공개 홈 | 별도 | 이미 존재. 이 핸드북 아님 |
TUC /touchpoints | 런타임 | 발송 엔진. 오늘 코드 숫자, 보냈는지, 변수 치환 |
| Quartz | 미정 | 초안, 아이디어, 실험 |
| 구글 시트 「로밍타이거 재고」 | 수량 정본 | 재고 숫자·발주 |
Quartz를 현장 절차나 손님 안내처럼 인용하지 않는다. 공개 손님 홈을 이 저장소에서 만들지 않는다.
git과 PR
- 사실 값이 바뀌면 facts를 먼저 고친다. 메시지·현장 페이지는 따라간다.
- 핸드북 변경은 git PR이 기본이다.
- Cloudflare Pages는
main을 빌드한다. 설정은 README. - Access가 켜지기 전까지 반비공개.
로컬: npm run docs:dev. 배포와 같은 결과: npm run docs:build.
TUC는 런타임만
TUC는 카피 SSOT가 아니다. 문구가 facts / 파생 초안과 다르면 drift다. Tyro가 「반영」할 때 TUC를 맞춘다.
- 도어 코드 숫자는 TUC만. 핸드북에 적지 않는다. 플레이스홀더는
{doorCode}. - 발송 정책(언제)은 facts/send-policy.
check_in_guide·bed_info는 seed/retired GAP — 임의로 고르지 않는다.
자동 동기화 없음
- facts → TUC 자동 푸시 없음.
- hostel-text / Quartz / 핸드북 봇 동기화 없음.
- 「반영」은 사람이 한다.
이 저장소에 넣지 말 것
- 현재 도어 코드, 일회용 비밀번호
- 재고 수량, 결제 계좌
- facts에 없는 새 운영 사실
- 손님 PII, 예약 원장
애매하면 Quartz에 적거나 오너에게 묻고, facts로 올릴 때만 PR한다.