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), schemehowmuchhome-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