정의
WUMM의 기술 아키텍처는 SwiftUI iOS 앱을 중심으로 하고, 인증·데이터 저장·파일 저장·푸시 알림·운영 자동화를 Firebase 계열 서비스로 묶는 구조다. 이 아키텍처는 wumm의 제품 범위와 couple-collaboration 경험을 가능하게 하는 기반이다.
앱 레이어
WUMMApp.swift에서 Firebase 초기화, Firestore 캐시 설정, Crashlytics, Performance, Kakao SDK, APNs 등록이 함께 수행된다. 즉 앱 시작 시점부터 관측성, 알림, 외부 로그인, 데이터 계층이 모두 연결된다. 이는 github-repo-2026-04-11의 핵심 기술 요약과 연결된다.
백엔드 레이어
functions/index.js는 Firebase Functions v2를 사용하며, 스케줄 작업과 Firestore/HTTPS 트리거를 함께 운영한다. 특히 앱은 푸시를 직접 전송하지 않고 Firestore notifications 컬렉션에 요청 문서를 만들고, Functions가 FCM HTTP v1 API를 호출하는 패턴을 사용한다. 이 비동기 구조는 couple-collaboration에서 상대방 알림을 안정적으로 전달하는 데 중요하다.
제품과의 연결
이 구조 덕분에 wedding-planning-workspace에 포함된 여러 모듈이 실시간 동기화와 알림 자동화를 공유할 수 있다. 따라서 기술 선택은 단순 구현 편의보다 제품 운영 모델과 더 직접적으로 연결돼 있다. 최근 Auth 사용자 증가를 읽을 때도 이 아키텍처가 중요하다. Kakao·Apple·Google·이메일 로그인이 함께 작동하고 Firebase Analytics 이벤트가 남기 때문에, 증가 추이는 auth-user-growth처럼 운영 데이터 관찰 문서로 이어질 수 있다.
관찰 메모
저장소에는 Notification Service Extension, 정적 웹 문서, Firebase 설정 파일까지 함께 들어 있어 “모바일 앱 + 서버리스 운영 계층 + 초대 웹 진입점”이 한 리포지토리 안에 공존한다. 이 점은 wumm이 비교적 완결된 단일 제품 저장소라는 신호다.
다만 운영 데이터 관점에서는 코드와 수집 결과 사이에 차이도 보인다. AnalyticsService 에는 sign_up, login, ios_home_partner_connect 계측 코드가 있지만, 2026-04-23 기준 GA4 조회에서는 최근 90일 동안 first_open 과 ios_home_partner_connect 만 확인되고 sign_up, login 은 보이지 않았다. 그래서 auth-user-growth에서 본 유저 증가 원인 해석은 일부 계측 공백을 안고 있었다.
2026-04-26에는 이 공백을 줄이기 위해 ga4-growth-instrumentation-2026-04-26 작업으로 가입·로그인·온보딩·초대·커플 연결·첫 가치 행동·리뷰 요청 이벤트를 보강하는 PR을 만들었다. 이 변경은 growth-playbook-2026-04-26에서 제안한 “성장 판단을 위한 최소 GA4 계측”의 첫 구현이다.