@simplysm/sd-claude 14.0.84 → 14.0.86

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

@@ -85,11 +85,11 @@ flowchart LR
 
 관련 섹션: [화면.재고 확인], [자동 처리.재고 스냅샷]
 
-### 3.2 마스터 데이터 변경 이력 [확정: 2026-04-01]
+### 3.2 시스템 기반 [확정: 2026-04-01]
 
-모든 마스터 데이터의 변경 (등록·편집·활성/비활성 전환) 이력을 자동으로 기록해야 함. 목적은 변경 추적·감사.
+앱 운영을 떠받치는 기반 구조 — 메뉴 트리·화면 접근 권한·기능 모듈 구성 — 를 한 곳에서 정의·관리할 수 있어야 함.
 
-관련 섹션: [횡단 처리.마스터 데이터 변경 이력]
+관련 섹션: [기반.앱 구조 정의]
 
 ## 4. 화면
 
@@ -409,41 +409,27 @@ Actor: 창고 관리자
   - 대처: 관리자에게 알림 발송. 동일 일자에 재실행할 경우 (날짜, 박스) 유일성 제약으로 중복 생성을 방지
   - 재시도 한계: 자동 재시도 없음 (다음 날 0시에 정상 동작)
 
-## 6. 횡단 처리
+## 6. 공통·기반 기능
 
-### 6.1 마스터 데이터 변경 이력 [확정: 2026-04-01]
+### 6.1 앱 구조 정의 [확정: 2026-04-01]
 
-목적: 마스터 데이터 변경의 추적·감사 (누가, 언제, 무엇을, 어떻게 바꿨는지 기록)
+목적: 앱의 메뉴 트리·화면 접근 권한·기능 모듈 구성을 한 곳에서 정의
 
-트리거 (부수효과 발동 조건):
-- 마스터 엔티티의 insert·update·delete 트랜잭션 commit 시점
-- 적용 대상 모델: [모델.품목], [모델.Location]
-- 적용 제외 모델 (트랜잭션 모델): [모델.재고], [모델.재고 스냅샷]
+트리거·적용 범위: 앱 부팅 시 / admin·PDA 클라이언트별 (클라이언트마다 자기 메뉴 배열을 정의)
 
-관련 섹션: [기타.마스터 데이터 변경 이력], [모델.품목], [모델.Location], [모델.DataLog]
+관련 섹션: [기타.시스템 기반], [화면.품목 관리], [화면.Location 관리], [화면.입고 스캔], [화면.재고 확인]
 
-#### 처리
+참조 매뉴얼: client-app-structure.md
 
-- 변경 전 값과 변경 후 값을 캡처 (insert 시 변경 전 = null, delete 시 변경 후 = null)
-- [모델.DataLog] 에 1행 적재 (테이블명·키·변경 전·변경 후·작업자·시각)
+### 6.2 마스터 변경 시 캐시 무효화 [확정: 2026-04-01]
 
-#### 예외 처리
+목적: 마스터 변경이 전 클라이언트 조회에 지체 없이 반영되도록 보장
 
-- DataLog 적재 실패 시:
-  - 위험: 변경 이력 추적 누락
-  - 대처: 원본 마스터 트랜잭션은 정상 commit 유지하고, DataLog 적재 실패만 별도 큐에 적재한 뒤 관리자에게 알림
-  - 재시도 한계: 큐에서 지수 백오프로 5회까지 재시도 후 운영팀에 알림
+트리거·적용 범위: [모델.품목]·[모델.Location] 의 insert·update·delete commit 시점 (부수효과) / 전체 클라이언트
 
-#### 모델 매핑
+관련 섹션: [프로세스.입고], [모델.품목], [모델.Location]
 
-| 필드 ([모델.DataLog]) | 용도                            |
-| --------------------- | ------------------------------- |
-| [모델.DataLog.테이블명] | 변경 대상 모델명 (예: `품목`) |
-| [모델.DataLog.키]       | 변경 대상 ID                  |
-| [모델.DataLog.변경 전]  | 컬럼별 변경 전 값 (JSON)      |
-| [모델.DataLog.변경 후]  | 컬럼별 변경 후 값 (JSON)      |
-| [모델.DataLog.작업자]   | 세션 사용자                   |
-| [모델.DataLog.시각]     | 변경 commit 시각              |
+해당 마스터의 공유 캐시를 무효화하여 클라이언트가 다음 조회 시 최신 데이터를 재적재하도록 함.
 
 ## 7. 공통 정의
 
@@ -571,25 +557,6 @@ Actor: 창고 관리자
 - 식별 키: ID (자동 부여)
 - 비즈니스 키: (날짜, 박스) 조합이 유일
 
-### 8.6 DataLog [확정: 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]

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

@@ -1,7 +1,7 @@
 ---
 name: sd-unpack
 description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/xls)를 첨부 포함 재귀적으로 풀어 평문 트리로 펼치기. Use when 위 형식 파일의 본문·첨부 전반을 훑어야 할 때 (분석·요약·정리·검토 등). 단순 단답 조회(특정 값/셀 확인)나 옆에 이미 펼친 `<basename>_<ext>/` 폴더가 있으면 호출 금지.
-
+model: haiku
 ---
 
 # sd-unpack

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

@@ -1,6 +1,7 @@
 ---
 name: sd-use
 description: 사용자 요청을 분석해 워크스페이스의 sd-* 스킬 중 가장 적합한 스킬을 추천하는 스킬. Use when 어떤 sd-* 스킬을 써야 할지 모를 때.
+model: haiku
 ---
 
 `/sd-use <요청>` 의 `<요청>` 에 적합한 sd-* 스킬을 추천만 출력하고 종료. 추천 대상 스킬의 자동 실행·산출물 생성 금지.

package/package.json

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

package/claude/references/sd-simplysm14/manuals/client-setup.md

@@ -1,154 +0,0 @@
-# 클라이언트 환경 셋업 매뉴얼
-
-화면 작성 시점에는 거의 건드리지 않음. 새 앱 부트스트랩 시 또는 새 서비스/마스터 데이터를 추가할 때만 참조.
-
-## AppServiceProvider
-
-`@simplysm/service-client` 위에 앱이 만드는 root provider. 서비스·이벤트 프록시와 ORM(Object-Relational Mapping) 커넥터를 lazy 캐싱으로 노출.
-
-```ts
-@Injectable({ providedIn: "root" })
-export class AppServiceProvider {
-  private readonly _sdServiceClientFactory = inject(SdServiceClientFactoryProvider);
-
-  private _orm?: OrmClientConnector;
-  private _user?: ServiceProxy<UserServiceType>;
-  private _authInfoEvent?: ClientEventProxy<typeof AuthInfoEvent>;
-  // ...
-
-  get client() {
-    return this._sdServiceClientFactory.get("MAIN");
-  }
-
-  get orm(): OrmClientConnector {
-    return (this._orm ??= createOrmClientConnector(this.client));
-  }
-
-  get user(): ServiceProxy<UserServiceType> {
-    return (this._user ??= this.client.getService<UserServiceType>("User"));
-  }
-
-  get authInfoEvent(): ClientEventProxy<typeof AuthInfoEvent> {
-    return (this._authInfoEvent ??= this.client.getEvent<typeof AuthInfoEvent>("AuthInfo"));
-  }
-
-  async connectAsync() {
-    await this._sdServiceClientFactory.connectAsync("MAIN");
-  }
-}
-```
-
-**약속**:
-
-- `@Injectable({ providedIn: "root" })`.
-- 서비스·이벤트는 `private _xxx?` 캐시 필드 + getter 로 노출. lazy 초기화는 `??=` 패턴 사용.
-- 서비스: `client.getService<XxxServiceType>("XxxName")` 호출. 이벤트: `client.getEvent<typeof XxxEvent>("XxxName")` 호출.
-- ORM 커넥터: `createOrmClientConnector(this.client)` 결과를 `orm` getter 로 노출.
-- `connectAsync()` — 앱 부트스트랩 시점에 서버 연결 수행.
-
-## AppOrmProvider
-
-`AppServiceProvider.orm` 위에 앱별 DB(데이터베이스) 설정(DbContext·데이터베이스명·스키마명)을 고정해 둔 root provider.
-
-```ts
-@Injectable({ providedIn: "root" })
-export class AppOrmProvider {
-  private readonly _appService = inject(AppServiceProvider);
-
-  connectAsync<R>(callback: (db: MainDbContext) => Promise<R>): Promise<R> {
-    return this._appService.orm.connect(
-      {
-        DbClass: MainDbContext,
-        connOpt: { configName: "MAIN" },
-        dbContextOpt: { database: "...", schema: "dbo" },
-      },
-      callback,
-    );
-  }
-
-  connectWithoutTransAsync<R>(callback: (db: MainDbContext) => Promise<R>): Promise<R> {
-    return this._appService.orm.connectWithoutTransaction(
-      { /* 같은 옵션 */ },
-      callback,
-    );
-  }
-}
-```
-
-**약속**:
-
-- `@Injectable({ providedIn: "root" })`.
-- DbContext 는 앱별로 정의 (예: `@adtek/db-main` 의 `MainDbContext`).
-- 기본 메서드는 `connectAsync` (트랜잭션 포함). `connectWithoutTransAsync` 는 initialize 등 트랜잭션 안에서 동작하지 않는 작업 전용 헬퍼.
-- 콜백의 반환값이 그대로 메서드의 반환값이 됨.
-
-## AppSharedDataProvider
-
-`@simplysm/angular` 의 `SdSharedDataProvider` 를 상속하여 화면에서 자주 참조하는 마스터 데이터(고객사·품목·로케이션 등)를 등록한 root provider.
-
-```ts
-export function useSharedSignal<K extends keyof TAppSharedData>(
-  name: K,
-): SharedDataHandle<TAppSharedData[K]> {
-  const appSharedData = inject(AppSharedDataProvider);
-  return appSharedData.getHandle(name);
-}
-
-@Injectable({ providedIn: "root" })
-export class AppSharedDataProvider extends SdSharedDataProvider<TAppSharedData> {
-  private readonly _appOrm = inject(AppOrmProvider);
-
-  override initialize() {
-    this.register("고객사", {
-      serviceKey: "MAIN",
-      getter: async (changeKeys) => {
-        return this._appOrm.connectAsync(async (db) => {
-          let qr = db.customer().select((item) => ({
-            id: item.id,
-            code: item.code,
-            name: item.name,
-            isDeleted: item.isDeleted,
-
-            __valueKey: item.id,
-            __searchText: expr.concat(item.code, "|_|", item.name),
-            __isHidden: item.isDeleted,
-          }));
-
-          if (changeKeys) {
-            qr = qr.where((item) => [expr.in(item.id, changeKeys as number[])]);
-          }
-          return qr.execute();
-        });
-      },
-      orderBy: (item) => item.code,
-    });
-
-    // ... 다른 마스터 데이터 등록 ...
-  }
-}
-
-export type TAppSharedData = {
-  고객사: ISharedCustomer;
-  // ...
-};
-
-export interface ISharedCustomer extends SharedDataBase<number> {
-  id: number;
-  code: string;
-  name: string;
-  isDeleted: boolean;
-}
-```
-
-**약속**:
-
-- `@Injectable({ providedIn: "root" })` 사용, `SdSharedDataProvider<TAppSharedData>` 를 상속.
-- 등록은 `override initialize()` 안에서 `this.register(name, opts)` 호출로 수행.
-- 각 항목의 인터페이스는 `SharedDataBase<TKey>` 를 상속.
-- getter 의 select 결과에 다음 매직 필드를 포함:
-  - `__valueKey` — 항목의 키.
-  - `__searchText` — 검색용 텍스트.
-  - `__isHidden` — 숨김 여부 (예: `isDeleted` 값으로 지정).
-- `getter(changeKeys)` 의 `changeKeys` 인자가 주어지면 해당 키들만 다시 조회 (incremental refresh).
-- `orderBy` 는 정렬 키를 반환하는 함수 (예: `(item) => item.code`).
-- `useSharedSignal<K>(name)` 헬퍼 함수를 함께 export — 컴포넌트는 inject 없이 이름만으로 접근 가능.