병원 LINE 예약 시스템 사례 | 동시 제어, 실시간 동기화 및 130+ 테스트

문제 배경

예약 시스템에서 가장 위험한 것은 화면이 보기 좋지 않은 것이 아니라, 데이터 레이어의 경쟁입니다. 두 환자가 동시에 동일한 시간에 예약하거나, 병원이 임시로 문을 닫지만 환자는 이전 시간을 볼 수 있거나, 카운터에서 예약 규칙을 업데이트했지만 LINE에서는 여전히 예약이 허용되는 상황입니다. 이러한 상황은 실제 트래픽에서 발생할 수 있습니다. 이 프로젝트의 핵심은 "화면에 표시된 예약"과 "데이터베이스에 실제로 예약"을 분리하여 처리하고, 백엔드에서 모든 변경 사항이 즉시 환자에게 반영되도록 하는 것입니다.

실천 방법

• —데이터베이스를 기반으로 동시에 예약 및 거래 처리를 수행: 예약 시 거래 내에서 해당 시간을 다시 조회하고 잠금하여, 두 사람이 동시에 예약하면 먼저 잠금을 획득한 쪽만 성공하고, 다른 쪽은 명확한 실패 메시지를 받습니다.
• —프론트엔드에서 제시하는 예약 시간은 참고 자료일 뿐입니다. 예약이 완료되는 유일한 기준은 서버 측에서 다시 확인하는 것입니다. 즉, 해당 시간대가 여전히 사용 가능한지, 환자가 규칙을 준수하는지, 기존 예약과 충돌하는지 등을 서버에서 다시 확인합니다.
• —Supabase Realtime 동기화를 사용하면, 백엔드에서 진료 중단, 시간 조정 또는 규칙 변경 시, 변경 사항이 즉시 환자 인터페이스에 전달되어 정보 불일치를 줄일 수 있습니다. 하지만, Realtime은 사용자 경험을 담당하며, 정확성을 보장하지 않습니다. 백엔드 검증이 최종 기준입니다.
• —예외 상황을 엔드 투 엔드 테스트로 작성합니다. 동시에 예약, 예약 후 즉시 취소, 백엔드에서 임시로 진료 중단, 규칙 변경 후 재확인, 연결이 끊어진 후 재전송 등은 반복 실행 가능한 테스트로 구성하여, 각 수정 시 전체를 재실행하여 검증합니다.

Falcon의 실제 책임 범위

• LINE LIFF 환자 예약 프로세스
• 진료소 시간 및 예약 관리 백엔드
• Supabase Realtime 실시간 동기화
• 데이터베이스 동시성 제어 및 엔드 투 엔드 테스트

LINE 예약 및 동시성 제어 프로세스

1. 01환자는 LINE을 통해 LIFF 예약 인터페이스를 열어 현재 사용 가능한 시간을 확인합니다. 이 목록은 화면 참고 자료일 뿐이며, 최종 기준이 아닙니다.
2. 02예약 시, 백엔드는 동일한 거래 내에서 시간, 예약 규칙, 시간 충돌 여부를 다시 확인하고, 모든 조건이 충족되면 예약이 완료됩니다.
3. 03두 사람이 동시에 동일한 시간을 예약하면, 데이터베이스 거래를 통해 승자를 결정합니다. 실패한 측은 명확한 메시지를 받고, 최신 사용 가능한 시간을 다시 불러옵니다.
4. 04Realtime은 시간 변경 사항과 백엔드 변경 사항을 환자 및 진료소 관리 인터페이스에 동기화하여, 양쪽 모두 동일한 상태를 확인합니다.

제한 사항, 실패 및 대체 방법

• —여러 사람이 동시에 동일한 시간을 선택하면, 백엔드 거래 결과를 통해 승자를 결정합니다. 실패한 측은 다시 선택해야 하며, "먼저 화면에 나타나면 예약"과 같은 가정을 할 수 없습니다.
• —즉시 연결이 끊어지더라도 예약이 성공했음을 가정할 수 없습니다. 화면은 백엔드의 공식 상태를 다시 확인한 후 결과를 표시해야 합니다.
• —백엔드 규칙 변경의 적용 시간은 서버 측을 기준으로 합니다. 환자 측 화면에 아직 업데이트되지 않은 경우, 예약 시 백엔드에서 다시 확인되어 거부될 수 있습니다.
• —익명 사례는 환자, 진료소, 예약 수 및 의료 정보를 공개하지 않으며, 의료 또는 운영 성과를 주장하지 않습니다.

증거 검증 방법

• ✓130+ 엔드 투 엔드 테스트에 포함된 시나리오 유형: 정상 예약 및 취소, 동시에 예약 경쟁, 백엔드 시간 변경 및 임시 진료 중단, 규칙 변경 후 예약 확인, 연결 끊김 및 재전송.
• ✓테스트 숫자는 기존 공개된 사례 수로, 결함이 없음을 의미하지 않습니다.
• ✓데이터베이스 잠금, 거래 및 Realtime은 시스템 설계에 해당하며, 운영 약속을 의미하지 않습니다.
• ✓고객 이름, 환자 정보, 예약 수 및 운영 지표는 공개되지 않습니다.

공개 가능한 측정 및 능력