SPMS/SPMS_API
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[Feature] FCM 발송 모듈 구현 (Firebase Cloud Messaging) #104

New Issue
Closed
opened 2026-02-10 06:41:42 +00:00 by seonkyu.kim · 0 comments
seonkyu.kim commented 2026-02-10 06:41:42 +00:00
Owner
Copy Link

📋 개요

Firebase Admin SDK를 사용하여 Android 디바이스에 푸시를 발송하는 모듈을 구현합니다.
PushWorker(#9)의 선행 작업으로, FCM HTTP v1 API 기반 발송 및 에러 처리를 포함합니다.

📐 설계

  • Interface: IFcmSender (Application Layer)
  • Implementation: FcmSender (Infrastructure Layer, Firebase Admin SDK)
  • 배치 발송 500건 단위
  • Service별 Firebase 인스턴스 관리 (멀티테넌시)

✅ 체크리스트

Application Layer

  • IFcmSender.cs — FCM 발송 인터페이스
  • PushResultDto.cs — 발송 결과 DTO

Infrastructure Layer

  • FcmSender.cs — Firebase Admin SDK 연동
  • Service별 Firebase 인스턴스 관리
  • DI 등록

에러 처리

  • FCM 응답 코드별 처리 로직
  • Unregistered → Device 삭제
  • InvalidArgument/SenderIdMismatch → Device 삭제
  • Unavailable/Internal/QuotaExceeded → 재시도

검증

  • 빌드 확인 (0 errors, 0 warnings)

📎 참고

  • Milestone: Phase 3 (v0.4.0)
  • PushWorker(#9)가 이 모듈을 사용하여 실제 발송 수행
## 📋 개요 Firebase Admin SDK를 사용하여 Android 디바이스에 푸시를 발송하는 모듈을 구현합니다. PushWorker(#9)의 선행 작업으로, FCM HTTP v1 API 기반 발송 및 에러 처리를 포함합니다. ## 📐 설계 - Interface: `IFcmSender` (Application Layer) - Implementation: `FcmSender` (Infrastructure Layer, Firebase Admin SDK) - 배치 발송 500건 단위 - Service별 Firebase 인스턴스 관리 (멀티테넌시) ## ✅ 체크리스트 ### Application Layer - [x] `IFcmSender.cs` — FCM 발송 인터페이스 - [x] `PushResultDto.cs` — 발송 결과 DTO ### Infrastructure Layer - [x] `FcmSender.cs` — Firebase Admin SDK 연동 - [x] Service별 Firebase 인스턴스 관리 - [x] DI 등록 ### 에러 처리 - [x] FCM 응답 코드별 처리 로직 - [x] Unregistered → Device 삭제 - [x] InvalidArgument/SenderIdMismatch → Device 삭제 - [x] Unavailable/Internal/QuotaExceeded → 재시도 ### 검증 - [x] 빌드 확인 (0 errors, 0 warnings) ## 📎 참고 - Milestone: Phase 3 (v0.4.0) - PushWorker(#9)가 이 모듈을 사용하여 실제 발송 수행
seonkyu.kim added the
Priority
Urgent
Status
In Progress
Type
Feature
 labels 2026-02-10 06:41:49 +00:00
seonkyu.kim self-assigned this 2026-02-10 06:41:52 +00:00
seonkyu.kim added this to the Phase 3: 메시지 & Push Core milestone 2026-02-10 06:41:55 +00:00
seonkyu.kim added
Status
Done
 and removed
Status
In Progress
 labels 2026-02-10 06:49:56 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
  
Priority
High
우선순위: 높음

  
Priority
Low
우선순위: 낮음

  
Priority
Medium
우선순위: 보통 [기본]

  
Priority
Non
우선순위: 없음 [처리 시점 유연]

  
Priority
Urgent
우선순위: 긴급 [지연 금지, 즉시 처리]

  
Status
Available
시작 전

  
Status
Done
종료

  
Status
In Progress
진행 중

  
Type
Bug
버그 수정

  
Type
Chore
유지보수

  
Type
Design
디자인

  
Type
Documentation
문서화

  
Type
Feature
새 기능 추가

  
Type
Improvement
기능 개선

  
Type
Refactor
리팩토링

  
Type
Research
연구, 조사

  
Type
Task
할 일

No Label
Priority
High
Priority
Low
Priority
Medium
Priority
Non
Priority
Urgent
Status
Available
Status
Done
Status
In Progress
Type
Bug
Type
Chore
Type
Design
Type
Documentation
Type
Feature
Type
Improvement
Type
Refactor
Type
Research
Type
Task
Milestone
Clear milestone
No items
No Milestone
Phase 3: 메시지 & Push Core
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
seonkyu.kim
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: SPMS/SPMS_API#104
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?