← 포트폴리오 목록
다지점 QR 보고서 관리 통합 콘솔
QR 발급 현황을 관제탑 형태로 통합 모니터링하고, 대량 보고서 배치 업로드와 자동 QR 일괄 발급, 보안 접근 감사로그, 다지점·다중 담당자 계층형 권한 관리까지 통합하는 확장 콘솔을 같은 Node.js 스택 위에 인프라를 더해 설계·구현합니다.
발급 이벤트 집계 파이프라인 설계PostgreSQL Materialized View로 일별·고객사별 QR 발급 데이터를 증분 집계하는 구조 구현
비동기 배치 처리 큐 아키텍처 구축Bull Queue와 Redis 기반으로 대량 업로드 작업을 분산 처리하고 실패 건 재시도 정책을 설계
규칙 기반 이상 접근 탐지 로직 구현짧은 시간 반복 조회 패턴을 감지하는 규칙 엔진과 Redis 카운터 캐싱 구조를 설계
Overview
프로젝트 개요
QR 발급 현황을 관제탑 형태로 통합 모니터링하고, 대량 보고서 배치 업로드와 자동 QR 일괄 발급, 보안 접근 감사로그, 다지점·다중 담당자 계층형 권한 관리까지 통합하는 확장 콘솔을 같은 Node.js 스택 위에 인프라를 더해 설계·구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
대량 배치 업로드 중 일부 파일이 실패했을 때 전체 작업을 롤백하지 않고 실패 건만 격리해 재처리하는 큐 설계
감사 로그 데이터가 누적될수록 조회 성능이 저하되지 않
인덱싱과 파티셔닝 전략을 함께 고려한 설계 필요
고객사-지점-담당자 계층 구조에서 상위 권한이 하위로 위임된 뒤 회수될 때 즉시 접근을 차단하는 세션 무효화 로직
다지점 롤업 집계와 지점별 개별 조회가 동시에 정확한 값을 반환하
집계 쿼리와 실시간 필터를 일치시키는 설계 필요
구현 내용
핵심 기능 상세
핵심 기능 1
발급 현황
QR 발급 건수, 최근 발급 이벤트 타임라인, 재발급 대기 등 우선 대응이 필요한 항목을 한 화면에서 확인할 수 있는 통합 관제 대시보드입니다
핵심 기능 2
배치 업로드
이미 발급된 기존 보고서를 대량으로 업로드하고 QR을 일괄 생성할 수 있는 배치 처리 화면입니다. Bull Queue로 업로드 작업을 비동기 처리하고, 진행률과 실패 건을 별도로 추적하는 큐 대시보드를 구성합니다
핵심 기능 3
감사 로그
누가 언제 어떤 보고서·QR에 접근했는지 기록하고, 비정상 접근 패턴을 탐지해 보여주는 보안 감사 화면입니다
핵심 기능 4
지점 계정 관리
고객사가 여러 지점·다중 담당자 계정을 운영할 수 있도록 계정을 그룹으로 묶어 관리하는 화면입니다
구현 과정
프로젝트 진행 단계
STEP 1
발급 이력 집계 구조 및 관제 대시보드 설계
Materialized View 기반 발급 이벤트 집계 설계, 상태바·타임라인·우선순위 큐 레이아웃 구성
STEP 2
배치 업로드 큐 인프라 구축
Bull Queue와 Redis 연동, 대량 업로드 비동기 처리 및 재시도 로직 구현
STEP 3
감사 로그 및 이상 탐지 모듈 개발
감사 로깅 미들웨어 적용, 규칙 기반 이상 접근 탐지 로직 및 관리자 조회 화면 구현
STEP 4
다지점 계층형 권한 모델 확장
고객사-지점-담당자 3단계 데이터 모델 확장, 위임형 RBAC 및 롤업 조회 뷰 구현
STEP 5
통합 테스트 및 연동 검증
배치·감사·다지점 기능 통합 테스트 케이스 작성, API-프론트엔드 연동 검증
프로젝트 성과
주요 성과
발급 이벤트 집계 파이프라인 설계PostgreSQL Materialized View로 일별·고객사별 QR 발급 데이터를 증분 집계하는 구조 구현
비동기 배치 처리 큐 아키텍처 구축Bull Queue와 Redis 기반으로 대량 업로드 작업을 분산 처리하고 실패 건 재시도 정책을 설계
규칙 기반 이상 접근 탐지 로직 구현짧은 시간 반복 조회 패턴을 감지하는 규칙 엔진과 Redis 카운터 캐싱 구조를 설계
계층형 위임 RBAC 모델 설계고객사-지점-담당자 3단계 권한 위임 구조와 롤업 집계 뷰를 구현
Review
기술적 주안점
- 슬림 상태바와 타임라인, 우선순위 큐를 결합한 관제탑형 레이아웃으로 대량 발급 데이터를 한눈에 파악할 수 있는 대시보드를 설계합니다
- 수백 건 단위의 기존 보고서를 큐 기반으로 처리하여 메인 스레드 부하 없이 배치 작업을 완료하는 구조를 구현합니다
- 감사 로그와 이상 탐지를 결합해 보고서·QR 접근에 대한 추적 가능성을 확보하는 보안 계층을 구현합니다
