프로젝트 목록으로
의료씨엠병원 · 2026.06 ~

PT Schedule — 물리치료실 스케줄 관리

치료사별 시간표·월간 통계·검색을 제공하는 사내 운영 도구

담당 — 설계·개발 전 과정 (백엔드 + 프론트엔드)

물리치료실 치료사별 일일 시간표(08:00~18:00)에 환자를 배정하고, 월간 캘린더 통계와 환자/치료사 검색을 제공하는 운영 시스템입니다. 관리자/치료사 이중 인증을 지원합니다.

cm_groupware의 문서/하네스 표준(Skills 잠금·MCP 프로젝트 로컬 격리·커밋 컨벤션)을 경량 스택에 이식했습니다.

접속 안내

실제 병원 운영 시스템으로, 환자 정보 보호를 위해 로그인 계정은 공개하지 않습니다. 위 스크린샷은 관리자 화면을 개인정보 블러 처리 후 캡처한 것입니다.

스크린샷

실제 운영/실행 화면을 직접 캡처했습니다.

치료사별 일일 시간표 — 직책별 색상 헤더, 시간대별 환자 배정 (환자·치료사 성명은 블러 처리)
치료사별 일일 시간표 — 직책별 색상 헤더, 시간대별 환자 배정 (환자·치료사 성명은 블러 처리)

배경과 문제

물리치료실의 치료사별 환자 배정이 수기 시간표로 관리되어 변경·조회·통계가 번거로웠습니다. 치료사별 일일 시간표(08:00~18:00)와 월간 통계, 환자/치료사 검색을 제공하는 운영 도구를 구축했습니다.

핵심 성과

  • schedule·therapist·auth·calendar·search 5개 기능 도메인
  • 치료사별 색상 시간표 + 월간 환자 수 통계
  • skills-lock.json 해시 고정으로 AI 도구 재현성 확보

아키텍처 & 설계 포인트

  • FastAPI 기능별 라우터 + core(config/database) 구조로 schedule·therapist·auth·calendar·search 5개 도메인 분리
  • 관리자/치료사 이중 인증 — 치료사는 개인 시간표 중심, 관리자는 전체 운영 관리
  • React 18 + TanStack Query로 시간표 그리드·월간 캘린더 통계(치료사별 환자 수) 구현, 치료사별 색상 구분
  • cm_groupware와 같은 서버에서 Docker Compose(edge 외부 네트워크 공유)로 운영, 그룹웨어 사이드바에서 바로 진입

AI(Claude Code) 활용

  • cm_groupware의 문서/하네스 표준을 경량 스택(FastAPI+React)에 이식 — 프로젝트 로컬 Skills 5종을 skills-lock.json 해시로 고정, MCP(playwright·context7)도 프로젝트 로컬 격리

기술 스택

FastAPISQLModelReact 18ViteTailwind CSSTanStack QueryMySQLDocker Compose