+  type MerchantDetailSummary,

+  /** 수정 — 상세가 있는 가맹점. 없으면 등록 화면이다. */

+  detail?: MerchantDetail;

+  /** 등록 — 아직 상세가 없는 가맹점 선택지. 업체명 자리에서 하나를 고른다. */

+  candidates?: MerchantDetailSummary[];

+  /** 등록 — 미리 골라 둘 가맹점(`?frcsNo=`). */

+  initialFrcsNo?: string;

+  products?: MerchantProduct[];

+ * 가맹몰 상세 등록·수정 — 기획 BO-MAL-002(등록)·003(수정). `detail`이 있으면 수정, 없으면 등록이다.

+ * 상세는 기존 가맹점에만 붙으므로 등록 화면은 업체명 자리에서 상세가 없는 가맹점을 고른다

+ * (사용자 확정). 업체명·연락처·우편번호·주소는 가맹점 원본이라 읽기 전용이고, 기획의 [주소 검색]은

+ * 가맹점 관리 화면의 것이라 여기서는 값을 바꾸지 않는다.

+export function MerchantDetailForm({

+  detail,

+  candidates = [],

+  initialFrcsNo,

+  products = [],

+  categories,

+}: MerchantDetailFormProps) {

+  const isEdit = detail !== undefined;

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

+  // 읽기 전용 칸의 출처 — 수정은 상세, 등록은 고른 가맹점.

+  const merchant: MerchantDetailSummary | null =

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

+  const [categoryCode, setCategoryCode] = useState(detail?.categoryCode ?? '');

+    detail?.isVisible === false ? 'N' : 'Y',

+    if (!detail) return;

+    if (!detail) return;

+    if (!detail) return;

+        <input type="hidden" name="frcsNo" value={frcsNo} />

+              {detail ? (

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

+              ) : (

+                <>

+                  <FoxSelect

+                    size="md"

+                    label="업체명"

+                    requirement="required"

+                    placeholder="상세를 등록할 가맹점 선택"

+                    options={candidates.map((row) => ({ value: row.id, label: row.name }))}

+                    value={frcsNo}

+                    onValueChange={setFrcsNo}

+                    error={Boolean(errors.frcsNo)}

+                  />

+                  {errors.frcsNo && <FoxHelperText type="danger" message={errors.frcsNo} />}

+                  {candidates.length === 0 && (

+                    <FoxHelperText

+                      type="information"

+                      message="상세를 붙일 가맹점이 없습니다. 가맹점 관리에서 먼저 등록해 주세요."

+                    />

+                  )}

+                </>

+              )}

+                value={formatOptionalValue(formatPhoneNumber(merchant?.phoneNumber ?? null))}

+              <FoxInput size="md" label="우편번호" requirement="required" value={formatOptionalValue(detail?.postalCode)} readOnly state="view" />

+              <FoxInput size="md" label="주소" value={formatOptionalValue(merchant?.address)} readOnly state="view" />

+              <FoxInput size="md" label="상세주소" value={formatOptionalValue(merchant?.addressDetail)} readOnly state="view" />

+                defaultValue={detail?.description ?? ''}

+                defaultValue={detail?.openTime ?? ''}

+                defaultValue={detail?.closeTime ?? ''}

+                defaultValue={detail?.closedDays ?? ''}

+                defaultValue={detail?.sortOrder == null ? '' : String(detail.sortOrder)}

+            defaultThumbnailUrl={detail?.thumbnailUrl ?? null}

+            retainedThumbnailId={detail?.thumbnailFileId ?? null}

+            defaultImageUrls={detail?.imageUrls ?? []}

+            retainedImageFileId={detail?.imageFileId ?? null}

+          <MerchantProductTable frcsNo={frcsNo} products={products} canAdd={isEdit} />

+        {detail && (

+            {detail && (

+import { notFound, redirect } from 'next/navigation';

+import { merchantDetailNewPath } from '@/lib/domain/merchant-detail-query';

+export const metadata: Metadata = { title: '가맹몰 상세 수정' };

+/** 수정 화면 — 상세가 있는 가맹점만. 아직 없는 가맹점이면 등록 화면으로 보내 거기서 고르게 한다. */

+  if (!detail.hasDetail) {

+    redirect(merchantDetailNewPath(frcsNo));

+  }

+    fetchMerchantProducts(frcsNo),

+    return { status: 'error', errors: { frcsNo: '업체를 선택해 주세요.' } };

+  MERCHANT_DETAIL_NEW_PATH,

+ * 상세가 등록된 가맹점만 선다(사용자 확정) — Repository가 가맹점 전체에서 걸러 준다. [+ 업체 등록]은

+ * 등록 화면으로 가서 상세가 없는 가맹점을 고르고, 행의 [수정]은 수정 화면으로 간다.

+            onAction={() => router.push(MERCHANT_DETAIL_NEW_PATH)}

+ * 기획 BO-MAL-001 관리 열 — [수정] [비활성|노출] [삭제]. 목록에는 상세가 있는 가맹점만 서므로

+ * [수정]은 수정 화면으로 간다.

+          아래 [등록]으로 상세를 먼저 저장하면 이어지는 수정 화면에서 메뉴를 추가할 수 있습니다.

+import type { Metadata } from 'next';

+import { verifySession } from '@/lib/auth/dal';

+import { fetchCommonCodes } from '@/lib/data/repositories/common-code-repository';

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

+import { CODE_GROUP } from '@/lib/domain/common-code';

+import { MerchantDetailForm } from '../[frcsNo]/_components/merchant-detail-form';

+

+export const metadata: Metadata = { title: '가맹몰 상세 등록' };

+export const dynamic = 'force-dynamic';

+

+interface PageProps {

+  searchParams: Promise<Record<string, string | string[] | undefined>>;

+}

+

+/** 등록 화면 — 상세가 없는 가맹점 중 하나를 골라 상세를 붙인다. `?frcsNo=`로 미리 고를 수 있다. */

+export default async function Page({ searchParams }: PageProps) {

+  await verifySession();

+

+  const params = await searchParams;

+  const requested = Array.isArray(params.frcsNo) ? params.frcsNo[0] : params.frcsNo;

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

+    fetchMerchantDetailCandidates(),

+    fetchCommonCodes(CODE_GROUP.merchantType),

+  ]);

+  const initialFrcsNo = candidates.some((row) => row.id === requested) ? requested : undefined;

+

+  return (

+    <MerchantDetailForm

+      candidates={candidates}

+      initialFrcsNo={initialFrcsNo}

+      categories={categories}

+    />

+  );

+}

+ *                                             (화면은 상세 있는 건만 목록에, 없는 건은 등록 선택지에)

+type SummaryFilters = Pick<

+  MerchantDetailQuery,

+  'keyword' | 'category' | 'visibility' | 'startDate' | 'endDate'

+>;

+

+async function fetchSummaryPage(

+  filters: Partial<SummaryFilters>,

+  pageIndex: number,

+  pageSize: number

+): Promise<{ items: MerchantDetailSummary[]; rowCount: number; totalCount: number }> {

+      ...(filters.keyword ? { searchFrcsNm: filters.keyword } : {}),

+      ...(filters.category ? { searchFrcsTypeCd: filters.category } : {}),

+      ...(filters.visibility ? { searchUseYn: filters.visibility } : {}),

+      ...(filters.startDate ? { searchStartDt: filters.startDate } : {}),

+      ...(filters.endDate ? { searchEndDt: filters.endDate } : {}),

+      pageIndex,

+      recordCountPerPage: pageSize,

+    return { items: [], rowCount: 0, totalCount: 0 };

+    // 매핑에서 걸러진 행이 있어도 페이지가 끝났는지는 원본 행 수로 판단한다.

+    rowCount: data.list.length,

+// 백엔드 목록에는 "상세가 있는 건만" 조건이 없다(보고함). 그래서 전 페이지를 받아 여기서 거른다 —

+// 가맹점은 많아야 수백 건이라 한두 번의 요청이다. 상한을 넘으면 그 뒤는 잘린다.

+// TODO(백엔드): 상세 유무 조건이 생기면 이 훑기를 없애고 페이지 하나만 받는다.

+const SCAN_PAGE_SIZE = 200;

+const MAX_SCAN_PAGES = 25;

+

+async function fetchAllSummaries(

+  filters: Partial<SummaryFilters>

+): Promise<MerchantDetailSummary[]> {

+  const items: MerchantDetailSummary[] = [];

+  let seen = 0;

+  for (let pageIndex = 1; pageIndex <= MAX_SCAN_PAGES; pageIndex += 1) {

+    const page = await fetchSummaryPage(filters, pageIndex, SCAN_PAGE_SIZE);

+    items.push(...page.items);

+    seen += page.rowCount;

+    if (page.rowCount < SCAN_PAGE_SIZE || seen >= page.totalCount) {

+      break;

+    }

+  }

+  return items;

+}

+

+/** 목록 — 상세가 있는 가맹점만, 화면 쪽 페이지로 잘라 준다(사용자 확정). */

+export async function fetchMerchantDetails(

+  query: MerchantDetailQuery

+): Promise<{ items: MerchantDetailSummary[]; totalCount: number }> {

+  const registered = (await fetchAllSummaries(query)).filter((row) => row.hasDetail);

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

+  return {

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

+    totalCount: registered.length,

+  };

+}

+

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

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

+  return (await fetchAllSummaries({})).filter((row) => !row.hasDetail);

+}

+

+    | 'frcsNo'

+export const MERCHANT_DETAIL_NEW_PATH = `${MERCHANT_DETAILS_PATH}/new`;

+/** 등록 화면. `frcsNo`를 주면 그 가맹점을 미리 골라 둔다. */

+export function merchantDetailNewPath(frcsNo?: string): string {

+  return frcsNo

+    ? `${MERCHANT_DETAIL_NEW_PATH}?frcsNo=${encodeURIComponent(frcsNo)}`

+    : MERCHANT_DETAIL_NEW_PATH;

+}

+

+/**

+ * 가맹점 한 건 + 상세 유무. 백엔드 목록은 가맹점 전체를 주지만 화면의 목록에는 상세가 있는

+ * 건만 서고(사용자 확정), 상세가 없는 건은 등록 화면의 업체 선택지가 된다.

+ */

+  /** 상세 행이 있는지 — 목록에 서는지, 등록 화면의 선택지가 되는지를 가른다. */