병원 웹앱을 Electron으로 옮기고 웹뷰 구조로 바꾼 이유
로그인 유지와 알림 가시성 때문에 병원용 웹앱을 Electron으로 옮긴 과정, 재시작하지 않는 병원 PC에 맞춰 웹뷰 로드 구조와 GitHub Releases 자동 업데이트로 정리한 이유를 다룹니다.

병원 PC는 꺼지지 않습니다. 그래서 "자동 업데이트는 앱을 재시작할 때 적용된다"는 Electron의 평범한 동작이 저희에게는 큰 문제가 됐습니다.
병원용 웹앱을 Electron으로 옮긴 뒤, React 앱을 통째로 패키징하던 구조를 버리고 렌더러에서 웹뷰로 웹앱을 불러오는 구조로 바꿨습니다. 앱 셸은 GitHub Releases로 자동 업데이트하고, 기능은 웹 배포만으로 반영합니다.
웹앱으로는 로그인과 알림을 지키기 어려웠다
병원 업무에 쓰는 B2B 웹앱에서 로그인이 계속 풀리고, 백그라운드 알림이 눈에 띄지 않았습니다. 저희는 처음에 클라우드 기반 웹 애플리케이션으로 배포했는데, 병원의 요구사항과 사용 환경을 분석해 보니 웹만으로는 충분한 안정성과 사용자 경험을 제공하기 어려웠습니다.
로그인이 계속 풀린다
병원에서는 여러 업무를 병행하며 앱을 씁니다. 로그인 상태가 유지되지 않으면 매번 다시 로그인해야 해서 업무 효율이 크게 떨어졌습니다.
PWA(Progressive Web App)로 설치해도 마찬가지였습니다. 브라우저 환경마다 세션 유지 정책이 달라 로그인 상태가 일정하지 않았고, Chrome 업데이트나 정책 변경에 따라 예상치 못한 세션 만료가 생길 가능성도 높았습니다.
백그라운드 알림이 Chrome 알림에 묻힌다
병원 업무에서는 실시간 알림이 필수입니다. 새로운 환자 요청이나 중요한 공지사항은 즉시 전달돼야 합니다. 그런데 웹앱에 FCM(Firebase Cloud Messaging)을 적용하니, 백그라운드 상태에서는 알림이 Chrome 알림 형태로 떠서 눈에 잘 띄지 않는다는 목소리가 많았습니다.
24시간 켜져 있는 병원 PC와 잦은 업데이트
병원 시스템은 24시간 운영되고, 사용자가 앱을 주기적으로 껐다 켤 일이 거의 없습니다. 동시에 서비스 초기라 기능 추가와 버그 수정이 잦았습니다. 이 제약은 Electron으로 옮긴 뒤 업데이트 방식을 고를 때 결정적인 조건이 됐습니다.
웹앱 유지, React 앱 패키징, 웹뷰 로드
| 선택지 | 얻는 것 | 잃는 것 |
|---|---|---|
| 웹앱(PWA) 유지 | 배포가 웹 서버 하나로 끝남 | 브라우저별 세션 정책에 로그인 유지가 좌우됨, 알림이 Chrome 알림에 묻힘 |
| Electron + React 앱 패키징 | 기존 UI·기능 그대로 데스크톱 실행, 네이티브 기능 사용 | 기능이 바뀔 때마다 앱 업데이트가 필요하고, 재시작해야 적용됨 |
| Electron + 웹뷰 로드 | 네이티브 기능은 유지, 기능은 웹 배포만으로 반영 | 앱 셸 자체를 고칠 때는 여전히 앱 업데이트가 필요 |
먼저 고른 것: React 앱을 그대로 패키징
처음에는 React 프로젝트를 Electron으로 패키징했습니다. 기존 웹 애플리케이션의 UI와 기능을 유지하면서 데스크톱에서 안정적으로 실행되게 하는 것이 목표였습니다. 기본 배포 구조를 잡은 뒤 electron-updater로 자동 업데이트도 붙여, 사용자가 직접 업데이트하지 않아도 최신 버전을 받게 했습니다.
깨진 지점: 재시작해야 적용되는 업데이트
Electron 자동 업데이트는 보통 앱이 재시작될 때 업데이트를 확인하고 적용합니다. 이 전제가 병원에서는 성립하지 않았습니다.
- 종료 시점이 없다: 새 버전을 릴리즈해도 사용자가 앱을 닫고 다시 실행하지 않으면 적용되지 않습니다. 병원 업무 환경에서는 재시작이 어렵습니다.
- 업데이트가 잦았다: 중요한 기능 추가와 버그 수정이 잦았지만 바로 적용할 수 없어 최신 기능이 반영되지 않았습니다. 중요한 보안 패치나 긴급 버그 수정도 앱을 다시 실행하지 않으면 반영되지 않아 업무 차질이 생길 수 있었습니다.
- 구버전이 남아 충돌했다: 구버전과 서버 API 사이의 호환성이 깨졌고, 여러 기기가 서로 다른 버전을 실행하면서 데이터 동기화와 UI 불일치가 생겼습니다. 최신 API를 써야 하는 기능이 구버전에는 그 API가 없어 비정상적으로 동작하기도 했습니다.
웹뷰를 고른 이유
앱을 재시작시킬 수 없다면, 재시작하지 않아도 화면이 바뀌어야 했습니다. 네이티브 기능은 Electron에 남기고 웹앱은 웹뷰로 불러오면, 기능 변경은 웹 배포만으로 반영됩니다. 그래서 웹뷰 구조를 도입했습니다.
메인 프로세스는 Electron, 화면은 웹뷰로
바탕이 되는 Electron 구조

Electron은 **메인 프로세스(Main Process)**와 **렌더러 프로세스(Renderer Process)**로 나뉩니다. 이 구조 덕분에 웹 기술(HTML, CSS, JavaScript)로 화면을 만들면서 OS의 네이티브 기능도 쓸 수 있습니다.
메인 프로세스는 Electron 앱이 실행될 때 가장 먼저 시작되며 앱의 수명 주기를 관리합니다. Node.js 환경에서 실행되며 다음 일을 맡습니다.
- 애플리케이션 창(Window) 생성 및 관리
- 파일 시스템, OS API 등 네이티브 기능 접근
- 백그라운드 작업 및 IPC(Inter-Process Communication) 관리
- 시스템 트레이, 메뉴, 알림(Notification) 등 운영체제 기능과 상호작용
렌더러 프로세스는 창마다 따로 실행되며, 웹 브라우저처럼 HTML, CSS, JavaScript로 UI를 렌더링합니다. 일반 웹앱과 똑같이 동작하지만, 메인 프로세스와 통신해 OS 기능을 쓸 수 있습니다.
- UI 렌더링 및 사용자 인터페이스 관리
- IPC를 통해 메인 프로세스와 데이터 교환
- DOM 조작 및 이벤트 핸들링
두 프로세스는 서로 직접 접근할 수 없고, IPC로 데이터를 주고받습니다.
최종 구조: 렌더러에서 웹뷰로 웹앱을 불러온다
- 메인 프로세스는 그대로 두고, 렌더러 프로세스에서 웹뷰(WebView)로 웹앱을 로드합니다.
- 기능이 추가될 때마다 앱 자체를 업데이트할 필요 없이 웹 서버 배포만으로 바로 반영됩니다.
- 알림, 파일 접근, 트레이 아이콘 같은 네이티브 기능은 Electron으로 그대로 쓰면서 웹앱의 유연성을 확보했습니다.
역할을 나누면 다음과 같습니다.
- Main Process: 애플리케이션 관리, 자동 업데이트, 네이티브 API 호출
- Renderer Process: 웹뷰(WebView)로 React 웹앱 로드
- Electron 네이티브 기능: 로그인 유지, FCM 알림, OS 연동 기능
앱 셸은 GitHub Releases로 자동 업데이트한다
웹뷰로 바꿔도 Electron 앱 자체를 고쳐야 할 때는 있습니다. CareFlow Electron 앱은 GitHub Releases로 자동 업데이트를 구현해, 병원 현장에서도 사용자가 따로 업데이트하지 않아도 최신 기능과 패치를 받게 했습니다.
- electron-updater의 autoUpdater: 앱 실행 시 버전을 확인하고, 새 릴리즈가 있으면 다운로드한 뒤 재시작할 때 반영합니다.
- GitHub Releases 연동: 릴리즈 페이지에 최신 .dmg(macOS), .exe(Windows) 파일을 포함한 릴리즈가 올라가면 앱이 이를 감지합니다.
- 무중단 업데이트 경험: 업데이트는 백그라운드에서 내려받고, 사용자에게는 알림(Notification)만 띄워 사용을 방해하지 않습니다.
기능은 웹 배포로, 앱 업데이트는 가끔만
자동 업데이트와 웹뷰 구조를 묶으면서 역할이 갈렸습니다. 클라이언트 앱은 Electron의 안정성과 네이티브 기능을 맡고, 대부분의 비즈니스 로직은 웹에서 바로 고칠 수 있게 됐습니다. 기능 변경이 더는 앱 재시작을 기다리지 않습니다.
남은 한계
앱 셸 업데이트는 여전히 재시작할 때 반영됩니다. 웹뷰 구조는 앱을 업데이트해야 하는 횟수를 줄인 것이고, 재시작이 필요하다는 조건 자체는 남아 있습니다.
배운 것
재시작을 기대할 수 없는 환경이라면, 업데이트 방식을 고민하기 전에 무엇을 앱에 넣고 무엇을 웹에 남길지부터 정해야 했습니다.
같은 주제의 글
WebView 하단 탭바를 Link와 idle prefetch로 가볍게 만든 기록
Next.js App Router + Flutter WebView에서 전역 5탭·금 모으기 4탭 하단바의 전환 지연, 초기 prefetch 부담, 입장 애니메이션을 라우팅 모델에 맞춰 나눠 푼 과정입니다.
Next.js 정적 파일을 S3·CloudFront로 옮겨 CPU 스파이크 줄이기
assetPrefix로 /_next/static만 S3 + CloudFront(OAC)로 분리한 구조와 배포 후 캐시 무효화 순서, 같이 챙겨야 했던 이미지 허용·빌드 OOM 설정을 정리했습니다.
허용 도메인만 열린 교육청 망에서 S3 이미지를 nginx 리버스 프록시로 띄운 기록
서울시교육청 시범 도입 중 화이트리스트 망에서 S3 이미지가 막히자, 이미 허용된 API 도메인 뒤에 nginx 리버스 프록시를 두어 이미지를 서빙한 과정과 트레이드오프를 정리했습니다.