공통코드 관리 — dooco 화면 스펙

공통코드 관리

1그룹코드

삭제 등록

순서	구분	코드값	코드명	사용	관리

2하위코드

삭제 등록

순서	코드값	코드명	사용	관리

3세부코드

삭제 등록

순서	코드값	코드명	사용	관리

공통코드 관리

dooco 화면 스펙 · 갱신 2026-09-03
목업 출처 Kanakku html/index.html 셸 + 표준 컴포넌트(표) 조합 · 구조 출처 FRD ERP 공통코드
← 인덱스로 · 변경 이력

미확정

목적

시스템 전반에서 쓰는 코드성 기준정보를 한 화면에서 등록·관리한다. 개별 코드 등록 화면 17종의 병합 수용처(메뉴 구조도 2차)
공통코드의 기준(8/25): 여러 화면이 드롭다운으로 공유하는 값만. 특정 화면의 개별 데이터(소유권·제작회사·사출처·캐비티·측정값)는 공통코드가 아니라 직접 입력
2026-09-03 구조 개편 — 좌측 아코디언 트리 + 우측 코드 표(2단)에서 표 3개(3단)로. 색상처럼 한 단계 더 내려가는 값을 담을 자리가 없었다. 9/8 회의에서 두코 확인
근거: FRD ERP 공통코드 화면(그룹코드 › 하위코드 › 세부코드) — 개발이 s-erp/frontend-server/src/pages/system/common-code/ 를 그대로 참고할 수 있다 (9/3 PM)

주요 요소

번호	요소	설명
1	그룹코드	대분류. 구분(공통·ERP·MES) · 코드값 · 코드명. 구분은 한 벌의 공통코드를 ERP·MES가 나눠 쓰기 위한 것 — 기본값 공통, MES가 붙으면 구분=MES 대분류만 늘리면 된다(테이블을 나누지 않는다). 코드값은 대분류 3자(8/26 확정: 그룹 코드 = 대분류 3자 + 순번) — DEV 개발 · COM 공통 · SPC 사양서 · CLR 색상
2	하위코드	고른 그룹코드에 속한 코드. DEV01 금형 채번 분류처럼 대분류 3자 + 순번. 색상만은 여기가 재질(CLR01 PP · CLR02 ABS)이다 — 재질에 따라 나오는 고유색이 다르기 때문 (9/3 두코 회신)
3	세부코드	고른 하위코드에 속한 값. 색상은 그 재질에서 나오는 고유색(PP → 투명·검정·점보백색 / ABS → NP·검정·점보백색·67번백색·73번백색). 세부코드를 쓰지 않는 그룹은 빈 표
열 구성		세 표 모두 순서 · (구분) · 코드값 · 코드명 · 사용 · 관리. 구분은 그룹코드 표에만 — 하위·세부는 그룹에서 상속한다(코드값 앞 3자가 곧 소속). 비고는 열로 벌리지 않고 코드명 툴팁(3열이라 폭이 좁다)
순서		맨 앞 칸의 ⠿ 를 잡아 끌면 순번이 바뀐다(s-erp usePutSystemCommonCodeGroupAllOrdering 과 같은 방식). 놓으면 1부터 다시 매겨진다
등록·수정·삭제		표마다 상단 [등록] [삭제], 행마다 ✎ 🗑. 등록 팝업 = 코드값·코드명·비고(그룹코드일 때만 구분). 수정은 코드명·비고 항상 가능, 코드값은 하위가 있으면 잠금(하위 0건이면 코드값도 수정 — 8/26 확정). 삭제는 하위가 남아 있으면 차단하고, 없을 때만 확인 팝업을 거친다(8/26 확정 "코드가 하나도 없는 그룹만 삭제")

인터랙션·상태

그룹코드 클릭 → 하위코드 갱신 · 하위코드 클릭 → 세부코드 갱신. 선택된 행은 음영 + 굵게
앞 단계를 고르지 않으면 뒤 단계는 등록·삭제가 막힌다(토스트로 안내)
삭제 차단 시 남은 하위 건수를 알려 준다 — "하위 12건이 남아 있어 삭제할 수 없습니다"
수정 팝업에서 코드값이 잠기면 그 아래에 잠긴 이유(참조 건수)를 표시
사용여부는 상태값이라 딱지, 구분은 속성이라 텍스트 (9/3 PM)

데이터·규칙

항목	내용
층	3단 — 그룹코드 › 하위코드 › 세부코드. 현행 화면의 대분류·그룹·코드 3층을 FRD 이름에 그대로 얹은 것
채번	그룹 코드 = 대분류 3자 + 2자리 순번, 자동 채번 (8/26 확정). 코드값은 화면 연동 참조 키라 하위가 있으면 잠금
구분	공통(기본) · ERP · MES. 한 테이블을 두 시스템이 공유하므로 값마다 소속을 둔다. 사용자·역할·금형·개발품·신제품 등 다른 화면은 메뉴 자체가 갈려 있어 구분이 필요 없다 (9/3 PM)
색상	재질(하위코드) → 고유색(세부코드). 9/3 두코 회신 "원료 자체에서 나오는 색상은 사용되는 원료의 그레이드별로 설정이 필요하며, 해당 사출품이 개발품에서 로드되면 선택할 수 있어야 합니다". 고유색이 아닌 색은 전용 안료로 착색하며 그 특수색상 사출품은 완제품에 귀속(= 신제품 사양서에서 직접 입력)
연동	화면들이 이 값을 드롭다운으로 읽는다 — 재질 DEV04 · GRADE DEV05 · 첨부 종류 DEV12 · 색상 CLR · 후가공 SPC03 · 제품 유형 SPC05 · 포장방식 SPC06
개발 참고	s-erp/.../system/common-code/ — CommonCodeGroupTable · CommonCodeSubTable · CommonCodeDetailTable 3표 + ordering 드래그가 이미 구현돼 있다
미확정	[미확정] 3단 구조 확정 — 9/8 두코 리뷰 · [미확정] 색상 하위코드를 재질로 둘지 그레이드로 둘지(회신은 그레이드인데 GRADE NO(DEV05)가 아직 공통코드가 아니라 직접 입력) · [미확정] PP·ABS 외 나머지 색상표(9/3 수령분은 "대략적인 색상표") · [미확정] MES 대분류 목록 — MES 설계 착수 후 · [미확정] 그룹코드 표에 업무 구분(DEV·COM·SPC)과 값 묶음(CLR)이 같이 앉는 것이 맞는지 — 9/8 두코 확인

화면의 예시 데이터는 설명용 더미이며 실제 연동은 없습니다.