@simplysm/sd-claude 14.0.89 → 14.0.91

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

@@ -93,14 +93,14 @@ flowchart LR
 
 ## 4. 화면
 
-| §   | 분류     | 화면               | 유형     | 장치 |
-| --- | -------- | ------------------ | -------- | ---- |
-| 4.1 | 기준정보 | 품목 관리          | 마스터   | PC   |
-| 4.2 | 기준정보 | 품목 등록·편집     | 마스터   | PC   |
-| 4.3 | 기준정보 | Location 관리      | 마스터   | PC   |
-| 4.4 | 기준정보 | Location 등록·편집 | 마스터   | PC   |
-| 4.5 | 입고     | 입고 스캔          | 트랜잭션 | PDA  |
-| 4.6 | 재고     | 재고 확인          | 조회     | PC   |
+| §   | 분류     | 화면          | 유형     | 장치 |
+| --- | -------- | ------------- | -------- | ---- |
+| 4.1 | 기준정보 | 품목 관리     | 마스터   | PC   |
+| 4.2 | 기준정보 | Location 관리 | 마스터   | PC   |
+| 4.3 | 입고     | 입고 스캔     | 트랜잭션 | PDA  |
+| 4.4 | 재고     | 재고 확인     | 조회     | PC   |
+
+전용 모달(품목 등록·편집·Location 등록·편집)은 각각 호출 화면(품목 관리·Location 관리) 한 곳에서만 쓰이므로 별도 §4.x 로 분리하지 않고 부모 §4.x 안에 포함 (sub-section). 자세한 배치 규칙은 spec-authoring.md "모달 처리" 참조.
 
 ### 4.1 품목 관리 (PC) [확정: 2026-04-01, 구현: 2026-04-05]
 
@@ -145,8 +145,8 @@ Actor: 창고 관리자
 #### 동작
 
 - `[조회]` 클릭: 검색 필터 조건으로 목록을 갱신
-- `[등록]` 클릭: [화면.품목 등록·편집] 을 빈 폼 상태로 모달 띄움
-- ID 버튼 클릭: [화면.품목 등록·편집] 을 해당 행 데이터로 채워 모달 띄움
+- `[등록]` 클릭: → 품목 등록·편집 을 빈 폼 상태로 모달 띄움
+- ID 버튼 클릭: → 품목 등록·편집 을 해당 행 데이터로 채워 모달 띄움
 - `[선택 삭제]` 클릭: 선택된 행들의 활성 여부를 false 로 전환 (이후 해당 품목 입출고 불가)
 - `[선택 복구]` 클릭: 선택된 행들의 활성 여부를 true 로 전환
 - `[엑셀 업로드]` 클릭: 엑셀 파일 선택 후, 코드를 키로 일괄 등록·수정
@@ -166,16 +166,11 @@ Actor: 창고 관리자
 | `화주코드` + `SEQ` | [모델.품목.코드] | `<화주코드>-<SEQ>` 형식으로 합성 |
 | `품목명`           | [모델.품목.명칭] | 1:1                              |
 
-### 4.2 품목 등록·편집 (PC) [확정: 2026-04-01, 구현: 2026-04-05]
+#### 품목 등록·편집 (모달)
 
-Actor: 창고 관리자
-관련 섹션: [프로세스.입고]
-
-기능 개요:
+품목 신규 등록 또는 기존 품목 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움).
 
-- 품목 신규 등록 또는 기존 품목 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
-
-#### 와이어프레임
+##### 와이어프레임
 
 ```
 ┌──────────────────────────────────────┐
@@ -187,7 +182,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────┘
 ```
 
-#### 항목
+##### 항목
 
 **입력 폼**
 
@@ -196,12 +191,12 @@ Actor: 창고 관리자
 | 코드 | 텍스트 입력 | O    | [모델.품목.코드] |      |
 | 명칭 | 텍스트 입력 | O    | [모델.품목.명칭] |      |
 
-#### 동작
+##### 동작
 
 - `[저장]` 클릭: 활성 품목 내에서 코드·명칭 유일성을 검증한 뒤 저장하고 모달 닫음
 - `[취소]` 클릭: 변경 사항을 폐기하고 모달 닫음
 
-### 4.3 Location 관리 (PC) [확정: 2026-04-01]
+### 4.2 Location 관리 (PC) [확정: 2026-04-01]
 
 Actor: 창고 관리자
 관련 섹션: [프로세스.입고]
@@ -243,8 +238,8 @@ Actor: 창고 관리자
 #### 동작
 
 - `[조회]` 클릭: 검색 필터 조건으로 목록을 갱신
-- `[등록]` 클릭: [화면.Location 등록·편집] 을 빈 폼 상태로 모달 띄움
-- ID 버튼 클릭: [화면.Location 등록·편집] 을 해당 행 데이터로 채워 모달 띄움
+- `[등록]` 클릭: → Location 등록·편집 을 빈 폼 상태로 모달 띄움
+- ID 버튼 클릭: → Location 등록·편집 을 해당 행 데이터로 채워 모달 띄움
 - `[선택 삭제]` 클릭: 선택된 행들의 활성 여부를 false 로 전환
 - `[선택 복구]` 클릭: 선택된 행들의 활성 여부를 true 로 전환
 - `[엑셀 업로드]` 클릭: 엑셀 파일 선택 후, 코드를 키로 일괄 등록·수정
@@ -264,16 +259,11 @@ Actor: 창고 관리자
 
 - 비활성 행: 전체 텍스트에 취소선 + 회색 처리
 
-### 4.4 Location 등록·편집 (PC) [확정: 2026-04-01]
+#### Location 등록·편집 (모달)
 
-Actor: 창고 관리자
-관련 섹션: [프로세스.입고]
-
-기능 개요:
+Location 신규 등록 또는 기존 Location 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움).
 
-- Location 신규 등록 또는 기존 Location 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
-
-#### 와이어프레임
+##### 와이어프레임
 
 ```
 ┌──────────────────────────────────────┐
@@ -285,7 +275,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────┘
 ```
 
-#### 항목
+##### 항목
 
 **입력 폼**
 
@@ -293,12 +283,12 @@ Actor: 창고 관리자
 | ---- | ----------- | ---- | -------------------- | ----------------------- |
 | 코드 | 텍스트 입력 | O    | [모델.Location.코드] | 영문 대문자/숫자/하이픈 |
 
-#### 동작
+##### 동작
 
 - `[저장]` 클릭: 활성 Location 내에서 코드 유일성을 검증한 뒤 저장하고 모달 닫음
 - `[취소]` 클릭: 변경 사항을 폐기하고 모달 닫음
 
-### 4.5 입고 스캔 (PDA) [확정: 2026-04-01]
+### 4.3 입고 스캔 (PDA) [확정: 2026-04-01]
 
 Actor: 창고 작업자
 관련 섹션: [프로세스.입고], [외부 인터페이스.ERP 입고 통보]
@@ -338,7 +328,7 @@ Actor: 창고 작업자
     3. [모델.재고] 레코드 생성
     4. [외부 인터페이스.ERP 입고 통보] 호출
 
-### 4.6 재고 확인 (PC) [확정: 2026-04-01]
+### 4.4 재고 확인 (PC) [확정: 2026-04-01]
 
 Actor: 창고 관리자
 관련 섹션: [프로세스.입고], [기타.과거 재고 조회], [자동 처리.재고 스냅샷]
@@ -602,4 +592,4 @@ Actor: 창고 관리자
   - 영향: 업무 프로세스 출고(2.2번 섹션) OPEN 상태 유지
 
 - 2026-04-05: 품목 마스터 sd-impl 완료 (구현 마커 부착)
-  - 근거: 시연 검증 통과 — 화면 품목 관리(4.1번 섹션), 품목 등록·편집(4.2번 섹션)
+  - 근거: 시연 검증 통과 — 화면 품목 관리(4.1번 섹션, 품목 등록·편집 모달 영역 포함)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "14.0.89",
+  "version": "14.0.91",
   "description": "심플리즘 패키지 - Claude Code 셋업",
   "author": "심플리즘",
   "license": "Apache-2.0",

package/claude/references/sd-simplysm14/apis/core-common/json-transfer.md

@@ -1,53 +0,0 @@
-# @simplysm/core-common — JSON / Worker 직렬화 (json / transfer)
-
-커스텀 타입을 보존하며 직렬화/역직렬화할 때 함께 읽히는 묶음. `json`(문자열 ↔ 객체)과 `transfer`(Web Worker 메시지 ↔ 객체). 두 모듈 모두 `Date`/`DateTime`/`DateOnly`/`Time`/`Uuid`/`Set`/`Map`/`Error`/`Uint8Array` 를 `{ __type__, data }` 태그 객체로 변환해 왕복 보존한다. (XML 직렬화 `xml` 네임스페이스는 README 의 "xml" 인라인 섹션 참조.)
-
-## json
-
-`import { json } from "@simplysm/core-common"`.
-
-```typescript
-json.stringify(obj: unknown, options?: {
-  space?: string | number;
-  replacer?: (key: string | undefined, value: unknown) => unknown;
-  redactBytes?: boolean;
-}): string;
-json.parse<TResult = unknown>(json: string): TResult;
-```
-
-- `stringify(obj, options)` — 커스텀 타입을 태그 객체로 변환 후 `JSON.stringify`. 전역 프로토타입을 건드리지 않아 Worker 환경에서 안전.
-  - `space` — 들여쓰기(숫자=공백 수, 문자열=들여쓰기 문자).
-  - `replacer(key, value)` — 기본 타입 변환 **전에** 호출되는 커스텀 변환 훅.
-  - `redactBytes: true` — `Uint8Array` 내용을 `"__hidden__"` 으로 대체(로깅용). 이 결과는 `parse` 로 복원 불가(복원 시도 시 `SdError`).
-  - 순환 참조가 있으면 `TypeError`. `toJSON` 메서드가 있는 객체는 그 결과를 사용(Date/DateTime 등 커스텀 타입은 사전 변환 처리됨).
-- `parse(json)` — 태그 객체를 원래 타입으로 복원. 복원 후 **모든 JSON null 을 undefined 로 변환**(simplysm null-free 규칙, `obj.nullToUndefined` 사용). 파싱 실패 시 `SdError`로 감싸 throw — `env("DEV")` 가 truthy 면 전체 JSON 문자열을, 아니면 길이만 메시지에 포함.
-
-주의: 사용자 데이터에 우연히 `{ __type__: "Date"|..., data: ... }` 형태가 있으면 의도치 않게 타입으로 복원될 수 있음.
-
-```typescript
-const s = json.stringify({ at: new DateTime(), id: Uuid.generate() }, { space: 2 });
-const o = json.parse<{ at: DateTime; id: Uuid }>(s); // 타입 복원, null→undefined
-```
-
-## transfer
-
-`import { transfer } from "@simplysm/core-common"`. `structuredClone` 이 다루지 못하는 커스텀 타입을 Worker 로 보내기 위한 인코딩/디코딩.
-
-```typescript
-transfer.encode(obj: unknown): { result: unknown; transferList: ArrayBuffer[] };
-transfer.decode(obj: unknown): unknown;
-```
-
-- `encode(obj)` — 커스텀 타입을 태그 객체로 변환한 `result` 와, zero-copy 전송 대상 `transferList`(Uint8Array 의 ArrayBuffer)를 반환. `postMessage(result, transferList)` 에 그대로 전달.
-  - `Uint8Array` 는 태그하지 않고 그대로 두되 그 buffer 를 `transferList` 에 추가(`SharedArrayBuffer` 는 제외 — 이미 공유 메모리).
-  - `Error` 는 `name`/`message`/`stack` 과 존재 시 `code`/`detail`/`cause` 까지 재귀 인코딩.
-  - 순환 참조 시 경로 정보를 담아 `TypeError` throw. 같은 객체가 여러 번 참조되면 캐싱된 인코딩 재사용.
-- `decode(obj)` — Worker 에서 받은 데이터의 태그 객체를 원래 타입으로 복원(`Date`/`DateTime`/`DateOnly`/`Time`/`Uuid`/`RegExp`/`Error`, Array/Map/Set/객체 재귀). `Uint8Array` 는 그대로 통과.
-
-```typescript
-// 송신
-const { result, transferList } = transfer.encode(data);
-worker.postMessage(result, transferList);
-// 수신
-const decoded = transfer.decode(event.data);
-```