@simplysm/sd-claude 14.0.51 → 14.0.52

package/claude/references/sd-simplysm-v14/angular/provider-types/sd-modal-content-def.md

@@ -0,0 +1,148 @@
+# `SdModalContentDef`
+
+모달 컴포넌트가 구현해야 하는 인터페이스.
+
+```typescript
+interface SdModalContentDef<O> {
+  initialized: Signal<boolean>;
+  close: OutputEmitterRef<O | undefined>;
+  actionTplRef?: TemplateRef<any>;
+  readonly _optionalModalInputs?: string;
+}
+```
+
+## Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `initialized` | `Signal<boolean>` | 초기화 완료 여부 |
+| `close` | `OutputEmitterRef<O \| undefined>` | 닫기 output (결과 전달) |
+| `actionTplRef` | `TemplateRef<any> \| undefined` | 모달 헤더 액션 영역 템플릿 |
+| `_optionalModalInputs` | `string \| undefined` | optional로 취급할 input 키 목록 (리터럴 타입) |
+
+## 구현 패턴
+
+```typescript
+export class CustomerDetail implements SdModalContentDef<boolean | undefined> {
+  initialized = signal(false);
+  close = output<boolean | undefined>();
+  actionTplRef?: TemplateRef<any>;
+
+  private readonly _modalActionTpl = viewChild("modalActionTpl", { read: TemplateRef });
+
+  constructor() {
+    effect(() => {
+      this.actionTplRef = this._modalActionTpl();
+    });
+  }
+
+  protected async onSubmit(): Promise<void> {
+    // ... (ORM upsert)
+    this.close.emit(true);
+  }
+}
+```
+
+## Related Types
+
+### `SdModalInfo`
+
+모달 생성 시 전달하는 정보.
+
+```typescript
+interface SdModalInfo<T extends SdModalContentDef<any>, X extends keyof any = ""> {
+  title: string;
+  type: Type<T>;
+  inputs: WithOptional<Omit<DirectiveInputSignals<T>, SdModalExcludeKeys | X>, ...>;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `title` | `string` | 모달 제목 |
+| `type` | `Type<T>` | 모달 컴포넌트 타입 |
+| `inputs` | `object` | 컴포넌트 inputs (initialized, close, actionTplRef 제외) |
+
+### `SdModalOptions`
+
+모달 옵션.
+
+```typescript
+interface SdModalOptions {
+  key?: string;
+  hideHeader?: boolean;
+  hideCloseButton?: boolean;
+  useCloseByBackdrop?: boolean;
+  useCloseByEscapeKey?: boolean;
+  float?: boolean;
+  fill?: boolean;
+  resizable?: boolean;
+  movable?: boolean;
+  position?: "bottom-right" | "top-right";
+  minHeightPx?: number;
+  minWidthPx?: number;
+  heightPx?: number;
+  widthPx?: number;
+  headerStyle?: string;
+  noFirstControlFocusing?: boolean;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `key` | `string \| undefined` | 동일 키의 모달이 이미 열려 있으면 재사용 |
+| `hideHeader` | `boolean \| undefined` | 헤더 숨김 |
+| `hideCloseButton` | `boolean \| undefined` | 닫기 버튼 숨김 |
+| `useCloseByBackdrop` | `boolean \| undefined` | 배경 클릭으로 닫기 |
+| `useCloseByEscapeKey` | `boolean \| undefined` | ESC 키로 닫기 |
+| `float` | `boolean \| undefined` | 플로팅 모달 |
+| `fill` | `boolean \| undefined` | 전체 화면 채우기 |
+| `resizable` | `boolean \| undefined` | 크기 조절 가능 |
+| `movable` | `boolean \| undefined` | 이동 가능 |
+| `position` | `"bottom-right" \| "top-right" \| undefined` | 위치 프리셋 |
+| `minHeightPx` | `number \| undefined` | 최소 높이 (px) |
+| `minWidthPx` | `number \| undefined` | 최소 너비 (px) |
+| `heightPx` | `number \| undefined` | 높이 (px) |
+| `widthPx` | `number \| undefined` | 너비 (px) |
+| `headerStyle` | `string \| undefined` | 헤더 인라인 스타일 |
+| `noFirstControlFocusing` | `boolean \| undefined` | 첫 번째 컨트롤 자동 포커스 비활성화 |
+
+### `SelectModalOutputResult`
+
+모달 선택 결과.
+
+```typescript
+interface SelectModalOutputResult<T> {
+  selectedItemKeys: any[];
+  selectedItems: T[];
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `selectedItemKeys` | `any[]` | 선택된 항목 키 배열 |
+| `selectedItems` | `T[]` | 선택된 항목 배열 |
+
+### `SdSelectModal`
+
+선택 모달 컴포넌트가 구현해야 하는 인터페이스. `SdModalContentDef<SelectModalOutputResult<T>>`를 확장한다.
+
+```typescript
+interface SdSelectModal<T> extends SdModalContentDef<SelectModalOutputResult<T>> {
+  selectMode: InputSignal<"single" | "multi" | undefined>;
+  selectedItemKeys: InputSignal<any[]>;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `selectMode` | `InputSignal<"single" \| "multi" \| undefined>` | 선택 모드 |
+| `selectedItemKeys` | `InputSignal<any[]>` | 이미 선택된 항목 키 배열 (복원용) |
+
+### `SdSelectModalInfo`
+
+모달 선택 정보.
+
+```typescript
+type SdSelectModalInfo<T extends SdSelectModal<any>> = SdModalInfo<T, "selectMode" | "selectedItemKeys">
+```

package/claude/references/sd-simplysm-v14/angular/provider-types/sd-toast-content-def.md

@@ -0,0 +1,73 @@
+# `SdToastContentDef`
+
+커스텀 토스트 컴포넌트가 구현해야 하는 인터페이스.
+
+```typescript
+interface SdToastContentDef<O> {
+  close: OutputEmitterRef<O | undefined>;
+}
+```
+
+## Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `close` | `OutputEmitterRef<O \| undefined>` | 닫기 output |
+
+## Related Types
+
+### `SdToastInput`
+
+커스텀 토스트 생성 입력.
+
+```typescript
+interface SdToastInput<T extends SdToastContentDef<any>> {
+  type: Type<T>;
+  inputs: Omit<DirectiveInputSignals<T>, "close">;
+}
+```
+
+### `SdToastSeverity`
+
+```typescript
+type SdToastSeverity = "info" | "success" | "warning" | "danger";
+```
+
+### `SdToastTheme`
+
+```typescript
+type SdToastTheme = "primary" | "secondary" | SdToastSeverity | "gray" | "blue-gray";
+```
+
+### `SdBusyType`
+
+```typescript
+type SdBusyType = "spinner" | "bar" | "cube";
+```
+
+## Related Types (Print)
+
+### `SdPrint`
+
+인쇄 컴포넌트가 구현해야 하는 인터페이스.
+
+```typescript
+interface SdPrint {
+  initialized: Signal<boolean>;
+  readonly _optionalPrintInputs?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `initialized` | `Signal<boolean>` | 초기화 완료 여부 (true 될 때까지 대기 후 인쇄) |
+| `_optionalPrintInputs` | `string \| undefined` | optional로 취급할 input 키 목록 |
+
+### `SdPrintInput`
+
+```typescript
+interface SdPrintInput<T, X extends keyof any = ""> {
+  type: Type<T>;
+  inputs: WithOptional<Omit<DirectiveInputSignals<T>, "_optionalPrintInputs" | X>, ...>;
+}
+```

package/claude/references/sd-simplysm-v14/angular/provider-types/shared-data-base.md

@@ -0,0 +1,59 @@
+# `SharedDataBase`
+
+공유 데이터 기본 인터페이스. 모든 공유 데이터 항목이 구현해야 한다.
+
+```typescript
+interface SharedDataBase<TKey extends string | number> {
+  __valueKey: TKey;
+  __searchText: string;
+  __isHidden: boolean;
+  __parentKey?: TKey;
+}
+```
+
+## Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `__valueKey` | `TKey` | 고유 키 |
+| `__searchText` | `string` | 검색 대상 텍스트 |
+| `__isHidden` | `boolean` | 숨김 여부 |
+| `__parentKey` | `TKey \| undefined` | 부모 키 (트리 구조용) |
+
+## Related Types
+
+### `SharedDataInfo`
+
+공유 데이터 등록 정보.
+
+```typescript
+interface SharedDataInfo<T extends SharedDataBase<string | number>> {
+  serviceKey: string;
+  getter: (changeKeys?: (string | number)[]) => Promise<T[]>;
+  filter?: unknown;
+  orderBy?: (a: T, b: T) => number;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `serviceKey` | `string` | ServiceClient 연결 키 |
+| `getter` | `(changeKeys?) => Promise<T[]>` | 데이터 조회 함수. changeKeys 전달 시 부분 조회 |
+| `filter` | `unknown` | 이벤트 필터 (같은 이름의 다른 필터 구분용) |
+| `orderBy` | `((a, b) => number) \| undefined` | 정렬 함수 |
+
+### `SharedDataHandle`
+
+공유 데이터 핸들. `SdSharedDataProvider.getHandle()`이 반환하는 객체.
+
+```typescript
+interface SharedDataHandle<T extends SharedDataBase<string | number>> {
+  items: Signal<T[]>;
+  get(key: T["__valueKey"] | undefined): T | undefined;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `items` | `Signal<T[]>` | 데이터 항목 signal |
+| `get(key)` | `(key) => T \| undefined` | 키로 항목 조회 |

package/claude/references/sd-simplysm-v14/angular/providers/sd-activated-modal-provider.md

@@ -0,0 +1,34 @@
+# `SdActivatedModalProvider`
+
+모달 내부에서 inject하여 모달/컨텐츠 컴포넌트 참조를 얻는 프로바이더. `@Injectable()`로 모달별 인스턴스 생성.
+
+```typescript
+@Injectable()
+class SdActivatedModalProvider<T extends SdModalContentDef<any> = SdModalContentDef<any>> {
+  modalComponent = signal<any>(undefined);
+  contentComponent = signal<T | undefined>(undefined);
+  canDeactivateFn: () => boolean;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `modalComponent` | property | `WritableSignal<any>` | SdModal 인스턴스 |
+| `contentComponent` | property | `WritableSignal<T \| undefined>` | 컨텐츠 컴포넌트 인스턴스 |
+| `canDeactivateFn` | property | `() => boolean` | 모달 닫기 가능 여부 판별 함수 (기본: `() => true`) |
+
+## Usage
+
+모달 내부 컴포넌트에서 `optional: true`로 inject하여 모달 컨텍스트를 확인한다. 타이틀 계산은 `injectViewTitleSignal()`이 내부에서 `SdActivatedModalProvider`를 자동으로 처리하므로 직접 inject할 필요가 없다:
+
+```typescript
+// 타이틀 — injectViewTitleSignal()이 modal/page 분기를 자동 처리
+protected readonly viewTitle = injectViewTitleSignal();
+
+// canDeactivateFn 등 모달 컨텍스트가 직접 필요한 경우에만 inject
+private readonly _sdActivatedModal = inject(SdActivatedModalProvider, { optional: true });
+```
+
+`optional: true`를 사용하는 이유: 동일 컴포넌트가 page 뷰로도 사용될 수 있으며, page 뷰에서는 `SdActivatedModalProvider`가 제공되지 않는다.

package/claude/references/sd-simplysm-v14/angular/providers/sd-app-structure-provider.md

@@ -0,0 +1,81 @@
+# `SdAppStructureProvider`
+
+앱 구조(메뉴/권한) 관리 프로바이더. 서브클래스 없이 직접 사용한다.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdAppStructureProvider<TModule = unknown> {
+  readonly usableModules = signal<TModule[] | undefined>(undefined);
+  readonly permRecord = signal<Record<string, boolean> | undefined>(undefined);
+  readonly items = signal<AppStructureItem<TModule>[]>([]);
+
+  usableMenus: Signal<SdMenu[]>;
+  usableFlatMenus: Signal<SdFlatMenu<TModule>[]>;
+
+  async initialize(serviceKey: string): Promise<void>;
+  getPermissionsByStructure(items, codeChain?): SdPermission<TModule>[];
+  getTitleByFullCode(fullCode: string): string;
+  getItemChainByFullCode(fullCode: string): AppStructureItem<TModule>[];
+  getPermsByFullCode<K extends string>(fullCodes: string[], permKeys: K[]): K[];
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `usableModules` | property | `WritableSignal<TModule[] \| undefined>` | 사용 가능한 모듈 목록. 외부에서 `set()`/`update()`로 설정 |
+| `permRecord` | property | `WritableSignal<Record<string, boolean> \| undefined>` | 권한 레코드. 외부에서 `set()`/`update()`로 설정 |
+| `items` | property | `WritableSignal<AppStructureItem<TModule>[]>` | 앱 구조 항목 배열 (`initialize()`로 초기화) |
+| `usableMenus` | computed | `Signal<SdMenu[]>` | 사용 가능한 메뉴 트리 |
+| `usableFlatMenus` | computed | `Signal<SdFlatMenu<TModule>[]>` | 사용 가능한 플랫 메뉴 |
+| `initialize(serviceKey)` | method | `(string) => Promise<void>` | 서비스에서 앱 구조 로드 |
+| `getTitleByFullCode(fullCode)` | method | `(string) => string` | fullCode로 타이틀 조회 |
+| `getItemChainByFullCode(fullCode)` | method | `(string) => AppStructureItem<TModule>[]` | fullCode로 항목 체인 조회 |
+| `getPermsByFullCode(fullCodes, permKeys)` | method | `(string[], K[]) => K[]` | fullCode 배열에서 보유 권한 키 반환 |
+
+## Related Types
+
+### `injectPermsSignal`
+
+앱 구조(`SdAppStructureProvider`)에서 지정된 뷰 코드와 키 배열에 대한 권한을 조회하는 signal. 생성자/필드 이니셜라이저에서 호출한다.
+
+```typescript
+function injectPermsSignal<K extends string>(viewCodes: string[], keys: K[]): Signal<K[]>
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `viewCodes` | `string[]` | 조회할 뷰 코드 배열 (예: `["sales.customer"]`) |
+| `keys` | `K[]` | 권한 키 배열 (예: `["use", "edit"]`) |
+
+반환: 현재 사용자가 보유한 권한 키 배열의 signal
+
+#### 사용 패턴
+
+```typescript
+protected readonly perms = injectPermsSignal(["sales.customer"], ["use", "edit"]);
+protected readonly canEdit = computed(() => this.perms().includes("edit"));
+```
+
+```html
+@if (!perms().includes("use")) {
+  <sd-note theme="warning">이 화면의 사용 권한이 없습니다.</sd-note>
+}
+```
+
+### `SdAppStructureUtils`
+
+앱 구조 유틸리티. 정적 메서드로 메뉴/권한 조회 로직을 제공한다.
+
+```typescript
+abstract class SdAppStructureUtils {
+  static getTitleByFullCode<TModule>(items, fullCode): string;
+  static getPermsByFullCode<TModule, K extends string>(items, fullCodes, permKeys, permRecord): K[];
+  static getItemChainByFullCode<TModule>(items, fullCode): AppStructureItem<TModule>[];
+  static getMenus<TModule>(items, codeChain, usableModules, permRecord): SdMenu[];
+  static getFlatMenus<TModule>(items, usableModules, permRecord): SdFlatMenu<TModule>[];
+  static getPermissions<TModule>(items, codeChain, usableModules): SdPermission<TModule>[];
+  static getFlatPermissions<TModule>(items, usableModules): FlatPermission<TModule>[];
+}
+```

package/claude/references/sd-simplysm-v14/angular/providers/sd-busy-provider.md

@@ -0,0 +1,18 @@
+# `SdBusyProvider`
+
+글로벌 busy 상태 관리 프로바이더.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdBusyProvider {
+  type = signal<SdBusyType>("bar");
+  globalBusyCount = signal(0);
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `type` | property | `WritableSignal<SdBusyType>` | busy 표시 유형 (`"spinner" \| "bar" \| "cube"`) |
+| `globalBusyCount` | property | `WritableSignal<number>` | 글로벌 busy 카운트 (0보다 크면 busy 표시) |

package/claude/references/sd-simplysm-v14/angular/providers/sd-file-dialog-provider.md

@@ -0,0 +1,40 @@
+# `SdFileDialogProvider`
+
+네이티브 파일 선택 대화상자 프로바이더.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdFileDialogProvider {
+  async showAsync(multiple?: false, accept?: string): Promise<File | undefined>;
+  async showAsync(multiple: true, accept?: string): Promise<File[] | undefined>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `showAsync(multiple?, accept?)` | method | overloaded | 파일 선택 대화상자 열기. `multiple=true`이면 `File[]`, 아니면 `File \| undefined` 반환 |
+
+## Parameters
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `multiple` | `boolean \| undefined` | 다중 선택 여부 |
+| `accept` | `string \| undefined` | 허용 파일 타입 (예: `"image/*"`, `".xlsx"`) |
+
+## Usage
+
+엑셀 파일 업로드 시 단일 파일을 선택받는 패턴:
+
+```typescript
+private readonly _sdFileDialog = inject(SdFileDialogProvider);
+
+async onUploadExcelButtonClick(): Promise<void> {
+  const file = await this._sdFileDialog.showAsync(false, ".xlsx");
+  if (file == null) return;
+  if (Array.isArray(file)) return;
+
+  // file: File 객체
+}
+```

package/claude/references/sd-simplysm-v14/angular/providers/sd-local-storage-provider.md

@@ -0,0 +1,20 @@
+# `SdLocalStorageProvider`
+
+`clientName` 스코프 localStorage 래퍼. 키가 `{clientName}.{key}` 형태로 저장된다.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdLocalStorageProvider<T> {
+  set<K extends keyof T & string>(key: K, value: T[K]): void;
+  get<K extends keyof T & string>(key: K): T[K] | undefined;
+  remove(key: keyof T & string): void;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `set(key, value)` | method | `(K, T[K]) => void` | 값 저장 |
+| `get(key)` | method | `(K) => T[K] \| undefined` | 값 조회 |
+| `remove(key)` | method | `(keyof T & string) => void` | 값 삭제 |

package/claude/references/sd-simplysm-v14/angular/providers/sd-modal-provider.md

@@ -0,0 +1,67 @@
+# `SdModalProvider`
+
+프로그래밍 방식으로 모달을 생성하는 프로바이더.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdModalProvider {
+  modalCount = signal(0);
+
+  async showAsync<T extends SdModalContentDef<any>>(
+    modal: SdModalInfo<T>,
+    options?: SdModalOptions,
+  ): Promise<Parameters<T["close"]["emit"]>[0] | undefined>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `modalCount` | property | `WritableSignal<number>` | 현재 열린 모달 수 |
+| `showAsync(modal, options?)` | method | `(SdModalInfo<T>, SdModalOptions?) => Promise<...>` | 모달 생성 후 close 결과를 Promise로 반환 |
+
+## Usage
+
+### 선택 모달 호출
+
+```typescript
+private readonly _sdModal = inject(SdModalProvider);
+
+const result = await this._sdModal.showAsync({
+  title: "고객 선택",
+  type: CustomerList,
+  inputs: {
+    selectMode: "multi",
+    selectedItemKeys: this.selectedCustomerIds(),
+  },
+});
+if (result != null) {
+  // result.selectedItemKeys: any[]
+  // result.selectedItems: ICustomer[]
+}
+```
+
+### 편집 모달 호출
+
+```typescript
+private async _editItem(item?: ICustomer): Promise<void> {
+  const r = await this._sdModal.showAsync({
+    title: item == null ? "고객 등록" : "고객 수정",
+    type: CustomerEditModal,
+    inputs: { itemId: item?.id },
+  });
+  if (r != null) await this._refresh();
+}
+```
+
+### 조회 전용 modal 호출
+
+```typescript
+await this._sdModal.showAsync({
+  title: "고객 주문 이력",
+  type: CustomerOrderHistoryModal,
+  inputs: { customerId: 123 },
+});
+// 반환값 미사용 — 닫기는 SdModal 기본 "X" 버튼
+```

package/claude/references/sd-simplysm-v14/angular/providers/sd-navigate-window-provider.md

@@ -0,0 +1,18 @@
+# `SdNavigateWindowProvider`
+
+새 윈도우 네비게이션 + 자동 닫기 프로바이더.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdNavigateWindowProvider {
+  get isWindow(): boolean;
+  open(navigate: string, params?: Record<string, string>, features?: string): void;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `isWindow` | getter | `boolean` | 현재 페이지가 팝업 윈도우인지 여부 |
+| `open(navigate, params?, features?)` | method | `(string, Record<string,string>?, string?) => void` | 새 윈도우 열기. `features` 지정 시 팝업, 미지정 시 새 탭 |

package/claude/references/sd-simplysm-v14/angular/providers/sd-print-provider.md

@@ -0,0 +1,25 @@
+# `SdPrintProvider`
+
+인쇄 및 PDF 생성 프로바이더. jsPDF + html-to-image 사용.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdPrintProvider {
+  async printAsync<T extends SdPrint>(
+    template: SdPrintInput<T>,
+    options?: { size?: string; margin?: string },
+  ): Promise<void>;
+
+  async getPdfBufferAsync<T extends SdPrint>(
+    template: SdPrintInput<T>,
+    options?: { orientation?: "portrait" | "landscape"; pageSize?: string },
+  ): Promise<Uint8Array>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `printAsync(template, options?)` | method | `(...) => Promise<void>` | 브라우저 인쇄 대화상자 열기. `size` 기본값 `"A4 auto"`, `margin` 기본값 `"0"` |
+| `getPdfBufferAsync(template, options?)` | method | `(...) => Promise<Uint8Array>` | PDF 바이너리 생성. `.page` 클래스 요소 단위로 페이지 분할 |

package/claude/references/sd-simplysm-v14/angular/providers/sd-service-client-factory-provider.md

@@ -0,0 +1,43 @@
+# `SdServiceClientFactoryProvider`
+
+ServiceClient 인스턴스 팩토리/관리. key별로 연결을 관리한다.
+
+```typescript
+@Injectable({ providedIn: "root" })
+class SdServiceClientFactoryProvider {
+  async connectAsync(key: string, options?: Partial<ServiceConnectionOptions>): Promise<void>;
+  async closeAsync(key: string): Promise<void>;
+  get(key: string): ServiceClient;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `connectAsync(key, options?)` | method | `(string, options?) => Promise<void>` | WebSocket 연결. 요청/응답 진행률을 토스트로 표시 |
+| `closeAsync(key)` | method | `(string) => Promise<void>` | 연결 종료 |
+| `get(key)` | method | `(string) => ServiceClient` | 연결된 ServiceClient 인스턴스 반환 |
+
+## Usage
+
+소비 프로젝트에서 `AppServiceProvider` 패턴으로 감싸서 사용한다:
+
+```typescript
+@Injectable({ providedIn: "root" })
+export class AppServiceProvider {
+  private readonly _sdServiceClientFactory = inject(SdServiceClientFactoryProvider);
+
+  get client() {
+    return this._sdServiceClientFactory.get("MAIN");
+  }
+
+  get systemLog() {
+    return this.client.getService<SystemLogServiceType>("SystemLog");
+  }
+
+  get orderUpdated() {
+    return this.client.getEvent<typeof OrderUpdatedEvent>("OrderUpdated");
+  }
+}
+```