@simplysm/sd-claude 14.0.65 → 14.0.66

package/claude/skills/sd-spec/references/example-spec.md

@@ -0,0 +1,585 @@
+# WMS 요구 분석서 (예시)
+
+> sd-spec 스킬이 산출하는 `spec.md` 의 풀 example.
+> 가상의 WMS 시나리오 — 박스 단위 Location 관리 + ERP 단방향 통보.
+> 시나리오 일자 = 2026-04-01 (사용자 확정 시작일 가정).
+
+## 1. 개요
+
+### 1.1 핵심 목적 [확정: 2026-04-01]
+
+박스 단위로 Location 추적, 입출고 발생을 ERP 와 연동하는 WMS
+
+### 1.2 주요 목표 [확정: 2026-04-01]
+
+- 박스 입고 처리
+- 박스 출고 처리
+- 입출고에 의한 재고 확인
+- 입출고 정보 ERP 동기화
+
+### 1.3 최종 사용자/이해관계자 [확정: 2026-04-01]
+
+- 창고 작업자: 현장에서 PDA를 들고 실제로 물건을 옮기는 작업을 하는 사람
+- 창고 관리자: 사무실에서 PC로 전반적인 관리나 일상 업무를 하는 사람
+
+### 1.4 환경/장치 [확정: 2026-04-01]
+
+```
+   ┌─────────┐              ┌─────────┐
+   │   PC    │              │   PDA   │
+   └────┬────┘              └────┬────┘
+        │                        │
+        └───────────┬────────────┘
+                    ▼
+              ┌───────────┐   통보(단방향)   ┌───────┐
+              │ WMS 서버  │ ───────────────► │  ERP  │
+              └─────┬─────┘                  └───────┘
+                    │
+            ┌───────┴────────┐
+            ▼                ▼
+      ┌───────────┐   ┌───────────────┐
+      │ A4 Printer│   │ Label Printer │
+      └───────────┘   └───────────────┘
+```
+
+- PC — 창고 관리자가 마스터·출고지시서·재고 화면에 사용
+  - OS: Windows 11
+  - Browser: Chrome 최신
+  - 해상도: 1920 x 1080
+- PDA — 창고 작업자가 박스·Location 스캔에 사용
+  - Model: DS60S
+  - OS: Android 9
+  - 해상도: 360 x 568
+- A4 Printer — 출고지시서 출력, Location 바코드 전체 출력(A4 다중)
+  - 스펙: 일반 시중의 모든 프린터
+- Label Printer — Location 라벨 1매씩 출력
+  - Model: [OPEN]
+
+## 2. 업무 프로세스
+
+### 2.1 입고 [확정: 2026-04-01]
+
+```mermaid
+flowchart LR
+    S([물건 도착]) --> T1[창고 작업자: PDA 박스 바코드 스캔]
+    T1 --> T2[창고 작업자: PDA Location 바코드 스캔]
+    T2 --> E1([입고 등록 완료])
+```
+
+- 박스 1개는 단일 품목·단일 Location (1개 박스가 2개 Location 동시 존재 X)
+- 입고 등록 = 박스의 첫 Location 적치 시점 (재입고/이동은 본 프로세스 X)
+- 박스 바코드는 외부에서 이미 부착된 상태로 도착 (창고에서 발급 X)
+- ERP 통보는 박스번호 기준 멱등 (재시도 가능)
+
+관련 섹션: [화면.입고 스캔], [화면.품목 관리], [화면.Location 관리], [화면.재고 확인]
+
+### 2.2 출고 [OPEN: 2026-04-01]
+
+- 자료 위치: 회의록.md L40-50
+- 대화 발췌: 사용자 — "출고 부분은 입고 끝나고 다음 단계에서 보자"
+
+## 3. 기타 요구사항
+
+### 3.1 과거 재고 조회 [확정: 2026-04-01]
+
+특정 일자의 재고 상태를 조회할 수 있어야 함.
+
+관련 섹션: [화면.재고 확인], [자동 처리.재고 스냅샷]
+
+## 4. 화면
+
+| §   | 분류     | 화면               | 유형     | 장치 |
+| --- | -------- | ------------------ | -------- | ---- |
+| 4.1 | 기준정보 | 품목 관리          | 마스터   | PC   |
+| 4.2 | 기준정보 | 품목 등록·편집     | 마스터   | PC   |
+| 4.3 | 기준정보 | Location 관리      | 마스터   | PC   |
+| 4.4 | 기준정보 | Location 등록·편집 | 마스터   | PC   |
+| 4.5 | 입고     | 입고 스캔          | 트랜잭션 | PDA  |
+| 4.6 | 재고     | 재고 확인          | 조회     | PC   |
+
+### 4.1 품목 관리 (PC) [확정: 2026-04-01, 구현: 2026-04-05]
+
+Actor: 창고 관리자
+관련 섹션: [프로세스.입고]
+
+기능 개요:
+
+- 품목 마스터 CRUD (등록 / 편집 / 삭제·복구 / 엑셀 업·다운로드)
+
+와이어프레임:
+
+```
+┌──────────────────────────────────────────────────────────────────────────┐
+│ 품목 관리                                                                │
+│ [조회]  <필터>                                                           │
+├──────────────────────────────────────────────────────────────────────────┤
+│ [등록] [선택 삭제] [선택 복구] [엑셀 업로드] [엑셀 다운로드]             │
+│ [화주 자료 업로드]                                                       │
+│ ──────────────────────────────────────────────────────────────────────── │
+│ <품목 목록 시트>                                                         │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+항목:
+
+**필터**
+
+| 항목 | 종류   | 필수 | 비고                     |
+| ---- | ------ | ---- | ------------------------ |
+| 검색 | 텍스트 | X    | 코드 또는 명칭 부분 일치 |
+
+**품목 목록 시트** (코드까지 fixed)
+
+| 컬럼  | 종류             | 필수 | 도메인 매핑      | 비고                          |
+| ----- | ---------------- | ---- | ---------------- | ----------------------------- |
+| `[ ]` | 선택 체크박스    | -    | -                |                               |
+| ID    | 숫자 + 편집 버튼 | -    | [모델.품목.ID]   | 클릭 시 편집 모달             |
+| 코드  | 문자             | -    | [모델.품목.코드] |                               |
+| 명칭  | 문자             | -    | [모델.품목.명칭] |                               |
+
+동작:
+
+- `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
+- `[등록]` 클릭: [화면.품목 등록·편집] 을 빈 폼으로 모달 띄움
+- ID 버튼 클릭: [화면.품목 등록·편집] 을 해당 행 데이터로 모달 띄움
+- `[선택 삭제]` 클릭: 선택된 행들의 활성 여부 false 전환 (입출고 불가)
+- `[선택 복구]` 클릭: 선택된 행들의 활성 여부 true 전환
+- `[엑셀 업로드]` 클릭: 엑셀 파일 선택 → 코드 기준 일괄 등록/수정
+- `[엑셀 다운로드]` 클릭: 현재 검색 필터 적용된 목록을 엑셀로 내보내기
+- `[화주 자료 업로드]` 클릭: [공통 정의.화주 품목 자료] 파일 선택 → 아래 양식 매핑 적용 후 코드 기준 일괄 등록/수정
+
+시각 규칙:
+
+- 비활성 행: 전체 취소선 + 회색
+
+양식 매핑:
+
+**업로드 양식** ([공통 정의.화주 품목 자료] → [모델.품목])
+
+| 파일 컬럼          | 도메인 모델      | 변환·규칙                        |
+| ------------------ | ---------------- | -------------------------------- |
+| `화주코드` + `SEQ` | [모델.품목.코드] | `<화주코드>-<SEQ>` 형식으로 합성 |
+| `품목명`           | [모델.품목.명칭] | 1:1                              |
+
+### 4.2 품목 등록·편집 (PC) [확정: 2026-04-01, 구현: 2026-04-05]
+
+Actor: 창고 관리자
+관련 섹션: [프로세스.입고]
+
+기능 개요:
+
+- 품목 신규 등록 또는 기존 품목 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
+
+와이어프레임:
+
+```
+┌──────────────────────────────────────┐
+│ 품목 등록·편집                       │
+├──────────────────────────────────────┤
+│ <입력 폼>                            │
+├──────────────────────────────────────┤
+│             [저장]  [취소]           │
+└──────────────────────────────────────┘
+```
+
+항목:
+
+**입력 폼**
+
+| 항목 | 종류        | 필수 | 도메인 매핑       | 비고 |
+| ---- | ----------- | ---- | ----------------- | ---- |
+| 코드 | 텍스트 입력 | O    | [모델.품목.코드] |      |
+| 명칭 | 텍스트 입력 | O    | [모델.품목.명칭] |      |
+
+동작:
+
+- `[저장]` 클릭: 활성 품목 내 코드·명칭 유일성 검증 → 저장 → 모달 닫음
+- `[취소]` 클릭: 변경 사항 폐기 → 모달 닫음
+
+### 4.3 Location 관리 (PC) [확정: 2026-04-01]
+
+Actor: 창고 관리자
+관련 섹션: [프로세스.입고]
+
+기능 개요:
+
+- Location 마스터 CRUD (등록 / 편집 / 삭제·복구 / 엑셀 업·다운로드)
+- 두 가지 바코드 출력: A4 다중 + 라벨프린터 1매씩
+
+와이어프레임:
+
+```
+┌────────────────────────────────────────────────────────────────────────────────────┐
+│ Location 관리                                                                      │
+│ [조회]  <필터>                                                                     │
+├────────────────────────────────────────────────────────────────────────────────────┤
+│ [등록] [선택 삭제] [선택 복구] [엑셀 업로드] [엑셀 다운로드] [A4 출력] [선택 라벨 출력]│
+│ ────────────────────────────────────────────────────────────────────────────────── │
+│ <Location 목록 시트>                                                               │
+└────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+항목:
+
+**필터**
+
+| 항목 | 종류   | 필수 | 비고           |
+| ---- | ------ | ---- | -------------- |
+| 검색 | 텍스트 | X    | 코드 부분 일치 |
+
+**Location 목록 시트** (코드까지 fixed)
+
+| 컬럼  | 종류             | 필수 | 도메인 매핑          | 비고                          |
+| ----- | ---------------- | ---- | -------------------- | ----------------------------- |
+| `[ ]` | 선택 체크박스    | -    | -                    |                               |
+| ID    | 숫자 + 편집 버튼 | -    | [모델.Location.ID]   | 클릭 시 편집 모달             |
+| 코드  | 문자             | -    | [모델.Location.코드] |                               |
+
+동작:
+
+- `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
+- `[등록]` 클릭: [화면.Location 등록·편집] 을 빈 폼으로 모달 띄움
+- ID 버튼 클릭: [화면.Location 등록·편집] 을 해당 행 데이터로 모달 띄움
+- `[선택 삭제]` 클릭: 선택된 행들의 활성 여부 false 전환
+- `[선택 복구]` 클릭: 선택된 행들의 활성 여부 true 전환
+- `[엑셀 업로드]` 클릭: 엑셀 파일 선택 → 코드 기준 일괄 등록/수정
+- `[엑셀 다운로드]` 클릭: 현재 필터 적용된 목록을 엑셀로 다운로드
+- `[A4 출력]` 클릭 (A4 다중):
+  - 절차:
+    1. 선택된 Location 목록을 A4 1매에 그리드로 배치
+    2. 각 칸에 [공통 정의.Location 라벨] 의 표시 항목을 인쇄
+    3. PDF 다운로드 또는 직접 인쇄
+  - [OPEN] A4 1매당 그리드 행/열
+- `[선택 라벨 출력]` 클릭 (라벨프린터):
+  - 절차:
+    1. 선택된 Location 을 [공통 정의.Location 라벨] 규격으로 라벨프린터 1매씩 출력
+    2. 다중 선택 시 선택 수만큼 연속 출력
+
+시각 규칙:
+
+- 비활성 행: 전체 취소선 + 회색
+
+### 4.4 Location 등록·편집 (PC) [확정: 2026-04-01]
+
+Actor: 창고 관리자
+관련 섹션: [프로세스.입고]
+
+기능 개요:
+
+- Location 신규 등록 또는 기존 Location 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
+
+와이어프레임:
+
+```
+┌──────────────────────────────────────┐
+│ Location 등록·편집                   │
+├──────────────────────────────────────┤
+│ <입력 폼>                            │
+├──────────────────────────────────────┤
+│             [저장]  [취소]           │
+└──────────────────────────────────────┘
+```
+
+항목:
+
+**입력 폼**
+
+| 항목 | 종류        | 필수 | 도메인 매핑          | 비고                    |
+| ---- | ----------- | ---- | -------------------- | ----------------------- |
+| 코드 | 텍스트 입력 | O    | [모델.Location.코드] | 영문 대문자/숫자/하이픈 |
+
+동작:
+
+- `[저장]` 클릭: 활성 Location 내 코드 유일성 검증 → 저장 → 모달 닫음
+- `[취소]` 클릭: 변경 사항 폐기 → 모달 닫음
+
+### 4.5 입고 스캔 (PDA) [확정: 2026-04-01]
+
+Actor: 창고 작업자
+관련 섹션: [프로세스.입고], [외부인터페이스.ERP 입고 통보]
+
+기능 개요:
+
+- 박스 → Location 순서로 스캔하여 재고 등록
+
+와이어프레임:
+
+```
+┌────────────────────────┐
+│ 입고 스캔              │
+├────────────────────────┤
+│ <스캔 입력 폼>         │
+│                        │
+│       [ 등록 ]         │
+└────────────────────────┘
+       (360 × 568)
+```
+
+항목:
+
+**스캔 입력 폼**
+
+| 항목        | 종류        | 필수 | 도메인 매핑          | 비고                                               |
+| ----------- | ----------- | ---- | -------------------- | -------------------------------------------------- |
+| 박스 바코드 | 텍스트 입력 | O    | -                    | PDA 스캐너 입력. 파싱 = 품목코드 + 수량 + 박스번호 |
+| Location    | 텍스트 입력 | O    | [모델.Location.코드] | PDA 스캐너 입력                                    |
+
+동작:
+
+- `[등록]` 클릭:
+  - 절차:
+    1. 박스 바코드 파싱 (품목코드 / 수량 / 박스번호)
+    2. 모델 존재 검증 (품목 활성 / Location 활성 / 박스번호 미중복)
+    3. [모델.재고] 생성
+    4. [외부인터페이스.ERP 입고 통보] 호출
+
+### 4.6 재고 확인 (PC) [확정: 2026-04-01]
+
+Actor: 창고 관리자
+관련 섹션: [프로세스.입고], [기타.과거 재고 조회], [자동 처리.재고 스냅샷]
+
+기능 개요:
+
+- 현재 재고: Location 별 적치된 박스 + 품목·수량 조회
+- 과거 시점 재고: 특정 날짜의 스냅샷 조회
+
+와이어프레임:
+
+```
+┌──────────────────────────────────────────────────────────────────────────┐
+│ 재고 확인                                                                │
+│ [조회]  <필터>                                                           │
+├──────────────────────────────────────────────────────────────────────────┤
+│ [엑셀 다운로드]                                                          │
+│ ──────────────────────────────────────────────────────────────────────── │
+│ <재고 시트>                                                              │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+항목:
+
+**필터**
+
+| 항목          | 종류   | 필수 | 비고                                         |
+| ------------- | ------ | ---- | -------------------------------------------- |
+| 기준일        | 날짜   | X    | 비우면 현재. 과거 일자 입력 시 스냅샷 조회   |
+| 품목 필터     | 텍스트 | X    | 코드 부분 일치                               |
+| Location 필터 | 텍스트 | X    | 코드 부분 일치                               |
+
+**재고 시트**
+
+| 컬럼     | 종류 | 필수 | 도메인 매핑                | 비고           |
+| -------- | ---- | ---- | -------------------------- | -------------- |
+| Location | 문자 | -    | [모델.재고.Location.코드]  |                |
+| 박스번호 | 문자 | -    | [모델.재고.박스.박스번호]  |                |
+| 품목     | 문자 | -    | [모델.재고.박스.품목.코드] | 품목 코드 표시 |
+| 수량     | 숫자 | -    | [모델.재고.박스.수량]      |                |
+
+동작:
+
+- `[조회]` 클릭:
+  - 기준일 비어있음: 현재 [모델.재고] 조회
+  - 기준일 입력됨: [모델.재고 스냅샷] 에서 해당 날짜 분 조회
+  - 필터 조건 적용 → 결과 표시
+- `[엑셀 다운로드]` 클릭: 현재 조회 결과를 엑셀로 다운로드
+
+## 5. 자동 처리
+
+### 5.1 재고 스냅샷 [확정: 2026-04-01]
+
+```mermaid
+flowchart LR
+    S([매일 0시]) --> T1[현재 재고 전체 조회]
+    T1 --> T2[스냅샷 테이블에 날짜별 저장]
+    T2 --> E1([완료])
+```
+
+목적:
+
+- 과거 시점 재고 조회 지원
+
+트리거:
+
+- 매일 0시 정각
+
+처리:
+
+- [모델.재고] 전체를 [모델.재고 스냅샷] 에 날짜별로 저장
+
+예외 처리:
+
+- 스냅샷 생성 실패 시:
+  - 위험: 당일 분 누락 시 해당 날짜의 과거 시점 조회 불가
+  - 대처: 관리자 알림. 동일 일자 재실행 시 (날짜, 박스) 유일성 검증으로 중복 생성 방지
+  - 재시도 한계: 별도 재시도 없음 (다음 날 0시 정상 동작)
+
+관련 섹션: [기타.과거 재고 조회], [화면.재고 확인]
+
+## 6. 공통 정의
+
+### 6.1 용어 사전 [확정: 2026-04-01]
+
+- 박스: 외부에서 이미 바코드(품목+수량+박스번호)가 부착된 입고 단위
+- Location: 창고 내 적치 위치 ([공통 정의.Location 라벨])
+- ERP 통보: 입출고 발생 시 WMS → ERP 단방향 알림
+- 활성 여부: 마스터 데이터의 소프트 삭제 플래그 (true = 정상, false = 삭제 처리됨). UI 의 "삭제/복구" 액션과 매핑. 마스터에 완전 삭제(DB 레코드 제거) 없음.
+
+### 6.2 박스 바코드 형식 [OPEN: 2026-04-01]
+
+- 자료 위치: 첨부B.pdf p.5 "박스 코드 체계" — 외부 송장 시스템 규격 명세
+- 자료 연결 메모: 박스 코드는 외부 규격이지만 [모델.박스] 식별 키 구조와 직결 — §7 박스 확정과 함께 검토
+
+### 6.3 Location 라벨 [확정: 2026-04-01]
+
+```
+┌────────────────────────────────┐
+│                                │
+│   [Code128 바코드: A-01-03]    │
+│                                │
+│            A-01-03             │
+│                                │
+└────────────────────────────────┘
+```
+
+- 표시 항목: 바코드 + Location 코드 텍스트
+- 심볼로지: Code128
+- 라벨 크기: 100 × 50 mm
+- 라벨 재질: 유포지, 흰색 무지
+
+### 6.4 화주 품목 자료 [확정: 2026-04-01]
+
+화주(품목을 본 WMS 에 보관 위탁한 거래처)가 자기 ERP 에서 수시로 다운로드해 화주별 별도 파일로 전달한다. 신규 화주 등록 또는 화주 측 품목 마스터 변경 시점에 본 WMS 에 1회 일괄 업로드한다. 식별 키는 `화주코드 + SEQ` 2컬럼 합성.
+
+| 컬럼     | 필수 | 설명                                                |
+| -------- | ---- | --------------------------------------------------- |
+| 화주코드 | O    | 화주 ERP 의 품목 코드. 영문 대문자 + 숫자, 최대 8자 |
+| SEQ      | O    | 같은 화주코드 내 revision 일련번호. 숫자 3자리      |
+| 품목명   | O    | 화주 측 명칭                                        |
+| 단위     | X    | `EA` / `BOX` 등                                     |
+
+## 7. 도메인 모델
+
+### 7.1 품목 [확정: 2026-04-01]
+
+필드:
+
+| 필드      | 타입    | 필수 | 비고             |
+| --------- | ------- | ---- | ---------------- |
+| ID        | 숫자    | O    | 자동 부여        |
+| 코드      | 문자    | O    | 자유 형식, 수정 가능 |
+| 명칭      | 문자    | O    |                  |
+| 활성 여부 | boolean | O    |                  |
+
+키/제약:
+
+- 식별 키: ID (자동 부여)
+- 비즈니스 키: 코드 (사용자 부여, 수정 가능)
+- 유일성: 활성 품목 내 코드, 명칭 각각 유일
+
+### 7.2 박스 [확정: 2026-04-01]
+
+필드:
+
+| 필드     | 타입        | 필수 | 비고                                  |
+| -------- | ----------- | ---- | ------------------------------------- |
+| ID       | 숫자        | O    | 자동 부여                             |
+| 박스번호 | 문자        | O    | [공통 정의.박스 바코드 형식] 형식 따름 |
+| 품목     | 참조 - 품목 | O    |                                       |
+| 수량     | 숫자        | O    |                                       |
+
+키/제약:
+
+- 식별 키: ID (자동 부여)
+- 비즈니스 키: 박스번호
+- 박스 1개 = 단일 품목
+- 유일성: 박스번호 유일
+
+### 7.3 Location [확정: 2026-04-01]
+
+필드:
+
+| 필드      | 타입    | 필수 | 비고                                                                |
+| --------- | ------- | ---- | ------------------------------------------------------------------- |
+| ID        | 숫자    | O    | 자동 부여                                                           |
+| 코드      | 문자    | O    | 영문 대문자/숫자/하이픈. 수정 가능. 예 `A-01-03`, `ZONE1-RACK7-LV2` |
+| 활성 여부 | boolean | O    |                                                                     |
+
+키/제약:
+
+- 식별 키: ID (자동 부여)
+- 비즈니스 키: 코드 (사용자 부여, 수정 가능)
+- 유일성: 활성 Location 내 코드 유일
+
+### 7.4 재고 [확정: 2026-04-01]
+
+필드:
+
+| 필드     | 타입            | 필수 | 비고      |
+| -------- | --------------- | ---- | --------- |
+| ID       | 숫자            | O    | 자동 부여 |
+| 박스     | 참조 - 박스     | O    |           |
+| Location | 참조 - Location | O    |           |
+
+키/제약:
+
+- 식별 키: ID (자동 부여)
+- 박스 1개는 동시에 1개 Location 에만 존재 (= 박스-재고 1:1)
+- Location 1개에 박스 다중 가능
+
+### 7.5 재고 스냅샷 [확정: 2026-04-01]
+
+필드:
+
+| 필드     | 타입            | 필수 | 비고      |
+| -------- | --------------- | ---- | --------- |
+| ID       | 숫자            | O    | 자동 부여 |
+| 날짜     | 날짜            | O    | 스냅샷 일자 |
+| 박스     | 참조 - 박스     | O    |           |
+| Location | 참조 - Location | O    |           |
+
+키/제약:
+
+- 식별 키: ID (자동 부여)
+- 비즈니스 키: (날짜, 박스) 조합 유일
+
+## 8. 외부 인터페이스
+
+### 8.1 ERP 입고 통보 [확정: 2026-04-01]
+
+- 상대 시스템: ERP
+- 방향: WMS → ERP
+- 전송 방식: REST API (POST)
+
+자료 매핑:
+
+| ERP 필드 | WMS 출처              |
+| -------- | --------------------- |
+| 품목코드 | [모델.박스.품목.코드] |
+| 수량     | [모델.박스.수량]      |
+| 박스번호 | [모델.박스.박스번호]  |
+| 발생시각 | 입고 등록 시각        |
+
+예외 처리:
+
+- 호출 실패 (네트워크 오류, ERP 서버 일시 다운 등):
+  - 위험: 단순 재시도 시 ERP 에 같은 박스가 2번 입고 등록될 수 있음 (첫 호출이 실제로는 ERP 에 도달했는데 응답만 못 받은 경우 등)
+  - 방지 전제: ERP 가 박스번호를 키로 사용해 이미 받은 통보는 무시하도록 구성되어야 함
+  - 대처: 위 전제 하에 지수 백오프로 재시도, 최대 5회
+  - 재시도 한계 초과: 관리자 알림 (이후 수동 확인 필요)
+
+관련 섹션: [화면.입고 스캔]
+
+## 9. 본문 외 결정사항
+
+### 9.1 분석 제외 항목 [확정: 2026-04-01]
+
+- 직원 관리 사원번호 컬럼 추가 — 운영 잔손
+- 재고 확인 화면 정렬 버그 — 운영 잔손
+
+## 10. 변경 이력
+
+- 2026-04-01: 운영 잔손 분리 — 직원 관리 사원번호 컬럼 추가, 재고 확인 화면 정렬 버그. 분석 제외 항목으로 기록.
+- 2026-04-01: 입고 분석 완료. 출고·박스 바코드 형식 보류.
+- 2026-04-01: 과거 재고 조회 요구 식별 → 재고 스냅샷 모델·자동 처리 추가, 재고 확인 화면에 기준일 필터 반영.
+- 2026-04-01: ERP 입고 통보 식별 → 입고 스캔 등록 후속 동작에서 호출.
+- 2026-04-05: 품목 관리·품목 등록·편집 sd-impl 완료 (구현 마커 부착).