@simplysm/sd-claude 14.0.92 → 14.0.94

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

@@ -27,17 +27,17 @@ ORM 호출, 파일 변환, 비즈니스 로직 등은 위 두 경우에 해당
 | ------------------------------------------------------- | ------------------------------------------------------ |
 | 클라이언트 공통 lint/template 규칙 (예: `$any` 금지) | [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)             |
+| `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)               |
 | 앱에서 서버 서비스·이벤트 호출 (provider 정의·항목 추가) | [client-service.md](./manuals/client-service.md)       |
 | 앱에서 ORM(DB) 사용 (AppOrmProvider 정의)               | [client-orm.md](./manuals/client-orm.md)               |
-| 앱에서 공유 마스터 데이터 사용 (provider 정의·항목 추가, 선택 컨트롤의 관리·선택 모달) | [client-shared-data.md](./manuals/client-shared-data.md) |
+| 앱에서 공유 마스터 데이터 사용 (provider 정의·항목 추가, 선택 컨트롤의 관리·선택 모달, 좌측 선택+우측 상세 레이아웃) | [client-shared-data.md](./manuals/client-shared-data.md) |
 | 클라이언트·서버 간 실시간 이벤트 정의·발생·구독         | [event.md](./manuals/event.md)                         |
 | 앱 메뉴 구조·권한 정의 추가/수정                        | [client-app-structure.md](./manuals/client-app-structure.md) |
-| ORM 쿼리 작성(조회 흐름·안티패턴), 컬럼 nullable/default 정책, 삭제 전략 | [orm.md](./manuals/orm.md)                             |
+| ORM 쿼리 작성(조회 흐름·안티패턴), 컬럼 nullable/default·유니크 정책, 삭제 전략 | [orm.md](./manuals/orm.md)                             |
 | 이종 엔티티를 한 목록으로 합쳐 표시 (UNION)             | [orm-union.md](./manuals/orm-union.md)                 |
-| CRUD 처리에 데이터 변경 이력 적재·조회 (누가·언제·무엇을 변경) | [data-log.md](./manuals/data-log.md)                   |
+| CRUD 처리에 데이터 변경 이력 적재·조회·표시 (누가·언제·무엇을 변경, 목록의 수정일시·수정자 컬럼) | [data-log.md](./manuals/data-log.md)                   |
 | 콘솔 로깅 코드 작성/수정 (모든 패키지)                  | [logging.md](./manuals/logging.md)                     |
 | 클라이언트 시스템 에러·로그를 DB 등 외부에 적재·조회    | [client-system-log.md](./manuals/client-system-log.md) |
 | 패키지 테스트·통합 테스트 작성/추가                     | [test.md](./manuals/test.md)                           |

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

@@ -116,7 +116,7 @@ view 의 합성 패턴 (예: `outbound-instruction.view.ts`):
 - view 는 list 컴포넌트를 템플릿 변수(`#headerSheet`) 로 잡아 `selectedKeys()` 를 읽고 `doRefresh()` 를 호출.
 - detail 의 단건 변경·삭제는 list 가 표시하는 동일 데이터에 반영해야 하므로, detail 의 `submitted` → list 의 `doRefresh()` 호출로 동기화.
 - view 는 `sd-base-container` 를 루트로 두고, 내부 콘텐츠는 `#contentTpl` 슬롯에 배치.
-- 미선택 빈 상태(`선택하세요.`) 코드는 위 예시 그대로 사용. `tablerArrowLeft` 아이콘을 쓰므로 화면 컴포넌트에 `NgIcon` 등록 필요 ([아이콘](#아이콘) 참조).
+- 미선택 빈 상태는 위 예시의 구조(아이콘 + 안내 문구 `div`)를 그대로 사용하되, 안내 문구는 무엇을 선택하는지 드러내는 맥락 문구로 작성(예: `역할을 선택하세요.`). `tablerArrowLeft` 아이콘을 쓰므로 화면 컴포넌트에 `NgIcon` 등록 필요 ([아이콘](#아이콘) 참조).
 
 ### list + list 합성 (마스터-라인)
 

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

@@ -73,6 +73,100 @@
 
 `selectMode` 는 `readonly` 와 독립 — selectMode 지정만으로는 편집이 막히지 않음. 등록·인라인 편집은 그대로 유지되고, `single` 일 때 "선택 삭제/복구" 버튼만 숨김. 읽기 전용이 필요하면 `readonly=true` 를 별도로 전달. `sd-shared-data-select-list` 가 모달을 띄울 때도 `selectMode="single"` 만 주입하므로 모달 내용은 편집 가능 상태로 유지됨.
 
+### 행을 클릭해 상세 편집으로 진입하려면 (inlineEdit=false)
+
+`inlineEdit=false` 목록의 편집 진입은 첫 컬럼(`#`)을 권한 분기된 진입점으로 만들어 처리. 편집 가능하면 편집 아이콘이 붙은 앵커를 눌러 상세 모달을 열고, 불가하면 값만 표시.
+
+```html
+<sd-sheet-column [key]="'id'" [header]="'#'">
+  <ng-template [cell]="items()" let-item="item">
+    @if (canEdit()) {
+      <sd-anchor class="flex-row gap-sm p-xs-sm" (click)="onEdit(item, $event)">
+        <div><ng-icon [svg]="tablerEdit" /></div>
+        <div class="flex-fill tx-right">{{ item.id }}</div>
+      </sd-anchor>
+    } @else {
+      <div class="p-xs-sm tx-right">{{ item.id }}</div>
+    }
+  </ng-template>
+</sd-sheet-column>
+```
+
+```ts
+async onEdit(item: IItem, event: Event): Promise<void> {
+  event.preventDefault(); // 앵커 기본 동작 차단
+  event.stopPropagation(); // 행 선택과 분리
+  await this._openDetail(item.id); // 상세 모달 열고, 닫힘 결과 있으면 refresh
+}
+```
+
+- `canEdit()` 가 false 면 앵커 대신 텍스트만 — 권한 없는 사용자에게 편집 진입을 노출하지 않음.
+- 앵커 레이아웃(`flex-row`·아이콘/값 정렬)은 화면 사정에 맞춤. 정규는 "`#` 컬럼 = 권한 분기된 편집 진입점" 까지.
+
+### 현재 검색 결과를 엑셀로 내려받게 하려면
+
+`#toolTpl` 에 다운로드 버튼을 두고, 페이징을 무시한 **현재 검색·필터 결과 전체**를 받아 엑셀로 변환. `ExcelWrapper`(zod 스키마) + `downloadBlob` 을 화면에 직접 둠.
+
+```html
+<ng-template #toolTpl>
+  <sd-button [size]="'sm'" [theme]="'link-success'" (click)="onDownloadExcelButtonClick()">
+    <ng-icon [svg]="tablerFileExcel" />
+    엑셀 다운로드
+  </sd-button>
+</ng-template>
+```
+
+```ts
+private readonly _excelWrapper = new ExcelWrapper(
+  z.object({
+    id: z.number().optional().describe("ID"),
+    name: z.string().describe("이름"),
+    isDeleted: z.boolean().describe("삭제"),
+    lastModifiedAt: z.custom<DateTime>().optional().describe("수정일시"),
+    lastModifiedBy: z.string().optional().describe("수정자"),
+  }),
+);
+
+async onDownloadExcelButtonClick(): Promise<void> {
+  if (this.busyCount() > 0) return;
+  this.busyCount.update((v) => v + 1);
+  await this._sdToast.try(async () => {
+    const r = await this._search(false); // 페이징 무시 — 검색·필터 결과 전체
+    const wb = await this._excelWrapper.write(this.viewTitle(), r.items);
+    try {
+      downloadBlob(
+        await wb.toBlob(),
+        `${this.viewTitle()}_${new DateTime().toFormatString("yyMMdd")}.xlsx`,
+      );
+    } finally {
+      await wb.close(); // 워크북 자원 해제
+    }
+  });
+  this.busyCount.update((v) => v - 1);
+}
+```
+
+- 조회는 목록과 같은 `_search` 를 페이징 인자만 꺼서 재사용 — 보이는 페이지가 아니라 결과 전체를 받음.
+- 파일명은 `<화면제목>_<yyMMdd>.xlsx`. 화면 제목은 `injectViewTitleSignal()`.
+- 양식 컬럼 = 화면 표시 컬럼 + `삭제`(참/거짓) + `수정일시`·`수정자`([data-log.md](./data-log.md) 의 표시 규약). 참조 마스터는 명칭으로 출력.
+- 비밀번호 등 평문으로 못 꺼내는 값은 양식에서 제외.
+- `ExcelWrapper`/`downloadBlob` 자체 사용법은 [apis/excel/README.md](../apis/excel/README.md) · [apis/core-browser/README.md](../apis/core-browser/README.md).
+
+### 특정 행의 선택·삭제를 막으려면
+
+`[getItemSelectableFn]` 로 행별 선택 가능 여부를 반환. 문자열을 반환하면 그 사유가 안내되고 해당 행은 선택(→삭제) 불가. 개별 선택·전체 선택 모든 경로에 적용됨.
+
+```ts
+// 로그인한 본인 계정은 선택(→삭제) 불가
+getItemSelectableFn = (item: IItem): boolean | string =>
+  item.id === this._appAuth.authInfo()?.employeeId
+    ? "본인 계정은 삭제할 수 없습니다."
+    : true;
+```
+
+- `true` = 선택 가능, `string` = 선택 불가 + 사유. 선택 자체가 막히므로 핸들러에 같은 가드를 또 두지 않아도 됨.
+- 단건 상세에는 선택 개념이 없으므로, 같은 제약을 삭제 버튼을 조건부로 숨겨 적용(`@if (!isSelf() && perms().includes("edit")) { ...삭제 버튼... }`).
+
 ## `sd-crud-detail`
 
 단일 레코드 편집 화면의 표준 골격. 다음 기능을 일괄 제공: 폼 래핑, CTRL+S 단축키 저장, 저장 버튼, 모달의 "확인" 버튼 자동 처리.
@@ -108,3 +202,90 @@
 - **`'page'`** — 라우팅 진입 단위. 상단에 저장 버튼.
 - **`'control'`** — view 안에 임베드. 명령 영역에 저장 버튼.
 - **`'modal'`** — 모달. 하단 우측에 "확인" 버튼이 자동으로 추가.
+
+## 삭제·복구를 처리하려면 (목록·단건 공통)
+
+삭제는 soft delete, 복구는 그 반대. 두 처리 모두 변경 이력 적재([data-log.md](./data-log.md))와 공유 데이터 통지([client-shared-data.md](./client-shared-data.md))를 같은 트랜잭션·동작 안에서 함께 수행.
+
+### 삭제 (onDelete)
+
+`confirm` → soft delete(`isDeleted=true`) → 이력 적재 → 공유 데이터 통지 → 목록은 refresh / 단건은 close.
+
+```ts
+async onDelete(targets: IItem[]): Promise<void> {
+  if (this.busyCount() > 0) return;
+  if (!this.canEdit()) return;
+  if (targets.length === 0) return;
+  if (!confirm("삭제하시겠습니까?")) return;
+
+  this.busyCount.update((v) => v + 1);
+  await this._sdToast.try(async () => {
+    const ids = targets.map((t) => t.id);
+    const employeeId = this._appAuth.authInfo()?.employeeId;
+    await this._appOrm.connectAsync(async (db) => {
+      await db.role().where((c) => [expr.in(c.id, ids)]).update(() => ({ isDeleted: true }));
+      for (const id of ids) {
+        await db.role().insertDataLog({ action: "삭제", itemId: id, employeeId });
+      }
+    });
+    await this._appSharedData.emitAsync("역할", ids);
+    this._sdToast.success("삭제되었습니다.");
+    await this._refresh();
+  });
+  this.busyCount.update((v) => v - 1);
+}
+```
+
+### 복구 (onRestore)
+
+복구는 `confirm` 없이 진행하되, **활성 유니크 컬럼(명칭·코드)이 있으면 복구로 활성 중복이 생기지 않는지 재검증**해야 함(삭제된 동안 같은 값의 활성 레코드가 생겼을 수 있음). 검증 위치가 단건/벌크에서 다름. 활성 유니크 정책 자체는 [orm.md](./orm.md) 의 유니크 전략.
+
+**단건 복구 (detail) — 선검증**: 복구 전에 `exists` 로 충돌을 막음.
+
+```ts
+// 복구 전 활성 유니크 재검증
+const isNameDuplicated = await db
+  .role()
+  .where((c) => [
+    expr.eq(c.name, roleName),
+    expr.eq(c.isDeleted, false),
+    expr.not(expr.eq(c.id, roleId)), // 자기 자신 제외
+  ])
+  .exists();
+if (isNameDuplicated) throw new Error("같은 이름의 활성 역할이 있어 복구할 수 없습니다.");
+
+await db.role().where((c) => [expr.eq(c.id, roleId)]).update(() => ({ isDeleted: false }));
+await db.role().insertDataLog({ action: "복구", itemId: roleId, employeeId });
+// → emitAsync → refresh (단건 복구는 닫지 않고 refresh)
+```
+
+**벌크 복구 (list) — 후검증**: update 전엔 대상이 모두 삭제 상태라 대상끼리 충돌을 쿼리로 못 봄 → update **후** 한 쿼리로 활성 중복을 검사하고, 충돌 시 throw 해 트랜잭션 전체를 롤백.
+
+```ts
+await db.role().where((c) => [expr.in(c.id, ids)]).update(() => ({ isDeleted: false }));
+
+// 복구 후 활성 유니크 재검증 — 대상끼리·기존 활성과의 충돌을 복구한 이름으로 한정해 한 번에
+const conflicts = await db
+  .role()
+  .where((c) => [expr.in(c.name, names), expr.eq(c.isDeleted, false)])
+  .groupBy((c) => [c.name])
+  .having(() => [expr.gt(expr.count(), 1)])
+  .select((c) => ({ name: c.name }))
+  .execute();
+if (conflicts.length > 0) {
+  const conflictNames = conflicts.map((x) => `'${x.name}'`).join(", ");
+  throw new Error(`같은 이름(${conflictNames})의 활성 역할이 있어 복구할 수 없습니다.`);
+}
+
+for (const id of ids) {
+  await db.role().insertDataLog({ action: "복구", itemId: id, employeeId });
+}
+// → emitAsync → refresh
+```
+
+### 지킬 것
+
+- 삭제·복구·이력 적재는 한 `connectAsync` 트랜잭션 안에서 수행 — 데이터만 바뀌고 이력이 빠지거나 그 반대가 되지 않게 함.
+- 벌크 복구는 하나라도 충돌하면 전체 롤백(원자성). 충돌분만 빼고 나머지를 복구하지 않음.
+- 활성 유니크 검증은 복구 경로에서 빠뜨리지 않음 — 단건은 선검증, 벌크는 후검증. 활성 유니크가 없는 모델이면 생략 가능.
+- 단건은 삭제 후 닫고(close), 복구 후엔 닫지 않고 refresh — 복구 직후 상세를 계속 보도록.

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

@@ -86,7 +86,7 @@ if (!result) return;
   <sd-button [size]="'sm'" [theme]="'link-success'" (click)="onExcelUploadClick()">
     <ng-icon [svg]="tablerFileExcel" /> 엑셀 업로드
   </sd-button>
-  <sd-button [size]="'sm'" [theme]="'link-primary'" (click)="onExcelDownloadClick()">
+  <sd-button [size]="'sm'" [theme]="'link-success'" (click)="onExcelDownloadClick()">
     <ng-icon [svg]="tablerDownload" /> 엑셀 다운로드
   </sd-button>
 </ng-template>

package/claude/references/sd-simplysm14/manuals/client-shared-data.md

@@ -165,6 +165,52 @@ sharedProducts = useSharedSignal("품목");
   - 이 계약은 `sd-crud-list` 의 모달 선택 모드와 동일 ([client-crud.md](./client-crud.md) 참조). 즉 목록 화면 하나가 일반 페이지·선택 모달 양쪽으로 재사용됨.
 - 선택 컨트롤이 띄울 때는 항상 `selectMode: "single"` 로 주입되므로, 목록은 단건 선택 모드로 동작함.
 
+## 좌측 선택 목록 + 우측 상세(master-detail) 레이아웃을 구성하려면
+
+`sd-shared-data-select-list` 를 좌측에 두어 마스터를 고르고, 선택된 항목의 상세를 우측에 임베드하는 2-pane 화면. 선택을 바꾸거나 화면을 떠날 때 우측 상세의 미저장 변경을 보호하려면 자식 상세의 변경 가드를 부모가 위임 호출하도록 연결.
+
+```html
+<div class="flex-row fill">
+  <sd-shared-data-select-list
+    class="flex-min"
+    [items]="sharedRoles.items()"
+    [(selectedItem)]="selectedRole"
+    [canChangeFn]="checkCanLeave"
+    [header]="'역할'"
+    [modal]="{ type: RoleList, title: '역할', inputs: {} }"
+  >
+    <ng-template [itemOf]="sharedRoles.items()" let-item="item">{{ item.name }}</ng-template>
+  </sd-shared-data-select-list>
+
+  @let _selectedRole = selectedRole();
+  @if (_selectedRole == null) {
+    <div class="flex-fill p-xxl">역할을 선택하세요.</div>
+  } @else {
+    <app-role-permission-detail class="flex-fill" [roleId]="_selectedRole.id" />
+  }
+</div>
+```
+
+```ts
+detail = viewChild(RolePermissionDetail);
+
+// 자식 상세의 미저장 변경 가드를 부모가 위임 호출
+protected readonly checkCanLeave = (): boolean => {
+  const detail = this.detail();
+  return detail == null || detail.checkIgnoreChanges();
+};
+
+constructor() {
+  setupCanDeactivate(this.checkCanLeave); // 라우팅 이탈 보호
+}
+```
+
+- 자식 상세는 변경 가드를 `public` 메서드(`checkIgnoreChanges()`)로 노출해 부모가 호출. 이 화면에선 자식이 직접 `setupCanDeactivate` 를 두지 않고 부모가 가드를 소유.
+- 두 이탈 경로를 모두 막음:
+  - `[canChangeFn]="checkCanLeave"` — 좌측에서 **다른 항목으로 전환**하기 전 확인.
+  - `setupCanDeactivate(checkCanLeave)` — **페이지(라우팅) 이탈** 전 확인.
+- 선택 전(`selectedItem == null`)에는 안내 문구를 두고 상세를 띄우지 않음.
+
 ## 지킬 것
 
 - 항목 추가 시 세 곳(`register` · `TAppSharedData` · 인터페이스)을 모두 갱신. 하나라도 빠지면 타입 불일치 또는 미등록 데이터가 됨.

package/claude/references/sd-simplysm14/manuals/data-log.md

@@ -200,9 +200,41 @@ rows[0].firstDataLog?.action;      // "등록"
 .joinLastDataLog({ excludeActions: ["삭제"] })
 ```
 
+## 목록 시트에 수정일시·수정자 컬럼을 두려면
+
+`joinLastDataLog()` 로 부착한 `lastDataLog` 를 표시용 필드로 평탄화한 뒤 시트 컬럼으로 노출. 컬럼은 기본 숨김으로 두고 사용자가 컬럼 설정에서 켜 보게 함. 엑셀 다운로드에는 숨김과 무관하게 항상 포함.
+
+```ts
+.joinLastDataLog()
+.select((c) => ({
+  // ...표시 컬럼들...
+  lastModifiedAt: c.lastDataLog?.dateTime,
+  lastModifiedBy: c.lastDataLog?.employeeName,
+}))
+```
+
+```html
+<sd-sheet-column [key]="'lastModifiedAt'" [header]="'수정일시'" [hidden]="true">
+  <ng-template [cell]="items()" let-item="item">
+    <div class="p-xs-sm">{{ item.lastModifiedAt | format: "yyyy-MM-dd HH:mm" }}</div>
+  </ng-template>
+</sd-sheet-column>
+
+<sd-sheet-column [key]="'lastModifiedBy'" [header]="'수정자'" [hidden]="true">
+  <ng-template [cell]="items()" let-item="item">
+    <div class="p-xs-sm">{{ item.lastModifiedBy ?? "&nbsp;" }}</div>
+  </ng-template>
+</sd-sheet-column>
+```
+
+- `[hidden]="true"` 로 기본 숨김 — 평소엔 안 보이고, 사용자가 시트 컬럼 설정에서 켜야 노출.
+- 엑셀 다운로드 양식에는 항상 포함([client-crud.md](./client-crud.md) 의 엑셀 다운로드).
+- 모델 단위 변경 로그(`itemId` 없음, 예: 초기화)는 개별 행에 조인되지 않아 그 행은 빈칸 — 정상.
+
 ## 지킬 것
 
 - 모델 변경을 적재할 땐 변경을 수행한 그 모델의 queryable 에서 `insertDataLog` 호출. `db.dataLog().insert(...)` 로 `tableName` 을 손으로 적지 않음(자동 도출이 깨짐).
 - "최종 수정자/일시"·"최초 등록자/일시" 는 대상 테이블에 별도 컬럼을 추가하지 말고 `joinLastDataLog`/`joinFirstDataLog` 조인으로 표시.
 - 적재와 본 데이터 변경은 같은 트랜잭션 안에서 수행 — 이력만 남고 데이터가 롤백되거나 그 반대가 되지 않게 함.
 - `action` 문자열은 프로젝트 단위로 고정된 집합을 쓰고, 조회 측 `includeActions`/`excludeActions` 와 철자를 일치시킴.
+- 목록 시트의 `수정일시`·`수정자` 컬럼은 `[hidden]="true"` 기본(사용자가 켜서 봄)이고, 엑셀 다운로드에는 항상 포함.

package/claude/references/sd-simplysm14/manuals/orm.md

@@ -103,3 +103,40 @@ WHERE 와 SELECT 양쪽에서 동일 도출 산식을 쓰겠다고 `buildDerived
 
 - **기초정보(마스터)**: soft delete (`isDisabled` 등) 사용. FK 참조 무결성 보존.
 - **프로세스 문서(트랜잭션)**: 물리 delete. 상세 행을 포함해 캐스케이드. 단, 다른 테이블이 FK 로 참조 중이면 삭제를 차단하고 최종 사용자에게 toast 등으로 사유 안내.
+
+## 유니크 전략 (활성 유니크 vs 완전 유니크)
+
+soft delete 하는 마스터에서 "중복 불가" 컬럼은 두 종류로 나뉨. 대부분 DB 유니크 제약 대신 앱 검증을 기본으로 함.
+
+### 명칭·코드 = 활성(비삭제) 유니크
+
+활성(`isDeleted=false`) 레코드끼리만 중복 불가. 삭제하면 그 값이 풀려 재사용 가능.
+
+- **DB 유니크 제약(부분 유니크 인덱스 포함)을 두지 않음.** 등록·수정 시 앱에서 검증:
+  ```ts
+  const isDuplicated = await db
+    .role()
+    .where((c) => [
+      expr.eq(c.name, data.name),
+      expr.eq(c.isDeleted, false),
+      ...(roleId == null ? [] : [expr.not(expr.eq(c.id, roleId))]), // 수정 시 자기 자신 제외
+    ])
+    .exists();
+  if (isDuplicated) throw new Error("이미 존재하는 역할 이름입니다.");
+  ```
+- **단, `(컬럼, isDeleted)` 복합 비유니크 인덱스는 둠** — 위 검증 쿼리(`컬럼=? AND isDeleted=false`)의 성능용. 유니크 제약이 아님.
+- 채택 이유: 코드·명칭은 엑셀·외부 데이터 업로드 시 id 가 없어 **코드·명칭으로 기존 레코드에 매핑**됨. 완전 유니크로 두면 삭제값이 영구 점유돼 매핑이 깨짐 → 활성만 유니크로 둬 삭제값을 재사용 가능하게 함.
+- 조회·매핑은 항상 `isDeleted=false`(활성) 대상으로.
+
+### 자격증명(loginId 등) = 완전 유니크
+
+전체 행(삭제 포함) 유니크. 영구 점유 — 퇴사자 ID 재사용 방지(보안).
+
+- 업로드 매핑 대상이 아니라 삭제값을 재사용할 이유가 없음 → **DB 유니크 인덱스를 둠**.
+- DB unique 위반은 raw 에러라 사용자 메시지로 못 씀 → 앱 선검증 + 메시지를 병행하고 DB 인덱스는 안전망으로 둠.
+
+### 지킬 것
+
+- 활성 유니크는 DB 유니크 제약으로 강제하지 말고 앱 검증(`where(컬럼, isDeleted=false, id≠self).exists()`)으로. DB 에는 검증 성능용 `(컬럼, isDeleted)` **비유니크** 인덱스만.
+- 완전 유니크는 DB 유니크 인덱스 + 앱 선검증(메시지용) 병행.
+- 활성 유니크 컬럼은 삭제 후 복구될 때 충돌이 생길 수 있음 → 복구 경로에서 반드시 재검증([client-crud.md](./client-crud.md) 의 삭제·복구 처리).

package/claude/sd-system-prompt.md

@@ -296,6 +296,10 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
 - 본질 의도가 불명확하면 추측 금지. 사용자에게 질문할 것.
 - 피드백을 받을 때마다 자문: "이게 1회 사례인가, 일반 규칙인가?" → 1회면 규칙으로 확정하지 말 것.
 
+**확정 결과만 기재**:
+
+- 문서 본문에는 확정된 결과값만 적음. 대화 중 교정으로 폐기된 값이나 그 부정형(`~아님`·`~는 예시일 뿐`)을 본문에 끌어오지 말 것 (상세: [어휘·태도](#어휘태도) 의 교정·치환 규칙).
+
 **사전 차단 우선**:
 
 - 지침은 "잘못된 행위를 막는다" 가 기본. "행위 후 점검으로 교정" 은 보조.

package/package.json

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