3.5 KiB

Raw Blame History

FCM 설정 (N4-1 ~ N4-4)

서버·클라이언트의 푸시 코드 경로는 준비됨.
새 Firebase 프로젝트는 레거시 서버 키가 비활성인 경우가 많아, HTTP v1 + 서비스 계정 JSON을 쓴다.

이미 된 것 (코드)

계층	동작
Flutter	`PushTokenService` — Firebase 가능하면 실 FCM 토큰, 아니면 `install:` 플레이스홀더
Android	`google-services.json`이 있을 때만 Google Services 플러그인 적용
core-backend	`notifyUser` + `POST /admin/push-test` — FCM HTTP v1(서비스 계정) 우선, 레거시 `FCM_SERVER_KEY`는 폴백

Master가 할 일

N4-1 — Firebase Android 앱

Firebase Console → Android 앱 추가
package: com.ykavu.ykavu_mobile
google-services.json을 로컬에만 배치 (git 금지):

cp ~/Downloads/google-services.json mobile/android/app/google-services.json

N4-3 — 서비스 계정 JSON (HTTP v1)

레거시 서버 키가 Cloud Messaging 탭에서 사용 중지됨이면 정상이다. 아래를 쓴다.

Google Cloud → 사용자 인증 정보 → 서비스 계정 만들기
(API: Firebase Cloud Messaging API, 데이터: 애플리케이션 데이터)
역할: Firebase Cloud Messaging Admin (없으면 Firebase 관리자 / 임시 소유자)
키 유형 JSON 다운로드
서버(또는 이 워크스페이스)에 배치:

# 파일명 고정
mkdir -p secrets
mv ~/Downloads/iykyka-*.json secrets/firebase-service-account.json
chmod 600 secrets/firebase-service-account.json

프로덕션 호스트에도 동일 파일:

# 예: scp 후
cd ~/project/ykavu
# secrets/firebase-service-account.json 존재 확인
docker compose up -d --build core-backend

docker-compose.yml이 ./secrets → 컨테이너 /secrets로 마운트하고
FCM_SERVICE_ACCOUNT_FILE=/secrets/firebase-service-account.json을 읽는다.

git / 채팅에 JSON 내용을 붙여넣지 않는다.

N4-2 / N4-4 — 실기기 스모크

cd mobile
flutter run --release --dart-define=CORE_API_BASE=https://msn.iykyka.com
# 로그: device token registered (FCM)

curl -sS -X POST https://msn.iykyka.com/admin/push-test \
  -H "Authorization: Bearer $ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": <USER_ID>, "title":"와카뷰","body":"push smoke"}'

기대: sent >= 1.
only_placeholder_tokens → Android에 google-services.json 넣고 재설치.
fcm_not_configured → 서버에 서비스 계정 파일 경로 확인.

Web

Web Push(FCM Web + VAPID)는 웹 고도화 트랙 N4-W4에서 다룬다.

설계·작업 분해·수락 기준: web-upgrade.md §N4-W4
실행 표: deploy-checklist.md §N4-W
Android N4(실기기)와 병행 가능. 서버 서비스 계정(HTTP v1)은 공유하고, 클라이언트는 google-services.json(Android) vs Firebase Web config + VAPID(Web)로 분리.
코드 as-is: PushTokenService가 kIsWeb이면 토큰을 건너뛰고 install:만 등록 — W4 구현 전까지 웹 /admin/push-test는 only_placeholder_tokens가 정상.

W4 Master 준비물 (요약)

Firebase Console → Web 앱 (msn.iykyka.com)
Cloud Messaging → Web Push 인증서 / VAPID key
빌드 시크릿으로 config 주입 (git 금지) — 상세는 web-upgrade.md 부록 B
스모크: 실 웹 토큰 등록 후 POST /admin/push-test → sent >= 1

3.5 KiB Raw Blame History