병원 동행·방문 돌봄 다중 역할 플랫폼
병원 동행, 돌봄 인력, 방문 서비스 주문을 위한 모듈러 모놀리스 플랫폼입니다. 환자용 미니프로그램, 돌봄 인력용 미니프로그램과 앱, 병원·운영사 콘솔, 결제 분할과 정산을 맡는 별도 원장 도메인으로 이루어집니다.
핵심 요약: 동행과 방문 돌봄 주문에 대해 환자, 돌봄 인력, 병원, 운영사를 모두 상대하는 모듈러 모놀리스 백엔드를 만들었습니다. 돈의 흐름은 별도 원장 스키마로 분리했고, 배정과 추적은 휴대폰의 미니프로그램이 할 수 있는 범위로 제한했습니다.
개요
환자와 가족은 미니프로그램으로 주문합니다. 돌봄 인력은 별도 미니프로그램과 Flutter 앱으로 일을 받고 마칩니다. 병원과 운영사는 웹 콘솔을 씁니다. 개발은 구조화된 아키텍처 검토에서 시작했고, 프레임워크 선택보다 규정 준수와 결제 분할 리스크를 먼저 다뤘습니다.
문제
동행과 돌봄 서비스에는 환자, 가족, 돌봄 인력, 병원, 운영사 등 여러 당사자가 얽혀 있고, 각자 다른 화면이 필요합니다. 결제는 결제 채널 규칙 안에서 플랫폼과 서비스 제공자 사이에 나눠야 합니다. 위치와 업무 배정 기능도 휴대폰의 미니프로그램이 실제로 할 수 있는 범위 안에서 돌아가야 합니다.
제약
- 환자 쪽 진입은 메신저 플랫폼 미니프로그램으로만. 돌봄 인력 쪽은 필요한 권한이 달라 별도 앱 ID가 필요함.
- 미니프로그램은 백그라운드에서 멈추므로 지속적인 실시간 추적은 믿을 만한 약속이 아니었음. 제품 문구를 ‘서비스 단계마다 기록’으로 바꿈.
- 결제 채널은 결제 금액 중 분할할 수 있는 비율을 제한함. 정산 규칙을 이 한도에 맞춰야 했음.
- 방문 간호는 성 단위 간호 서비스 기준에 따른 인허가와 기록 장비 요건을 충족할 때까지 첫 마일스톤에서 뺐음.
아키텍처
| 구성 요소 | 구현 |
|---|---|
| 백엔드 | Java 21, Spring Boot 4.1. order, staff, hospital, market, pay, settle, notify 등 15개 도메인 모듈을 가진 Maven 멀티 모듈 모놀리스 |
| 데이터 | 업무 스키마와 원장 스키마를 분리한 PostgreSQL 17. 원장 도메인은 jOOQ, 업무 도메인은 Spring Data JDBC. 모든 스키마 변경은 버전 관리되는 Flyway 마이그레이션 |
| 클라이언트 | 플랫폼 네이티브 프레임워크로 만든 미니프로그램 두 개, 돌봄 인력용 Flutter 앱, Vue 3 병원·운영 콘솔 |
| 로컬 환경 | 메신저 플랫폼 모의 서비스를 포함한 Docker Compose. 로그인과 결제 흐름을 실제 자격 증명 없이 실행 |
핵심 결정
- 마이크로서비스가 아니라 모듈러 모놀리스. 주문, 배정, 정산이 하나의 배포 단위를 공유해 트랜잭션이 로컬에 머뭅니다. 모듈 경계는 네트워크가 아니라 코드로 강제합니다.
- 별도 원장 도메인. 정산과 분할은 자체 스키마에서 명시적인 SQL로 작성하고, 업무 도메인은 금전 기록을 직접 쓰지 않습니다. 그래서 모든 돈의 흐름을 한 모듈까지 추적할 수 있습니다.
- 지킬 수 없는 약속은 하지 않음. 주문을 뿌려 먼저 잡는 사람이 가져가는 방식 대신, 지정 배정, 확인 시간 초과 시 단계적 상향, 자동 음성 전화로 인력을 배정합니다.
- 코드보다 계약 먼저. API, 데이터베이스, 테마, 환경, 테스트 계약을 먼저 문서로 정했고, 아키텍처 검토에서는 프로젝트 오너만 결정할 수 있는 항목을 기록했습니다.
근거
- 백엔드의 Java 테스트 클래스 287개, 버전 관리 마이그레이션 파일 156개.
- 저장소 문서에 전체 감사 보고서(2026-09-17)와 납품 검토(2026-09-19)가 있습니다.
한계
주문량, 현재 운영 상태, 제휴 기관, 금전 조건은 공개하지 않습니다. 이 사례의 규제 해석은 엔지니어링 관점의 의견이며 법률 자문이 아닙니다.
자주 묻는 질문
환자용으로 네이티브 앱 대신 미니프로그램을 쓴 이유는 무엇인가요?
환자는 병원에서 코드를 스캔해 들어옵니다. 아키텍처 검토 결과 이 진입 경로와 결제 채널에는 미니프로그램이 맞고, 별도 네이티브 앱은 환자에게 보탬이 적다고 판단했습니다.
돈은 어떻게 다루나요?
원장 도메인은 자체 스키마를 가지며, 금전 기록은 이 도메인만 씁니다. 분할 규칙은 결제 채널의 한도 안에서 설계했습니다.
돌봄 인력의 실시간 위치 추적을 지원하나요?
플랫폼은 서비스 단계를 하나하나 기록합니다. 미니프로그램은 백그라운드에서 위치를 계속 보고할 수 없기 때문에 지속적인 실시간 추적은 약속하지 않습니다.