← 포트폴리오 목록
치과 데스크 통합 관리 시스템
진료실·담당의·체어별 멀티 레인 예약 스케줄러, 환자 통합 CRM, 수납·미수금 관리, SMS·알림톡 발송 큐를 포함한 치과 데스크 통합 관리 시스템을 React + Node.js/Express + PostgreSQL(Prisma) 기반으로 설계·구현합니다.
멀티 레인 예약 충돌 방지 로직 설계진료실·의사·체어 3축 리소스 기반 예약 슬롯 검증, PostgreSQL 트랜잭션으로 이중 예약 충돌을 방지하는 로직을 설계합니다.
환자 진료 이력 타임라인 뷰 구현내원·진료·상담 이력을 시계열로 통합 조회하는 타임라인 컴포넌트를 설계하고, 인덱싱 전략으로 대량 이력 조회를 고려합니다.
수납·미수금 정합성 검증 로직 구축진료 항목별 수납 내역과 미수금 상태(미수금/부분수납/완료)를 자동 동기화하는 상태 머신을 설계합니다.
Overview
프로젝트 개요
진료실·담당의·체어별 멀티 레인 예약 스케줄러, 환자 통합 CRM, 수납·미수금 관리, SMS·알림톡 발송 큐를 포함한 치과 데스크 통합 관리 시스템을 React + Node.js/Express + PostgreSQL(Prisma) 기반으로 설계·구현합니다. 실시간 예약 동기화는 Socket.io로 구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
진료실·의사·체어 3축 리소스가 동시에 겹치는 예약 충돌을 방지하는 슬롯 검증 로직 설계
환자 개인정보(연락처·진료기록)를 의료법 기준으로 암호화 저장하고 접근 로그를 남기는 구조 설계
수납·미수금 상태 전환 시 트랜잭션 정합성을 보장하는 동시성 제어 설계
SMS와 카카오 알림톡을 채널별로 분리 발송하면서 발송 실패를 감지·재처리하는 큐 아키텍처 설계
핵심 기능 1
멀티 레인 예약 스케줄러
진료실·담당 의사·체어별로 구분된 멀티 레인 캘린더에서 예약을 드래그&드롭으로 조정할 수 있는 스케줄러입니다
핵심 기능 2
환자 통합 관리
환자 기본정보 등록, 이름/연락처 기반 검색, 상세 페이지에서 내원·진료·상담 이력을 통합 조회할 수 있는 CRM입니다
핵심 기능 3
수납·미수금 관리
진료 항목별 수납 내역을 수기 입력하고, 미수금 발생 건을 상태별(미수금/부분수납/수납완료)로 관리합니다. 수납 등록 폼과 미수금 현황 목록 화면을 구성하고, 상태 전환 시 트랜잭션을 원자적으로 처리합니다
핵심 기능 4
SMS·알림톡 자동 발송
예약 리마인드와 리콜 메시지를 SMS와 카카오 알림톡 채널로 발송 관리하는 화면입니다. 발송 대상 필터링, 메시지 템플릿 관리, 채널별 발송 큐와 발송 로그를 구현합니다
구현 과정
프로젝트 진행 단계
STEP 1
업무 프로세스 분석 및 ERD 설계
예약·환자·수납 프로세스 분석, PostgreSQL 테이블 18~22개 정의 및 진료실/의사/체어 리소스 모델링
STEP 2
예약 스케줄러 및 환자 CRUD API 개발
Express 기반 예약 CRUD·충돌 검증 API, 환자 검색·이력 API 구현, Prisma 트랜잭션 적용
STEP 3
수납·SMS 발송 및 프론트엔드 UI 개발
React 기반 스케줄러·환자상세·수납관리 화면 구현, SMS·알림톡 발송 큐 연동
STEP 4
통합 테스트 및 반응형 최적화
예약 충돌 시나리오 테스트, 모바일 반응형 레이아웃 검증, 크로스 브라우저 테스트
프로젝트 성과
멀티 레인 예약 충돌 방지 로직 설계진료실·의사·체어 3축 리소스 기반 예약 슬롯 검증, PostgreSQL 트랜잭션으로 이중 예약 충돌을 방지하는 로직을 설계합니다.
환자 진료 이력 타임라인 뷰 구현내원·진료·상담 이력을 시계열로 통합 조회하는 타임라인 컴포넌트를 설계하고, 인덱싱 전략으로 대량 이력 조회를 고려합니다.
수납·미수금 정합성 검증 로직 구축진료 항목별 수납 내역과 미수금 상태(미수금/부분수납/완료)를 자동 동기화하는 상태 머신을 설계합니다.
SMS·알림톡 발송 큐 아키텍처 설계예약 리마인드·리콜 메시지를 채널별로 분리 발송하는 큐 구조를 설계하고, 발송 실패 시 재시도 정책을 적용합니다.
Review
기술적 주안점
- Socket.io 기반 실시간 예약 상태 동기화로 여러 데스크 직원이 동시에 캘린더를 봐도 충돌 없이 반영되는 구조를 구현합니다
- 환자 개인정보(연락처·진료기록) 필드는 컬럼 단위 암호화를 적용해 의료법 기준 개인정보 보호 구조를 설계합니다
- 다중 선택 후 일괄 수납 처리 시 부분 실패 없이 트랜잭션 단위로 전체 처리되는 구조를 설계합니다
