🗄️ 공사관리 ERP — DB 설계서 v1

분홍이 구상 + 분홍아빠 기획 기반 나중에 제작하면서 수정/추가 예정

1. Company (회사)

Company
├── id                  UUID PK
├── name                VARCHAR(100)       -- 회사명
├── business_number     VARCHAR(20)        -- 사업자등록번호
├── domain              VARCHAR(100)       -- 전용 도메인
├── address             TEXT
├── phone               VARCHAR(20)
├── email               VARCHAR(100)
├── logo_url            VARCHAR(500)
├── settings            JSONB              -- 회사별 설정
├── subscription        ENUM(무료/기본/프리미엄)
├── subscription_expires TIMESTAMP
├── is_active           BOOLEAN DEFAULT TRUE
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

2. User (사용자)

User
├── id                  UUID PK
├── company_id          UUID FK → Company
├── name                VARCHAR(50)
├── email               VARCHAR(100)       -- 로그인ID
├── password_hash       VARCHAR(255)
├── phone               VARCHAR(20)
├── role                ENUM(관리자/공사감독/현장대리/현장팀/공무팀)
├── team_type           ENUM(외선/접속/기타) -- 현장팀만, 나머지 NULL
├── is_active           BOOLEAN DEFAULT TRUE
├── last_login_at       TIMESTAMP
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

ViewerPermission (감시인 페이지 권한)

ViewerPermission
├── id                  UUID PK
├── user_id             UUID FK → User
├── page_key            VARCHAR(50)        -- 예: 공사목록/자재현황/진행상태
├── can_view            BOOLEAN DEFAULT TRUE
└── granted_by          UUID FK → User     -- 관리자

3. ProjectType (공사유형 템플릿)

ProjectType
├── id                  UUID PK
├── company_id          UUID FK → Company
├── name                VARCHAR(100)       -- 예: 통신선로공사, 건축공사
├── description         TEXT
├── is_active           BOOLEAN DEFAULT TRUE
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

ProjectTypeStage (유형별 파이프라인 단계)

ProjectTypeStage
├── id                  UUID PK
├── project_type_id     UUID FK → ProjectType
├── stage_group         ENUM(발생/실사/설계/검토/진행/현장완료/준공/완료)
├── stage_name          VARCHAR(100)       -- 예: 공가사전검토
├── stage_order         INT                -- 정렬순서
├── is_required         BOOLEAN DEFAULT TRUE
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

예시 (통신선로공사):

stage_group	stage_name	order
발생	접수	1
실사	실사	2
설계	설계	3
검토	검토(승인)	4
진행	공가사전검토	5
진행	선로포설	6
진행	선번조사	7
진행	절체	8
진행	선로철거	9
현장완료	현장완료	10
준공	서류작성	11
준공	공가신청	12
준공	서류접수	13
완료	완료	14

4. Project (공사)

Project
├── id                  UUID PK
├── company_id          UUID FK → Company
├── project_type_id     UUID FK → ProjectType
├── title               VARCHAR(200)       -- 공사명
├── description         TEXT
├── location            TEXT               -- 공사 위치
├── current_stage       ENUM(발생/실사/설계/검토/진행/현장완료/준공/완료)
├── current_step        VARCHAR(100)       -- 현재 진행단계명
├── approval_status     ENUM(대기/승인/취소) DEFAULT '대기'
├── agent_id            UUID FK → User     -- 현장대리 (1명, 교체가능)
├── started_at          TIMESTAMP
├── completed_at        TIMESTAMP
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

5. ProjectTeam (현장팀 배정)

ProjectTeam
├── id                  UUID PK
├── project_id          UUID FK → Project
├── user_id             UUID FK → User
├── team_type           ENUM(외선/접속/기타)
├── assigned_at         TIMESTAMP
└── removed_at          TIMESTAMP          -- 팀에서 빠질 때

6. ProjectStageLog (공사 단계 진행 이력)

ProjectStageLog
├── id                  UUID PK
├── project_id          UUID FK → Project
├── stage_group         ENUM(발생/실사/설계/검토/진행/현장완료/준공/완료)
├── stage_name          VARCHAR(100)
├── status              ENUM(시작/완료/취소)
├── note                TEXT               -- 비고
├── updated_by          UUID FK → User
├── started_at          TIMESTAMP
├── completed_at        TIMESTAMP
└── created_at          TIMESTAMP

7. Material (자재 마스터)

Material
├── id                  UUID PK
├── company_id          UUID FK → Company
├── name                VARCHAR(100)       -- 자재명
├── code                VARCHAR(50)        -- 자재코드
├── unit                VARCHAR(20)        -- 단위 (개/m/등)
├── supply_type         ENUM(사급/지입)
├── unit_price          DECIMAL(12,2)      -- 단가 (지입만 해당)
├── is_active           BOOLEAN DEFAULT TRUE
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

8. MaterialInput (자재 입력 — 공사별)

MaterialInput
├── id                  UUID PK
├── project_id          UUID FK → Project
├── material_id         UUID FK → Material
├── input_type          ENUM(최초/사용/반영)
├── quantity             INT
├── input_by            UUID FK → User
├── team_type           ENUM(외선/접속/관리자) -- 누가 입력했나
├── input_at            TIMESTAMP
└── created_at          TIMESTAMP

자동 계산 (VIEW 또는 앱단)

불용자재 = 사용자재 - 반영자재 (같은 project_id + material_id 기준)
재고 = 최초입력 - 사용자재

9. Plugin (플러그인 관리)

Plugin
├── id                  UUID PK
├── company_id          UUID FK → Company
├── plugin_key          VARCHAR(50)        -- 예: 공가신청/선번조사결과
├── name                VARCHAR(100)       -- 표시명
├── enabled             BOOLEAN DEFAULT FALSE
├── config              JSONB              -- 플러그인별 설정
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

ProjectTypePlugin (공사유형별 플러그인 연결)

ProjectTypePlugin
├── id                  UUID PK
├── project_type_id     UUID FK → ProjectType
├── plugin_id           UUID FK → Plugin
└── enabled             BOOLEAN DEFAULT TRUE

10. Document (공가신청/해지 — 플러그인 전용)

Document
├── id                  UUID PK
├── project_id          UUID FK → Project
├── doc_type            ENUM(공가신청/공가해지) -- 플러그인 활성화 시만
├── status              ENUM(작성중/신청/접수/완료)
├── content             JSONB              -- 서류 내용
├── created_by          UUID FK → User
├── created_at          TIMESTAMP
└── updated_at          TIMESTAMP

11. OCRUpload (OCR 자료 반영)

OCRUpload
├── id                  UUID PK
├── project_id          UUID FK → Project
├── uploaded_by         UUID FK → User     -- 현장(접속)팀
├── file_path           VARCHAR(500)
├── ocr_result          JSONB              -- OCR 분석 결과
├── reviewed_by         UUID FK → User     -- 현장대리
├── review_status       ENUM(대기/확인/수정)
├── uploaded_at         TIMESTAMP
└── reviewed_at         TIMESTAMP

🔗 ER 관계 요약

Company ──── User ──── ViewerPermission
   │
   ├──── ProjectType ── ProjectTypeStage
   │         │
   │         └──── ProjectTypePlugin ── Plugin
   │
   ├──── Project ── ProjectTeam
   │         │
   │         ├──── ProjectStageLog
   │         ├──── MaterialInput ←── Material
   │         ├──── Document (플러그인)
   │         └──── OCRUpload
   │
   └──── Material

📌 나중에 추가할 것

감사 로그 (AuditLog) — 누가 뭘 언제 변경했나
알림 시스템 — 단계 변경 시 알림
파일 첨부 — 공사별 첨부파일
통계/리포트 — 관리자 대시보드용
API 토큰 — 외부 연동용

[!note] 수정이력 | 2026-05-08 02:35, 루키 (hermes)

NAS 이전볼트(v0.2) 교체재로 내용 복원

원본: 2026-04-20_공사관리ERP_DB설계_v1.md