🏗️ 공사관리 ERP — 기획 정리 (2026-04-20)

분홍아빠 기획 + 분홍(Hermes) 설계/구현

📋 프로젝트 개요

목표: 모든 공사유형(건축, 토목, 통신 등)에 범용 가능한 웹 어플리케이션
판매 모델: 회사당 1 VM 독립 환경 (SaaS 형태)
기존 시스템: 레드마인 변형 사용 (현재 폐지) → 신규 구축

👤 역할 & 권한 (5그룹)

역할	권한
관리자	웹서버 관리, 최고권한, 공사유형 템플릿 커스텀
공사감독	거의 뷰어 (외부 자체프로그램 사용)
현장대리	각 공사의 진행 관리 (공사당 1명, 교체 가능)
현장팀	각 공사의 부분 처리 담당 (공사당 여러 명)
공무팀	공사 완료 시 서류 작성

특이사항

공사감독은 외부 프로그램 사용 → 현장대리가 승인 결과 대신 입력
승인 상태: 승인 / 취소 둘 뿐

📋 공사 진행 파이프라인

발생(접수) → 실사 → 설계 → 검토(승인) → 진행 → 현장완료 → 준공 → 완료

진행 단계 (공사유형별 상이)

통신선로공사 기준:

공가사전검토 → 선로포설 → 선번조사 → 절체 → 선로철거

관리자가 공사유형 템플릿을 직접 커스터마이징 가능해야 함

준공 단계

서류작성 → 공가신청 → 서류접수

📦 자재관리

최초 자재 입력 (사급/지입 지정 + 수량)
        ↓
사용자재 입력 → 현장(외선)팀
        ↓
반영자재 재입력 → 현장(접속)팀
        ↓
불용자재 = 사용 - 반영 (자동계산)
        ↓
재고 = 최초입력 - 사용자재(반영+불용) (자동계산)

재고 분류

사급: 원청에서 지급한 자재
지입: 직접 구매한 자재
반납 없음 — 반영+불용 기준

예시

최초: 100 (사급)
사용: 80 (외선 입력)
반영: 60 (접속 재입력)
불용: 20 (자동계산: 80-60)
재고: 20 (자동계산: 100-80)

📊 선번조사 연동

별도 독립 웹프로그램 (ERP 내부에 넣으면 너무 무거움)
현장(접속)팀이 자료 업로드 → OCR/웹분석 자동 반영 → 현장대리 확인
API 연동은 필요 없음

📄 제외 항목

설계서류, 준공서류, 작업계획서 등 → Excel로 별도 작업
ERP 내부에 반영하지 않음 (양이 방대)

🖥️ 배포 아키텍처

서버컴 (Proxmox)
├── 가상헤놀로지 (회사 NAS)
├── 공사관리ERP VM #1 (A회사용, 독립도메인)
├── 공사관리ERP VM #2 (B회사용, 독립도메인)
└── ...

VM 당 구성 (Docker Compose)

├── 프론트 (Vue 3 + Vuetify)
├── 백엔드 (FastAPI)
├── PostgreSQL
├── Redis (세션/캐시)
├── OCR 서비스
└── Nginx (리버스프록시)

백업 전략

VM 스냅샷
DB 정기 백업 (상세 미정)

🎯 통합/분리 결정

항목	결정	이유
선번조사툴	❌ 분리	독립 웹프로그램, 무거움
공가신청/해지	✅ 통합	가벼움
Excel 서류	❌ 제외	방대함