← 포트폴리오 목록
전사 운영 관제 및 결재 통합 플랫폼
보건복지 분야 비영리 특수법인을 위해 근태·출장 결재, 차량 배차, 외부 그룹웨어 연동을 하나의 관제 콘솔로 통합해 13개 사업장의 운영 현황을 실시간으로 파악할 수 있는 확장 플랫폼을 React + Node.js + Redis 기반으로 설계·구현합니다.
결재·배차 통합 관제 뷰 설계근태·출장 결재와 차량 배차 상태를 하나의 상태 스트립으로 합산하는 집계 로직을 구현합니다
비동기 결재 처리 큐 구축Bull Queue로 결재 승인·반려 이벤트를 비동기 처리해 다단계 결재선 병목을 분산하는 구조를 설계합니다
외부 그룹웨어 연동 어댑터 설계웹훅과 REST 어댑터로 계정·결재 이벤트를 외부 그룹웨어 규격에 맞춰 변환하는 인터페이스를 구현합니다
Overview
프로젝트 개요
보건복지 분야 비영리 특수법인을 위해 근태·출장 결재, 차량 배차, 외부 그룹웨어 연동을 하나의 관제 콘솔로 통합해 13개 사업장의 운영 현황을 실시간으로 파악할 수 있는 확장 플랫폼을 React + Node.js + Redis 기반으로 설계·구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
다단계 결재선(기안-검토-승인)의 병렬·순차 혼합 구조를 안정적으로 처리해야 하며
상태 머신 기반 결재 엔진과 큐 재시도 정책으로 대응합니다
차량 배차와 출장 신청이 동시에 몰릴 때 동일 차량 중복 배정이 발생할 리스크
배차 트랜잭션에 낙관적 잠금을 적용해 대응합니다
외부 그룹웨어 시스템의 API 규격과 인증 방식이 확정되지 않은 상태에서 연동 인터페이스를 설계해야 하며
어댑터 패턴으로 프로토콜 계층을 분리해 대응합니다
13개 사업장의 배차·결재 현황을 하나의 관제 화면에 실시간 반영해야 하며
WebSocket 채널을 사업장 단위로 분리 구독하는 구조로 대응합니다
구현 내용
핵심 기능 상세
핵심 기능 1
전사 운영 관제 대시보드
13개 사업장의 결재 대기, 배차 현황, 재고 알림을 하나의 관제 화면에서 실시간으로 확인할 수 있는 통합 대시보드를 구현합니다
핵심 기능 2
근태·출장 결재 워크플로우
출퇴근 근태 등록부터 출장 신청, 다단계 결재선 처리까지 하나의 타임라인 뷰에서 진행 상태를 추적할 수 있는 화면을 구현합니다
핵심 기능 3
차량 배차 및 운행 관리
출장 신청과 연계된 차량 배차 요청을 접수하고, 차량별 운행 일정 충돌을 방지하며 배정하는 화면을 구현합니다. 배차 요청 시간대와 기존 운행 일정을 대조해 중복 배정을 차단하고, 대안 차량을 추천합니다
핵심 기능 4
외부 그룹웨어 연동 인터페이스
사내에서 사용 중인 메신저 기반 그룹웨어와 계정·결재 이벤트를 주고받는 연동 인터페이스를 어댑터 구조로 구현합니다
구현 과정
프로젝트 진행 단계
STEP 1
운영 관제 데이터 모델 및 상태 집계 설계
결재·배차·재고 상태를 하나의 관제 뷰로 합산하는 집계 테이블과 이벤트 스키마 설계
STEP 2
결재·배차 워크플로우 엔진 개발
Bull Queue 기반 결재선 처리 및 배차 배정 로직을 Express API로 구현
STEP 3
관제 콘솔 UI 구현
상태 스트립·타임라인·우선순위 큐로 구성된 command-tower 화면을 React로 구현
STEP 4
외부 그룹웨어 연동 인터페이스 개발
계정·결재 이벤트를 외부 시스템에 전달하는 웹훅 기반 연동 인터페이스 구현
STEP 5
실시간 알림 및 통합 검증
WebSocket 기반 관제 알림 스트림 구현, 결재·배차 시나리오 통합 테스트 수행
프로젝트 성과
주요 성과
결재·배차 통합 관제 뷰 설계근태·출장 결재와 차량 배차 상태를 하나의 상태 스트립으로 합산하는 집계 로직을 구현합니다
비동기 결재 처리 큐 구축Bull Queue로 결재 승인·반려 이벤트를 비동기 처리해 다단계 결재선 병목을 분산하는 구조를 설계합니다
외부 그룹웨어 연동 어댑터 설계웹훅과 REST 어댑터로 계정·결재 이벤트를 외부 그룹웨어 규격에 맞춰 변환하는 인터페이스를 구현합니다
차량 배차 충돌 검증 로직 구현동일 시간대 중복 배차를 방지하는 스케줄 겹침 검증과 대안 차량 추천 로직을 설계합니다
Highlights
기술적 주안점
- 상태 스트립-타임라인-우선순위 큐 3단 구조의 관제 콘솔을 설계해 여러 업무 모듈의 현황을 하나의 화면에서 실시간으로 통합합니다
- 결재선을 하드코딩된 조건문이 아닌 상태 머신으로 모델링해 사업장별로 다른 결재 단계 구성을 유연하게 확장 가능한 구조로 설계합니다
- DB 제약조건과 애플리케이션 로직을 함께 사용해 배차 충돌을 이중으로 방지하는 구조를 구현합니다
