← 포트폴리오 목록
파이어허브 소방설계 팀 협업 분석 플랫폼
설계 팀원 간 CAD 도면 분석 공유·댓글·버전 관리, 관리자 법규 기준 설정, 버팀대 제품 카탈로그 연동, 분석 이력 통계 대시보드를 통합한 확장형 소방설계 협업 플랫폼을 FastAPI + SQLAlchemy + PostgreSQL + Redis 기반으로 설계·구현합니다.
소방법규 규칙 외부화 및 동적 적용 구조 설계법규 규칙을 PostgreSQL JSONB 컬럼으로 외부화하여 코드 수정 없이 관리자 UI에서 기준값 변경 후 즉시 다음 분석에 반영되는 구조 구현
SQLAlchemy 이벤트 훅 감사 추적 시스템 구현규칙 테이블 변경 시 event.listen 훅으로 변경자·변경 전후값·타임스탬프를 자동 기록, 관리자 감사 로그 전체 추적 구조 설계
마킹 좌표 기반 댓글 앵커 협업 구조 구현Canvas 마킹 오브젝트 ID를 댓글 앵커로 연결하는 PostgreSQL 스키마 설계, WebSocket 브로드캐스트로 팀원 간 실시간 마킹·댓글 동기화 구조 구현
Overview
프로젝트 개요
설계 팀원 간 CAD 도면 분석 공유·댓글·버전 관리, 관리자 법규 기준 설정, 버팀대 제품 카탈로그 연동, 분석 이력 통계 대시보드를 통합한 확장형 소방설계 협업 플랫폼을 FastAPI + SQLAlchemy + PostgreSQL + Redis 기반으로 설계·구현합니다. 팀 단위 프로젝트 관리와 법규 기준 자동 업데이트 구조를 포함하여 B2B SaaS 확장에 대응 가능한 멀티테넌트 아키텍처를 구축합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
팀원이 동일 도면을 동시 편집할 때 마킹 변경 충돌을 처리하는 WebSocket 브로드캐스트 순서 보장 및 Last-Write-Wins 정책 설계
소방법규 규칙이 버전별로 다른 분석 결과를 생성할 때 규칙 버전과 분석 결과를 정합성 있게 추적하는 외래키 연결 스키마 설계
대용량 CAD 도면 파일을 팀 멤버가 동시 업로드할 때 AWS S3 멀티파트 업로드와 Redis 업로드 세션 관리로 충돌 없이 처리하는 구조 설계
제품 카탈로그 CSV 업로드 중 일부 행 파싱 실패 시 전체 롤백 vs 부분 커밋을 선택하는 트랜잭션 전략 및 실패 행 리포트 제공 방안 설계
Redis 팀 집계 캐시와 PostgreSQL View의 데이터 동기화 시점 차이로 발생하는 대시보드 수치 불일치를 최소화하는 캐시 무효화 전략 설계
핵심 기능 1
팀 협업 분석 대시보드
팀별 분석 프로젝트 현황, 법규 준수율 추이, 미결 검토 항목 알림을 통합한 팀 협업 대시보드를 제공합니다
핵심 기능 2
도면 버전 관리 및 댓글
동일 도면의 분석 버전을 관리하고, 팀원이 마킹 위치에 직접 댓글을 달아 검토 의견을 공유할 수 있습니다
핵심 기능 3
관리자 법규 기준 설정
관리자가 소방 법규 규칙(버팀대 간격 기준, 하중 허용값, 배관 재질 물성)을 UI에서 직접 설정하고, 변경 이력을 관리합니다
핵심 기능 4
버팀대 제품 카탈로그 관리
소방설비 버팀대 제품 목록(규격·하중 한도·제조사)을 관리하고, 하중 검토 시 적합한 제품을 자동 추천합니다
구현 과정
프로젝트 진행 단계
STEP 1
멀티테넌트 도메인 모델링 및 법규 규칙 테이블 설계
팀·프로젝트·버전·댓글·법규규칙·제품 도메인 PostgreSQL 테이블 16개 정의, JSONB 규칙 컬럼 스키마 설계, SQLAlchemy ORM 매핑 및 Alembic 마이그레이션
STEP 2
FastAPI 백엔드 및 권한·감사 구조 개발
FastAPI API 38개 엔드포인트 구현, JWT Role Guard 미들웨어 설계, SQLAlchemy 이벤트 훅 기반 규칙 변경 감사 로그 자동 기록 구조 구현
STEP 3
실시간 협업 및 Redis 캐싱 파이프라인 구현
FastAPI WebSocket 마킹 실시간 브로드캐스트 구현, Redis Hash 집계 캐싱 구조 설계, PostgreSQL View 팀 집계 쿼리 최적화, SSE 알림 채널 구현
STEP 4
React SPA 및 제품 카탈로그 UI 개발
React 18 + TypeScript SPA 24개 화면 구현, TanStack Table 제품 카탈로그 복합 필터, Recharts 팀 분석 통계 차트 5종, 다크 테마 디자인 시스템 구축
STEP 5
통합 검증 및 권한 시나리오 점검
팀 역할별 접근 권한 시나리오 테스트 42개 케이스 작성, 규칙 변경 감사 로그 정합성 검증, CSV 업로드 파이프라인 엔드투엔드 테스트
프로젝트 성과
소방법규 규칙 외부화 및 동적 적용 구조 설계법규 규칙을 PostgreSQL JSONB 컬럼으로 외부화하여 코드 수정 없이 관리자 UI에서 기준값 변경 후 즉시 다음 분석에 반영되는 구조 구현
SQLAlchemy 이벤트 훅 감사 추적 시스템 구현규칙 테이블 변경 시 event.listen 훅으로 변경자·변경 전후값·타임스탬프를 자동 기록, 관리자 감사 로그 전체 추적 구조 설계
마킹 좌표 기반 댓글 앵커 협업 구조 구현Canvas 마킹 오브젝트 ID를 댓글 앵커로 연결하는 PostgreSQL 스키마 설계, WebSocket 브로드캐스트로 팀원 간 실시간 마킹·댓글 동기화 구조 구현
제품 카탈로그 하중 매칭 쿼리 설계산출 하중 결과와 제품 허용하중을 JOIN 쿼리로 실시간 매칭, CSV 벌크 업로드 SQLAlchemy bulk_save_objects 파이프라인 구현
Review
기술적 주안점
- SQLAlchemy 비동기 세션과 PostgreSQL View를 조합하여 팀 집계 쿼리를 최적화하고, Redis 계층 캐싱으로 동시 접속 팀원 수에 무관하게 대시보드 조회 응답을 일관되게 유지하는 구조를 설계합니다
- 마킹 좌표(x, y, canvas 스케일)를 JSON 컬럼으로 저장하는 PostgreSQL 댓글 앵커 시스템을 구현하고, FastAPI WebSocket 브로드캐스트로 동일 도면을 열람하는 팀원 간 마킹 변경을 실시간 동기화하는 협업 구조를 설계합니다
- 소방법규 규칙을 PostgreSQL JSONB 컬럼으로 외부화하여 관리자가 UI에서 기준값을 변경하면 다음 분석부터 즉시 적용되는 구조를 설계하고, SQLAlchemy 이벤트 훅으로 규칙 변경 감사 로그를 자동 기록합니다
