ADR-T-191_웹 채널 및 구독 동기화 규칙

ADR-T-191 웹 채널 및 구독 동기화 규칙

1. Metadata

• ADR ID: ADR-T-191
• Title: 웹 채널 및 구독 동기화 규칙
• Status: draft
• Date: 2026-03-09
• Owner: YSY
• Related ADRs: ADR-T-190, ADR-PA-026, ADR-T-160
• Supersedes:
• Superseded By:

2. Context

Deprecated Web/Tech ADR(ADR-W-001/003/005/011/013/014, ADR-T-005)의 운영 결정을 신규 ADR 체계로 통합할 필요가 있다.

3. Decision

1. 사용자 웹은 조회 중심 채널로 운영하고 상태 변경 액션은 제한한다.
2. 웹 배포는 정적/엣지 배포(CDN 기반)와 CI 자동 배포를 기본으로 한다.
3. 웹 위치권한 실패 시 지역 선택 fallback을 제공한다.
4. 구독 상태 동기화는 결제 웹훅 이벤트를 단일 기준으로 처리한다.
5. 웹 조회 API는 공개 읽기 모델을 사용하되 RLS/RPC 경계로 제한한다.
6. 공유 가능한 고정 URL(슬롯 단위)을 제공한다.

4. Consequences / Impact

1. 웹 채널 운영 범위와 보안 경계를 명확히 할 수 있다.
2. 결제사 웹훅 장애/지연 대응 런북이 필수다.

5. Validation

• 웹에서 제한된 읽기 모델만 호출된다.
• 위치권한 거부 시 지역 선택 fallback이 동작한다.
• 구독 상태 변경이 웹훅 이벤트 기준으로 동기화된다.
• 슬롯 공유 URL이 고정 경로로 접근 가능하다.

Buy me a coffee