← 포트폴리오 목록

외벽 점검 단지 현황 및 배치 분석 콘솔

MVP 이후 확장 방향으로, 단지 단위 배치 분석 큐와 진행 상태, 입면 파손 분포 인사이트, 심각도 기준 설정, 점검 메타데이터 관리를 통합한 콘솔을 구현합니다.

프로젝트 납품 요약

아래 프로젝트 개요와 핵심 기능에서 구현 화면을 확인할 수 있습니다.

서비스 타입Web
업종CRM 서비스
기술 스택
ReactTailwind CSSRechartsNode.jsExpressPostgreSQLPrismaRedisBull Queue
주요 기능
  • 단지 파손 현황 인사이트
  • 배치 분석 큐·진행 현황
  • 탐지 기준·심각도 규칙 설정
  • 점검 메타데이터·보고서 이력

프로젝트 개요

범위: 개발, 디자인, 기획

MVP 이후 확장 방향으로, 단지 단위 배치 분석 큐와 진행 상태, 입면 파손 분포 인사이트, 심각도 기준 설정, 점검 메타데이터 관리를 통합한 콘솔을 구현합니다. P1과 같은 Node.js 스택에 Redis 기반 작업 큐를 더해 1.5만 장 규모 사진을 다루는 구조를 설계합니다.

작업 범위

  • 단지 파손 현황 인사이트: 단지 전체의 동별·면별 파손 분포와 심각도 구성을 한 화면의 대형 차트와 보조 위젯으로 확인합니다
  • 배치 분석 큐·진행 현황: 1.5만 장 규모 사진의 분석 작업 진행률을 단지·그룹별로 확인하고 실패 건을 재시도하거나 이어서 실행합니다
  • 탐지 기준·심각도 규칙 설정: 탐지 신뢰도 임계값과 심각도 등급 규칙을 단지별로 조정하고 샘플 사진에 미리 적용해 결과 변화를 확인합니다
  • 점검 메타데이터·보고서 이력: 촬영일, 점검자, 점검 소요 시간을 그룹 단위로 기록하고 생성된 엑셀 보고서의 이력을 조회합니다

주요 업무

  • 단지 파손 현황 인사이트 화면: 입면 히트맵을 주인공으로 두고 심각도 도넛, 구역별 막대, 최근 점검 타임라인을 보조 위젯으로 배치합니다
  • 배치 분석 큐·진행 현황 화면: 작업 큐 상태, 처리 속도 추이, 실패 사유별 목록을 한 화면에서 보고 재개 조작을 제공합니다
  • 탐지 기준·심각도 규칙 설정 화면: 규칙 버전을 저장하고 샘플 사진 묶음에 적용한 결과를 이전 버전과 나란히 비교합니다
  • 점검 메타데이터·보고서 이력 화면: 점검 일정과 담당자 정보를 입력하고 보고서 생성 이력을 단지·버전별로 관리합니다
외벽 점검 단지 현황 및 배치 분석 콘솔
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

1.5만 장 규모 배치에서 동시 실행 수와 메모리 사용량을 조절하는 큐 동시성 설정 전략이 필요합니다

탐지 결과가 규칙 버전에 따라 달라지므로 과거 보고서와 현재 집계를 구분해 보여주는 버전 추적 설계가 필요합니다

입면도 기준 히트맵을 만들려면 사진과 동·면 위치를 연결하는 그룹 지정 규칙이 정리되어야 하며 단계적 입력 방식을 계획합니다

추론 실행 환경이 GPU 또는 장시간 CPU 중 어느 쪽인지에 따라 큐 처리량 설계가 달라져 환경 확인 후 조정이 필요합니다

구현 내용

핵심 기능 상세

핵심 기능 1

단지 파손 현황 인사이트

단지 전체의 동별·면별 파손 분포와 심각도 구성을 한 화면의 대형 차트와 보조 위젯으로 확인합니다. 입면 히트맵을 주인공으로 두고 심각도 도넛, 구역별 막대, 최근 점검 타임라인을 보조 위젯으로 배치합니다.

  • PostgreSQL Materialized View로 동·면·심각도별 집계를 사전 계산
  • Recharts 기반 입면 히트맵과 도넛·막대 위젯을 동일한 필터 상태로 연동
  • 집계 갱신 시점을 화면에 표기하여 보는 데이터의 기준 시각을 명확히 제공

동·면 좌표 기준 파손 집계를 입면도 형태로 시각화하여 예시 보고서의 요약 구성과 같은 관점을 제공하는 구조를 설계합니다.

단지 파손 현황 인사이트
단지 파손 현황 인사이트 실제 화면
핵심 기능 2

배치 분석 큐·진행 현황

1.5만 장 규모 사진의 분석 작업 진행률을 단지·그룹별로 확인하고 실패 건을 재시도하거나 이어서 실행합니다. 작업 큐 상태, 처리 속도 추이, 실패 사유별 목록을 한 화면에서 보고 재개 조작을 제공합니다.

  • Bull Queue와 Redis로 사진 단위 분석 작업을 분산하고 동시 실행 수를 설정으로 제한
  • 작업 상태를 DB에 체크포인트로 기록하여 중단 후 완료 건을 건너뛰고 재개
  • Server-Sent Events로 진행률을 화면에 실시간 반영

실패 건만 골라 재시도하고 중단 지점부터 이어가는 재개형 배치 구조를 구현합니다.

배치 분석 큐·진행 현황
배치 분석 큐·진행 현황 실제 화면
핵심 기능 3

탐지 기준·심각도 규칙 설정

탐지 신뢰도 임계값과 심각도 등급 규칙을 단지별로 조정하고 샘플 사진에 미리 적용해 결과 변화를 확인합니다. 규칙 버전을 저장하고 샘플 사진 묶음에 적용한 결과를 이전 버전과 나란히 비교합니다.

  • 규칙을 버전 단위로 저장하고 단지별 적용 버전을 관리
  • 샘플 사진 묶음에 대한 미리 보기 재계산을 별도 작업으로 분리
  • 공개 데이터셋 평가 결과와 임계값 설정 이력을 함께 기록

탐지 품질이 모델과 데이터에 의존한다는 전제 아래 샘플 기반으로 기준을 보정하는 설정 구조를 설계합니다.

탐지 기준·심각도 규칙 설정
탐지 기준·심각도 규칙 설정 실제 화면
핵심 기능 4

점검 메타데이터·보고서 이력

촬영일, 점검자, 점검 소요 시간을 그룹 단위로 기록하고 생성된 엑셀 보고서의 이력을 조회합니다. 점검 일정과 담당자 정보를 입력하고 보고서 생성 이력을 단지·버전별로 관리합니다.

  • 그룹 단위 메타데이터 일괄 입력과 사진 단위 개별 수정을 함께 지원
  • 보고서 파일을 S3 호환 스토리지에 저장하고 서명 URL로 내려받기 제공
  • 점검자 권한에 따라 수정 가능한 필드를 제한하는 역할 기반 접근 제어 적용

점검 메타데이터와 보고서 이력을 연결하여 어떤 기준으로 만든 보고서인지 추적할 수 있는 구조를 구현합니다.

점검 메타데이터·보고서 이력
점검 메타데이터·보고서 이력 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

집계 모델과 작업 큐 구조 설계 · 2026.10

동·면·심각도 집계 뷰, 작업 체크포인트 테이블, Redis 큐 토폴로지 설계

STEP 2

배치 분석 워커 및 재개 로직 구현 · 2026.10

Bull Queue 워커, 실패 분류, 중단 후 재개 API 구현

STEP 3

인사이트 보드 및 규칙 설정 화면 개발 · 2026.10

Recharts 히트맵·도넛·막대 위젯과 규칙 버전 비교 화면 구현

STEP 4

보고서 이력 및 권한 체계 적용 · 2026.10

서명 URL 다운로드, 점검 메타데이터 입력, 역할별 수정 권한 적용

개발 결과

재개형 배치 분석 큐 구조 설계Bull Queue와 DB 체크포인트로 중단 지점부터 이어가는 사진 단위 분석 큐 구현, 실패 사유별 재시도 정책 적용
입면 단위 파손 집계 뷰 구축Materialized View로 동·면·심각도 집계를 사전 계산하고 위젯 간 필터 상태를 공유하는 구조 설계
버전형 심각도 규칙 비교 기능 구현규칙 버전을 저장하고 샘플 사진 묶음에 적용한 결과를 나란히 비교하는 미리 보기 구조 구축
보고서 이력 추적 체계 설계보고서와 규칙 버전·담당자를 연결해 생성 기준을 추적하고 서명 URL로 내려받는 구조 구현

기술적 주안점

  • 동·면 좌표 기준 파손 집계를 입면도 형태로 시각화하여 예시 보고서의 요약 구성과 같은 관점을 제공하는 구조를 설계합니다
  • 실패 건만 골라 재시도하고 중단 지점부터 이어가는 재개형 배치 구조를 구현합니다
  • 탐지 품질이 모델과 데이터에 의존한다는 전제 아래 샘플 기반으로 기준을 보정하는 설정 구조를 설계합니다

유사한 프로젝트를 기획하고 계신가요?

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의