📂 문서 구조: 이 문서는 공통임. 프론트·백엔드가 함께 합의해야 하는 경계면만 다룸. 구현 상세는 하위 페이지에 있으며, 하위 문서는 여기 정의된 계약을 참조만 하고 재정의하지 않음.

문서 정보

1. 요약 — Summary

루틴 실패를 사용자가 지정한 지인에게 전달하는 장치임. 기술적으로는 두 가지를 구현함 — 동의를 성립시키는 초대 플로우와 확정된 실패를 ACTIVE 감시자에게 보내는 통지 플로우임.

설계 전체가 하나의 법적 제약에서 나옴 — 룰업은 동의하지 않은 외부인에게 먼저 닿을 수 없음. 그래서 초대 전달은 사용자 본인 명의의 카카오톡 공유로, 통지는 인앱 수락으로 동의가 성립한 뒤에만 나감.

2. 배경 — Background

• 사업적 배경은 기능 스펙 1-3 참조. 여기서는 기술 전제만 적음.
• 감시자는 방 멤버가 아님: 챌린지 내부 권한 모델과 무관한 별도 관계 엔티티가 필요함. 방 조회 권한을 주면 안 되며, 통지에 담기는 3개 필드 외에는 아무것도 보여주지 않음.
• 수락 증적은 업무 DB가 원본: watcher_relations.accepted_at과 consent_version으로 누가 어떤 동의 문안에 언제 수락했는지 보관함. 푸시 설정은 알림 설정 DB, 차단은 사용자 차단 DB가 각각 소유하며 CloudWatch 구조화 로그는 실행 감사에만 사용함.
• 통지 트리거가 시간 의존: 실패 확정이 아니라 이의 기간이 지난 뒤의 상태가 트리거임. 귀속일+2일 00:00 KST에 확정되므로 그 직후부터 발송 대상이 됨.
• 통지는 되돌릴 수 없음: 이의가 인용될 수 있는 실패로 망신을 주면 복구 불가. 조기 발송 0건이 절대 가드레일임.

3. 목표 — Goals

• PENDING 상태에 발송 0건을 보장함 — 무동의 발송은 위법임
• 이의 기간 종료 전 발송 0건을 보장함 — 발송 시각과 확정 시각을 대조해 감사함
• 연락처를 수집하지 않음 — 입력 경로 자체를 두지 않아 구조적으로 불가하게 함
• 수락 증적은 watcher_relations, 푸시 설정은 알림 설정 DB, 차단은 사용자 차단 DB에 소유권을 나눠 보관함
• 응원·놀림을 실패 건당 1회로 제한해 도배를 구조적으로 막음
• 페이지2에서 재동의·채널별 동의 이력이 업무 데이터가 되면 그때 별도 이벤트 테이블을 추가함 — Phase 1에 범용 이력 테이블을 미리 두지 않음