다중 현장 공사기간 검토 관리 플랫폼
설계·구현 참고 자료 — 고객 납품 실적으로 구분된 항목이 아닙니다.
단일 현장 산정 도구를 넘어, 여러 현장의 공사기간 검토를 칸반 보드로 동시에 추적하고 승인 워크플로우·이력 아카이브·리스크 분석 대시보드까지 통합하는 플랫폼을 설계합니다.
프로젝트 개요
단일 현장 산정 도구를 넘어, 여러 현장의 공사기간 검토를 칸반 보드로 동시에 추적하고 승인 워크플로우·이력 아카이브·리스크 분석 대시보드까지 통합하는 플랫폼을 설계합니다. FastAPI + Celery 비동기 큐로 다건 보고서 생성을 병렬 처리하는 구조를 구현합니다.
작업 범위
- 다중 현장 검토 현황판: 여러 현장의 공사기간 검토 건을 접수·검토중·보고서작성·승인완료 단계별 칸반 컬럼으로 한눈에 파악합니다
- 검토 이력 아카이브 및 버전 비교: 완료된 검토 건의 보고서 버전을 아카이브에 보관하고, 재검토 시 이전 버전과의 산정 근거 차이를 비교합니다
- 팀 협업 및 승인 워크플로우: 검토 담당자·승인자 역할을 구분해 다단계 승인 체인을 진행하고, 각 단계에서 코멘트로 협업합니다
- 현장별 리스크 관리자 분석 대시보드: 전체 현장의 비작업일수 리스크와 검토 처리 현황을 지역별 히트맵과 통계로 시각화하는 관리자 전용 대시보드입니다
주요 업무
- 다중 현장 검토 현황판 화면: 각 검토 건을 카드로 표현해 담당자·마감일·리스크 태그를 표시하고, 드래그 앤 드롭으로 단계를 전환하면 상태 머신 검증을 거쳐 이력을 기록합니다
- 검토 이력 아카이브 및 버전 비교 화면: 보고서 스냅샷을 JSONB로 버전별 저장하고, 두 버전을 선택하면 비작업일수·공기 산정값의 변경분을 하이라이트로 표시합니다
- 팀 협업 및 승인 워크플로우 화면: 역할 기반 권한으로 승인 가능 단계를 제한하고, 반려 시 사유와 함께 이전 단계로 자동 회귀시키며 코멘트 스레드를 카드별로 유지합니다
- 현장별 리스크 관리자 분석 대시보드 화면: 현장 좌표 기준 비작업일수 리스크를 Materialized View로 집계해 지도 히트맵으로 표시하고, 단계별 평균 처리 소요일을 관리자에게 제공합니다
프로젝트 핵심 과제
다중 현장의 검토 단계를 동시에 추적하면서 담당자별 병목 구간을 식별하는 지표 설계
승인 반려 시 이전 산정 근거와 재작업 이력을 함께 추적하는 버전 관리 구조 설계
Celery 비동기 큐에서 보고서 생성 작업 실패 시 재시도와 알림을 처리하는 오류 복구 전략
현장별 기상 리스크를 지도에 시각화할 때 다수 마커의 렌더링 성능을 유지하는 최적화
핵심 기능 상세
다중 현장 검토 현황판
여러 현장의 공사기간 검토 건을 접수·검토중·보고서작성·승인완료 단계별 칸반 컬럼으로 한눈에 파악합니다.
- 드래그 앤 드롭 상태 전이 시 허용된 전이 경로만 통과시키는 상태 머신 검증 로직 구현
- 칸반 카드에 담당자·마감일·리스크 태그를 표시하고 필터/정렬을 URL 상태와 동기화
- React Query로 카드 목록을 캐싱하고 Optimistic UI로 드래그 전환을 즉시 반영
상태 머신 기반 전이 검증과 Optimistic UI를 결합해, 다건 검토 건을 안전하게 병렬 관리하는 칸반 보드를 구현합니다.
검토 이력 아카이브 및 버전 비교
완료된 검토 건의 보고서 버전을 아카이브에 보관하고, 재검토 시 이전 버전과의 산정 근거 차이를 비교합니다.
- PostgreSQL JSONB 컬럼으로 보고서 버전별 산정 데이터 스냅샷 저장
- 두 버전 선택 시 필드 단위 diff를 계산해 변경된 산정값을 하이라이트 표시
- AWS S3에 버전별 PDF 원본을 보관하고 서명된 URL로 다운로드 제공
버전 스냅샷과 필드 diff 계산을 결합해, 재검토 시 무엇이 왜 바뀌었는지 추적 가능한 아카이브 구조를 구현합니다.
팀 협업 및 승인 워크플로우
검토 담당자·승인자 역할을 구분해 다단계 승인 체인을 진행하고, 각 단계에서 코멘트로 협업합니다.
- 역할 기반 접근 제어로 승인 권한을 단계별로 제한하는 미들웨어 구현
- 반려 사유를 기록하고 해당 카드를 이전 단계로 자동 회귀시키는 워크플로우 로직
- 카드별 코멘트 스레드를 WebSocket으로 실시간 동기화
역할 기반 승인 체인과 실시간 코멘트 스레드를 결합해, 다중 담당자가 하나의 검토 건을 안전하게 협업하는 구조를 구현합니다.
현장별 리스크 관리자 분석 대시보드
전체 현장의 비작업일수 리스크와 검토 처리 현황을 지역별 히트맵과 통계로 시각화하는 관리자 전용 대시보드입니다.
- PostgreSQL Materialized View로 지역별 비작업일수 리스크 집계 테이블 설계
- 지도 히트맵 컴포넌트로 현장 좌표 기반 리스크 분포 시각화
- 단계별 평균 처리 소요일과 병목 구간을 Recharts로 시각화
Materialized View 기반 집계와 지도 히트맵을 결합해, 관리자가 다건 현장의 리스크를 한 화면에서 파악하는 분석 대시보드를 구현합니다.
프로젝트 진행 단계
다중 프로젝트 칸반 보드 및 상태 전이 엔진 설계 · 2026.09
칸반 상태 머신 모델링, 드래그 앤 드롭 카드 이동과 전이 검증 로직 구현
권한 계층별 승인 워크플로우 및 코멘트 시스템 개발 · 2026.09
역할 기반 승인 체인 API 구현, WebSocket 기반 카드별 코멘트 스레드 개발
이력 아카이브 버전 비교 뷰 및 리스크 분석 대시보드 구현 · 2026.09
JSONB 버전 스냅샷과 diff 뷰 구현, Materialized View 기반 지역별 리스크 히트맵 개발
Celery 비동기 큐 통합 및 통합 테스트 · 2026.09
다건 보고서 생성 비동기 큐 연동, 전체 워크플로우 통합 테스트 및 성능 검증
개발 결과
기술적 주안점
- 상태 머신 기반 전이 검증과 Optimistic UI를 결합해, 다건 검토 건을 안전하게 병렬 관리하는 칸반 보드를 구현합니다
- 버전 스냅샷과 필드 diff 계산을 결합해, 재검토 시 무엇이 왜 바뀌었는지 추적 가능한 아카이브 구조를 구현합니다
- 역할 기반 승인 체인과 실시간 코멘트 스레드를 결합해, 다중 담당자가 하나의 검토 건을 안전하게 협업하는 구조를 구현합니다
