병원 식수관리 시스템

대학병원 직원 식사 운영을 위한 내부 웹 시스템입니다. 근린·정석 식권, 추가식수, 이동배식 신청과 부서장 확인, 관리자 집계, 식당 단말기 차감을 하나의 체계로 통합했습니다. 납품 후 유지보수 계약으로 운영 요청을 반영하고 있습니다.

프로젝트 개요

• 범위: 직원·부서 관리자·시스템 관리자 웹 화면, 신청·확인·집계 업무 로직, 인사 DB 및 식당 단말기 데이터 연동, 배치 처리, 엑셀 내보내기, 서버 배포
• 운영 형태: 상시 운영 업무 시스템. 사번 기반 로그인, 권한별 메뉴
• 연동 대상: 인사 DB(재직·부서·직종), 식당 단말기 사용 이력 DB

주요 기능

• 직원: 나의 식수 현황(고정식·이월식·추가식 사용과 잔여), 근린·정석 식권 신청, 추가식수·이동배식 신청과 본인 이력 조회
• 부서 관리자: 부서원 대리 신청·일괄 신청, 부서 신청 내역 확인·취소, 부서장 확인 처리
• 시스템 관리자: 전체 신청 내역 관리, 식수현황 집계표(일별×끼니×단말기), 식수관리현황표, 근린/정석 집계표, 식수 사용 등록, 고정식 등록·변경, 공휴일·마감·식사시간 설정, 메뉴 권한·운영자 관리
• 엑셀 내보내기 8종(신청 내역·집계표·사용 현황 등)과 당월 입사자 일괄 등록(엑셀 업로드)

시스템 구성

• 프론트엔드: React, TypeScript, Ant Design. 화면별 코드 분할과 ETag 기반 캐시로 초기 로딩 최적화
• 백엔드: Spring Boot(Java 17), Spring Security, JPA, Swagger 문서화
• 데이터: MS SQL Server. 인사 DB와 식수 DB가 분리되어 있어 사번 키로 애플리케이션 계층에서 병합
• 인증·권한: JWT(액세스·리프레시 토큰), 20분 유휴 자동 로그아웃, 권한 코드별 메뉴 매핑(DB 관리), 복수 권한 보유자는 로그인 시 권한 선택
• 배포: 프론트를 백엔드 JAR에 내장한 단일 실행 파일, systemd 서비스 등록, 리버스 프록시 선택 적용

업무 규칙 구현

• 신청 상태: 신청 → 승인 → 취소. 승인 취소는 이력 보존을 위해 중간 상태와 신규 행으로 기록
• 부서장 확인은 신청 상태와 별도로 관리하여 집계표에서 확인·미확인·취소를 구분
• 마감 규칙: 월별 신청 기간·시간·한도(근린/정석), 끼니별 마감 시각(이동배식·추가식수)을 설정 화면에서 관리
• 차감 우선순위: 이월분(2개월 전 → 1개월 전) → 추가분 → 고정식. 단말기 태깅과 이동배식은 각각의 순서를 적용하고, 취소 시 차감 기록까지 역순 복원
• 배치: 매월 1일 고정식 일괄 부여, 추가식수 만료 자동 처리, 관리자 수동 실행 화면 제공

성능·운영

• 대량 조회 화면(고정식 변경)의 응답 시간을 13초대에서 1초 미만으로 개선. DB 페이징과 일괄 조회로 쿼리 수를 99% 이상 감소
• 엑셀 다운로드는 서버 스트리밍 방식으로 통일하여 대량 데이터에서도 브라우저 부담 없이 처리
• 통합 예외 처리와 표준 응답 형식, 운영 환경 API 문서·소스맵 비활성화