Repository navigation
Conversation
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the
|
4 tasks done
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📌 Summary
일정·세션 생성, 당일 세션 안내, 회비 납부 의무 발생 시 사용자 설정에 따라 알림을 발송합니다.
📝 Changes
What
• 일정·세션 생성 및 정오 당일 세션 요약 알림 추가
• 회비 납부 의무 발생 알림 추가
• 발송 전 대상 상태 재검증과 중복·만료 처리 적용
Why
• 사용자가 새로운 일정과 당일 세션, 회비 납부 의무를 확인할 수 있도록 안내합니다.
• 중복 이벤트나 발송 대기 중 상태 변경으로 불필요한 알림이 전달되는 것을 방지합니다.
How
• 생성 이벤트를 BEFORE_COMMIT에서 처리해 원본 데이터와 알림 작업을 함께 저장하고, 실제 발송은 커밋 이후 비동기로 처리합니다.
• 유형별 코드 템플릿과 동아리별 마스터·카테고리 수신 설정을 적용합니다.
• 일정·세션 생성은 해당 기수의 활성 회원에게 안내하며 작성자는 제외합니다. 반복 세션은 그룹당 한 번 안내합니다.
• 당일 세션은 한국 시간 정오에 사용자별로 요약하고, 발송 전 세션 상태와 조회 권한을 다시 확인합니다. 12시 30분 이후에는 발송하지 않습니다.
• 회비는 장부 등록 완료 시 납부 의무가 있는 활성 회원에게 안내하고, 발송 전 납부·제외 여부를 다시 확인합니다.
• 이벤트 키로 중복 생성을 차단하며, 회비 알림은 기존방식과 SQS 방식 모두 적용합니다
📸 Screenshots / Logs
비즈니스 로직에서 알림 발송까지
설명 기준: PR #141,
41fb782. 공통 Outbox·SQS·재시도 구조는 PR #136에서 상속하고, 이번 PR은 비즈니스 발생 조건과 발송 전 재검증을 연결합니다.전체 흐름
알림이 발생하는 시점과 대상
일정·세션·회비 리스너는 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 기록 endnotification.dispatch.enabled=true와notification.day-reminder.enabled=true가 모두 필요합니다. 기본은 비활성입니다.회비 안내: 납부 의무 유효성 재확인
장부 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