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

기준정보 분석 결과

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

분석 목적

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

---

메뉴 구조

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

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

---

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

개요

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

페이지 구성

코드	페이지명	경로
FG	품목 등록 / 제품	/제품관리/품목_등록

섹션 구조

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

탭 구조 (EAV)

계층구조 → 섹션 → 항목 → 속성

---

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

개요

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

페이지 구성

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

섹션 구조

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

---

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

개요

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

페이지 구성

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

탭 구조

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

KS규격 연동

• 산업 표준 검사 기준 참조
• 샘플링 기준 자동 적용

---

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

개요

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

페이지 구성

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

섹션 구조

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

---

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

개요

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

페이지 구성

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

섹션 구조 (6개)

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

제작사양 필드 (방화셔터 특화)

• 가로(W): 개구폭 (mm)
• 세로(H): 개구높이 (mm)
• 설치유형: 벽면형, 측면형, 혼합형
• 모터전원: 220V, 380V
• 제어기: 유선, 무선
• 샤프트 규격: 4", 5", 6", 8" (자동 산출)

---

6. 생산기준관리

개요

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

페이지 구성

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

공통 UI 패턴

• 검색조건 영역
• 리포트카드 (요약 통계)
• 목록테이블

---

7. 출고기준관리

개요

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

페이지 구성

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

---

8. 공정관리

개요

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

공정 목록

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

테이블 컬럼

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

---

9. 채번관리

개요

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

채번 규칙 목록 (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. 공통코드관리

개요

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

코드 카테고리 (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. 견적수식관리

개요

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

수식 현황

• 총 수식 수: 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	계산식	스크린500350/철재650500

데이터 스키마

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. 문서양식관리

개요

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

문서 현황

• 총 문서 양식: 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순위: 생산/출고 기준관리, 공정관리 (마스터 데이터)