플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - 입주 전 사전 점검과 입주 후 하자 신고를 동일 호수 기준으로 시점 구분하여 일관성 있게 저장·조회하는 데이터 모델 설계 필요 - 동일 하자에 대한 복수 담당자 동시 배정 요청 발생 시 충돌 없이 단일 배정을 보장하는 동시성 제어 전략 설계 필요 - 하자 사진 대용량 업로드 시 원본 보존·썸네일 생성·S3 저장을 단일 미들웨어 파이프라인으로 처리하는 비동기 구조 설계
프로젝트 성과
하자 상태 전이 State Machine 미들웨어 구현
접수→확인→처리중→완료·반려 5단계 전이 규칙을 서버 미들웨어에서 검증, 불법 전이 시 409 반환하는 방어적 아키텍처 설계
동시 배정 충돌 방지 트랜잭션 설계
PostgreSQL Advisory Lock으로 동시 배정 요청 직렬화, 실패 시 Bull Queue 지연 재시도 등록하는 2단계 충돌 방지 구조 구현
다중 조건 동적 필터 쿼리 빌더 설계
동·호수·유형·상태·날짜 범위 5개 조건 조합 Prisma 동적 where 빌더 구현, URL searchParams 양방향 동기화로 필터 상태 공유 설계
입주 전후 시점 분리 아카이브 스키마 구축
inspection_type 구분 복합 인덱스(unit_id, type, created_at) 설계, 호수별 before/after 사진 이력 조회 쿼리 구조 최적화
Materialized View 기반 대시보드 집계 파이프라인 설계
일별·주별·동별 3종 Materialized View 구현, REFRESH CONCURRENTLY로 조회 부하 없이 주기적 갱신 가능한 집계 아키텍처 구축
핵심 기능
통합 현황 대시보드
전체 단지의 하자 접수·처리 현황을 카드와 차트로 한눈에 파악할 수 있는 메인 대시보드
진행 단계
하자 도메인 분석 및 데이터 모델 설계
2026.03.
아파트 하자 접수·처리 업무 프로세스 분석, PostgreSQL 테이블 24개 및 복합 인덱스 설계, 상태 전이 규칙 정의
프로젝트 상세
1) 포트폴리오 소개 신축 아파트 및 오피스텔 입주 전후 하자 사진 기록·처리 현황을 통합 관리하는 웹 기반 관리자 시스템을 React + Node.js 기반으로 설계·구현. 하자 접수부터 처리 완료까지 단계별 워크플로우, 동·호수별 현황판, 처리자 배정 기능을 포함한 풀스택 대시보드를 구축. 2) 작업 범위 - 통합 현황 대시보드: 전체 단지의 하자 접수·처리 현황을 카드와 차트로 한눈에 파악할 수
