# 설계 인계와 고객 워크스루 아젠다

> 상태: 고객 워크스루 전 · 확인 예정이 많은 초안
> 원칙: 첫 인터뷰에서 위시켓이 만든 데모·와이어프레임을 먼저 보여주지 않는다. 실제 고객 화면·파일·판단과 산출 흐름을 확인한 뒤 중간보고에서 검증된 MVP 1~2개만 제시한다. — 사용자 확인 2026-08-29

## 1. 설계 인계 원칙

| 원칙 ID | 원칙 | 적용 | 상태 | 근거 |
|---|---|---|---|---|
| H-01 | 원천키 보존 | `item_code`를 기준 후보로 사용하되 WMS·채널 코드를 덮어쓰지 않고 매핑 이력을 둔다 | 제안 | `_materials/files/wms-data.md`; 사용자 확인 2026-08-29 |
| H-02 | 원천과 계산값 분리 | 원본 재고·매출·계획 값과 표준 계산값·가마감 값을 별도 필드로 보존한다 | 제안 | `_materials/files/google-sheets-operations.md`; `_materials/files/system-data-round1.md` |
| H-03 | 기준시점 필수 | 재고·계획·매출의 `snapshot_at`, 거래일, 인식일을 구분한다 | 제안 | `_materials/files/wms-data.md`; `_materials/files/sales-plans.md` |
| H-04 | 업무정책 선확정 | 매출 인식, 가용·배정재고, SKU 오너십을 화면 세부설계 전에 확정한다 | 확인 예정 | `_materials/files/customer-basis-documents.md` §3.2~3.3 |
| H-05 | 파생 요구 동시 감지 | 매출·가마감·손익을 확인할 때 프로모션·광고의 공통키·입도도 함께 확인한다 | 사용자 확인 | 사용자 확인 2026-08-29 |
| H-06 | 효과 기준선 측정 | 인터뷰에서 현재 소요시간과 KPI/KR을 기록해 종료보고 개선량의 기준으로 사용한다 | 사용자 확인 | 사용자 확인 2026-08-29 |

## 2. 화면 후보

화면 후보는 요구를 설계 언어로 번역한 것이며 구현 확정 목록이 아니다.

| 후보 ID | 화면 후보 | 해결할 질문 | 필요한 확정 데이터·정책 | 우선도 | 상태 | 근거 |
|---|---|---|---|---:|---|---|
| UI-01 | 시스템·데이터 원천 현황 | 어떤 시스템에서 무엇을 어떻게 받고 무엇이 비어 있는가 | 시스템 오너, 추출방식, 주기, 파일·시트, 보안등급 | P0 | 내부 운영용 | `03-systems.md` 예정; `_materials/INDEX.md` |
| UI-02 | 제품/SKU 기준정보 | 동일 제품의 ERP·WMS·채널 코드를 어떻게 연결하는가 | ITEM 오너, 채번·종료·리뉴얼·세트 규칙, `valid_from/to` | P1 | 확인 예정 | `_materials/files/wms-data.md`; `_materials/screens/erp-u.md` §6~8 |
| UI-03 | 창고·재고 통합조회 | 어디에 무엇이 얼마 있고 실제 판매 가능한 양은 얼마인가 | S/L↔WMS 매핑, 상태코드, 가용·배정·보류 산식, 기준시각 | P1 | 확인 예정 | `_materials/files/wms-data.md`; `_materials/screens/*` |
| UI-04 | 입고·공급 상태 | 발주·입고예정·실입고·제조사 보유 흐름이 어디서 끊기는가 | 오더키, 상태값, 예정/확정일, 제조사·창고 역할 | P1 | 확인 예정 | `_materials/files/google-sheets-operations.md`; `_materials/screens/erp-u.md` |
| UI-04A | 출고지시 지원 | 주문·배정·가용재고를 보고 어떤 출고를 언제 요청해야 하는가 | 주문-재고 연결, 승인권자, ERP 업로드/연결 방식, 실패 재처리 | 제안 | 범위 확인 필요 | ERP-SAL-04 출고요청등록; 사용자 가설 2026-08-29 |
| UI-05 | 채널 매출·가마감·손익·계획 | 계획 대비 실적과 가마감/확정을 어떤 기준으로 함께 보는가 | 인식일, 도서관파일 조정, 공통비, 계획 버전, 동일기간 표본 | P1 | 확인 예정 | `_materials/files/system-data-round1.md`; `_materials/files/sales-plans.md` |
| UI-06 | 프로모션·광고×실적 | 어떤 행사·캠페인이 어떤 SKU·채널·기간 실적과 연결되는가 | 채널·캠페인·프로모션 ID, SKU, 기간입도, 계정 접근 | P2 | 확인 예정 | `_materials/files/customer-basis-documents.md` §3.2 F-08~09; TikTok 원장 |
| UI-07 | LOT·품질 추적 | 문제 LOT가 어떤 제품·출고·고객 범위에 영향을 주는가 | BOM·처방, LOT 판정, 출고·주문 연결, 개인정보/RBAC | Extension 후보 | 근거 부족 | `_materials/screens/erp-u.md` §6; `_materials/files/raw-material-round-20260831.md:126-130`; LOT 출하적부 미수령 |
| UI-08 | 원료→완제품 영향 시각화 | 원료 수급·규격 변경이 어떤 완제품에 영향을 주는가 | 원료마스터·BOM 정본·제조사·유효기간 | Extension 후보 | 근거 부족 | `_materials/files/customer-basis-documents.md` §3.2 F-11 |
| UI-09 | 메디컬 채권 통합조회 | 거래처의 매출·수금·잔액·활동을 같은 기준으로 볼 수 있는가 | 전체 거래이력, 회전기준, 조회 시작일 영향, 입력범위 | P2 | 확인 예정 | `_materials/screens/erp-u.md` ERP-AR-01; 요구 F-12 |

## 3. 워크스루 세션

### 마스터 등록 위치에 대한 현재 설계 가설

| 층 | 현재 역할 가설 | 초기 구현 원칙 | 확인할 것 | 상태 |
|---|---|---|---|---|
| ERP | 회사/공장 품목과 운영 `item_code`의 기간계 정본 후보 | 조회·동기화 우선, 플랫폼에서 ERP 직접 수정하지 않음 | 코드 오너·등록승인·변경이력·정기 추출 | 확인 예정 |
| 통합 플랫폼 ITEM | ERP 코드를 기준으로 표준 품명·분류와 확장 속성·유효기간을 관리 | 원천값 보존, 승인된 확장 필드와 이력 관리 | CRUD/RBAC·승인 워크플로우 | 제안 |
| ITEM_CODE_MAP | WMS·OMS·3PL·채널 SKU·바코드를 ITEM에 연결 | 다대다·과거코드·예외·`valid_from/to` 허용 | 시스템별 코드 생성·전파·정정 책임 | 제안 |
| WMS·채널 | 실행 시스템의 원천 코드와 상태·수량을 유지 | 표준코드로 원천을 덮어쓰지 않음 | 반영주기·실패처리·역매핑 | 제안 |
| 원료·BOM | 연구소·ERP·제조사 원천을 연결할 별도 하위 마스터 후보 | 원료 원문과 코드·조성·문서 관계를 보존하고 BOM 수령 전 제품 연결 구조는 확정하지 않음 | 원료 식별·버전·업무오너, BM BOM, 문서·보안 오너 | 원료 자료 수령/BOM 미수령 |

### SCM 입출고·재고 흐름 가설

```text
주문·발주
  → 제품/원부자재 입고예정
  → WMS 입고·검수·품질상태
  → 창고/제조사/거래처 보유 및 창고이동
  → 주문·배정·가용재고에 따른 출고요청
  → WMS 출고·납품
  → 출고 실적과 재경 매출의 연결
  → 입출고 추세·재고·품절/과잉 분석
```

- 입고·WMS 출고·TODAY 창고이동·ERP 출고요청 화면의 존재는 확인됐다.
- 출고와 재경 매출의 실제 연결키·인식일·반영주기, 창고이동 승인과 반영 순서는 확인 예정이다.
- 출고지시 자동화는 `추천 → 검토/승인 → ERP 출고요청 연결 또는 표준 업로드`를 우선 검토한다. ERP 기간계 거래를 플랫폼이 직접 등록하는 것은 현재 확정 범위가 아니다.

### WS-01 제품·원료·재고 기준정보

| 항목 | 내용 |
|---|---|
| 우선 참석 | BM, SCM, 경영관리/재경, 연구개발, RM; 물류 시스템 담당 |
| 사전 제공 | 제품/SKU 파일, ERP 품목 화면 또는 추출, 원료 식별자료, 대표 BOM·처방, LOT 출하적부 표본 |
| 실제로 볼 것 | 회사/공장품목 등록, WMS 상품마스터, 코드 생성·변경·단종 사례, 창고·상태 대사 파일 |
| 질문 | 누가 어떤 목적에서 어떤 화면·필드를 보고 무엇을 판단하며 어떤 산출물을 만드는가; 수정·승인·전파는 어떻게 되는가; 주기·빈도·소요시간·KPI는 무엇인가 |
| 종료 산출물 | 체번·종료 규칙, ITEM/ITEM_CODE_MAP 구조, 오너·승인자, WMS·채널 전파방식, 적용 순서와 미결대장 |
| 상태 | 원료 목록·전성분·사급원료·동일원료 문서는 EDA 가능. BM BOM과 RM LOT 출하적부는 미수령이며 실제 생성·승인 흐름도 확인 필요 |

### WS-02 재고·입고·배정 정책

| 항목 | 내용 |
|---|---|
| 우선 참석 | SCM 구매·물류·S&OP, 한익·품고·글로비스 담당, 대표 영업부서, RM |
| 실제로 볼 것 | 동일 시각 ERP/WMS 재고, AG/EXP/QC 및 재고등급, 품고 가용/창고/불용, 글로비스 가용/보류/할당, 창고이동·외주출고 |
| 결정 | 물리창고/가상창고/제조사 보유 분리, 가용·배정·보류·불량 정의, 대사 책임과 허용오차, LOT 미제공 처리 |
| 기준선 | 현행 다운로드·대사 소요시간, 불일치 건수, 재고 선점·조정 빈도 |
| 상태 | 파일 실측 완료, 공식 상태사전·기준시각·오너 확인 예정 |

### WS-03 매출·가마감·손익·계획과 마케팅 공통기획

| 항목 | 내용 |
|---|---|
| 우선 참석 | 재경, 경영관리, 국내/해외 영업, SCM, MC·글로벌MC·동북아MC |
| 실제로 볼 것 | 도서관파일 생성 전 원본과 수기 조정, 가마감 산출물, 판매계획 버전, 대표 채널 sell-in/out, 같은 기간 프로모션·광고 실적 |
| 결정 | 판매/출고/정산일 용도, 가마감-확정 이력, 공통비 범위, 계획 버전, 채널·SKU·기간·캠페인 공통키 |
| 기준선 | 월 마감 리드타임, 수기 취합시간, 조정행·재작업 건수, 보고 KPI/KR |
| 상태 | 재경 누계매출·계획·TikTok 표본 실측, 도서관파일 조정과 광고계정 권한 확인 예정 |

### WS-04 채널 수집 방식

| 항목 | 내용 |
|---|---|
| 우선 참석 | 대표 채널 담당, GEC, 국내/글로벌 마케팅, IT·보안 |
| 실제로 볼 것 | API, 관리자 다운로드, 대행사 리포트, BigQuery 적재, 표준 업로드 후보 |
| 결정 | 자동/API·배치·파일업로드 구분, 수집주기, 실패 재처리, 보존기간, 계정·대행사 오너 |
| 상태 | TikTok/BigQuery 표본만 실측; 다수 채널은 요구정의 요약뿐 |

### WS-05 품질·채권

| 항목 | 내용 |
|---|---|
| 우선 참석 | RM, 연구소, 메디컬영업, 재경 |
| 실제로 볼 것 | LOT 출하적부, VOC/품질 시트, ERP 거래처원장 동일 거래처의 조회기간별 결과 |
| 결정 | 품질 상태·Claim·LOT 연결, 개인정보/RBAC, 채권 회전기준·조회범위, ERP 입력 유지 범위 |
| 상태 | ERP 화면 존재만 확인; 업무 원장과 산식은 미수령 |

## 4. 다음 고객 요청·확인 대장

| 요청 ID | 요청·확인 | 이유 | 우선도 | 상태 | 근거 |
|---|---|---|---:|---|---|
| ASK-01 | ERP 회사/공장 품목 추출과 코드 변경·단종 이력 | 기준 ITEM·전파 규칙 확정 | P0 | 확인 예정 | ERP-Q-01~03 |
| ASK-02 | 대표 BOM·LOT 출하적부와 원료 생성·변경 승인 흐름 | 수령한 원료·전성분·사급수불을 제품·LOT·품질로 연결 | P0 | 원료자료 수령/나머지 확인 예정 | `_materials/files/raw-material-round-20260831.md:126-157` |
| ASK-03 | 세 WMS 재고 추출 기준시각·검색조건·정기 추출방식 | 반복 적재와 대사 | P0 | 확인 예정 | `_materials/files/wms-data.md` |
| ASK-04 | ERP S/L↔한익·품고·글로비스 공식 매핑과 상태사전 | 창고·재고 표준화 | P0 | 확인 예정 | `_materials/files/wms-data.md` |
| ASK-05 | 도서관파일 조정규칙·가마감 산출물·동일기간 채널 원본 | 매출·가마감·손익 정의 | P1 | 확인 예정 | `_materials/files/system-data-round1.md` |
| ASK-06 | 프로모션 캘린더·광고 리포트의 동일기간 표본과 계정 오너 | 매출 설계 재작업 방지 | P1 | 확인 예정 | 요구 F-08~09 |
| ASK-07 | 시스템별 업무오너·기술오너·접근·갱신주기 | 수집 운영 설계 | P0 | 확인 예정 | `03-systems.md` 예정 |

## 5. 중간보고 게이트

다음 조건을 통과한 화면 중 1~2개만 MVP로 제시한다.

1. 실제 원천 2개 이상을 연결했고 미매핑·중복·다대다를 설명할 수 있다.
2. 기준시점과 계산식이 문서화됐다.
3. 업무오너가 표본 숫자를 대사했다.
4. 인터뷰에서 측정한 기존 소요시간 또는 KPI와 연결된다.
5. 확인 예정 정책을 확정값처럼 화면에 박지 않았다.

## 6. 랩업·Extension 후보의 취급

- LOT 기반 고객 영향추적과 BOM 기반 원료 영향 시각화는 현재 요구·원본이 부족한 Extension 후보로 유지한다.
- 개인정보가 필요한 고객 경고 기능은 별도 권한·목적·보존기간 합의 전 설계 확정하지 않는다.
- EDA·매핑·대사·오류처리 방법과 실행 로그를 운영 매뉴얼에 포함해 후임자가 원자료부터 다시 해석하지 않게 한다.