개요 통합

ADR-000 개요 통합

1. Metadata

• ADR ID: ADR-000
• Status: draft
• Date: 2026-03-09
• Owner: YSY

2. Domain Decision

도메인 핵심 축을 아래 3개로 고정한다.

1. Slot 상태: issued -> closed
2. Reservation 상태: hold -> reserved -> redeemed | expired | cancelled
3. Verification/Payment는 상태가 아니라 전이 조건으로 분리한다.

추가 원칙:

1. arrived, checkin 용어는 사용하지 않는다.
2. 검증은 verification_method (none, location, qr)로 통일한다.
3. 결제는 payment_method (on_site, prepaid)로 통일한다.
4. 업종(category) 공통 코드 체계는 ADR-005를 기준으로 적용한다.

3. Product Decision

현재 제품 정책 축:

1. 지연 인증: 읽기/탐색은 비로그인 허용, 상태 변경 시 인증
2. 파트너 상태/구독 연동: partner_registered, partner_active, partner_suspended
3. 구독 활성(partner_active)에서만 슬롯 발행 허용

4. UX Decision

기본 UX 원칙:

1. 앱 최초 진입은 탐색 화면 우선
2. 비로그인 사용자도 슬롯 상세 진입 허용
3. 예약 클릭 시점에 로그인 바텀시트로 지연 인증
4. 로그인 완료 후 원래 액션 컨텍스트로 복귀

5. Tech Decision

기술 원칙:

1. DB는 App/db SQL 순서 실행을 기준으로 운영
2. 권한은 RLS + RPC 최소권한 원칙 적용
3. 상태 전이는 서버 함수/제약으로 강제
4. 앱은 서버 SoT를 표시하고 로컬 상태는 캐시로 제한

6. Ops Decision

운영 원칙:

1. 모든 배포 절차는 RUNBOOK에 실행형으로 기록
2. 데이터 정정은 Backfill 문서 + 검증 SQL을 함께 기록
3. cron/배치 변경은 롤백 절차를 같이 작성

7. Validation

• Domain/Product/UX/Tech/Ops 결정이 충돌하지 않는다.
• 구현 기준은 SPEC과 정합성을 유지한다.
• 운영 절차는 RUNBOOK으로 연결된다.

Buy me a coffee