+  /** 상세가 있는 가맹점 — 고친다. */

+  /** 상세가 아직 없는데 가맹점은 정해진 경우(행의 [수정]) — 그 가맹점에 처음 만든다. */

+  merchant?: MerchantDetailSummary;

+  /** 가맹점도 정해지지 않은 경우([+ 업체 등록]) — 업체명 자리에서 하나를 고른다. */

+ * 고치고, `merchant`면 그 가맹점에 처음 만들고, 둘 다 없으면 업체명 자리에서 가맹점을 골라 만든다.

+ * 첫 저장 뒤에는 그 가맹점 주소로 옮겨 가되 화면 구성은 그대로라 바로 메뉴를 붙일 수 있고, 이후

+ * 저장은 그 자리에 머문다.

+  merchant: fixedMerchant,

+  // 가맹점이 정해져 있으면(상세가 있든 없든) 업체명은 읽기 전용이고, 아니면 여기서 고른다.

+  const pinned: MerchantDetailSummary | null = detail ?? fixedMerchant ?? null;

+  const [frcsNo, setFrcsNo] = useState(pinned?.id ?? '');

+    pinned ?? candidates.find((row) => row.id === frcsNo) ?? null;

+              {pinned ? (

+                <FoxInput size="md" label="업체명" requirement="required" value={pinned.name} readOnly state="view" />

+import {

+  fetchMerchantDetail,

+  fetchMerchantSummary,

+} from '@/lib/data/repositories/merchant-detail-repository';

+ * 가맹점 하나의 상세 화면. 상세가 있으면 고치고, 없으면(백엔드 단건이 NOT_FOUND — develop은 빈 가맹점

+ * 행을 주므로 `hasDetail`로 한 번 더 거른다) 가맹점 목록에서 찾아 그 가맹점을 고정한 채 처음 만든다.

+  const categoriesPromise = fetchCommonCodes(CODE_GROUP.merchantType);

+

+    const merchant = await fetchMerchantSummary(frcsNo);

+    if (!merchant) {

+      notFound();

+    }

+    return <MerchantDetailForm merchant={merchant} categories={await categoriesPromise} />;

+  const [products, categories, merchant] = await Promise.all([

+    categoriesPromise,

+    // 상세 응답에 업체명이 빠지는 백엔드 결함 — 코드만 왔으면 가맹점 목록에서 이름을 채운다.

+    detail.name === detail.id ? fetchMerchantSummary(frcsNo) : Promise.resolve(null),

+  return (

+    <MerchantDetailForm

+      detail={merchant ? { ...detail, name: merchant.name } : detail}

+      products={products}

+      categories={categories}

+    />

+  );

+ * 가맹점 전체가 서고 상세가 없는 건은 상태·등록일이 `-`다(사용자 확정) — Repository가 가맹점 목록에

+ * 상세를 덧입혀 준다. [+ 업체 등록]은 가맹점을 고르는 등록 화면으로, 행의 [수정]은 그 가맹점의

+ * 상세 화면으로 간다(상세가 없으면 거기서 처음 만든다).

+          {/* 등록일 기간 — 백엔드가 조건에 쓰지 않아 Repository가 등록일로 거른다. */}

+/**

+ * 기획 BO-MAL-001 관리 열 — 모든 행에 [수정] [비활성|노출] [삭제](시안대로, 사용자 확정). [수정]은 그

+ * 가맹점의 상세 화면으로 가고(상세가 없으면 거기서 처음 만든다), 상세가 없는 행의 [비활성]·[삭제]는

+ * 백엔드가 NOT_FOUND로 거절해 사유가 토스트로 올라온다.

+ */

+ * GET    /api/v1/mngr/voc/pagination          가맹점 전체 — 목록 합치기·등록 선택지·상세 없는 단건에 쓴다

+/**

+ * 목록 — 가맹점 전체에 상세를 덧입혀 상세가 없는 가맹점도 세운다(사용자 확정). 백엔드 목록은 상세가

+ * 있는 것만 주므로 가맹점 목록과 상세 목록을 모두 받아 합치고, 검색·기간·페이지는 여기서 처리한다.

+ * 부수 효과로 백엔드가 쓰지 않던 등록일 기간 조건과 응답에 빠진 업체명(결함 1)이 여기서 채워진다.

+ */

+  const merged = await fetchMergedSummaries();

+  const keyword = query.keyword.trim().toLowerCase();

+  const filtered = merged.filter((row) => {

+    if (keyword && !row.name.toLowerCase().includes(keyword)) return false;

+    if (query.category && row.categoryCode !== query.category) return false;

+    if (query.visibility && row.isVisible !== (query.visibility === 'Y')) return false;

+    if (query.startDate && (row.registeredAt === null || row.registeredAt < query.startDate)) return false;

+    if (query.endDate && (row.registeredAt === null || row.registeredAt > query.endDate)) return false;

+    return true;

+  const start = (query.page - 1) * query.pageSize;

+    items: filtered.slice(start, start + query.pageSize),

+    totalCount: filtered.length,

+}

+

+/** 상세 있는 가맹점을 등록일 내림차순으로 먼저, 나머지 가맹점을 코드 내림차순으로 뒤에 둔다. */

+function compareSummaryOrder(a: MerchantDetailSummary, b: MerchantDetailSummary): number {

+  if (a.hasDetail !== b.hasDetail) return a.hasDetail ? -1 : 1;

+  const dateA = a.registeredAt ?? '';

+  const dateB = b.registeredAt ?? '';

+  if (dateA !== dateB) return dateA < dateB ? 1 : -1;

+  return b.id.localeCompare(a.id, undefined, { numeric: true });

+}

+

+async function fetchMergedSummaries(): Promise<MerchantDetailSummary[]> {

+  const [merchants, details] = await Promise.all([

+    fetchAllPages(`${VOC_PATH}/pagination`, toCandidate),

+    fetchAllPages(`${DETAIL_PATH}/pagination`, toSummary),

+  ]);

+  const byId = new Map(merchants.map((row) => [row.id, row]));

+  for (const detail of details) {

+    // develop 백엔드(LEFT JOIN)는 상세 없는 가맹점도 섞어 준다 — 상세 있는 행만 덧입힌다.

+    if (!detail.hasDetail) continue;

+    const merchant = byId.get(detail.id);

+    byId.set(detail.id, {

+      ...detail,

+      // 결함 1 — 상세 응답에 업체명이 없으면 가맹점 목록의 이름을 쓴다.

+      name: detail.name === detail.id && merchant ? merchant.name : detail.name,

+    });

+  }

+  return [...byId.values()].sort(compareSummaryOrder);

+/** 등록 화면의 업체 선택지 — 아직 상세가 없는 가맹점 전부. */

+  return (await fetchMergedSummaries()).filter((row) => !row.hasDetail);

+}

+

+/** 가맹점 한 건(상세 없이) — 가맹점 단건 API가 없어 목록에서 찾는다. */

+export async function fetchMerchantSummary(

+  frcsNo: string

+): Promise<MerchantDetailSummary | null> {

+  const merchants = await fetchAllPages(`${VOC_PATH}/pagination`, toCandidate);

+  return merchants.find((row) => row.id === frcsNo) ?? null;