@simplysm/sd-claude 14.0.65 → 14.0.68

package/claude/references/sd-requirement-source-handling.md

@@ -0,0 +1,64 @@
+# Requirement Source 부정확성 처리
+
+## STT 텍스트 보정
+
+**명백한 오타만 보정**. 보정 시 `[원문]` 발췌로 원본도 보존.
+
+```markdown
+> [2026-03-17 회의] "PDF에 빨간색으로 강조"
+> [원문] "PDF에 빨간색으루 강조"
+> 출처: .docs/회의대본_3.txt:L120
+```
+
+판정:
+- ✅ 명백 (오타 1~2글자, 의미 자명): 보정
+- ❌ 모호 (의미가 여러 갈래로 해석 가능): **사용자에게 즉시 확인**, 원문 그대로 발췌
+
+## 화자 추정
+
+회의록 화자가 부정확/누락된 경우 컨텍스트로 추정. `[추정: ...]` 표기.
+
+```markdown
+> [2026-03-17 회의, 추정: B 차장] "주문 단위로 가는 게 맞다"
+> 출처: .docs/회의대본_3.txt:L78-L80
+```
+
+판정:
+- ✅ 컨텍스트로 명확: 추정
+- ❌ 모호: **사용자에게 즉시 확인**, 화자 미상으로 발췌
+
+## 모호 발화 처리
+
+지시대명사·생략 표현·비격식 발언:
+- "그거 그렇게" / "이렇게 가는 걸로" / "지난번처럼" / "알아서"
+
+처리:
+- **자동 해석 금지** (이전 발언/맥락 추측해서 채워 넣지 말 것)
+- **사용자에게 즉시 확인** — "그거"가 무엇인지, "그렇게"가 어떤 방식인지
+
+## 다중 화자 발언 섞임 (회의록)
+
+여러 사람이 같은 주제를 다른 입장에서 말한 경우:
+- 양쪽(또는 모든) 발언 모두 발췌 보존
+- 사용자에게 어느 의견 채택할지 즉시 확인
+
+## 비격식 메일 / paste
+
+주어 생략, 맥락 누락:
+- 보충 가능한 부분(자명한 주어 등): 발췌 시 `[추정 보충: ...]` 표기로 원문에 덧붙이지 않고 명시
+- 모호한 부분: 사용자에게 즉시 확인
+
+## 도메인 용어 다의성
+
+Requirement Source 는 시스템 용어가 아니라 **현장 은어**. 같은 단어가 시스템상 여러 동작에 매핑될 수 있음.
+
+- 예: "출고" → 창고간 재고이동 / 고객사 납품 / 차량 적재 / 그 외
+- 예: "마감" → 일마감 / 월마감 / 정산마감 / 작업종료
+- 예: "주문" → 고객 발주 / 내부 작업지시 / 견적 단계
+
+**위험도 역설**: 일반적으로 들리는 업무 용어(출고/입고/재고/주문/마감/등록 등)일수록 더 의심. 낯선 용어는 자연스럽게 의문이 생기지만, 익숙한 용어는 모두가 안다고 착각함.
+
+처리:
+- **자동 매핑 금지**
+- **사용자에게 즉시 확인** — "이 단어가 시스템상 어떤 동작을 가리키는지"
+- **후보 나열 금지** — Claude 가 추측한 후보를 제시하면 사용자가 그 안에서만 고르게 가둠. 후보는 사용자가 답하게 둘 것

package/claude/references/sd-simplysm14/README.md

@@ -1,51 +1,55 @@
-# 문서 설명
+# @simplysm/* v14 행동 지침
 
 Claude 에이전트가 반드시 지켜야 할 행동 지침이다. (@simplysm/\* v14 포함시)
 
-## CLAUDE.md 명령어 구성 참조
+## 코드 위치 원칙
 
-명령어 구성시 check, typecheck, lint 중 check 가 기본임을 표기
+기본 위치는 **클라이언트**. 서버(`service-server`)는 다음 두 경우에만 둔다:
 
-- `pnpm check --fix`이 **기본 검증 명령**이며, typecheck + lint 한꺼번에, 자동수정 포함
-- `pnpm typecheck`, `pnpm lint`는 `pnpm check` 에서 문제 났을 때 타입만 따로 보기 위함
+- **보안**: 클라이언트에 노출 불가한 자격증명/키, 권한 우회 위험, 외부에 직접 노출하면 안 되는 연산.
+- **클라이언트 미지원**: 브라우저/모바일 런타임에서 실행 불가한 기능(특정 네이티브 API, 서버 측 자원 접근 등).
+
+ORM 호출, 파일 변환, 비즈니스 로직 등은 위 두 사유에 해당하지 않는 한 클라이언트 코드에 직접 둔다. "서버에 두는 게 관행"이라는 이유로 service 로 이관하지 않는다.
+
+## CLAUDE.md 명령어 표기
+
+`CLAUDE.md` 작성 시, 검증 명령은 다음 역할로 표기한다.
+
+- **기본 검증 (평소 사용)**: `pnpm check --fix` — typecheck + lint 일괄, 자동 수정 포함.
+- **보조**: `pnpm typecheck`, `pnpm lint` — `pnpm check` 에서 문제 났을 때 각각 따로 보기 위함. 단독 사용은 회피.
 
 ## 개발 매뉴얼
 
-- **클라이언트 화면 작성** — [client-component.md](./client-component.md)
-- **클라이언트 탭 컨트롤** — [client-tab.md](./client-tab.md)
-- **클라이언트 환경 셋업** — [client-setup.md](./client-setup.md)
-- **ORM 쿼리 작성** — [orm.md](./orm.md)
-  - **UNION 사용법** — [orm-union.md](./orm-union.md)
+트리거 조건이 처음 충족될 때 해당 자료를 Read.
+
+| 트리거                                                  | 매뉴얼                                                 |
+| ------------------------------------------------------- | ------------------------------------------------------ |
+| 클라이언트 코드(앱·`@simplysm/angular`) 작성 — 항상     | [client-rules.md](./manuals/client-rules.md)           |
+| 화면 컴포넌트(`<domain>.<역할>.ts`) 작성/수정           | [client-component.md](./manuals/client-component.md)   |
+| `sd-crud-list` / `sd-crud-detail` 채택한 목록·단건 화면 | [client-crud.md](./manuals/client-crud.md)             |
+| 클라이언트 데모 컴포넌트 작성                           | [client-demo.md](./manuals/client-demo.md)             |
+| `<sd-tab>` 사용                                         | [client-tab.md](./manuals/client-tab.md)               |
+| 새 앱 부트스트랩 또는 새 서비스·마스터 데이터 추가      | [client-setup.md](./manuals/client-setup.md)           |
+| DB 스키마 정의 또는 ORM 쿼리 작성                       | [orm.md](./manuals/orm.md)                             |
+| 이종 엔티티를 한 목록으로 합쳐 표시 (UNION)             | [orm-union.md](./manuals/orm-union.md)                 |
 
 ## 패키지 인덱스
 
-- **angular** — 표준 Angular UI/기능 라이브러리
-- **capacitor-plugin-auto-update** — 모바일 앱 자동 업데이트(zip diff + APK 설치)
-- **capacitor-plugin-file-system** — 모바일 앱 네이티브 파일시스템 접근
-- **capacitor-plugin-intent** — Android Intent 송수신
-- **capacitor-plugin-usb-storage** — Android USB OTG 외장 저장소 접근
-- **core-common** — 환경 비종속 공용 도구
-  - 표준 에러 클래스(`SdError`/`ArgumentError`/`NotImplementedError`/`TimeoutError`)
-  - 값 타입(`Uuid`/`DateTime`/`DateOnly`/`Time`/`LazyGcMap`)
-  - 디바운스 큐·직렬 큐·이벤트 에미터
-  - bytes/날짜/JSON/숫자/객체/경로/텍스트/XML/zip 변환 유틸
-- **core-browser** — 브라우저 전용 보강
-  - DOM 트리 탐색·포커스 보조 확장
-  - IndexedDB 기반 가상 파일시스템
-  - 진행률·취소·타임아웃 가능 fetch 래퍼
-  - 파일 선택/다운로드 헬퍼
-- **core-node** — Node 전용 보강
-  - 파일 IO/복사/경로 래퍼
-  - 파일 감시(chokidar)
-  - 로거(consola)
-  - worker_threads 추상화
-- **excel** — xlsx 파일 읽기/쓰기
-- **lint** — 자체 ESLint 플러그인 + recommended 프리셋
-- **orm-common** — DB 비종속 ORM 코어(쿼리 빌더·표현식·스키마·DDL)
-- **orm-node** — Node DB 드라이버 연결(mssql/mysql/postgresql)
-- **sd-claude** — 소비 앱에 Claude Code 셋업을 npm 으로 배포
-- **sd-cli** — 모노레포 빌드/배포 오케스트레이터(tsc/esbuild/ngtsc/Capacitor/Electron)
-- **service-client** — 서비스 서버 호출 클라이언트 SDK
-- **service-common** — 서비스 서버↔클라이언트 프로토콜·타입 계약
-- **service-server** — Fastify 기반 서비스 서버
-- **storage** — FTP/SFTP 원격 파일 스토리지 클라이언트
+- **angular** — Angular 21 standalone/signal/zoneless 기반 업무 클라이언트 UI 라이브러리. `provideSdAngular` 부트스트랩, 폼/시트/CRUD/모달/토스트/사이드바·탑바·드롭다운/공유데이터·칸반 등 화면 컴포넌트와 인프라 프로바이더 제공. 자세히: [apis/angular/README.md](./apis/angular/README.md)
+- **capacitor-plugin-auto-update** — Android Capacitor 앱에서 APK 자동 업데이트와 APK 설치 권한·버전 조회. 자세히: [apis/capacitor-plugin-auto-update/README.md](./apis/capacitor-plugin-auto-update/README.md)
+- **capacitor-plugin-file-system** — Capacitor 모바일/웹 파일 시스템 접근(권한·경로·디렉토리·파일 IO). 자세히: [apis/capacitor-plugin-file-system/README.md](./apis/capacitor-plugin-file-system/README.md)
+- **capacitor-plugin-intent** — Android 인텐트 브로드캐스트 송수신 및 `startActivityForResult` 연동(산업용 스캐너·PDA·외부 결제 등). 자세히: [apis/capacitor-plugin-intent/README.md](./apis/capacitor-plugin-intent/README.md)
+- **capacitor-plugin-usb-storage** — Android/Browser 에서 USB Mass Storage 장치 목록·권한·디렉토리/파일 읽기. 자세히: [apis/capacitor-plugin-usb-storage/README.md](./apis/capacitor-plugin-usb-storage/README.md)
+- **core-browser** — 브라우저 전용. `Element`/`HTMLElement` 프로토타입 확장, DOM 탐색·포커스·레이아웃 보정, 클립보드/측정, 파일 다이얼로그·다운로드, 진행률 fetch, IndexedDB 키/값 저장소와 가상 파일시스템. 자세히: [apis/core-browser/README.md](./apis/core-browser/README.md)
+- **core-common** — 공통 유틸리티(타입·에러·큐·이벤트·변환·확장 메서드·환경변수). simplysm 모든 패키지의 공용 기반. 자세히: [apis/core-common/README.md](./apis/core-common/README.md)
+- **core-node** — Node 전용 IO/경로/프로세스/감시/consola/worker_threads 래퍼(`fsx`, `pathx`, `cpx`, `FsWatcher`, `setupConsola`, `Worker`/`createWorker`). 자세히: [apis/core-node/README.md](./apis/core-node/README.md)
+- **excel** — xlsx 워크북을 열어 셀·시트·스타일·조건부서식·이미지를 읽고 쓰거나, Zod 스키마 기반 레코드 입출력. 자세히: [apis/excel/README.md](./apis/excel/README.md)
+- **lint** — ESLint flat config 작성 시 `@simplysm/lint/eslint-recommended` 프리셋 또는 `@simplysm/lint/eslint-plugin` 개별 규칙 import. 자세히: [apis/lint/README.md](./apis/lint/README.md)
+- **orm-common** — Dialect 독립 ORM 코어. `DbContext` 서브클래싱 + Table/View/Procedure 빌더 + `expr` AST + `Queryable` 체이닝으로 SQL 을 만들고 dialect QueryBuilder 로 렌더. 자세히: [apis/orm-common/README.md](./apis/orm-common/README.md)
+- **orm-node** — Node 환경에서 `DbContext` 를 MSSQL/MySQL/PostgreSQL 실 연결에 붙이는 어댑터(`createOrm`), raw SQL/bulk insert (`createDbConn`). 자세히: [apis/orm-node/README.md](./apis/orm-node/README.md)
+- **sd-claude** — `.claude/` 자산 배포 및 `sd-claude` CLI 만 제공. 라이브러리 코드 API 없음(npm 배포 전용). 자세히: [apis/sd-claude/README.md](./apis/sd-claude/README.md)
+- **sd-cli** — `sd.config.ts` 작성 타입, Vitest 의 Angular AOT plugin(`sdAngularPlugin`), TS 패키지 증분 컴파일 엔진(`SdTsCompiler`). 자세히: [apis/sd-cli/README.md](./apis/sd-cli/README.md)
+- **service-client** — `@simplysm/service-server` 와 WebSocket 으로 통신하는 클라이언트. RPC·이벤트 구독·파일 업/다운로드·원격 ORM 실행을 단일 `ServiceClient` 에서 제공(Node/브라우저 공용). 자세히: [apis/service-client/README.md](./apis/service-client/README.md)
+- **service-common** — 서버/클라이언트가 공유하는 서비스 프로토콜·메시지·서비스 인터페이스·앱 구조·이벤트 정의. 자세히: [apis/service-common/README.md](./apis/service-common/README.md)
+- **service-server** — Fastify + WebSocket 위에 서비스(`defineService`)·JWT 인증(`auth`)·빌트인 ORM/AutoUpdate/AppStructure·V1 레거시 호환을 부트스트랩(`createServiceServer().listen()`). 자세히: [apis/service-server/README.md](./apis/service-server/README.md)
+- **storage** — FTP/FTPS/SFTP 원격 스토리지에 동일 인터페이스(`StorageClient`)로 파일 읽기/쓰기/관리. 자세히: [apis/storage/README.md](./apis/storage/README.md)

package/claude/references/sd-simplysm14/apis/angular/README.md

@@ -0,0 +1,95 @@
+# @simplysm/angular
+
+Angular 21 기반 클라이언트 UI 라이브러리. 폼/리스트/시트/모달/토스트 등 업무화면 컴포넌트와 부트스트랩 프로바이더를 모두 포함한다. 모든 컴포넌트는 standalone, signal/zoneless 기반.
+
+## 사용 트리거 인덱스
+
+- **앱 부트스트랩** — `provideSdAngular`, `SdAngularConfigProvider`, `setupBgTheme`, `SdSystemLogProvider`. 앱 부트스트랩/루트 컴포넌트에서 1회.
+- **테마 (`SdThemeProvider`, `SdThemeSelector`)** — dark/fontSize 토글. `provideSdAngular`가 localStorage 자동 연동.
+- **라우팅/페이지 컨텍스트** — 자세히: [routing.md](./routing.md). `SdRouterLink`, `injectViewTypeSignal`, `setupCanDeactivate` 등.
+- **앱 구조/메뉴/권한** — 자세히: [app-structure.md](./app-structure.md). `SdAppStructureProvider`, `injectPermsSignal`, `SdMenu`.
+- **모달** — 자세히: [modal.md](./modal.md). `SdModalProvider`, `SdModal`, `SdPromptModal`/`SdConfirmModal`, `SdAddressSearchModal`.
+- **토스트** — 자세히: [toast.md](./toast.md). `SdToastProvider`(info/success/warning/danger/notify/try).
+- **버튼류** — 자세히: [buttons.md](./buttons.md). `SdButton`, `SdAnchor`, `SdAdditionalButton`, `SdModalSelectButton`.
+- **입력/폼 컨트롤** — 자세히: [forms.md](./forms.md). `SdForm`, `SdTextfield`/`SdTextarea`/`SdNumpad`/`SdRange`/`SdDateRangePicker`, `SdCheckbox`/`SdSwitch`/`SdCheckboxGroup(Item)`.
+- **드롭다운/셀렉트** — 자세히: [select-dropdown.md](./select-dropdown.md). `SdDropdown(Popup)`, `SdSelect(Item|Button)`.
+- **레이아웃 (사이드바/탑바)** — 자세히: [layout.md](./layout.md). `SdSidebar*`, `SdTopbar*`.
+- **시트(테이블)** — 자세히: [sheet.md](./sheet.md). `SdSheet`, `SdSheetColumn`, `SdSheetColumnCellTemplate`, `SdSheetConfig*`.
+- **CRUD 화면 골격** — 자세히: [crud.md](./crud.md). `SdBaseContainer`, `SdCrudList`, `SdCrudDetail`.
+- **서버 공유 데이터 (`SharedData*` + 선택 컨트롤)** — 자세히: [shared-data.md](./shared-data.md). `SdSharedDataProvider`, `SdSharedDataSelect(Button|List)`, `matchesSearchText`.
+- **선택/확장/정렬 매니저 훅** — 자세히: [selection-managers.md](./selection-managers.md). `useSelectionManager`, `useExpandingManager`, `useSortingManager`.
+- **칸반 보드** — 자세히: [kanban.md](./kanban.md). `SdKanbanBoard`, `SdKanban`, `SdKanbanLane`.
+- **시각 컴포넌트 (라벨/노트/프로그레스/달력/바코드/차트)** — 자세히: [visual.md](./visual.md).
+- **인프라 프로바이더 (서비스 클라이언트/파일 다이얼로그/스토리지/시스템 설정/인쇄)** — 자세히: [infrastructure.md](./infrastructure.md).
+- **`SdBusyContainer` / `SdBusyProvider`** — busy 오버레이. `provideSdAngular`가 라우터 navigation 동안 globalBusyCount 자동 증감.
+- **`SdPermissionTable`** — `SdPermission<TModule>[]` 트리를 `Record<string, boolean>` 모델로 편집하는 권한표.
+- **`SdStatePreset` / `SdStatePresetDef`** — 화면 상태(`state`)를 키별 프리셋으로 저장/복원. `SdSystemConfigProvider` 활용.
+- **`SdTiptapEditor`** — Tiptap 기반 리치 에디터. `value`, `extensions`, `validatorFn`.
+- **유틸 디렉티브/파이프 등** — 인라인 항목 참조.
+- **유틸 타입/함수** — 인라인 항목 참조.
+
+## 앱 부트스트랩
+
+```typescript
+bootstrapApplication(AppComponent, {
+  providers: [provideSdAngular({ clientName: "myapp" }), provideRouter(routes)],
+});
+```
+
+- `provideSdAngular({ clientName })`: zoneless CD, NgIcons config, 글로벌 에러 핸들러(`SdGlobalErrorHandlerPlugin`), `SdOptionEventPlugin`(이벤트 `.capture`/`.passive`/`.once`), 테마 dark/fontSize ↔ localStorage 동기화, SwUpdate 폴링, Router navigation 중 `SdBusyProvider.globalBusyCount` 자동 ±1.
+- `SdAngularConfigProvider.clientName`: localStorage 키 prefix·service client name 으로 사용. `provideSdAngular` 옵션에서 설정됨.
+- `SdSystemLogProvider.writeFn?`: severity별 로그 후크 등록(서버 전송 등). 자동으로 console에도 출력.
+- `setupBgTheme({ theme?, lightness? })`: 컴포넌트 constructor 내에서 호출. body `--background-color` CSS 변수 토글, 파괴 시 자동 복원.
+
+## 테마
+
+- `SdThemeProvider`: `dark = signal<boolean>`, `fontSize = signal<number>` (presets `[12,14,16,20,24,28]`), `increaseFontSize()`/`decreaseFontSize()`. dark면 body에 `sd-theme-dark` 클래스, fontSize는 html `font-size` 적용. `provideSdAngular`가 localStorage 영속화.
+- `SdThemeSelector`: 토글 UI 컴포넌트.
+
+## SdBusyContainer / SdBusyProvider
+
+`<sd-busy-container [busy] [message] [type] [progressPercent]>`. type: `"spinner" | "bar" | "cube"`. `busy=true` 동안 keydown 차단.
+`SdBusyProvider.globalBusyCount = signal(0)`. > 0이면 body 전면 오버레이.
+
+## SdPermissionTable
+
+`<sd-permission-table [items] [(value)] [disabled]>`. `items: SdPermission<TModule>[]` (`SdAppStructureUtils.getPermissions` 결과), `value: Record<string, boolean>` (코드.use|edit 형식).
+
+## SdStatePreset
+
+`<sd-state-preset [key] [(state)] [size]>`. `state` 를 `SdSystemConfigProvider` 키 `key` 아래 프리셋 배열로 저장/로드. 별 아이콘 클릭 → 이름 입력 모달 → 저장.
+
+## SdTiptapEditor
+
+`<sd-tiptap-editor [(value)] [disabled] [readonly] [required] [placeholder] [validatorFn] [extensions]>`. value=HTML string. `extensions?: AnyExtension[]` 으로 Tiptap 확장 주입.
+
+## 유틸 디렉티브/파이프
+
+이벤트·표시 보조용. constructor injection 또는 셀렉터 attach.
+
+- `SdOptionEventPlugin`: `(click.capture)`, `(scroll.passive)`, `(touchmove.capture.passive)`, `(transitionend.once)` 등 `.capture/.passive/.once` 변형 이벤트 바인딩 활성화. `provideSdAngular`로 자동 등록.
+- `SdResizeDirective` (`[sdResize]`): RO 기반 size 변화 emit (`{ heightChanged, widthChanged, target, contentRect }`).
+- `SdIntersectionDirective` (`[sdIntersection]`): IO entry emit.
+- `SdEvents`: 다양한 native event의 `.capture`/`.passive`/`.once` output 디렉티브 (예: `(scroll.passive)`, `(touchstart.passive)`).
+- `SdCommandDirective`: `[sdRefreshCommand]`/`[sdSaveCommand]`/`[sdInsertCommand]` — Ctrl+Alt+L/Ctrl+S/Insert 단축키 emit. 최상위 열린 모달 또는 모달이 없을 때만 처리.
+- `SdRipple` (`[sdRipple]="bool"`) / `setupRipple(enableFn?)`: pointerdown 시 원형 ripple.
+- `SdShowEffect` (`[sdShowEffect]="bool"` + `[sdShowEffectType]="'l2r'|'t2b'"`) / `setupRevealOnShow`: viewport intersection 시 fade-in.
+- `SdInvalid` (`[sdInvalid]="msg"`) / `setupInvalid(getMsg)`: hidden input의 customValidity 로 form 검증 + 표시 인디케이터.
+- `SdTypedTemplate` (`<ng-template [typed]>`): template context 타입 추론용 (typeToken).
+- `SdItemOfTemplate` (`<ng-template [itemOf]>`, ctx `{ $implicit, item, index, depth }`) — 컬렉션 컴포넌트 항목 템플릿.
+- `FormatPipe` (`{{ v | format:fmt }}`): `DateTime`/`DateOnly`는 `toFormatString(fmt)`, string은 `X` 자리표시(예: `'XXX-XXXX-XXXX'`).
+- `SdGap`: spacer. `height|width|widthEm` 또는 `heightPx|widthPx`. 단위 키: `xxs|xs|sm|default|lg|xl|xxl`.
+- `SdCollapse [open]` / `SdCollapseIcon`: 접힘.
+- `SdTab [(value)]`/`SdTabItem [value]`: 탭.
+- `SdList`/`SdListItem`: 리스트. `SdListItem` `layout: "accordion"|"flat"`, `selectedIcon`, `contentStyle/Class`.
+- `SdPagination [(currentPage)] [totalPageCount] [visiblePageCount=10]`.
+- `mark(signal)`: array/object signal의 in-place mutation 후 shallow copy로 trigger.
+- `setSafeStyle(renderer, el, partial)`: renderer.setStyle 일괄.
+- `setupModelHook(model, canFn)`: WritableSignal의 set/update를 `canFn(value) -> boolean | Promise<boolean>`로 가로채기. constructor 내에서 호출.
+
+## 유틸 타입/기타
+
+- `DirectiveInputSignals<T>`: 컴포넌트의 InputSignal 프로퍼티만 추출(`{ name: T }`). undefined 필드는 optional.
+- `UndefToOptional<T>`: undefined 포함 필드를 optional 로 변환.
+- `WithOptional<T, K>`: 특정 키만 optional 로.
+- `SelectModalOutputResult<TKey> = { selectedKeys: TKey[] }`: 모달 선택 결과.

package/claude/references/sd-simplysm14/apis/angular/app-structure.md

@@ -0,0 +1,49 @@
+# @simplysm/angular — app-structure
+
+서버의 `AppStructureService`에서 받은 메뉴/권한 트리(`AppStructureItem<TModule>[]`)를 클라이언트 측에서 사용 가능 형태로 변환.
+
+## `SdAppStructureProvider<TModule>`
+
+```typescript
+const sas = inject<SdAppStructureProvider<MyModule>>(SdAppStructureProvider);
+await sas.initialize("main");                // 서비스 키 → AppStructureService.getItems()
+sas.usableModules.set(myModules);            // 활성 모듈
+sas.permRecord.set({ "order.list.use": true });
+
+sas.usableMenus();        // Signal<SdMenu[]>          (트리)
+sas.usableFlatMenus();    // Signal<SdFlatMenu[]>      (flat)
+sas.getTitleByFullCode("order.list");
+sas.getPermsByFullCode(["order.list"], ["use","edit"]);
+sas.getPermissionsByStructure(items, codeChain);
+```
+
+내부적으로 `SdAppStructureUtils.getMenus/getFlatMenus/getPermissions/...` 위임.
+
+## `injectPermsSignal<K>(viewCodes, keys)`
+
+```typescript
+const perms = injectPermsSignal(["order.list"], ["use", "edit"] as const);
+perms(); // 갖고 있는 권한만 필터된 배열
+```
+
+## 타입
+
+```typescript
+interface SdMenu      { title; codeChain: string[]; url?; icon?; children? }
+interface SdFlatMenu  { titleChain; codeChain; modulesChain: TModule[][] }
+interface SdPermission { title; codeChain; modules; perms: ("use"|"edit")[]?; children? }
+```
+
+## `SdAppStructureUtils` 정적 메서드
+
+- `getMenus(items, codeChain, usableModules, permRecord)` — `isNotMenu` 제외, 모듈 활성·`.use` 권한 통과한 항목.
+- `getFlatMenus(items, usableModules, permRecord)` — 평탄화 + 부모 modules 누적 검사.
+- `getPermissions(items, codeChain, usableModules)` — 권한 트리 (`SdPermissionTable` 입력용).
+- `getFlatPermissions(items, usableModules)` — `@simplysm/service-common` 재노출.
+- `getTitleByFullCode`, `getItemChainByFullCode`, `getPermsByFullCode`.
+
+## 주의
+
+- `permRecord` 키는 `"<code>.<perm>"` (예: `"order.list.use"`).
+- 그룹 메뉴는 자식 중 하나라도 표시 가능해야 노출.
+- Leaf 가 `perms`를 가지면 `.use` 권한 필수, `perms`가 없거나 권한 자체가 없으면 통과.

package/claude/references/sd-simplysm14/apis/angular/buttons.md

@@ -0,0 +1,42 @@
+# @simplysm/angular — buttons
+
+## `<sd-button>`
+
+`type: "button"|"submit" = "button"`, `theme`(`primary|secondary|info|success|warning|danger|gray|blue-gray|link|link-<theme>|link-rev`), `inline`, `inset`, `size: "sm"|"lg"`, `disabled`, `buttonStyle`, `buttonClass`. content projection.
+
+```html
+<sd-button [theme]="'primary'" (click)="save()">저장</sd-button>
+```
+
+## `<sd-anchor>`
+
+링크형 클릭 요소. `disabled`, `theme`(`primary|secondary|...|blue-gray`, default `primary`). tabindex 자동.
+
+```html
+<sd-anchor [theme]="'danger'" (click)="del()">삭제</sd-anchor>
+```
+
+## `<sd-additional-button>`
+
+본문 + 우측 부가 버튼 슬롯. `size`.
+
+## `<sd-modal-select-button>`
+
+검색 모달을 띄워 값을 선택받는 입력 위젯. `setupInvalid` 로 required 검증 내장.
+
+```html
+<sd-modal-select-button
+  [modal]="orderSelectModalInfo"        <!-- SdSelectModalInfo<SdSelectModal<TKey>> -->
+  [(value)]="selectedKey"                <!-- single 모드: TKey | multi 모드: TKey[] -->
+  [selectMode]="'single'"
+  [modalOptions]="{ resizable: true }"
+  [required]="true"
+  [disabled]="false"
+  [searchIcon]="customIcon">
+  {{ displayLabel() }}
+</sd-modal-select-button>
+```
+
+- `SdSelectModal<TKey>` = `SdModalContentDef<SelectModalOutputResult<TKey>>` + `selectMode: InputSignal<"single"|"multi"|undefined>` + `selectedKeys: InputSignal<TKey[]>`.
+- `SdSelectModalInfo<T>` = `SdModalInfo<T, "selectMode"|"selectedKeys">`.
+- erase 아이콘 클릭 시 `value` 초기화(`undefined` 또는 `[]`).

package/claude/references/sd-simplysm14/apis/angular/crud.md

@@ -0,0 +1,35 @@
+# @simplysm/angular — crud
+
+CRUD 화면 골격. 상단 명령바·필터·toolbar·페이지 페이저·시트를 갖춘 리스트 화면(`SdCrudList`)과 디테일 화면(`SdCrudDetail`)과 공통 컨테이너(`SdBaseContainer`).
+
+## `<sd-base-container>`
+
+페이지/모달 공통 컨테이너. `SdSharedDataProvider.wait()` 완료까지 busy 표시 후 `ready=true`.
+
+inputs: `viewType: SdViewType` (required), `restricted`, `initialized`. models: `ready`, `busyCount`. content templates: `#topbarTpl`, `#commandTpl`, `#contentTpl`, `#bottomCommandTpl`.
+
+```html
+<sd-base-container [viewType]="vt">
+  <ng-template #commandTpl>...</ng-template>
+  <ng-template #contentTpl>...</ng-template>
+</sd-base-container>
+```
+
+## `<sd-crud-list<TItem, TKey>>`
+
+리스트+페이지+선택+삭제/복원 골격.
+
+- 필수 input: `viewType`, `key`, `trackByFn: (TItem) => TKey`.
+- inputs: `selectMode: "single"|"multi"`, `items`, `currDeletedItems`, `totalPageCount`, `itemsPerPage`, `visiblePageCount=10`, `readonly`, `restricted`, `initialized`.
+- models: `ready`, `busyCount`, `selectedKeys: NonNullable<TKey>[]`, `currentPage`, `sorts: SortingDef[]`.
+- outputs: `filterSubmit`, `submit`, `create`, `delete: TItem[]`, `restore: TItem[]`.
+- content templates: `#commandTpl`, `#filterTpl`, `#toolTpl`, `#bottomCommandTpl` + `<sd-sheet-column>` 자식들이 자동으로 sheet 에 전달.
+- 삭제된 아이템은 `text-decoration: line-through`.
+- 모달 컨텍스트면 confirm/cancel 핸들러 자동 (`onModalSelectionConfirmClick`/`onModalSelectionCancelClick`).
+
+## `<sd-crud-detail>`
+
+단일 레코드 편집.
+
+- 필수: `viewType`. inputs: `restricted`, `readonly`, `initialized`. models: `ready`, `busyCount`. output: `submit`. templates: `#commandTpl`, `#contentTpl`, `#bottomCommandTpl`.
+- 저장 버튼 → 내부 `SdForm.requestSubmit()`.

package/claude/references/sd-simplysm14/apis/angular/forms.md

@@ -0,0 +1,63 @@
+# @simplysm/angular — forms
+
+폼 컨테이너 + 입력 컨트롤. 모든 컨트롤은 `value` model 기반. native form validity API 사용 (`SdForm`이 submit 시 reportValidity 호출).
+
+## `<sd-form>`
+
+```html
+<sd-form (formSubmit)="onSubmit($event)" (formInvalid)="onInvalid()">
+  <sd-textfield [type]="'text'" [(value)]="name" [required]="true" />
+  <sd-button [type]="'submit'">저장</sd-button>
+</sd-form>
+```
+
+- 내부에 hidden submit 버튼 자동 삽입(Enter 키 submit 지원).
+- `requestSubmit()` 메서드 노출.
+- invalid 시 reportValidity → `formInvalid` emit.
+
+## `<sd-textfield<K>>`
+
+```html
+<sd-textfield [type]="'number'" [(value)]="qty" [min]="0" [max]="999" [step]="1" />
+<sd-textfield [type]="'date'" [(value)]="dt" />
+<sd-textfield [type]="'format'" [format]="'XXX-XXXX-XXXX'" [(value)]="phone" />
+```
+
+`SdTextfieldTypes`: `number→number`, `text|password|color|email|format→string`, `date|month|year→DateOnly`, `datetime|datetime-sec→DateTime`, `time|time-sec→Time`. `sdTextfieldTypes` 배열로 키 목록 enum.
+
+주요 input: `value` (model), `type` (required), `placeholder`, `title`, `inputStyle/Class`, `disabled/readonly/required` (booleanAttribute), `min/max/minlength/maxlength`, `pattern`, `validatorFn(value) => string | undefined` (커스텀 메시지), `format`, `step`, `autocomplete`, `minDigits`, `size`, `theme`.
+
+## `<sd-textarea>`
+
+`[(value)]: string`, `placeholder`, `title`, `minRows=1`, `size`, `validatorFn`, `theme`, `inputStyle/Class`.
+
+## `<sd-numpad>`
+
+숫자 키패드. `[(value)]: number`, `placeholder`.
+
+## `<sd-range<K>>`
+
+`type: K` (TextfieldTypes 키), `[(from)]`, `[(to)]: SdTextfieldTypes[K]`, `inputStyle`.
+
+## `<sd-date-range-picker>`
+
+`[(periodType)]: "일"|"월"|"범위" = "범위"`, `[(from)]: DateOnly`, `[(to)]: DateOnly`.
+
+## `<sd-checkbox>` / `<sd-switch>`
+
+```html
+<sd-checkbox [(value)]="agreed" [theme]="'primary'">동의</sd-checkbox>
+<sd-switch [(value)]="enabled" [size]="'sm'" />
+```
+
+`value: boolean` (model), `canChangeFn(value) => boolean | Promise<boolean>` — false 면 변경 차단. `radio` (checkbox만), `disabled`, `size`, `inline`, `inset`, `theme`, `contentStyle` (checkbox).
+
+## `<sd-checkbox-group<T>>` / `<sd-checkbox-group-item<T>>`
+
+`<sd-checkbox-group [(value)]="selected"> <sd-checkbox-group-item [value]="opt">{{opt}}</sd-checkbox-group-item> ... </sd-checkbox-group>`. value: `T[]` (다중).
+
+## 검증
+
+- 컨트롤 내부에서 `setupInvalid(getMessage)` 사용 (cf. directives). 빈 문자열이면 valid.
+- `validatorFn` 은 컨트롤 입력값을 검사해 메시지 반환.
+- `SdForm` submit 시 자동으로 reportValidity 호출 + invalid 인디케이터 표시.

package/claude/references/sd-simplysm14/apis/angular/infrastructure.md

@@ -0,0 +1,80 @@
+# @simplysm/angular — infrastructure
+
+앱 인프라 프로바이더(전부 `providedIn: "root"` 또는 single instance).
+
+## `SdServiceClientFactoryProvider`
+
+`@simplysm/service-client` 의 `ServiceClient` 를 키별로 보관.
+
+```typescript
+const factory = inject(SdServiceClientFactoryProvider);
+await factory.connectAsync("main", { host, port, ssl });   // 옵션 생략 시 location 기반
+const client = factory.get("main");
+await factory.closeAsync("main");
+```
+
+- 같은 키 재연결 금지(`이미 연결된`/`이미 연결이 끊긴`). 한 번 close된 키는 재사용 불가.
+- request/response progress → `SdToastProvider.info(message, true)` 로 진행률 토스트 자동.
+- destroy 시 모든 클라이언트 close.
+
+## `SdFileDialogProvider`
+
+```typescript
+const file  = await inject(SdFileDialogProvider).showAsync();
+const files = await inject(SdFileDialogProvider).showAsync(true, "image/*");
+```
+
+cancel/empty → `undefined`. 동적 `<input type=file>` 생성/제거.
+
+## `SdLocalStorageProvider<T>`
+
+```typescript
+const ls = inject<SdLocalStorageProvider<Schema>>(SdLocalStorageProvider);
+ls.set("theme", "dark");
+const v = ls.get("theme");
+ls.remove("theme");
+```
+
+키는 `<clientName>.<key>` 로 prefix. JSON 직렬화.
+
+## `SdSystemConfigProvider<T>`
+
+```typescript
+const cfg = inject<SdSystemConfigProvider<Schema>>(SdSystemConfigProvider);
+cfg.fn = { set: (k, v) => svc.set(k, v), get: (k) => svc.get(k) };  // 옵션: 서버 연동
+await cfg.setAsync("sheet.order", config);
+const v = await cfg.getAsync("sheet.order");
+```
+
+`fn` 미설정이면 `SdLocalStorageProvider` 폴백. SdSheet/SdModal/SdStatePreset 등이 자동 사용.
+
+## `injectSdSystemConfigResource<T>({ key })`
+
+```typescript
+const r = injectSdSystemConfigResource<MyConfig>({ key: keySignal });
+r.value(); r.isLoading(); r.status();
+r.set(v); r.update((prev) => ...); r.reload(); r.hasValue();
+```
+
+키는 `<elementTagName>.<key()>` 로 prefix. set 호출 시 화면 즉시 갱신 + queueMicrotask 로 비동기 영속화 (실패 시 ErrorHandler).
+
+## `SdGlobalErrorHandlerPlugin`
+
+`provideSdAngular`가 `ErrorHandler` 로 등록. 처리되지 않은 Error/PromiseRejectionEvent/ErrorEvent 캐치 → `SdSystemLogProvider.writeAsync("error", ...)` + 전면 오버레이 + ApplicationRef destroy. 클릭 시 reload(prod는 hash `/` 로 리셋).
+
+## `SdOptionEventPlugin`
+
+`provideSdAngular`가 `EVENT_MANAGER_PLUGINS` 로 등록. 이벤트명에 `.capture` / `.passive` / `.once` 접미 허용 (예: `(scroll.passive)`, `(click.capture.once)`).
+
+## `SdPrintProvider`
+
+```typescript
+await print.printAsync({ type: MyTpl, inputs: { ... } }, { size: "A4", margin: "0" });
+const bytes = await print.getPdfBufferAsync({ type, inputs }, { orientation: "portrait", pageSize: "a4" });
+```
+
+- 템플릿 컴포넌트는 `SdPrint` 구현 필요 (`initialized: Signal<boolean>`, optional `_optionalPrintInputs`).
+- `SdPrintInput<T, X>` = `{ type; inputs: WithOptional<DirectiveInputSignals<T> 제외..., optional 키들> }`.
+- print: `@page` + `@media print` 스타일 임시 주입 → `initialized=true` 및 이미지 로드 대기 → `window.print()`.
+- PDF: `.page` 자식이 있으면 페이지별, 없으면 단일 페이지. `htmlToImage.toCanvas` (pixelRatio=4) → `jspdf.addImage`.
+- 두 메서드 모두 진행 동안 `SdBusyProvider.globalBusyCount` ±1.

package/claude/references/sd-simplysm14/apis/angular/kanban.md

@@ -0,0 +1,33 @@
+# @simplysm/angular — kanban
+
+드래그·드롭 칸반 보드.
+
+```html
+<sd-kanban-board [(selectedValues)]="selected" (drop)="onDrop($event)">
+  <sd-kanban-lane [value]="laneA" [busy]="loading">
+    <sd-kanban [value]="card" [draggable]="true" [selectable]="true">{{ card.title }}</sd-kanban>
+  </sd-kanban-lane>
+</sd-kanban-board>
+```
+
+## `<sd-kanban-board<L, T>>`
+
+- `selectedValues = model<T[]>([])`.
+- `drop = output<SdKanbanBoardDropInfo<L, T>>` (`{ sourceKanbanValue?, targetLaneValue?, targetKanbanValue? }`).
+- `dragKanban = signal<SdKanbanDragRef | undefined>` — 자식이 드래그 시작 시 설정.
+
+## `<sd-kanban-lane<L, T>>`
+
+`value: L`, `busy`, `useCollapse`, `collapse` (model). drop target 구현.
+
+## `<sd-kanban<L, T>>`
+
+`value: T`, `draggable`, `selectable`, `contentClass`. drag ref + drop target 둘 다 구현(카드 위에 드롭 가능).
+
+## 타입
+
+```typescript
+interface SdKanbanBoardDropInfo<L, T> { sourceKanbanValue?: T; targetLaneValue?: L; targetKanbanValue?: T }
+interface SdKanbanDragRef<_L, T>      { value(): T | undefined; heightOnDrag(): number }
+interface SdKanbanDropTarget<L, T>    { targetLaneValue(): L | undefined; targetKanbanValue?(): T | undefined }
+```

package/claude/references/sd-simplysm14/apis/angular/layout.md

@@ -0,0 +1,41 @@
+# @simplysm/angular — layout
+
+## 사이드바
+
+```html
+<sd-sidebar-container>
+  <sd-sidebar>
+    <sd-sidebar-user [userMenu]="userMenu">유저영역</sd-sidebar-user>
+    <sd-sidebar-menu [menus]="menus" [layout]="'accordion'" [getMenuIsSelectedFn]="isSel" />
+  </sd-sidebar>
+  <ng-content />
+</sd-sidebar-container>
+```
+
+- `SdSidebarContainer`: `toggle = signal(false)`. Router NavigationStart 시 자동 false.
+- `SdSidebar`: 부모 container의 toggle 추종.
+- `SdSidebarMenu`: `menus: SdMenu[]`, `layout: "accordion"|"flat"`, `getMenuIsSelectedFn?`.
+- `SdSidebarUser`: `userMenu?: SdSidebarUserMenu`.
+
+```typescript
+interface SdSidebarUserMenu { /* see source */ }
+```
+
+## 탑바
+
+```html
+<sd-topbar-container>
+  <sd-topbar [sidebarContainer]="sc">
+    <sd-topbar-menu [menus]="menus" />
+    <sd-topbar-user [menus]="userMenus" />
+  </sd-topbar>
+</sd-topbar-container>
+```
+
+- `SdTopbar`: `sidebarContainer?: SdSidebarContainer` 입력(미지정 시 inject 시도). 햄버거 버튼이 `sc.toggle` 토글.
+- `SdTopbarMenu`: `menus: SdMenu[]`, `getMenuIsSelectedFn?`.
+- `SdTopbarUser`: `menus: SdTopbarUserMenu[]` (required).
+
+## 메뉴 데이터
+
+`SdMenu` (`./app-structure.md` 참조)을 그대로 입력. 선택 상태는 `getIsMenuSelected(menu, fullPageCode, customFn?)` 또는 `getMenuIsSelectedFn` 으로.