Skip to content

[WTH-20] 알림 유형별 수신 설정 및 비동기 2 - #141

Open
soo0711 wants to merge 3 commits into
feat/WTH-20-알림-유형별-수신-설정-및-비동기from
feat/WTH-20-session-day-reminder
Open

soo0711 wants to merge 3 commits into
feat/WTH-20-알림-유형별-수신-설정-및-비동기from
feat/WTH-20-session-day-reminder

Conversation

@soo0711

@soo0711 soo0711 commented Nov 15, 2026 •

Copy link
Copy Markdown
Collaborator

📌 Summary

어떤 작업인지 한 줄 요약해 주세요.

일정·세션 생성, 당일 세션 안내, 회비 납부 의무 발생 시 사용자 설정에 따라 알림을 발송합니다.

📝 Changes

변경사항을 what, why, how로 구분해 작성해 주세요.

What

• 일정·세션 생성 및 정오 당일 세션 요약 알림 추가
• 회비 납부 의무 발생 알림 추가
• 발송 전 대상 상태 재검증과 중복·만료 처리 적용

Why

• 사용자가 새로운 일정과 당일 세션, 회비 납부 의무를 확인할 수 있도록 안내합니다.
• 중복 이벤트나 발송 대기 중 상태 변경으로 불필요한 알림이 전달되는 것을 방지합니다.

How

• 생성 이벤트를 BEFORE_COMMIT에서 처리해 원본 데이터와 알림 작업을 함께 저장하고, 실제 발송은 커밋 이후 비동기로 처리합니다.
• 유형별 코드 템플릿과 동아리별 마스터·카테고리 수신 설정을 적용합니다.
• 일정·세션 생성은 해당 기수의 활성 회원에게 안내하며 작성자는 제외합니다. 반복 세션은 그룹당 한 번 안내합니다.
• 당일 세션은 한국 시간 정오에 사용자별로 요약하고, 발송 전 세션 상태와 조회 권한을 다시 확인합니다. 12시 30분 이후에는 발송하지 않습니다.
• 회비는 장부 등록 완료 시 납부 의무가 있는 활성 회원에게 안내하고, 발송 전 납부·제외 여부를 다시 확인합니다.
• 이벤트 키로 중복 생성을 차단하며, 회비 알림은 기존방식과 SQS 방식 모두 적용합니다

📸 Screenshots / Logs

필요시 스크린샷 or 로그를 첨부해주세요.

비즈니스 로직에서 알림 발송까지

설명 기준: PR #141, 41fb782. 공통 Outbox·SQS·재시도 구조는 PR #136에서 상속하고, 이번 PR은 비즈니스 발생 조건과 발송 전 재검증을 연결합니다.

전체 흐름

flowchart TB
  S["일정 또는 세션 등록"] --> L1["BEFORE_COMMIT 일정·세션 리스너"]
  L1 --> S1["해당 기수 활성 회원: 작성자 제외"]
  A["회비 장부 등록 완료"] --> A1["활성 장부 + 미납 의무 + 활성 회원"]
  A1 --> L2["BEFORE_COMMIT 회비 리스너"]
  S1 --> C["공통 알림 생성: 설정 + 코드 템플릿"]
  L2 --> C
  T["정오 스케줄러"] --> T1["동아리와 날짜 실행 선점"]
  T1 --> T2["당일 유효 세션을 사용자별 요약"]
  T2 --> C
  C --> D["앱 알림 + Delivery + Outbox 저장"]
  D -->|커밋 이후| Q["Relay → SQS → Spring 워커"]
  Q --> G["발송 전 공통 수신 설정 재확인"]
  G --> R["정오 안내: 원본 세션과 기수 및 만료 재확인"]
  G --> P["회비 안내: 의무 소유자와 미납 여부 재확인"]
  G --> O["그 외: 공통 대상 및 토큰 확인"]
  R --> F["FCM 전송 및 토큰별 결과 기록"]
  P --> F
  O --> F
Loading

알림이 발생하는 시점과 대상

발생 시점 수신 대상 중복 기준
일정 신규 저장 완료 해당 기수 활성 회원, 작성자 제외 EVENT_CREATED:{clubId}:{eventId}
단일 세션·출석행 저장 완료 해당 기수 활성 회원, 작성자 제외 SESSION_CREATED:{clubId}:{sessionId}
반복 세션 그룹·전체 회차 저장 완료 그룹당 한 번, 작성자 제외 SESSION_GROUP_CREATED:{clubId}:{groupId}
정오 당일 세션 집계 소속 기수 세션의 사용자별 합집합, 작성자 포함 SESSION_DAY_REMINDER:{clubId}:{userId}:{date}
회비 장부 활성화·후속 정산 완료 활성 장부의 미납 의무 대상 본인 DUES_OBLIGATION_CREATED:{accountId}:{targetId}

일정·세션·회비 리스너는 BEFORE_COMMIT에서 공통 알림 생성기를 호출합니다. 원본이 롤백되면 앱 알림·발송 작업도 함께 롤백됩니다. 두 채널의 코드 템플릿과 동아리별 마스터·카테고리 설정을 적용합니다. 일정 생성과 정오 안내는 같은 SCHEDULE 설정을 공유합니다.

정오 요약: 생성과 실제 전송을 구분

sequenceDiagram
  participant S as 정오 스케줄러
  participant G as 생성 UseCase
  participant DB as MySQL
  participant W as 발송 워커
  participant F as FCM
  S->>G: 한국 시간 12시부터 12시 30분 전까지 매분
  G->>DB: 동아리와 날짜 실행 claim
  DB-->>G: claim token 및 lease
  G->>DB: 당일 세션과 회원 기수 조회
  G->>DB: 사용자별 앱 알림 + Delivery + Outbox
  Note over G,DB: 원본 세션 ID 목록과 만료 시각 저장
  G->>DB: 실행 완료 COMMIT
  Note over DB,W: 공통 Relay와 SQS 경유
  W->>DB: 원본 ID 범위에서 세션과 조회 기수 재확인
  DB-->>W: 현재 유효한 세션으로 요약 재생성
  alt 발송 가능 시간과 세션
    W->>F: I/O 실행 직전 만료 재확인 후 전송
  else 만료 또는 유효 세션 없음
    W->>DB: SKIPPED 기록
  end
Loading
  • 활성화: notification.dispatch.enabled=true와 notification.day-reminder.enabled=true가 모두 필요합니다. 기본은 비활성입니다.
  • 생성 창: Asia/Seoul 기준 12:00 이상 12:30 미만에서 매분 실행합니다. 실행 행은 동아리·날짜·종류 단위이며 60초 lease로 중단 후 복구합니다.
  • 후보: 당일 시작·아직 종료 전·OPEN·정오까지 생성된 세션을 고릅니다. 여러 기수의 같은 사용자에게는 세션 ID를 중복 제거해 한 번 안내합니다.
  • 발송 스냅샷: sourceSessionIds와 당일 12:30 만료를 저장합니다. 발송 시 그 ID 범위에서 현재 기수·원본 상태를 다시 검사합니다. 새 세션은 소급 추가하지 않습니다.
  • 재시도·만료: 공통 토큰별 재시도를 사용하되 12:30 만료가 우선합니다. I/O 실행 직전에도 확인합니다. 이미 시작한 FCM 호출의 최종 도착 시각을 취소하는 기능은 아닙니다.
  • 알림함: 최초 내용을 유지하고, 정오 PUSH만 유효한 원본 세션의 최신 제목·시간으로 재렌더링합니다.

회비 안내: 납부 의무 유효성 재확인

장부 DRAFT 저장·대상 선택·계좌 입력에는 알리지 않습니다. 등록 완료 후 ACTIVE 장부의 TARGETED·UNPAID·양수 잔여액 및 활성 회원·사용자 조건을 만족해야 합니다. 생성 시 마스터·DUES·회비 기능 공개 설정을 적용합니다.

발송 전 targetId·accountId·clubId·의무 소유자·현재 미납 여부를 다시 확인합니다. 납부/제외되면 durable·legacy 모두 푸시를 차단하고 알림함 내역은 남깁니다. 회비의 이벤트 선점은 두 모드 모두 적용하며, 수신 거부 또는 비공개로 제외된 동일 이벤트는 공개 후 재전달해도 소급 생성하지 않습니다.

상속하는 전송과 실패 처리

dispatch 활성 시 Outbox → Relay → SQS → Spring 워커 → FCM → 토큰별 결과 기록으로 이어집니다. 일시 실패는 기본 최대 5회, 소진 작업은 DLQ 감사, 명시적 재처리는 generation으로 분리합니다. Lambda나 새 채널은 추가하지 않습니다. 기본 false 모드에서는 기존 AFTER_COMMIT 비동기 전송과 실패 로그를 사용합니다.

스키마와 범위

V27은 delivery의 source_session_ids·expires_at 및 notification_schedule_run 테이블을 추가합니다. 경고 부여 알림, 미납 독촉, 부하 측정, AWS 배포는 이번 PR의 구현 범위에 없습니다.

코드 읽기 순서

💡 Reviewer 참고사항

리뷰에 참고할 내용을 작성해주세요.

• 정오 안내는 notification.dispatch.enabled=true, notification.day-reminder.enabled=true일 때 활성화됩니다. 정오 안내의 기본값은 비활성입니다.

✅ Checklist

  • PR 제목 설정 완료 (WTH-123 인증 필터 설정)
  • 테스트 구현 완료
  • 리뷰어 등록 완료
  • 자체 코드 리뷰 완료

@soo0711
soo0711 requested review from hyxklee and woneeeee November 15, 2026 12:54
@soo0711 soo0711 self-assigned this Nov 15, 2026
@soo0711 soo0711 added the ✨ Feature 새로운 기능 추가 label Nov 15, 2026
@coderabbitai

coderabbitai Bot commented Nov 15, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 39b31567-84ca-4e6d-98df-de8995c12637

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@soo0711
soo0711 changed the base branch from dev to feat/WTH-20-알림-유형별-수신-설정-및-비동기 November 15, 2026 13:03

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

✨ Feature 새로운 기능 추가

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant