인프라 점검 데이터 업로드 플랫폼의 MVP 이후를 확장한 관리자 운영 콘솔 구현한 프로젝트입니다.
인프라 점검 데이터 업로드 플랫폼의 MVP 이후를 확장한 관리자 운영 콘솔 구현한 프로젝트입니다. 접수완료→분석중→분석완료→보완요청 상태를 칸반 보드로 관리하고, 회원·권한 관리, 결과물 업로드 자동화, 외부 분석 서버 연동 API와 처리 현황 통계까지 React + Node.js 기반으로 통합 구현합니다.
작업 범위
주요 업무



단일 소스(내부 API)로 동기화하는 아키텍처 설계 필요
접수완료→분석중→분석완료→보완요청 네 단계로 점검 건을 칸반 보드에 배치해, 관리자가 현재 처리 중인 작업량과 지연 건을 한눈에 파악하고 카드 단위로 상태를 전환할 수 있는 작업 관리 화면입니다.
칸반 보드의 컬럼 이동을 내부 API 단일 경로로 처리해, 이후 외부 분석 서버가 같은 API로 상태를 자동 갱신할 수 있는 확장 구조를 설계합니다.


전체 회원 목록을 조회하고 계정별 이용 권한을 수동으로 부여·회수하는 관리자 화면입니다. 권한 상태는 사용자 화면의 구매 문의 분기와 동일한 데이터를 공유합니다.
권한 변경 API와 사용자단 라우트 가드가 동일한 판정 함수를 공유하도록 설계해 관리자 조작과 사용자 화면 노출이 항상 일치하도록 구현합니다.


관리자가 분석 완료된 결과 HTML을 업로드하면 해당 점검의 상태가 자동으로 분석완료로 전환되어 사용자에게 즉시 노출되는 처리 화면입니다.
결과 업로드~상태 전환~알림 발송을 하나의 서버 트랜잭션 경계로 묶어, 상태 불일치 없이 사용자에게 결과가 노출되도록 설계합니다.


외부 분석 서버가 신규 작업 조회·입력 데이터 다운로드·상태 갱신·결과 업로드를 동일 API로 자동 처리할 수 있도록 인증 API와 문서를 제공하고, 처리 현황을 통계 위젯으로 함께 보여줍니다.
외부 분석 서버가 관리자와 동일한 내부 API를 API 키로 호출하도록 설계해, 향후 수동 업로드를 자동 처리로 전환할 때 화면 로직 변경 없이 확장 가능한 구조를 구현합니다.


점검 상태 전이 규칙(접수완료→분석중→분석완료→보완요청) 정의, 권한·로그 테이블 스키마 설계
React 기반 칸반 보드, 회원 검색·권한 토글 화면, 감사 로그 조회 UI 구현
Bull Queue 기반 비동기 알림, 결과 업로드-상태전환 트랜잭션, Redis 캐시 적용
API 키 인증 미들웨어, OpenAPI 문서 자동화, Recharts 기반 처리 현황 위젯 구현