온결 메디컬 통합 운영 콘솔
예약 현황, 지점별 스케줄 슬롯 설정, 게시판·문의 관리, 예약·문의 통계, 지점별 권한과 감사 로그를 한 콘솔에서 다루는 확장 프로젝트입니다.
프로젝트 개요
예약 현황, 지점별 스케줄 슬롯 설정, 게시판·문의 관리, 예약·문의 통계, 지점별 권한과 감사 로그를 한 콘솔에서 다루는 확장 프로젝트입니다. 사이트 쪽 예약 흐름의 다음 단계인 운영 업무를 지점 관리자와 본사 관리자 역할로 나누어 보여 줍니다. 회원가입·로그인 체계는 범위에서 제외하고 관리자 계정 기준으로 구성합니다.
작업 범위
- 예약 현황 대시보드: 오늘 접수된 예약과 처리가 필요한 변경·취소 요청, 지점별 문의 대기 건이 한 화면에 모입니다. 요청 줄을 누르면 해당 처리 화면으로 이동합니다
- 예약 관리와 스케줄 슬롯 설정: 예약 목록을 지점·진료과·상태로 거르고 상세에서 확정·변경·취소를 처리합니다. 슬롯 설정 화면에서는 지점별 진료 요일과 시간 간격, 휴진일을 정합니다
- 게시판·문의 관리: 공지사항, 언론보도, FAQ 글을 작성·수정·삭제하고 방문자 문의에 답변합니다. 문의는 접수·답변 완료 상태로 나뉘고 지점별로 담당이 갈립니다
- 통계와 지점 권한·감사 로그: 예약과 문의 추이를 지점·기간별로 보고, 지점 관리자와 본사 관리자의 권한을 설정합니다. 누가 어떤 설정을 바꿨는지 감사 로그로 남습니다
주요 업무
- 예약 현황 대시보드 화면: 지점 범위로 필터된 예약·문의 집계를 한 번에 조회하고 역할에 따라 보이는 지점이 달라지도록 구성합니다
- 예약 관리와 스케줄 슬롯 설정 화면: 슬롯 규칙을 지점별 데이터로 저장하고 규칙 변경 시 이미 접수된 예약과 충돌하는 구간을 사전에 알려 줍니다
- 게시판·문의 관리 화면: 게시판 세 종을 공통 콘텐츠 모델과 종류 필드로 관리하고 문의 답변 이력을 남깁니다
- 통계와 지점 권한·감사 로그 화면: 집계 쿼리와 권한 매트릭스, 변경 이력 기록을 분리해 구성하고 역할을 바꾸면 메뉴와 버튼이 실제로 달라지도록 합니다
프로젝트 핵심 과제
지점마다 운영 규칙이 달라 슬롯 규칙을 데이터로 두고 변경 영향을 미리 보여 주는 방식으로 대응할 계획입니다
회원 정보 조회가 포함되므로 개인정보 마스킹과 조회 이력 기록을 함께 설계할 계획입니다
역할이 늘어날 때 화면 분기가 흩어지지 않
권한 매트릭스를 데이터로 두고 공통 검사 함수를 쓸 계획입니다
핵심 기능 상세
예약 현황 대시보드
오늘 접수된 예약과 처리가 필요한 변경·취소 요청, 지점별 문의 대기 건이 한 화면에 모입니다. 요청 줄을 누르면 해당 처리 화면으로 이동합니다.
- 역할별 지점 범위를 쿼리 조건으로 강제해 집계 단계에서 권한 분리
- 처리 대기 건을 상태 인덱스로 조회해 대시보드 목록 구성
- Express 미들웨어에서 역할 검사를 공통 적용
대시보드의 건수와 목록이 같은 쿼리 결과를 쓰도록 설계해 숫자와 목록의 불일치를 막습니다.
예약 관리와 스케줄 슬롯 설정
예약 목록을 지점·진료과·상태로 거르고 상세에서 확정·변경·취소를 처리합니다. 슬롯 설정 화면에서는 지점별 진료 요일과 시간 간격, 휴진일을 정합니다.
- 슬롯 규칙 테이블과 예외 휴진일 테이블로 지점별 스케줄 모델링
- 규칙 변경 전 충돌 예약을 조회해 영향 범위를 미리 표시
- 상태 전이 검증을 사이트 쪽 API와 같은 서비스 계층으로 공유
슬롯 규칙 변경이 기존 예약에 미치는 영향을 저장 전에 보여 주는 구조를 설계합니다.
게시판·문의 관리
공지사항, 언론보도, FAQ 글을 작성·수정·삭제하고 방문자 문의에 답변합니다. 문의는 접수·답변 완료 상태로 나뉘고 지점별로 담당이 갈립니다.
- 콘텐츠 종류 필드로 세 게시판을 한 모델에서 관리
- 문의 상태와 답변 이력을 별도 테이블로 기록
- 삭제는 보관 처리 후 되돌릴 수 있게 설계
세 종류의 게시판을 한 콘텐츠 모델로 묶어 화면과 API를 재사용하는 구조를 설계합니다.
통계와 지점 권한·감사 로그
예약과 문의 추이를 지점·기간별로 보고, 지점 관리자와 본사 관리자의 권한을 설정합니다. 누가 어떤 설정을 바꿨는지 감사 로그로 남습니다.
- 기간·지점 단위 집계를 SQL 뷰로 두고 차트 데이터로 사용
- 권한 매트릭스를 데이터로 저장하고 라우트와 버튼 양쪽에서 검사
- 설정 변경을 감사 로그 테이블에 변경 전후 값과 함께 기록
권한 설정과 감사 로그를 같은 서비스 계층에서 처리해 설정 변경이 항상 기록되도록 설계합니다.
프로젝트 진행 단계
관리 범위와 권한 모델 설계 · 2026.10
역할·지점 범위·권한 매트릭스와 감사 로그 구조 정의
관리 API 개발 · 2026.10
예약 처리, 슬롯 규칙, 게시판·문의, 통계 집계 API 구현
콘솔 화면 개발 · 2026.10
대시보드, 예약 관리, 슬롯 설정, 게시판·문의, 통계, 권한 화면 구현
운영 환경과 인수인계 · 2026.10
Staging·Production 분리 배포와 백업 확인 경로, 운영 매뉴얼 작성
개발 결과
기술적 주안점
- 대시보드의 건수와 목록이 같은 쿼리 결과를 쓰도록 설계해 숫자와 목록의 불일치를 막습니다
- 슬롯 규칙 변경이 기존 예약에 미치는 영향을 저장 전에 보여 주는 구조를 설계합니다
- 세 종류의 게시판을 한 콘텐츠 모델로 묶어 화면과 API를 재사용하는 구조를 설계합니다
