병원 동행·방문 돌봄 다중 역할 플랫폼

병원 동행, 돌봄 인력, 방문 서비스 주문을 위한 모듈러 모놀리스 플랫폼입니다. 환자용 미니프로그램, 돌봄 인력용 미니프로그램과 앱, 병원·운영사 콘솔, 결제 분할과 정산을 맡는 별도 원장 도메인으로 이루어집니다.

핵심 요약: 동행과 방문 돌봄 주문에 대해 환자, 돌봄 인력, 병원, 운영사를 모두 상대하는 모듈러 모놀리스 백엔드를 만들었습니다. 돈의 흐름은 별도 원장 스키마로 분리했고, 배정과 추적은 휴대폰의 미니프로그램이 할 수 있는 범위로 제한했습니다.

개요

환자와 가족은 미니프로그램으로 주문합니다. 돌봄 인력은 별도 미니프로그램과 Flutter 앱으로 일을 받고 마칩니다. 병원과 운영사는 웹 콘솔을 씁니다. 개발은 구조화된 아키텍처 검토에서 시작했고, 프레임워크 선택보다 규정 준수와 결제 분할 리스크를 먼저 다뤘습니다.

돌봄 서비스 플랫폼 아키텍처: 환자용 미니프로그램, 돌봄 인력용 미니프로그램과 앱, 병원 콘솔, 운영 콘솔이 업무 모듈과 별도 원장 스키마를 PostgreSQL에 둔 모듈러 모놀리스 백엔드를 호출한다. 결제 대행사와 알림 채널은 외부에 있다.

문제

동행과 돌봄 서비스에는 환자, 가족, 돌봄 인력, 병원, 운영사 등 여러 당사자가 얽혀 있고, 각자 다른 화면이 필요합니다. 결제는 결제 채널 규칙 안에서 플랫폼과 서비스 제공자 사이에 나눠야 합니다. 위치와 업무 배정 기능도 휴대폰의 미니프로그램이 실제로 할 수 있는 범위 안에서 돌아가야 합니다.

제약

  • 환자 쪽 진입은 메신저 플랫폼 미니프로그램으로만. 돌봄 인력 쪽은 필요한 권한이 달라 별도 앱 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. 로그인과 결제 흐름을 실제 자격 증명 없이 실행

핵심 결정

  1. 마이크로서비스가 아니라 모듈러 모놀리스. 주문, 배정, 정산이 하나의 배포 단위를 공유해 트랜잭션이 로컬에 머뭅니다. 모듈 경계는 네트워크가 아니라 코드로 강제합니다.
  2. 별도 원장 도메인. 정산과 분할은 자체 스키마에서 명시적인 SQL로 작성하고, 업무 도메인은 금전 기록을 직접 쓰지 않습니다. 그래서 모든 돈의 흐름을 한 모듈까지 추적할 수 있습니다.
  3. 지킬 수 없는 약속은 하지 않음. 주문을 뿌려 먼저 잡는 사람이 가져가는 방식 대신, 지정 배정, 확인 시간 초과 시 단계적 상향, 자동 음성 전화로 인력을 배정합니다.
  4. 코드보다 계약 먼저. API, 데이터베이스, 테마, 환경, 테스트 계약을 먼저 문서로 정했고, 아키텍처 검토에서는 프로젝트 오너만 결정할 수 있는 항목을 기록했습니다.

근거

  • 백엔드의 Java 테스트 클래스 287개, 버전 관리 마이그레이션 파일 156개.
  • 저장소 문서에 전체 감사 보고서(2026-09-17)와 납품 검토(2026-09-19)가 있습니다.

한계

주문량, 현재 운영 상태, 제휴 기관, 금전 조건은 공개하지 않습니다. 이 사례의 규제 해석은 엔지니어링 관점의 의견이며 법률 자문이 아닙니다.

자주 묻는 질문

환자용으로 네이티브 앱 대신 미니프로그램을 쓴 이유는 무엇인가요?

환자는 병원에서 코드를 스캔해 들어옵니다. 아키텍처 검토 결과 이 진입 경로와 결제 채널에는 미니프로그램이 맞고, 별도 네이티브 앱은 환자에게 보탬이 적다고 판단했습니다.

돈은 어떻게 다루나요?

원장 도메인은 자체 스키마를 가지며, 금전 기록은 이 도메인만 씁니다. 분할 규칙은 결제 채널의 한도 안에서 설계했습니다.

돌봄 인력의 실시간 위치 추적을 지원하나요?

플랫폼은 서비스 단계를 하나하나 기록합니다. 미니프로그램은 백그라운드에서 위치를 계속 보고할 수 없기 때문에 지속적인 실시간 추적은 약속하지 않습니다.