임동욱 임동욱 09-14
docs: 가맹몰 상세의 백엔드 결함 목록에서 useYn 항목을 정정한다
MngrVocDetailVo는 MngrVocVo를 상속해 useYn을 갖는다 — 등록·수정·조회 모두 실리므로
결함이 아니었다(origin/develop 22f67cb 재확인). 남은 결함은 셋: 단건 SELECT의 상세 컬럼
누락, 등록일 검색 조건 미사용, 바우처 사용 필드 부재. hasDetail 주석도 c5ad833 이후
상태로 맞춘다.

Co-Authored-By: Claude Opus 5 
@f9d8da5badbe6a4ea349811cc6801a6f05cf5f3d
lib/data/repositories/merchant-detail-repository.ts
--- lib/data/repositories/merchant-detail-repository.ts
+++ lib/data/repositories/merchant-detail-repository.ts
@@ -22,11 +22,13 @@
  * ```
  *
  * ⚠️ 백엔드 결함(보고함, 미수정) — 화면은 시안대로 두고 값을 그대로 보낸다(사용자 확정):
- * 1. `MngrVocDetailVo`에 `useYn`이 없어 노출 상태가 등록·수정에서 유실되고 조회에도 안 온다.
- * 2. 단건 SELECT에 소개·카테고리·영업시간·휴무일·추가이미지·순서가 없어 수정 프리필이 빈다.
- * 3. 목록에 카테고리 코드·이름이 없다.
- * 4. `searchStartDt/EndDt`를 VO만 받고 WHERE에 쓰지 않는다.
- * 5. 「바우처 사용」을 담을 필드가 없다 — `voucherUseYn`으로 보내되 버려진다.
+ * 1. 목록·단건 SELECT(`includeSql`)에 소개·카테고리 코드·영업시간·휴무일·추가이미지·순서가
+ *    없어 수정 프리필이 빈다. 카테고리 이름(`CD_NM`)은 SELECT엔 있으나 VO에 담을 곳이 없다.
+ * 2. `searchStartDt/EndDt`를 VO만 받고 WHERE에 쓰지 않는다.
+ * 3. 「바우처 사용」을 담을 필드가 없다 — `voucherUseYn`으로 보내되 버려진다.
+ *
+ * 노출 상태(`useYn`)는 `MngrVocDetailVo`가 `MngrVocVo`에서 상속받아 등록·수정·조회 모두 실린다
+ * (처음엔 없다고 잘못 보고했다 — 2026-09-14 정정).
  */
 
 const DETAIL_PATH = '/api/v1/mngr/voc/detail';
lib/domain/merchant-detail.ts
--- lib/domain/merchant-detail.ts
+++ lib/domain/merchant-detail.ts
@@ -21,11 +21,11 @@
   thumbnailUrl: string | null;
   /** 백엔드 `frcsTypeCd` — 카테고리 코드. 목록 SQL에 아직 없어 늘 null이다(보고함). */
   categoryCode: string | null;
-  /** 백엔드 상세 `useYn`. VO에 필드가 없어 아직 오지 않는다(보고함). */
+  /** 백엔드 상세 `useYn`. 상세가 없는 가맹점은 null이다. */
   isVisible: boolean | null;
   /** 상세 등록일(`d.FRST_REG_DT`). 없으면 상세가 아직 없는 가맹점이다. */
   registeredAt: string | null;
-  /** 상세 행이 있는지 — 행 관리 버튼이 [상세 등록]과 [수정·비활성·삭제]로 갈린다. */
+  /** 상세 행이 있는지 — 일괄 비활성·삭제 대상인지, 메뉴를 추가할 수 있는지를 가른다. */
   hasDetail: boolean;
 };
 
Add a comment
List