Skip to Content
DecisionsADR-0026: 집행부 앱을 고객앱과 별개의 Expo 앱(apps/dashboard-app)으로 만들고 OTA 서버는 공유한다

ADR-0026: 집행부 앱을 고객앱과 별개의 Expo 앱(apps/dashboard-app)으로 만들고 OTA 서버는 공유한다

  • Status: Accepted
  • Date: 2026-10-27
  • 관련: HMH-10302(에픽) · HMH-10304(이번 작업) · HMH-10303·HMH-10313(OTA 앱 구분, web#6460·#6463) · 설계 docs/superpowers/specs/2026-10-26-dashboard-app-design.md

Context

조합 집행부 임원은 동의율을 확인하려고 웹 대시보드 통계 탭을 캡처해 단톡방에 올린다. 휴대폰에서 바로 보고 공유하는 앱이 필요하다. App Store·Play에 공개 출시한다.

제약은 다음과 같다.

  • 웹 대시보드(apps/dashboard)는 데스크톱 기준이다. 반응형이 없고 RN 브릿지도 없다.
  • 고객앱(apps/native-app)에는 본인인증 게이팅, 웹뷰 브릿지, Airbridge, ChannelIO, Sendbird, Firebase 등 고객 전용 배선이 깊게 들어가 있다.
  • 자체 OTA 서버(apps/api /api/updates/*)는 앱이 하나라는 전제로 만들어져 있었다.
  • yarn v1 단일 워크스페이스이고 루트 patches/가 특정 버전에 고정돼 있다.

검토한 대안

대안채택 안 한 이유
고객앱 안에 “집행부 모드”를 둔다대시보드 계정과 고객 계정은 로그인·세션 체계가 다르다. 고객 게이팅·심사 메타데이터·번들 크기가 서로 묶인다. 고객앱 회귀 위험이 커진다.
웹 대시보드를 웹뷰로 감싼다대시보드가 데스크톱 전용이라 휴대폰에서 쓸 수 없다. 반응형 작업이 웹 전체에 퍼지고, 애플 심사 4.2(최소 기능) 반려 위험이 있다.
집행부 앱용 OTA 서버를 따로 둔다같은 서명 키·R2·DB 운영을 두 벌로 해야 한다. 앱 식별 헤더 하나로 구분할 수 있으므로 공유한다.

Decision

  • 새 워크스페이스 apps/dashboard-app(패키지 howmuchhome-dashboard-app)를 둔다. 고객앱은 복제하지 않고, 빌드 설정(Metro·babel·tailwind·expo-router)과 provider 뼈대만 가져온다. 화면은 @howmuchhome-web/ui/native와 packages/api로 네이티브로 만든다.
  • 정체성은 별도다: 번들ID co.howmuchhome.DashboardApp(+.dev), scheme howmuchhome-dashboard(+-dev), Sentry 프로젝트 howmuchhome-dashboard-app. 같은 기기에 고객앱과 함께 설치된다. 이름·번들ID는 스토어 등록(HMH-10312) 전까지 임시다.
  • OTA 서버는 공유한다. 집행부 앱은 updates.requestHeaders에 howmuchhome-app: dashboard-app을 보내고(apps/dashboard-app/app.config.ts), 서버는 이 값으로 release를 나눈다(apps/api/src/features/expoUpdates/app.ts, expo_update_release.app). 헤더가 없으면 고객앱으로 처리한다. 서명 키가 하나라 certs/certificate.pem은 고객앱과 같다.
  • 의존성 버전은 고객앱과 문자열까지 같게 둔다. apps/dashboard-app/scripts/checkSdkSync.mjs가 PR CI(.github/workflows/dashboard-app-check.yml)에서 검사한다.
  • 고객앱 워크플로(native-app-*.yml, gate-main-on-ota.yml, native-auto-bump.yml)는 수정하지 않는다. 집행부 앱 워크플로는 따로 둔다.

Consequences

좋아지는 것

  • 고객앱 코드·빌드·심사와 독립적으로 출시하고 고칠 수 있다.
  • 고객앱 파이프라인을 건드리지 않아 회귀 위험이 없다.
  • 공유 패키지(packages/api, packages/ui)가 바뀌면 두 앱에 같이 반영돼, 대시보드와 숫자가 어긋나지 않는다.

감수하는 것

  • 고객앱 SDK·RN을 올리는 PR에서 집행부 앱도 같이 올려야 한다(버전 일치 CI가 강제한다).
  • 앱 두 개의 스토어 계정·인증서·Sentry·Datadog을 따로 관리한다.
  • OTA 롤백 주의: 집행부 앱 release가 생긴 뒤에는 서버의 앱 구분 코드만 되돌리면 안 된다(native-app/ota.mdx “여러 앱 구분”).
  • 집행부 앱에서 쓰는 공유 패키지가 웹 전용 모듈을 끌고 오면 Metro shim이 필요하다(apps/dashboard-app/metro.config.js).

이 결정을 다시 열어야 할 때

  • 집행부 기능이 고객앱 기능(채팅·푸시·본인인증)을 대부분 재사용하게 되면, 공용 앱 셸 패키지로 뽑거나 앱을 합치는 것을 다시 검토한다.
  • 웹 대시보드가 모바일 반응형을 갖추면 일부 화면을 웹뷰로 바꾸는 것을 검토한다.
Last updated on