ADR-T-180_관심구독 저장 및 알림 연동 규칙

ADR-T-180 관심구독 저장 및 알림 연동 규칙

1. Metadata

• ADR ID: ADR-T-180
• Title: 관심구독 저장 및 알림 연동 규칙
• Status: draft
• Date: 2026-03-08
• Owner: YSY
• Related ADRs: ADR-DS-180, ADR-T-070, ADR-T-140
• Supersedes:
• Superseded By:

2. Decision

1. 관심상점/관심업종 저장 API는 멱등 업서트(upsert)로 구현한다.
2. 중복 삽입 방지는 (user_id, store_id), (user_id, category_id) 유니크 인덱스로 보장한다.
3. 구독 변경 이벤트는 감사로그와 알림 파이프라인 입력 이벤트로 분리 기록한다.
4. 알림 발송 후보 생성은 비동기 배치/큐로 처리하고 사용자별 빈도 제한 키를 적용한다.

3. Consequences / Impact

1. 중복 요청/재시도 상황에서 데이터 정합성이 높아진다.
2. 큐 지연 및 재처리 시 중복 발송 방지 장치가 필요해진다.

4. Validation

• 동일 요청 재시도 시 추가 레코드가 생성되지 않는다.
• 구독 변경 이벤트가 감사로그와 알림 이벤트에 모두 기록된다.
• 사용자별 빈도 제한 키가 발송 경로에서 적용된다.

Buy me a coffee