junsobi

오너그라운드 점주앱

매머드커피·텐퍼센트·더리터 등 7개 프랜차이즈 브랜드의 약 2,800개 매장을 위한 점주용 대시보드 앱입니다.

Thu Mar 12 2026

React Native
Expo
TypeScript
EAS Update
Codemagic
GitHub Actions
Firebase
오너그라운드 점주앱의 매장 현황 화면을 담은 대표 이미지
오늘 매출과 주요 현황을 보여 주는 오너그라운드 홈 화면
메뉴별 판매 비중을 보여 주는 분석 화면
주문별 금액과 결제 수단을 확인하는 실시간 결제 내역 화면
시간대별 매출과 최근 4주 평균을 비교하는 매출 분석 화면
매장 공지와 신메뉴 안내를 모아 보는 브랜드 소식 화면
스탬프와 쿠폰 사용 이력을 확인하는 리워드 관리 화면

프로젝트 요약

기간
2026.03–현재
소속과 역할
CirclePlatform · Infrastructure architect, Frontend developer
담당 범위
앱 설정부터 EAS Update, CI/CD, 내부 배포, 런타임 오류 복구까지 맡고 있습니다.
배경과 과제
플랫폼과 배포 목적에 따라 달라지는 앱 설정을 안전하게 관리하고, 네트워크·WebView·저장소 오류가 앱 전체 중단으로 이어지지 않게 해야 했습니다.

설계와 구현

  • 앱 설정을 한곳에서 파생해 플랫폼과 배포 목적별 값이 섞이지 않도록 했습니다.
  • 빌드·업데이트·내부 배포 워크로드를 각 도구가 맡을 책임에 따라 나눴습니다.
  • query error boundary와 네트워크·WebView·저장소 예외 처리를 사용자 복구 경로와 연결했습니다.

적용 결과

  • 플랫폼과 배포 목적별 설정을 한 원본에서 관리하도록 정리했습니다.
  • preview 검증과 내부 배포, production 업데이트 경로를 분리했습니다.
  • 데이터 요청과 WebView 메시지 오류가 화면 전체 중단으로 번지지 않도록 방어했습니다.

관련 링크

오너그라운드는 매머드커피, 텐퍼센트, 더리터, 카페게이트, 트리플에이커피 등 7개 프랜차이즈 브랜드의 약 2,800개 매장을 대상으로 하는 React Native 점주용 대시보드 앱입니다. 가맹점주는 매출과 결제 내역, 리워드 현황, 브랜드 소식을 한곳에서 확인할 수 있습니다. 저는 앱 설정, EAS Update, CI/CD, 내부 배포와 런타임 안정성 영역을 담당했습니다.

설정과 배포 경로

플랫폼과 배포 목적에 따라 달라지는 값을 한 설정 파일에서 파생하도록 정리했습니다. 빌드, preview 검증, 업데이트, 내부 배포는 각 도구가 맡을 책임에 맞춰 나눴고 production 작업은 수동 확인 지점을 남겼습니다.

EAS Update

runtimeVersion을 앱 버전과 연결하고 업데이트 확인과 적용 상태를 시작 화면에 표시했습니다. 새 업데이트를 적용할 수 없으면 기존 버전으로 돌아가 앱을 계속 열 수 있게 했습니다.

런타임 오류 경로

데이터 요청 실패는 query error boundary에서 복구할 수 있도록 구성했습니다. 인증 갱신, WebView 메시지 파싱, AsyncStorage 접근, 푸시 처리에서 생기는 예외도 각 경계에서 잡아 사용자에게 재시도 경로를 보여 주도록 정리했습니다.