@simplysm/sd-claude 14.0.78 → 14.0.80

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

@@ -75,8 +75,7 @@ flowchart LR
 
 ### 2.2 출고 [OPEN: 2026-04-01]
 
-- 자료 위치: 회의록.md L40-50
-- 대화 발췌: 사용자 — "출고 부분은 입고 끝나고 다음 단계에서 보자"
+분석 방법: 회의록.md L40-50 재독 (입고 분석 끝난 후). 사용자 보류 발언 — "출고 부분은 입고 끝나고 다음 단계에서 보자".
 
 ## 3. 기타 요구사항
 
@@ -86,6 +85,12 @@ flowchart LR
 
 관련 섹션: [화면.재고 확인], [자동 처리.재고 스냅샷]
 
+### 3.2 마스터 데이터 변경 이력 [확정: 2026-04-01]
+
+모든 마스터 데이터의 변경 (등록·편집·활성/비활성 전환) 이력을 자동 기록해야 함. 변경 추적·감사 목적.
+
+관련 섹션: [횡단 처리.마스터 데이터 변경 이력]
+
 ## 4. 화면
 
 | §   | 분류     | 화면               | 유형     | 장치 |
@@ -106,7 +111,7 @@ Actor: 창고 관리자
 
 - 품목 마스터 CRUD (등록 / 편집 / 삭제·복구 / 엑셀 업·다운로드)
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
@@ -120,7 +125,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **필터**
 
@@ -137,7 +142,7 @@ Actor: 창고 관리자
 | 코드  | 문자             | -    | [모델.품목.코드] |                               |
 | 명칭  | 문자             | -    | [모델.품목.명칭] |                               |
 
-동작:
+#### 동작
 
 - `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
 - `[등록]` 클릭: [화면.품목 등록·편집] 을 빈 폼으로 모달 띄움
@@ -146,15 +151,15 @@ Actor: 창고 관리자
 - `[선택 복구]` 클릭: 선택된 행들의 활성 여부 true 전환
 - `[엑셀 업로드]` 클릭: 엑셀 파일 선택 → 코드 기준 일괄 등록/수정
 - `[엑셀 다운로드]` 클릭: 현재 검색 필터 적용된 목록을 엑셀로 내보내기
-- `[화주 자료 업로드]` 클릭: [공통 정의.화주 품목 자료] 파일 선택 → 아래 양식 매핑 적용 후 코드 기준 일괄 등록/수정
+- `[화주 자료 업로드]` 클릭: [공통 정의.화주 품목 자료] 파일 선택 → 아래 업로드 양식 적용 후 코드 기준 일괄 등록/수정
 
-시각 규칙:
+#### 시각 규칙
 
 - 비활성 행: 전체 취소선 + 회색
 
-양식 매핑:
+#### 업로드 양식
 
-**업로드 양식** ([공통 정의.화주 품목 자료] → [모델.품목])
+[공통 정의.화주 품목 자료] → [모델.품목]
 
 | 파일 컬럼          | 도메인 모델      | 변환·규칙                        |
 | ------------------ | ---------------- | -------------------------------- |
@@ -170,7 +175,7 @@ Actor: 창고 관리자
 
 - 품목 신규 등록 또는 기존 품목 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────┐
@@ -182,7 +187,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **입력 폼**
 
@@ -191,7 +196,7 @@ Actor: 창고 관리자
 | 코드 | 텍스트 입력 | O    | [모델.품목.코드] |      |
 | 명칭 | 텍스트 입력 | O    | [모델.품목.명칭] |      |
 
-동작:
+#### 동작
 
 - `[저장]` 클릭: 활성 품목 내 코드·명칭 유일성 검증 → 저장 → 모달 닫음
 - `[취소]` 클릭: 변경 사항 폐기 → 모달 닫음
@@ -206,7 +211,7 @@ Actor: 창고 관리자
 - Location 마스터 CRUD (등록 / 편집 / 삭제·복구 / 엑셀 업·다운로드)
 - 두 가지 바코드 출력: A4 다중 + 라벨프린터 1매씩
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌────────────────────────────────────────────────────────────────────────────────────┐
@@ -219,7 +224,7 @@ Actor: 창고 관리자
 └────────────────────────────────────────────────────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **필터**
 
@@ -235,7 +240,7 @@ Actor: 창고 관리자
 | ID    | 숫자 + 편집 버튼 | -    | [모델.Location.ID]   | 클릭 시 편집 모달             |
 | 코드  | 문자             | -    | [모델.Location.코드] |                               |
 
-동작:
+#### 동작
 
 - `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
 - `[등록]` 클릭: [화면.Location 등록·편집] 을 빈 폼으로 모달 띄움
@@ -255,7 +260,7 @@ Actor: 창고 관리자
     1. 선택된 Location 을 [공통 정의.Location 라벨] 규격으로 라벨프린터 1매씩 출력
     2. 다중 선택 시 선택 수만큼 연속 출력
 
-시각 규칙:
+#### 시각 규칙
 
 - 비활성 행: 전체 취소선 + 회색
 
@@ -268,7 +273,7 @@ Actor: 창고 관리자
 
 - Location 신규 등록 또는 기존 Location 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────┐
@@ -280,7 +285,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **입력 폼**
 
@@ -288,7 +293,7 @@ Actor: 창고 관리자
 | ---- | ----------- | ---- | -------------------- | ----------------------- |
 | 코드 | 텍스트 입력 | O    | [모델.Location.코드] | 영문 대문자/숫자/하이픈 |
 
-동작:
+#### 동작
 
 - `[저장]` 클릭: 활성 Location 내 코드 유일성 검증 → 저장 → 모달 닫음
 - `[취소]` 클릭: 변경 사항 폐기 → 모달 닫음
@@ -302,7 +307,7 @@ Actor: 창고 작업자
 
 - 박스 → Location 순서로 스캔하여 재고 등록
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌────────────────────────┐
@@ -315,7 +320,7 @@ Actor: 창고 작업자
        (360 × 568)
 ```
 
-항목:
+#### 항목
 
 **스캔 입력 폼**
 
@@ -324,7 +329,7 @@ Actor: 창고 작업자
 | 박스 바코드 | 텍스트 입력 | O    | -                    | PDA 스캐너 입력. 파싱 = 품목코드 + 수량 + 박스번호 |
 | Location    | 텍스트 입력 | O    | [모델.Location.코드] | PDA 스캐너 입력                                    |
 
-동작:
+#### 동작
 
 - `[등록]` 클릭:
   - 절차:
@@ -343,7 +348,7 @@ Actor: 창고 관리자
 - 현재 재고: Location 별 적치된 박스 + 품목·수량 조회
 - 과거 시점 재고: 특정 날짜의 스냅샷 조회
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
@@ -356,7 +361,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **필터**
 
@@ -375,7 +380,7 @@ Actor: 창고 관리자
 | 품목     | 문자 | -    | [모델.재고.박스.품목.코드] | 품목 코드 표시 |
 | 수량     | 숫자 | -    | [모델.재고.박스.수량]      |                |
 
-동작:
+#### 동작
 
 - `[조회]` 클릭:
   - 기준일 비어있음: 현재 [모델.재고] 조회
@@ -387,49 +392,73 @@ Actor: 창고 관리자
 
 ### 5.1 재고 스냅샷 [확정: 2026-04-01]
 
-```mermaid
-flowchart LR
-    S([매일 0시]) --> T1[현재 재고 전체 조회]
-    T1 --> T2[스냅샷 테이블에 날짜별 저장]
-    T2 --> E1([완료])
-```
-
-목적:
-
-- 과거 시점 재고 조회 지원
+목적: 과거 시점 재고 조회 지원
 
-트리거:
+트리거: 매일 0시 정각
 
-- 매일 0시 정각
+관련 섹션: [기타.과거 재고 조회], [화면.재고 확인]
 
-처리:
+#### 처리
 
 - [모델.재고] 전체를 [모델.재고 스냅샷] 에 날짜별로 저장
 
-예외 처리:
+#### 예외 처리
 
 - 스냅샷 생성 실패 시:
   - 위험: 당일 분 누락 시 해당 날짜의 과거 시점 조회 불가
   - 대처: 관리자 알림. 동일 일자 재실행 시 (날짜, 박스) 유일성 검증으로 중복 생성 방지
   - 재시도 한계: 별도 재시도 없음 (다음 날 0시 정상 동작)
 
-관련 섹션: [기타.과거 재고 조회], [화면.재고 확인]
+## 6. 횡단 처리
+
+### 6.1 마스터 데이터 변경 이력 [확정: 2026-04-01]
+
+목적: 마스터 변경 추적·감사 (누가 언제 무엇을 어떻게 바꿨는지)
+
+트리거 (부수효과 발동 조건):
+- 마스터 엔티티의 insert / update / delete 트랜잭션 commit 시
+- 적용 범위: [모델.품목], [모델.Location]
+- 적용 제외: 트랜잭션 모델 ([모델.재고], [모델.재고 스냅샷])
+
+관련 섹션: [기타.마스터 데이터 변경 이력], [모델.품목], [모델.Location], [모델.DataLog]
+
+#### 처리
+
+- 변경 전 값과 변경 후 값 캡처 (insert 시 변경 전 = null, delete 시 변경 후 = null)
+- [모델.DataLog] 에 한 행 적재 (테이블·키·전·후·작업자·시각)
+
+#### 예외 처리
+
+- DataLog 적재 실패 시:
+  - 위험: 변경 추적 누락
+  - 대처: 본 트랜잭션은 정상 commit 유지, DataLog 적재 실패만 별도 큐로 적재 후 관리자 알림
+  - 재시도 한계: 큐에서 5회 지수 백오프 후 운영팀 알림
+
+#### 모델 매핑
+
+| 필드 ([모델.DataLog]) | 용도                            |
+| --------------------- | ------------------------------- |
+| [모델.DataLog.테이블명] | 변경 대상 모델명 (예: `품목`) |
+| [모델.DataLog.키]       | 변경 대상 ID                  |
+| [모델.DataLog.변경 전]  | 컬럼별 변경 전 값 (JSON)      |
+| [모델.DataLog.변경 후]  | 컬럼별 변경 후 값 (JSON)      |
+| [모델.DataLog.작업자]   | 세션 사용자                   |
+| [모델.DataLog.시각]     | 변경 commit 시각              |
 
-## 6. 공통 정의
+## 7. 공통 정의
 
-### 6.1 용어 사전 [확정: 2026-04-01]
+### 7.1 용어 사전 [확정: 2026-04-01]
 
 - 박스: 외부에서 이미 바코드(품목+수량+박스번호)가 부착된 입고 단위
 - Location: 창고 내 적치 위치 ([공통 정의.Location 라벨])
 - ERP 통보: 입출고 발생 시 WMS → ERP 단방향 알림
 - 활성 여부: 마스터 데이터의 소프트 삭제 플래그 (true = 정상, false = 삭제 처리됨). UI 의 "삭제/복구" 액션과 매핑. 마스터에 완전 삭제(DB 레코드 제거) 없음.
 
-### 6.2 박스 바코드 형식 [OPEN: 2026-04-01]
+### 7.2 박스 바코드 형식 [OPEN: 2026-04-01]
 
-- 자료 위치: 첨부B.pdf p.5 "박스 코드 체계" — 외부 송장 시스템 규격 명세
-- 자료 연결 메모: 박스 코드는 외부 규격이지만 [모델.박스] 식별 키 구조와 직결 — §7 박스 확정과 함께 검토
+분석 방법: 첨부B.pdf p.5 "박스 코드 체계" (외부 송장 시스템 규격) 분석. [모델.박스] 식별 키 구조와 직결 — §8 박스 확정과 함께 검토.
 
-### 6.3 Location 라벨 [확정: 2026-04-01]
+### 7.3 Location 라벨 [확정: 2026-04-01]
 
 ```
 ┌────────────────────────────────┐
@@ -446,7 +475,7 @@ flowchart LR
 - 라벨 크기: 100 × 50 mm
 - 라벨 재질: 유포지, 흰색 무지
 
-### 6.4 화주 품목 자료 [확정: 2026-04-01]
+### 7.4 화주 품목 자료 [확정: 2026-04-01]
 
 화주(품목을 본 WMS 에 보관 위탁한 거래처)가 자기 ERP 에서 수시로 다운로드해 화주별 별도 파일로 전달한다. 신규 화주 등록 또는 화주 측 품목 마스터 변경 시점에 본 WMS 에 1회 일괄 업로드한다. 식별 키는 `화주코드 + SEQ` 2컬럼 합성.
 
@@ -457,18 +486,18 @@ flowchart LR
 | 품목명   | O    | 화주 측 명칭                                        |
 | 단위     | X    | `EA` / `BOX` 등                                     |
 
-## 7. 도메인 모델
+## 8. 도메인 모델
 
-### 7.1 품목 [확정: 2026-04-01]
+### 8.1 품목 [확정: 2026-04-01]
 
 필드:
 
-| 필드      | 타입    | 필수 | 비고             |
-| --------- | ------- | ---- | ---------------- |
-| ID        | 숫자    | O    | 자동 부여        |
+| 필드      | 타입    | 필수 | 비고                 |
+| --------- | ------- | ---- | -------------------- |
+| ID        | 숫자    | O    | 자동 부여            |
 | 코드      | 문자    | O    | 자유 형식, 수정 가능 |
-| 명칭      | 문자    | O    |                  |
-| 활성 여부 | boolean | O    |                  |
+| 명칭      | 문자    | O    |                      |
+| 활성 여부 | boolean | O    |                      |
 
 키/제약:
 
@@ -476,7 +505,7 @@ flowchart LR
 - 비즈니스 키: 코드 (사용자 부여, 수정 가능)
 - 유일성: 활성 품목 내 코드, 명칭 각각 유일
 
-### 7.2 박스 [확정: 2026-04-01]
+### 8.2 박스 [확정: 2026-04-01]
 
 필드:
 
@@ -494,7 +523,7 @@ flowchart LR
 - 박스 1개 = 단일 품목
 - 유일성: 박스번호 유일
 
-### 7.3 Location [확정: 2026-04-01]
+### 8.3 Location [확정: 2026-04-01]
 
 필드:
 
@@ -510,7 +539,7 @@ flowchart LR
 - 비즈니스 키: 코드 (사용자 부여, 수정 가능)
 - 유일성: 활성 Location 내 코드 유일
 
-### 7.4 재고 [확정: 2026-04-01]
+### 8.4 재고 [확정: 2026-04-01]
 
 필드:
 
@@ -526,31 +555,52 @@ flowchart LR
 - 박스 1개는 동시에 1개 Location 에만 존재 (= 박스-재고 1:1)
 - Location 1개에 박스 다중 가능
 
-### 7.5 재고 스냅샷 [확정: 2026-04-01]
+### 8.5 재고 스냅샷 [확정: 2026-04-01]
 
 필드:
 
-| 필드     | 타입            | 필수 | 비고      |
-| -------- | --------------- | ---- | --------- |
-| ID       | 숫자            | O    | 자동 부여 |
+| 필드     | 타입            | 필수 | 비고        |
+| -------- | --------------- | ---- | ----------- |
+| ID       | 숫자            | O    | 자동 부여   |
 | 날짜     | 날짜            | O    | 스냅샷 일자 |
-| 박스     | 참조 - 박스     | O    |           |
-| Location | 참조 - Location | O    |           |
+| 박스     | 참조 - 박스     | O    |             |
+| Location | 참조 - Location | O    |             |
 
 키/제약:
 
 - 식별 키: ID (자동 부여)
 - 비즈니스 키: (날짜, 박스) 조합 유일
 
-## 8. 외부 인터페이스
+### 8.6 DataLog [확정: 2026-04-01]
 
-### 8.1 ERP 입고 통보 [확정: 2026-04-01]
+필드:
+
+| 필드     | 타입 | 필수 | 비고                                  |
+| -------- | ---- | ---- | ------------------------------------- |
+| ID       | 숫자 | O    | 자동 부여                             |
+| 테이블명 | 문자 | O    | 변경 대상 모델명 (예: `품목`)         |
+| 키       | 숫자 | O    | 변경 대상 ID                          |
+| 변경 전  | JSON | X    | 컬럼별 이전 값. insert 시 null        |
+| 변경 후  | JSON | X    | 컬럼별 변경 후 값. delete 시 null     |
+| 작업자   | 문자 | O    | 세션 사용자                           |
+| 시각     | 일시 | O    | 변경 commit 시각                      |
+
+키/제약:
+
+- 식별 키: ID (자동 부여)
+- 인덱스: (테이블명, 키, 시각) — 특정 엔티티 변경 이력 조회용
+
+## 9. 외부 인터페이스
+
+### 9.1 ERP 입고 통보 [확정: 2026-04-01]
 
 - 상대 시스템: ERP
 - 방향: WMS → ERP
 - 전송 방식: REST API (POST)
 
-자료 매핑:
+관련 섹션: [화면.입고 스캔]
+
+#### 자료 매핑
 
 | ERP 필드 | WMS 출처              |
 | -------- | --------------------- |
@@ -559,7 +609,7 @@ flowchart LR
 | 박스번호 | [모델.박스.박스번호]  |
 | 발생시각 | 입고 등록 시각        |
 
-예외 처리:
+#### 예외 처리
 
 - 호출 실패 (네트워크 오류, ERP 서버 일시 다운 등):
   - 위험: 단순 재시도 시 ERP 에 같은 박스가 2번 입고 등록될 수 있음 (첫 호출이 실제로는 ERP 에 도달했는데 응답만 못 받은 경우 등)
@@ -567,23 +617,22 @@ flowchart LR
   - 대처: 위 전제 하에 지수 백오프로 재시도, 최대 5회
   - 재시도 한계 초과: 관리자 알림 (이후 수동 확인 필요)
 
-관련 섹션: [화면.입고 스캔]
-
-## 9. 본문 외 결정사항
+## 10. 본문 외 결정사항
 
-### 9.1 분석 제외 항목 [확정: 2026-04-01]
-
-- 직원 관리 사원번호 컬럼 추가
+- 2026-04-01 [제외]: 직원 관리 사원번호 컬럼 추가
+  - 근거: 본 spec 범위 밖 — 인사 마스터 영역
   - 후속 처리: sd-dev
   - 자료 위치: 회의록.md L42
-- 재고 확인 화면 정렬 버그
+
+- 2026-04-01 [제외]: 재고 확인 화면 정렬 버그
+  - 근거: 본 spec 범위 밖 — 운영 잔손
   - 후속 처리: 운영 잔손
   - 자료 위치: 이슈 #128
 
-## 10. 변경 이력
+- 2026-04-01: 출고 분석은 입고 끝나고 다음 단계
+  - 근거: 사용자 결정 — 입고 검증 후 출고 진행이 안전
+  - 자료 위치: 회의록.md L40-50
+  - 영향: §2.2 출고 OPEN 상태 유지
 
-- 2026-04-01: 운영 잔손 분리 — 직원 관리 사원번호 컬럼 추가, 재고 확인 화면 정렬 버그. 분석 제외 항목으로 기록.
-- 2026-04-01: 입고 분석 완료. 출고·박스 바코드 형식 보류.
-- 2026-04-01: 과거 재고 조회 요구 식별 → 재고 스냅샷 모델·자동 처리 추가, 재고 확인 화면에 기준일 필터 반영.
-- 2026-04-01: ERP 입고 통보 식별 → 입고 스캔 등록 후속 동작에서 호출.
-- 2026-04-05: 품목 관리·품목 등록·편집 sd-impl 완료 (구현 마커 부착).
+- 2026-04-05: 품목 마스터 sd-impl 완료 (구현 마커 부착)
+  - 근거: 시연 검증 통과 (§4.1·§4.2)

package/claude/skills/sd-unpack/SKILL.md

@@ -49,10 +49,10 @@ meeting_eml/
     embedded_xlsx/
       README.md
       _source.xlsx
-      workbook.meta.json     ← defined names 등 (있을 때)
+      workbook.meta.json     ← defined names·sheet_code_map (있을 때)
       sheets/
-        01_Sheet1.png
-        01_Sheet1.jsonl
+        01_Sheet1.png        ← 시각 (서식·바탕색·border 모두)
+        01_Sheet1.jsonl      ← 분석 데이터 (값·number_format·수식·merges 등)
 ```
 
 형식별 산출물 매트릭스:
@@ -61,7 +61,7 @@ meeting_eml/
 |---|---|---|---|
 | pptx/ppt | `slides/<idx>_<title>.png` | `slides/<idx>_<title>.jsonl` (슬라이드별 노드) | `charts/*.data.json`, `images/`, `attachments/`, `macros/` |
 | docx/doc | `pages/<NNN>.png` (시각 검증용) | `content.jsonl` (단일 시퀀스), `pages.meta.json` (PNG↔노드 매핑) | `images/`, `attachments/`, `macros/` |
-| xlsx/xlsb/xls | `sheets/<idx>_<name>.png` | `sheets/<idx>_<name>.jsonl` (값·수식·시트 메타 통합), `workbook.meta.json` | `charts/*.data.json`, `images/<sheet>_<cell>`, `attachments/`, `macros/` |
+| xlsx/xlsb/xls | `sheets/<idx>_<name>.png` (일반 시트만) | `sheets/<idx>_<name>.jsonl` (값·수식·시트 메타), `workbook.meta.json` | `charts/sheet<idx>_chart*.data.json` (일반 시트 안 차트 + Chartsheet 의 차트), `images/<sheet>_<cell>`, `attachments/`, `macros/` |
 | pdf | `pages/<NNN>.png` | `pages/<NNN>.jsonl` (블록 bbox + 표 셀 단위) | `images/p<NNN>_b<bid>.<ext>`, `attachments/` (PDF 임베드) |
 | eml/msg | — | `body.md` (평문 본문), `headers.json`, `images.rels.json` | `body.html` (원본), `attachments/` (컨테이너면 재귀) |
 
@@ -78,11 +78,14 @@ meeting_eml/
 
 ## xlsx jsonl 규약
 
-시트별 `.jsonl`. 좌표 명시로 위치 셈 오차 차단.
+시트별 `.jsonl` — 분석 핵심 (값·number_format·수식·merges·hyperlinks·comments). 시각 표시 (바탕색·border·폰트)·frozen·dims 는 미보존 (PNG 가 시각 보조, 필요 시 `_source.xlsx` 직접 추출).
 
-- 첫 줄: `{"_meta":{"dims":[행수,열수], "merges":["A1:C1",...], "frozen":"A4", "hyperlinks":{"D5":"http://..."}, "comments":{"E3":"메모"}, "number_formats":{"H4":"#,##0", "E1":"yyyy-mm-dd"}}}`
-  - 비어있는 메타 키는 생략
-  - `number_formats`: General(기본) 외 셀의 표시 형식 (통화·날짜·% 등)
+- 첫 줄: `{"_meta":{"merges":["A1:C1",...], "number_formats":{"E1":"yyyy-mm-dd",...}, "hyperlinks":{"D5":"http://..."}, "comments":{"E3":"메모"}}}`
+  - `merges`: 머지된 셀 영역 (셀 좌표 해석에 필수 — 머지 영역 안 빈 셀 오해 차단)
+  - `number_formats`: General(기본) 외 셀 표시 형식 — Date·통화·% 등 셀 값 의미 단서
+  - `hyperlinks`: 셀 URL (URL 자체가 셀 정보)
+  - `comments`: 셀 메모
+  - 비어있는 메타 키는 생략 (모두 비면 `{"_meta":{}}`)
 - 데이터 줄: `{"r":11, "A":"P001", "I":7800, "J":12.5, "_f":{"I":"=SUM(...)", "J":"=I11*1.5"}}`
   - `r`: 1-based 행번호 (Excel 동일)
   - 열문자 키 (`A`·`B`·...·`AA`·...): 셀 값. 빈 셀은 키 생략
@@ -90,8 +93,22 @@ meeting_eml/
 - 빈 행도 `{"r":N}` 한 줄 유지 → Read offset = 행번호 (오프바이원 차단)
 - 값 타입: JSON 네이티브 (`int`·`float`·`bool`·`str`), datetime 은 ISO 8601 문자열
 
-워크북 단위 메타 (시트 외) 는 `workbook.meta.json`:
+### Chartsheet (시트 자체가 차트)
+
+xlsx 안 시트는 일반 Worksheet 외에 **Chartsheet** (셀 없이 차트 1개) 도 있을 수 있음.
+
+- Chartsheet 는 `sheets/<idx>_<name>.jsonl` 미생성 (셀 없음)
+- Chartsheet 의 차트 데이터: `charts/sheet<idx>_chart.data.json`
+- README sheet_summaries 에 `(chart sheet — "...")` 명시
+- 일반 시트·Chartsheet 통합 시트 순서 (idx) 대로 보존
+
+### 워크북 단위 `workbook.meta.json`
+
+시트 외 워크북 공통 정보 (있을 때만 생성):
+
 - `defined_names`: `{"이름":["'Sheet1'!$A$1:$C$10", ...]}` (다중 destination 시 list 다수 항목)
+- `sheet_code_map`: `{"Sheet1":"BOA", ...}` (VBA codeName → raw 시트명. 매크로 모듈 파일명과 매칭용)
+- `pivots`: pivot table 정의 list. 각 항목 `{name, source, location, rowFields, colFields, pageFields, dataFields}`. 결과 셀은 시트별 jsonl 에 일반 셀로 들어감
 
 ## pptx jsonl 규약
 
@@ -146,15 +163,17 @@ paragraph 안 hyperlink 가 있으면 `hyperlinks`: `[{"text":"...", "url":"..."
 
 페이지별 `pages/<NNN>.jsonl`. PDF 페이지는 원본 단위.
 
-- 첫 줄: `{"_meta":{"page":N, "size":[w,h], "blocks":B, "tables":T, "table_cells":C}}`
+- 첫 줄: `{"_meta":{"page":N, "size":[w,h], "blocks":B, "tables":T, "table_cells":C, "form_fields":F, "annotations":A}}`
 - 노드 줄:
   - `text_block`: `{"page":N, "block":B, "type":"text_block", "bbox":[x0,y0,x1,y1], "text":"..."}`
   - `image_block`: `{"page":N, "block":B, "type":"image_block", "bbox":[...], "ref":"images/p001_b03.png"}`
   - `table_cell`: `{"page":N, "type":"table_cell", "table_idx":T, "table_bbox":[...], "row":R, "col":C, "text":"..."}`
+  - `form_field`: `{"page":N, "type":"form_field", "name":"...", "field_type":"text", "value":"...", "bbox":[...]}` (PDF 양식 입력란)
+  - `annotation`: `{"page":N, "type":"annotation", "subtype":"Highlight", "bbox":[...], "content":"...", "author":"..."}` (주석·highlight·sticky note)
 - 모든 블록 보존 (표 영역과 겹쳐도 skip 안 함) — find_tables 정확도 100% 가정 시 정보 손실 위험 회피. text_block·image_block·table_cell 노드가 동일 영역에 중복 출력될 수 있음. Claude 가 양쪽 비교 판단
-- bbox 는 PDF 기준 좌표 (left-top, pt 단위, 소수점 2자리)
+- bbox 는 PDF 기준 좌표 (left-top, pt 단위, raw float)
 
-heading 추출은 미적용 (PDF 는 style 정보 없음). 필요 시 본문 grep 으로 패턴 검출.
+heading 추출은 미적용 (PDF 는 style 정보 없음). OCR 미적용 (스캔 PDF 는 image_block 만 추출).
 
 ## 인라인 이미지 매핑 (eml/msg)
 
@@ -166,6 +185,12 @@ heading 추출은 미적용 (PDF 는 style 정보 없음). 필요 시 본문 gre
   - text/plain·HTML 둘 다 있을 때 → `body.md` 는 plain (placeholder 없음), `body.from_html.md` 가 변환본 (placeholder 포함)
 - 인라인 이미지 없으면 `images.rels.json` 미생성
 
+## TNEF (winmail.dat) 풀이
+
+Outlook RTF 메일이 첨부를 `winmail.dat` 단일 binary (TNEF 형식) 로 패키징한 경우, `tnefparse` 로 내부 첨부 추출하여 `attachments/` 에 같이 풀어 둠. 원본 `winmail.dat` 도 유지 (원본 보존).
+
+내부 첨부도 컨테이너 (xlsx·pptx 등) 면 재귀 풀이 (다른 첨부와 동일).
+
 ## eml/msg 본문 규약
 
 본문 흐름 정확성(text/plain 우선) + 인라인 이미지 위치 단서(HTML→평문 변환본) 둘 다 보존:
@@ -183,8 +208,8 @@ heading 추출은 미적용 (PDF 는 style 정보 없음). 필요 시 본문 gre
 ## xlsb 클린업
 
 - legacy → xlsx 변환 시 `_converted.xlsx` 는 임시 폴더에서만 처리 (산출 폴더에 미잔존)
-- VBA 매크로 파일 첫 줄에 시트 객체명↔raw 시트명 매핑 코멘트 추가
-  - 예: `Sheet1.vba` 첫 줄 `' (object: Sheet1, sheet: "BOA")`
+- VBA 매크로는 원본 코드 그대로 `macros/<모듈명>.vba` 저장 (변형 X)
+- VBA 시트 객체명↔raw 시트명 매핑은 `workbook.meta.json` 의 `sheet_code_map` 키 (예: `{"Sheet1":"BOA","Sheet3":"Mapping"}`)
 
 ## 산출물 사용
 

package/claude/skills/sd-unpack/scripts/handlers/_common.py

@@ -160,6 +160,65 @@ def temp_workdir():
         shutil.rmtree(d, ignore_errors=True)
 
 
+def is_tnef(path: Path) -> bool:
+    """TNEF (winmail.dat) 형식인지 검사. filename 또는 magic bytes."""
+    if path.name.lower() in ("winmail.dat", "win.dat"):
+        return True
+    try:
+        with open(long_str(path), "rb") as f:
+            magic = f.read(4)
+        return magic == b"\x78\x9f\x3e\x22"
+    except Exception:
+        return False
+
+
+def unpack_tnef(path: Path, attachments_dir: Path) -> list[Path]:
+    """TNEF (winmail.dat) 내부 첨부 추출. 추출된 path list 반환.
+
+    TNEF 아니거나 실패 시 빈 list. 원본 winmail.dat 은 유지 (원본 보존).
+    """
+    if not is_tnef(path):
+        return []
+    ensure_pip("tnefparse")
+    try:
+        from tnefparse import TNEF
+        with open(long_str(path), "rb") as f:
+            t = TNEF(f.read())
+    except Exception:
+        return []
+
+    saved: list[Path] = []
+    for att in getattr(t, "attachments", []):
+        try:
+            name = None
+            lf = getattr(att, "long_filename", None)
+            if callable(lf):
+                try:
+                    name = lf()
+                except Exception:
+                    name = None
+            if not name:
+                name = getattr(att, "name", None)
+            if isinstance(name, bytes):
+                try:
+                    name = name.decode("utf-8")
+                except UnicodeDecodeError:
+                    name = name.decode("cp949", errors="replace")
+            if not name:
+                name = "tnef_attachment.bin"
+            data = att.data
+            if not data:
+                continue
+        except Exception:
+            continue
+        if not isinstance(name, str):
+            name = "tnef_attachment.bin"
+        dst = unique_path(attachments_dir, name)
+        write_bytes(dst, data)
+        saved.append(dst)
+    return saved
+
+
 def save_source(input_path: Path, out_dir: Path) -> None:
     ext = input_path.suffix.lstrip(".")
     dst = out_dir / f"_source.{ext}"

package/claude/skills/sd-unpack/scripts/handlers/eml_handler.py

@@ -136,6 +136,13 @@ def run(input_path: Path, out_dir: Path) -> None:
             json.dumps(rels, ensure_ascii=False, indent=2),
         )
 
+    # TNEF (winmail.dat) 풀이 — Outlook RTF 메일의 첨부 패키지 안 내부 첨부 추출
+    tnef_saved: list[Path] = []
+    for ap in saved_attachments:
+        extra = _common.unpack_tnef(ap, attachments_dir)
+        tnef_saved.extend(extra)
+    saved_attachments.extend(tnef_saved)
+
     attachment_links: list[str] = []
     for ap in saved_attachments:
         size = ap.stat().st_size