sam-docs/projects/mes/v2-analysis/master-data-analysis/README.md

# 기준정보 분석 결과

> 분석 일시: 2024-12-18
> 분석 대상: design/mes기획서_리액트 (디자인팀 기획 사이트)

## 분석 목적

디자인팀에서 제작한 기획 사이트의 **기준정보** 메뉴를 분석하여 API 개발에 필요한 스펙을 추출합니다.

---

## 메뉴 구조

기준정보 메뉴는 크게 3가지 유형으로 분류됩니다:

| 유형 | 메뉴 | 설명 |
|------|------|------|
| **EAV 메타관리** | 품목/공정/검사/현장/수주 기준관리 | 폼 템플릿 동적 구성 |
| **마스터 데이터** | 생산/출고 기준관리, 공정관리, 채번관리, 공통코드, 문서양식 | 고정 스키마 데이터 |
| **수식 엔진** | 견적수식관리 | 자동 견적 산출 |

---

## 1. 품목기준관리 (EAV 메타)

![품목기준관리](screenshots/01-item-master-list.png)

### 개요
품목 등록 폼의 구조를 동적으로 정의하는 메타데이터 관리 시스템입니다.

### 페이지 구성
| 코드 | 페이지명 | 경로 |
|------|----------|------|
| FG | 품목 등록 / 제품 | /제품관리/품목_등록 |

### 섹션 구조
| 섹션명 | 항목 | 속성 |
|--------|------|------|
| 기본정보 | 품목코드, 품목명, 분류 | text, required 등 |
| BOM | BOM 필요 | toggle |

### 탭 구조 (EAV)
```
계층구조 → 섹션 → 항목 → 속성
```

---

## 2. 공정기준관리 (EAV 메타)

![공정기준관리](screenshots/02-process-master.png)

### 개요
공정 등록 폼의 구조를 정의합니다.

### 페이지 구성
| 코드 | 페이지명 | 경로 |
|------|----------|------|
| PROD | 공정 등록 / 생산 | /기준정보/공정_등록 |

### 섹션 구조
| 섹션명 | 항목 |
|--------|------|
| 기본정보 | 공정코드, 공정명, 공정구분, 담당부서 |
| 자원정보 | 설비정보, 필요인원 |
| 작업정보 | 작업일지 양식, 공정흐름코드, 설명 |

---

## 3. 검사기준관리 (EAV 메타)

![검사기준관리](screenshots/03-inspection-master.png)

### 개요
검사 기준 및 검사 성적서 폼 구조를 정의합니다.

### 페이지 구성
| 코드 | 페이지명 | 설명 |
|------|----------|------|
| IQC | 검사기준 등록 | 검사 템플릿 |
| IQC | 수입검사성적서 | 수입 자재 검사 |
| PQC | 중간검사성적서 | 공정 중간검사 |

### 탭 구조
```
계층구조 | 섹션 | 검사항목 | 속성 | 검사템플릿 | KS규격 | 샘플링기준
```

### KS규격 연동
- 산업 표준 검사 기준 참조
- 샘플링 기준 자동 적용

---

## 4. 현장기준관리 (EAV 메타)

![현장기준관리](screenshots/04-site-master.png)

### 개요
현장 등록 폼의 구조를 정의합니다.

### 페이지 구성
| 코드 | 페이지명 | 경로 |
|------|----------|------|
| NEW | 현장 등록 / 신축 | /판매관리/현장_등록 |

### 섹션 구조
| 섹션명 | 항목 |
|--------|------|
| 기본정보 | 현장코드, 현장명, 거래처, 카테고리, 상태, 위치 |
| 계약정보 | 계약시작일, 계약종료일 |
| 담당자정보 | 현장소장, 연락처 |

---

## 5. 수주기준관리 (EAV 메타)

![수주기준관리](screenshots/05-order-master.png)

### 개요
수주 등록 폼의 구조를 정의합니다. 가장 복잡한 EAV 구조를 가집니다.

### 페이지 구성
| 코드 | 페이지명 | 설명 |
|------|----------|------|
| NORMAL | 일반 수주 | 신규 수주 |
| ADDITIONAL | 추가 수주 | 기존 현장 추가 수주 |

### 섹션 구조 (6개)
| 섹션명 | 주요 항목 |
|--------|----------|
| 기본정보 | 수주번호, 수주일, 거래처, 현장 |
| 납품정보 | 납품예정일, 설치예정일 |
| 품목정보 | 제품카테고리, 제품명, 수량 |
| 제작사양 | 가로(W), 세로(H), 설치유형, 모터전원, 제어기 |
| 금액정보 | 단가, 금액, 부가세 |
| 기타정보 | 비고, 특이사항 |

### 제작사양 필드 (방화셔터 특화)
- **가로(W)**: 개구폭 (mm)
- **세로(H)**: 개구높이 (mm)
- **설치유형**: 벽면형, 측면형, 혼합형
- **모터전원**: 220V, 380V
- **제어기**: 유선, 무선
- **샤프트 규격**: 4", 5", 6", 8" (자동 산출)

---

## 6. 생산기준관리

![생산기준관리](screenshots/06-production-master.png)

### 개요
생산 관련 마스터 데이터 관리 페이지 모음입니다.

### 페이지 구성
| 코드 | 페이지명 | 설명 |
|------|----------|------|
| WO | 작업지시 목록 | 작업지시 조회/관리 |
| WO | 작업지시 등록 | 신규 작업지시 생성 |
| EQ | 설비 목록 | 생산 설비 관리 |
| LN | 라인/작업장 목록 | 생산 라인 관리 |
| BOM | BOM 목록 | 자재명세서 관리 |

### 공통 UI 패턴
- 검색조건 영역
- 리포트카드 (요약 통계)
- 목록테이블

---

## 7. 출고기준관리

![출고기준관리](screenshots/07-shipment-master.png)

### 개요
출고 관련 마스터 데이터 관리 페이지 모음입니다.

### 페이지 구성
| 코드 | 페이지명 | 설명 |
|------|----------|------|
| DM | 배송방법 | 배송 방법 코드 관리 |
| CR | 배송업체 | 운송 업체 정보 |
| SS | 출하상태 | 출하 상태 코드 |
| PK | 포장기준 | 포장 규격 정보 |
| VH | 차량 | 배송 차량 관리 |
| SD | 출하문서 | 출하 문서 양식 |

---

## 8. 공정관리

![공정관리](screenshots/08-process-list.png)

### 개요
실제 공정 목록을 관리합니다. (EAV 메타가 아닌 실제 데이터)

### 공정 목록
| 공정코드 | 공정명 | 구분 | 담당부서 |
|----------|--------|------|----------|
| P-001 | 스크린 | 제조 | 스크린팀 |
| P-002 | 절곡 | 제조 | 절곡팀 |
| P-003 | 슬랫 | 제조 | 슬랫팀 |
| P-004 | 재고(포밍) | 반제품생산 | 절곡팀 |

### 테이블 컬럼
| 컬럼 | 설명 |
|------|------|
| 공정코드 | P-### 형식 |
| 공정명 | 공정 이름 |
| 구분 | 제조, 반제품생산 등 |
| 담당부서 | 담당 부서명 |
| 분류규칙 | 품목 분류 규칙 |
| 인원 | 필요 인원 |
| 상태 | 활성/비활성 |

---

## 9. 채번관리

![채번관리](screenshots/09-numbering-list.png)

### 개요
시스템 전체의 자동 채번 규칙을 관리합니다.

### 채번 규칙 목록 (15개)
| 번호기준 이름 | 적용 대상 | 접두사 | 날짜 형식 | 순번 자릿수 | 리셋 주기 | 예시 |
|---------------|-----------|--------|-----------|-------------|-----------|------|
| 출고번호 | 출고 | OUT | YYMMDD | 3 | 일별 | OUT241218-001 |
| 현장코드 | 현장 | S | YYMM | 3 | 월별 | S-2412-001 |
| 출하번호 | 출하 | KD-SH | YY | 4 | 연별 | KD-SH-24-0001 |
| 작업지시번호 | 작업지시 | KD-WO | YY | 4 | 연별 | KD-WO-24-0001 |
| 검사LOT | 검사 | KD-IQC | YYMM | 4 | 월별 | KD-IQC-2412-0001 |
| 생산LOT | 생산 | KD-PL | YYMM | 4 | 월별 | KD-PL-2412-0001 |
| 수주번호(일반) | 수주 | KD-TS | YY | 4 | 연별 | KD-TS-24-0001 |
| 수주번호(슬랫) | 수주 | KD-SL | YY | 4 | 연별 | KD-SL-24-0001 |
| 수주번호(비드) | 수주 | KD-BD | YY | 4 | 연별 | KD-BD-24-0001 |
| ... | ... | ... | ... | ... | ... | ... |

### 데이터 스키마
```
numbering_rules
├── id (PK)
├── tenant_id (FK)
├── name - 번호기준 이름
├── target_entity - 적용 대상 (orders, shipments, work_orders 등)
├── prefix - 접두사
├── date_format - 날짜 형식 (YY, YYMM, YYMMDD)
├── sequence_digits - 순번 자릿수
├── reset_period - 리셋 주기 (daily, monthly, yearly)
├── current_sequence - 현재 순번
├── last_reset_date - 마지막 리셋일
├── separator - 구분자 (-, _, 없음)
├── status - 상태
├── created_at
└── updated_at
```

### API 스펙
```
GET    /api/numbering-rules           - 채번 규칙 목록
GET    /api/numbering-rules/{id}      - 채번 규칙 상세
POST   /api/numbering-rules           - 채번 규칙 등록
PUT    /api/numbering-rules/{id}      - 채번 규칙 수정
DELETE /api/numbering-rules/{id}      - 채번 규칙 삭제
POST   /api/numbering-rules/{id}/generate - 번호 생성
POST   /api/numbering-rules/{id}/reset    - 순번 리셋
```

---

## 10. 공통코드관리

![공통코드관리](screenshots/10-common-code-list.png)

### 개요
시스템 전체에서 사용하는 코드 체계를 관리합니다.

### 코드 카테고리 (8개)
| 카테고리 | 건수 | 패턴 예시 | 설명 |
|----------|------|-----------|------|
| 기본코드 | - | C-001 | 기본 분류 코드 |
| 부자재 | - | BP-GR-001 | 부자재 품목 코드 |
| 원자재 | - | SCR-0.3T | 원자재 규격 코드 |
| 구매부품 | - | E-220V-300KG | 구매 부품 코드 |
| 절곡부품 | - | RC24 | 절곡 부품 코드 |
| 셔터종류 | - | SCR, SLT | 셔터 유형 코드 |
| 인정제품 | - | - | 인정 제품 코드 |
| 신규인정 | - | - | 신규 인정 코드 |

### 데이터 스키마
```
common_codes
├── id (PK)
├── tenant_id (FK)
├── category - 코드 카테고리
├── code - 코드값 (UNIQUE within category)
├── name - 코드명
├── description - 설명
├── parent_id (FK, self) - 상위 코드 (계층 구조)
├── sort_order - 정렬 순서
├── is_system - 시스템 코드 여부 (수정 불가)
├── status - 상태
├── created_at
└── updated_at
```

### API 스펙
```
GET    /api/common-codes              - 공통코드 목록
GET    /api/common-codes/{id}         - 공통코드 상세
POST   /api/common-codes              - 공통코드 등록
PUT    /api/common-codes/{id}         - 공통코드 수정
DELETE /api/common-codes/{id}         - 공통코드 삭제

GET    /api/common-codes/categories   - 카테고리 목록
GET    /api/common-codes/by-category/{category} - 카테고리별 코드
```

---

## 11. 견적수식관리

![견적수식관리](screenshots/11-quote-formula-list.png)

### 개요
자동 견적 산출을 위한 수식 엔진을 관리합니다.

### 수식 현황
- **총 수식 수**: 44개
- **제품**: 공통 (제품별 확장 가능)
- **카테고리**: 13개 (실행 순서 기반)

### 카테고리 및 실행 순서
| 순서 | 카테고리명 | 수식 수 | 설명 |
|------|------------|---------|------|
| 1 | 기본정보 | 10 | 입력값 정의 |
| 2 | 제작사이즈 | 0 | 제작 치수 계산 |
| 3 | 면적&중량 | 1 | 면적/중량 산출 |
| 4 | 모터용량산출 | 2 | 모터 용량 결정 |
| 5 | 브라켓&받침용앵글 | 4 | 브라켓 수량 계산 |
| 6 | 감기샤프트 | 2 | 샤프트 규격 선정 |
| 7 | 가이드레일 | 7 | 레일 수량 계산 |
| 8 | 연기차단재 | 0 | 연기차단재 산출 |
| 9 | 셔터박스(케이스) | 9 | 케이스 규격 산출 |
| 10 | 하단마감재 | 2 | 마감재 산출 |
| 11 | 부자재 | 4 | 부자재 수량 |
| 12 | 구매부품 | 3 | 구매부품 수량 |
| 13 | 장수산출 | 0 | 최종 장수 계산 |

### 기본정보 변수
| 순서 | 이름 | 변수 | 타입 | 설명 |
|------|------|------|------|------|
| 1 | 제품구분 | PC | 계산식 | 스크린/철재 |
| 2 | 오픈사이즈 가로 | W0 | 계산식 | 고객 주문 가로 (mm) |
| 3 | 오픈사이즈 세로 | H0 | 계산식 | 고객 주문 세로 (mm) |
| 4 | 샤프트 규격 | SHAFT_INCH | 계산식 | 4"/5"/6"/8" |
| 5 | 설치유형 | INSTALL_TYPE | 계산식 | 벽면형/측면형/혼합형 |
| 6 | 모터 전원 | MP | 계산식 | 220V/380V |
| 7 | 유선/무선 | WIRE | 계산식 | 유선/무선 |
| 8 | 연동제어기 타입 | CT | 계산식 | 매립/노출 |
| 9 | 수량 | QTY | 계산식 | 주문 수량 |
| 10 | 케이스 사이즈 | CASE_SIZE | 계산식 | 스크린500*350/철재650*500 |

### 데이터 스키마
```
quote_formulas
├── id (PK)
├── tenant_id (FK)
├── product_code - 제품 코드 (공통 또는 특정 제품)
├── category_id (FK) - 카테고리
├── sort_order - 실행 순서
├── name - 수식 이름
├── variable_name - 변수명 (W0, H0, SHAFT_INCH 등)
├── formula_type - 타입 (input, formula, lookup, condition)
├── formula_expression - 수식 표현식
├── result_type - 결과 타입 (number, text, output)
├── description - 설명
├── status - 상태
├── created_at
└── updated_at

quote_formula_categories
├── id (PK)
├── tenant_id (FK)
├── name - 카테고리명
├── execution_order - 실행 순서
├── formula_count - 수식 수 (계산 필드)
├── status
└── created_at
```

### API 스펙
```
GET    /api/quote-formulas                    - 수식 목록
GET    /api/quote-formulas/{id}               - 수식 상세
POST   /api/quote-formulas                    - 수식 등록
PUT    /api/quote-formulas/{id}               - 수식 수정
DELETE /api/quote-formulas/{id}               - 수식 삭제

GET    /api/quote-formula-categories          - 카테고리 목록
POST   /api/quote-formulas/calculate          - 견적 계산 실행

# 수식 관리 버튼
POST   /api/quote-formulas/products/{code}/formulas  - 품목 수식 관리
POST   /api/quote-formulas/categories                - 분류 관리
POST   /api/quote-formulas/prices                    - 단가 수식 관리
POST   /api/quote-formulas/auto-calculate            - 자동 견적 산출
```

---

## 12. 문서양식관리

![문서양식관리](screenshots/12-document-template-list.png)

### 개요
시스템에서 사용하는 문서 양식을 관리합니다.

### 문서 현황
- **총 문서 양식**: 29개
- **카테고리**: 5개

### 카테고리별 문서
| 카테고리 | 건수 | 문서 목록 |
|----------|------|-----------|
| 판매문서 | 4 | 견적서(QT), 견적산출내역서(QT-DTL), 수주확인서(SO), 거래명세서(SL) |
| 생산문서 | 11 | 작업지시서(WO), 스크린 생산지시서(WO-SCR), 슬랫 생산지시서(WO-SLT), 절곡 생산지시서(WO-FLD), 발주서(PO), 생산실적보고서(PR), 스크린 작업일지(WL-SCR), 절곡 작업일지(WL-FLD), 슬랫 작업일지(WL-SLT), 재고생산 작업일지(WL-STK), 포장 작업일지(WL-PKG) |
| 품질문서 | 7 | 수입검사성적서(IQC), 중간검사성적서(PQC), 스크린 중간검사성적서(PQC-SCR), 절곡품 중간검사성적서(PQC-BND), 제품검사성적서(FQC), 부적합품보고서(NCR), 제품검사신청서(FQC-REQ) |
| 물류문서 | 4 | 입고전표(GR), 출고전표(GI), 배송지시서(DL), 납품확인서(DC) |
| 회계문서 | 3 | 세금계산서(INV), 매출장(SLS), 매입장(PUR) |

### 문서 상세

#### 판매문서
| 코드 | 문서명 | 템플릿 | 설명 |
|------|--------|--------|------|
| QT | 견적서 | O | 고객에게 제출하는 견적서 |
| QT-DTL | 견적산출내역서 | O | 견적 상세 산출내역 |
| SO | 수주확인서 | O | 수주 확정 문서 |
| SL | 거래명세서 | O | 출하 시 발행하는 거래명세서 |

#### 생산문서
| 코드 | 문서명 | 템플릿 | 설명 |
|------|--------|--------|------|
| WO | 작업지시서 | O | 생산 작업지시 문서 (공통) |
| WO-SCR | 스크린 생산지시서 | - | 스크린 공정 생산지시서 |
| WO-SLT | 슬랫 생산지시서 | - | 슬랫 공정 생산지시서 |
| WO-FLD | 절곡 생산지시서 | - | 절곡 공정 생산지시서 |
| PO | 발주서 | O | 자재/외주 발주 문서 |
| PR | 생산실적보고서 | - | 생산 완료 실적 보고 |
| WL-SCR | 스크린 작업일지 | O | 스크린 생산부서 작업일지 |
| WL-FLD | 절곡 작업일지 | O | 절곡 생산부서 작업일지 |
| WL-SLT | 슬랫 작업일지 | O | 슬랫 생산부서 작업일지 |
| WL-STK | 재고생산 작업일지 | O | 절곡품 재고생산 작업일지 (중간검사성적서 포함) |
| WL-PKG | 포장 작업일지 | - | 포장 생산부서 작업일지 |

#### 품질문서
| 코드 | 문서명 | 템플릿 | 설명 |
|------|--------|--------|------|
| IQC | 수입검사성적서 | O | 수입 자재 검사 성적서 |
| PQC | 중간검사성적서 | O | 공정 중간검사 성적서 |
| PQC-SCR | 스크린 중간검사성적서 | O | 스크린 제품 중간검사 |
| PQC-BND | 절곡품 중간검사성적서 | O | 절곡품 중간검사 |
| FQC | 제품검사성적서 | O | 출하 후 고객요청 검사 성적서 |
| NCR | 부적합품보고서 | - | 불합격 판정 보고서 |
| FQC-REQ | 제품검사신청서 | - | 자동방화셔터 제품검사요청서 |

#### 물류문서
| 코드 | 문서명 | 템플릿 | 설명 |
|------|--------|--------|------|
| GR | 입고전표 | - | 자재 입고 전표 |
| GI | 출고전표 | - | 자재 출고 전표 |
| DL | 배송지시서 | - | 출하 배송 지시서 |
| DC | 납품확인서 | O | 현장 납품 확인서 (자재내역, 절곡내역, 도면 포함) |

#### 회계문서
| 코드 | 문서명 | 템플릿 | 설명 |
|------|--------|--------|------|
| INV | 세금계산서 | O | 세금계산서 |
| SLS | 매출장 | - | 매출 기록 문서 |
| PUR | 매입장 | - | 매입 기록 문서 |

### 데이터 스키마
```
document_templates
├── id (PK)
├── tenant_id (FK)
├── code (UNIQUE) - 문서 코드
├── name - 문서명
├── category - 카테고리 (판매문서, 생산문서, 품질문서, 물류문서, 회계문서)
├── description - 설명
├── has_template - 템플릿 여부
├── template_file - 템플릿 파일 경로
├── template_engine - 템플릿 엔진 (blade, html, pdf)
├── data_source - 데이터 소스 테이블
├── status - 상태
├── created_at
└── updated_at
```

### API 스펙
```
GET    /api/document-templates                    - 문서양식 목록
GET    /api/document-templates/{id}               - 문서양식 상세
POST   /api/document-templates                    - 문서양식 등록
PUT    /api/document-templates/{id}               - 문서양식 수정
DELETE /api/document-templates/{id}               - 문서양식 삭제

GET    /api/document-templates/{id}/preview       - 미리보기
POST   /api/document-templates/{id}/generate      - 문서 생성
GET    /api/document-templates/by-category/{cat}  - 카테고리별 조회
```

---

## EAV 공통 스키마

기준관리 메뉴들 (품목, 공정, 검사, 현장, 수주)은 공통적인 EAV 구조를 따릅니다.

### 페이지 정의
```
form_pages
├── id (PK)
├── tenant_id (FK)
├── page_code (UNIQUE) - 페이지 코드 (FG, PROD, IQC, NEW, NORMAL 등)
├── page_name - 페이지명
├── page_path - 경로
├── target_entity - 대상 엔티티 (items, processes, inspections 등)
├── description
├── status
├── created_at
└── updated_at
```

### 섹션 정의
```
form_sections
├── id (PK)
├── page_id (FK)
├── section_code - 섹션 코드
├── section_name - 섹션명
├── sort_order - 정렬 순서
├── is_collapsible - 접기 가능 여부
├── default_expanded - 기본 펼침 여부
├── status
└── created_at
```

### 필드(항목) 정의
```
form_fields
├── id (PK)
├── section_id (FK)
├── field_code - 필드 코드
├── field_name - 필드명
├── field_type - 타입 (text, number, select, date, toggle 등)
├── is_required - 필수 여부
├── default_value - 기본값
├── validation_rules - 유효성 규칙 (JSON)
├── options - 선택 옵션 (JSON, select 타입용)
├── placeholder - 플레이스홀더
├── help_text - 도움말
├── sort_order - 정렬 순서
├── status
└── created_at
```

### 필드 속성
```
form_field_attributes
├── id (PK)
├── field_id (FK)
├── attribute_key - 속성 키
├── attribute_value - 속성 값
└── created_at
```

---

## 요약

### 분석 완료 항목
| 메뉴 | 유형 | 스크린샷 | 상태 |
|------|------|----------|------|
| 품목기준관리 | EAV 메타 | 01-item-master-list.png | ✅ |
| 공정기준관리 | EAV 메타 | 02-process-master.png | ✅ |
| 검사기준관리 | EAV 메타 | 03-inspection-master.png | ✅ |
| 현장기준관리 | EAV 메타 | 04-site-master.png | ✅ |
| 수주기준관리 | EAV 메타 | 05-order-master.png | ✅ |
| 생산기준관리 | 마스터 | 06-production-master.png | ✅ |
| 출고기준관리 | 마스터 | 07-shipment-master.png | ✅ |
| 공정관리 | 마스터 | 08-process-list.png | ✅ |
| 채번관리 | 마스터 | 09-numbering-list.png | ✅ |
| 공통코드관리 | 마스터 | 10-common-code-list.png | ✅ |
| 견적수식관리 | 수식엔진 | 11-quote-formula-list.png | ✅ |
| 문서양식관리 | 마스터 | 12-document-template-list.png | ✅ |

### 구현 우선순위
1. **1순위**: 채번관리, 공통코드관리 (다른 기능의 의존성)
2. **2순위**: EAV 공통 스키마 (품목/공정/검사/현장/수주 기준관리)
3. **3순위**: 견적수식관리 (견적 기능 의존)
4. **4순위**: 문서양식관리 (PDF 출력 기능)
5. **5순위**: 생산/출고 기준관리, 공정관리 (마스터 데이터)