거래처·단가 관리 DE22-1 §02 · 로우파이 와이어프레임

거래처 목록을 검색·조회하고, 행 클릭 시 우측 상세 패널에서 기본정보·취급 자재/공정 단가를 편집한다. (경로 /partners · /partners/:partnerId)
Figma 실제 디자인 기준 재작성(2026-07-08) — DE22-1 원본 대비 변경점: ① 목록 테이블 9컬럼(사업자번호·연락처·등록일 3개 추가) ② 페이지 타이틀 바("거래처 관리"+등록 버튼)를 목록/상세 분할 영역 위 전체 폭으로 분리, "Excel 다운로드"는 검색 바로 이동 ③ 상세 패널의 "거래처 유형"은 등록 후 읽기전용 필드로 상단 이동(더 이상 인라인 select 아님) ④ 역할·우선순위·리드타임(금형사 전용) 조건부 블록을 "비고" 필드 뒤 폼 최하단으로 재배치 ⑤ "비고" 필드 추가.

진입 — 사이드바 > 거래처관리

1. + 거래처 등록 버튼 — 페이지 타이틀 바 우측. 클릭 시 등록 모달(f4) 오픈, 성공 시 목록 갱신·새 행 자동 선택·상세 패널 오픈으로 이어진다.
2. 검색 바 — 거래처명·사업자번호 부분일치 검색. Enter 또는 [검색] 클릭 시 목록 조회 파라미터로 전달된다.
3. Excel 다운로드 — 현재 검색 조건 기준 거래처 목록 xlsx 내보내기.
4. 목록 테이블(9컬럼) — 거래처코드·거래처명·유형·사업자번호·대표자·연락처·자재 수·활성·등록일. 행 클릭 시 우측 상세 패널 오픈 + URL 갱신(/partners/:partnerId).
5. 활성 토글 — 상세 패널 헤더의 거래처 활성/비활성을 즉시 전환한다(PATCH).
6. 상세 탭 — 기본정보 / 취급 자재·단가 / 취급 공정·단가 3탭 전환. 각 탭은 별도 화면(f1 기본정보 · f2 · f3)으로 상세 정의.
7. 금형사 조건부 블록 — 거래처 유형=금형사 선택 시에만 역할·우선순위·리드타임 필드를 폼 최하단에 노출한다.
8. 저장 버튼 — 기본정보 탭 폼 하단. 편집한 기본정보를 저장·수정한다(PUT).

선택 거래처가 취급하는 자재와 유효단가 목록. 행 클릭 시 최근 5건 단가 이력 아코디언이 열린다. 전체 이력은 SCR-PM-006 으로 이동.

진입 — SCR-PM-004 상세 패널 [기본정보] 탭에서 [취급 자재·단가] 탭 클릭 (f1 참조)

1. + 자재 추가 버튼 — 헤더 액션. 클릭 시 자재 검색 모달을 열어 자재-거래처 매핑을 생성한다(POST).
2. 목록 테이블(5컬럼) — 자재코드·자재명·단위·유효단가·변경일. 행 클릭 시 아래로 단가 이력 아코디언이 펼쳐진다.
3. 단가 이력 아코디언 — 최근 5건(적용시작·적용종료·이전단가·변경단가·변경사유)만 표시(BE ?limit=5).
4. 안내 힌트 — 전체 매핑·이력 관리는 SCR-PM-006[매핑 거래처 목록]으로 이동한다는 안내.

거래처가 수행하는 공정과 규격범위별 단가. (공정, 규격범위) 1건 단위. 정방향 매핑(거래처 고정, 공정 검색).

진입 — SCR-PM-004 상세 패널에서 [취급 공정·단가] 탭 클릭 (f1 참조)

1. + 공정 추가 버튼 — 거래처-공정 매핑을 생성하는 공정 검색 모달을 연다.
2. + 단가 등록 버튼 — 선택된 (공정 × 규격범위) 단위로 단가 시계열을 등록한다.
3. 목록 테이블(5컬럼) — 공정·규격범위·단가·적용시작일·변경사유. (공정, 규격범위) 1건 단위로 나열.
4. 규격범위 규칙 힌트 — min·max 둘 다 필수 입력. 무제한 상한은 max=99999(mm) 컨벤션, 길이무관은 min·max NULL로 '전체' 표기. 행 클릭 시 최근 5건 단가 이력 아코디언이 펼쳐진다.
5. 단가 이력 아코디언 예시 — "절단 L ≤ 3,000mm" 행 클릭 시 펼쳐지는 모습을 시연한다. [취급 자재·단가] 탭과 동일하게 최근 5건만 표시(BE ?limit=5).

좌측 목록 [+ 거래처 등록] 클릭 시 열린다. 필수: partnerCode · 거래처명 · 유형. 사업자번호는 선택. 금형사 선택 시 역할·priority·leadTimeDays 활성.

1. 식별자 — 거래처코드(필수, 예: P-2026-001). 저장 시 partnerCode 중복이면 POST 409 폴백으로 처리한다(사전 검증 endpoint 없음).
2. 기본 정보 — 거래처명·유형(필수) + 사업자번호·대표자·연락처·이메일(선택).
3. 금형사 조건부 블록 — 유형=금형사 선택 시에만 역할(필수)·priority(1~99)·리드타임(0~365일)이 활성화된다.
4. 추가 정보 — 주소(선택, max 500)·비고(선택, max 1000).
5. 검증·저장 안내 — 저장 직전 일괄 검증(필드별 inline 에러). partnerCode 중복은 POST 409 폴백. 등록 성공 시 목록 즉시 갱신·새 행 자동 선택·상세 패널 오픈.
6. [등록] 버튼 — 12필드를 제출한다(POST /api/pm/partners).

한 자재에 매핑된 거래처 목록과 시계열 단가 이력. 우선순위 드래그·묶음 단가(📦) 환산·거래처 별칭·비활성 배지를 표기. (경로 /materials/:itemCode/partners)

진입 — SCR-PM-003 [거래처 매핑] 탭 인라인 / SCR-PM-004 [취급 자재·단가] 탭 행 클릭(전체 매핑·이력) / 사이드바 > 거래처관리 > 자재-거래처 매핑 (자재 미선택 시 SCR-PM-001 자재 목록 redirect + "자재를 선택하세요" 안내)

1. 자재 컨텍스트 — 상단에 현재 자재(코드·명·단위)를 고정 표시한다.
2. + 거래처 매핑 추가 버튼 — 클릭 시 거래처 매핑 추가 모달(f6)을 연다.
3. 매핑 거래처 목록 테이블(9컬럼) — 우선순위·거래처·type/역할·별칭·거래단가·단위단가(환산)·리드타임·적용기간·액션. ⠿ 핸들 드래그로 금형사 우선순위(1 주/2 보조/3 예비)를 재정렬한다(PATCH reorder).
4. 묶음(📦) 단가 배지 — 묶음단위×수량으로 입력된 단가를 단위 단가로 자동 환산해 함께 표기한다(예: 8,500÷100=85).
5. 비활성 배지(⚠) — 거래처가 비활성 상태임을 표기하며, 신규 매핑 대상에서 제외된다.
6. 단가 이력 아코디언 — 행 클릭 시 펼쳐지며, 유효 단가 행을 강조(볼드) 표시한다.

자재는 고정(🔒), 거래처를 검색·선택. 단위/묶음(📦) 단가 택1, 유효기간·변경사유 입력. priority·리드타임은 금형사 한정. 적용시작 min=today(소급 차단).

진입 — SCR-PM-006 [+ 거래처 매핑 추가] 버튼 클릭 (f5 참조)

1. 자재(고정) 필드 — 🔒 읽기전용. 매핑 대상 자재를 고정 표시한다.
2. 거래처 검색 select — 활성 거래처만 검색·선택 대상으로 노출된다.
3. type·역할 자동 채움 — 거래처 선택 시 해당 거래처의 type·역할을 읽기전용으로 자동 표시한다.
4. 단가 입력 방식 라디오 — 단위 단가 / 📦 묶음 단가 중 택1.
5. 묶음 조건부 블록 — 📦 묶음 단가 선택 시 묶음단위·수량·묶음단가를 입력하면 환산 단위단가를 자동 계산한다(예: 8,500÷100=85).
6. 우선순위 select — 금형사 거래처에 한정해 1(주)/2(보조)/3(예비) 우선순위를 지정한다.
7. 유효 시작일 — min=today로 소급 적용을 차단한다. 기존 유효 단가는 신규 시작일 직전으로 자동 종료된다.
8. 매핑 등록 버튼 — 모달 하단. 자재-거래처 매핑과 초기 단가를 등록한다(POST).

priority · 단가 · 리드타임 · status 의 시간순 변경 타임라인. [diff] 클릭 시 before/after 전체 필드 비교 모달. 90일 경과 이력은 자동 아카이브.

진입 — SCR-PM-006 [매핑 거래처 목록] 탭에서 [변경 이력] 탭 클릭 (f5 참조)

1. 탭 전환 — [매핑 거래처 목록](f5) / [변경 이력] 2탭.
2. 자재 컨텍스트 · 보관 기간 — 상단에 현재 자재와 이력 보관 기간(90일)을 함께 표시한다.
3. 변경 이력 테이블(7컬럼) — 변경일시·거래처·변경 항목·before→after·변경자·사유·액션. priority·단가·리드타임·status 변경을 시간순으로 나열.
4. [diff] 버튼 — 행별로 클릭하면 before/after 전체 필드 비교 모달이 열린다.
5. 자동 아카이브 안내 — 90일이 지난 이력은 감사용으로 자동 아카이브된다.