개요

데모 · US 3PL 고객 가시성 포털 (시나리오 1)

고객사 US 법인의 3PL 운영 가시성 요구 SOW 105개 항목에 대한 회신서(Fit 62 · Partial 41 · Gap 2)를 화면으로 증명하는 데모입니다. 재고 8상태·시리얼 개체 추적· 복합운송 구간·통관·POD·SAP 인터페이스를 한 흐름으로 이어 붙였고, 회신서에서 「신규 개발 필요」라고 답한 Gap 2건도 여기서 실제로 돌아갑니다.

전량 가상 데이터입니다. 고객 회신서(US 3PL 기능확인요청 260907)의 SOW 105항목을 화면으로 증명하기 위한 시연용이며 실제 재고·주문·운송 수치가 아닙니다. 기준일 2026-09-01 · 대상 기간 2026-03-01 ~ 2026-08-31. 데이터 관리에서 Excel 업로드로 교체하거나 초기화할 수 있습니다.

이 데모가 답하는 5가지 질문

1고객이 자기 재고를 상태별·시리얼별·로케이션별로 지금 볼 수 있는가창고×품목 8상태 표 + 로케이션 잔고 + 시리얼 개체 목록보기
2시리얼 하나를 찍으면 입고부터 배송까지 전 이동이력이 나오는가입하→적치→품질→이동→할당→피킹→출하→마일스톤→배송→POD보기
3배송완료인데 POD 가 없는 화물을 시스템이 먼저 찾아내는가POD 누락 탭 + 운송사 요청이력(Gap #95)보기
4통관에서 막힌 화물을 막힌 그 시점에 알려 주는가통관 차단 경보 + 보류일수·근거보기
5SAP 와 무엇을 주고받는가 — 인터페이스 목록과 실패 재처리가 보이는가인터페이스 12본 · 일별 로그 · 재처리보기

회신서 커버리지

SOW 105개 항목 전건이 화면·엔진 함수에 매핑돼 있습니다. 이 숫자는 화면에서 세지 않고 src/lib/les/coverage.ts 에서 오며, 검증 ⑮ 가 회신서 원문(docs/les/SPEC.md)과 매번 대조합니다 — 화면을 지우거나 판정을 바꾸면 즉시 깨집니다.

충족 (Fit) 62부분충족 (Partial) 41미충족 (Gap) 2합계 105
Gap 2건 — 이 데모의 요점입니다. 회신서에 「대응 엔티티 없음 · 신규 개발 필요」로 답한 두 건을 눈앞에서 돌려 보입니다.
  • #32 ★ 공급사↔고객 시리얼 매핑 테이블 + 역조회 + 미매핑 84개체 — 회신서 Gap — 데모에서 실제로 구현 · /serial
  • #95 ★ 운송사 POD 요청이력(채널·응답·대기시간) — 회신서 Gap — 데모에서 실제로 구현 · /pod
시연 순서
  1. ① /data 에서 [시연 데이터로 초기화] — 항상 같은 상태에서 시작합니다.
  2. ② /dashboard 에서 6축 필터를 걸어 KPI 가 함께 움직이는 것을 봅니다(합계 보존).
  3. ③ /stock 에서 8상태 표를 보고 검사대기(격리) 행을 눌러 /serial 로 내려갑니다.
  4. ④ /serial 에서 고객 시리얼로 역조회 → 매핑 없는 개체(Gap #32)를 찾아 그 자리에서 등록합니다.
  5. ⑤ /inbound/receipt 에서 시리얼을 중복 스캔해 검증이 즉시 잡아내는 것을 보입니다.
  6. ⑥ /shipments 에서 해상 구간이 늦어진 화물의 ETA 재산정 근거를 폅니다.
  7. ⑦ /pod 의 [POD 없음] 탭에서 5건을 확인하고 운송사에 요청(Gap #95) → 요청이력에 남는 것을 보입니다.
  8. ⑧ /alerts 에서 9종을 근거와 함께 훑고, /interface 에서 실패 메시지를 재처리해 마무리합니다.