candidates?: MerchantDetailSummary[];

   products?: MerchantProduct[];

   categories: CommonCode[];

 }

 /**

   candidates = [],

   products = [],

   categories,

 }: MerchantDetailFormProps) {

   const router = useRouter();

   const { showAlert, hideAlert, showToast } = useFeedback();

           description="앱 상세 화면의 메뉴 목록에 노출된다"

           className={styles.section}

         >

         </FoxCard>

         {detail && (

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

   }

     fetchMerchantProducts(frcsNo),

     categoriesPromise,

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

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

   ]);

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

       products={products}

       categories={categories}

     />

   );

 }

 import type { Metadata } from 'next';

 import { notFound } from 'next/navigation';

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

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

 import {

   fetchMerchantProduct,

   fetchMerchantProducts,

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

 import { MerchantProductForm } from '../_components/merchant-product-form';

 export const metadata: Metadata = { title: '가맹몰 메뉴 수정' };

   await verifySession();

   const { frcsNo, productSn } = await params;

     fetchMerchantDetail(frcsNo),

     fetchMerchantProduct(productSn),

     fetchMerchantProducts(frcsNo),

   ]);

   if (!detail || !product || product.frcsNo !== frcsNo) {

     notFound();

   }

 }

 import { submitFormAction } from '@/app/_hooks/submit-form-action';

 import { useBlockingAction } from '@/app/_hooks/use-blocking-action';

 import { useFeedback } from '@/app/_hooks/use-feedback';

 import { FILE_MODULE, fileModuleAccept } from '@/lib/domain/file-module';

 import { formatOptionalValue, type MerchantDetail } from '@/lib/domain/merchant-detail';

 import {

 } from '@/lib/domain/merchant-detail-query';

 import {

   MAX_PRODUCT_BADGES,

   MERCHANT_PRODUCT_VISIBILITY_OPTIONS,

   type MerchantProduct,

 } from '@/lib/domain/merchant-product';

 interface MerchantProductFormProps {

   detail: MerchantDetail;

   product?: MerchantProduct;

   productCount: number;

 }

  * 가맹몰 메뉴 등록·수정 — 기획 BO-MAL-004. 대상 업체는 읽기 전용이고 이 화면에서 바꾸지 않는다.

  * 저장하면 업체 상세 화면으로 돌아간다.

  */

   const router = useRouter();

   const { showAlert, hideAlert, showToast } = useFeedback();

   const [isBusy, startAction] = useBlockingAction();

               label="배지"

               name="badges"

               optionalText="복수 선택"

               values={badges}

               onChange={setBadges}

               maxSelected={MAX_PRODUCT_BADGES}

 import type { Metadata } from 'next';

 import { notFound } from 'next/navigation';

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

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

 import { fetchMerchantProducts } from '@/lib/data/repositories/merchant-product-repository';

 import { MerchantProductForm } from '../_components/merchant-product-form';

 export const metadata: Metadata = { title: '가맹몰 메뉴 등록' };

     notFound();

   }

 }

   MERCHANT_DETAILS_PATH,

   merchantDetailPath,

 } from '@/lib/domain/merchant-detail-query';

 import {

   validateMerchantProduct,

   type MerchantProductFormState,

 }

 /**

  *

  * 폼: 칸마다 `imageSlot`(`saved:<fileSn>` | `new`)과 `imageFile`(같은 순서, 안 고른 칸은 빈 파일).

  */

   }

   if (untouched) {

     return retainedId;

   }

   let newBytes = 0;

 function readBadges(formData: FormData): MerchantProductBadge[] {

   return formData

     .getAll('badges')

 }

 async function resolveProductImageId(formData: FormData): Promise<string> {

   let failed: MerchantProductFormState | null = null;

   try {

     if (!validation.ok) {

       return { status: 'error', errors: validation.errors };

     }

 import { FoxTable } from '@fox/core/components/fox-table';

 import { FoxTableCell } from '@fox/core/components/fox-table-cell';

 import { FoxTableRow } from '@fox/core/components/fox-table-row';

 import { EMPTY_FIELD_PLACEHOLDER } from '@/lib/domain/merchant-detail';

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

 import {

 interface MerchantProductTableProps {

   frcsNo: string;

   products: MerchantProduct[];

   /** 상세가 아직 저장되지 않은 가맹점 — 백엔드가 메뉴 등록을 거부하므로 추가를 막는다. */

   canAdd: boolean;

  * 기획 BO-MAL-002 ⑥ — 메뉴는 목록으로만 보이고 등록·수정은 별도 화면에서 한다.

  * 목록 화면 뼈대(FoxListContainer)는 머리말·검색까지 딸려 와 카드 안에는 표 조각만 놓는다.

  */

   const router = useRouter();

   return (

                     <span className={styles.badges}>

                       {product.badges.map((badge) => (

                         <FoxBadge key={badge} type="pastel" color="neutral" size="sm">

                         </FoxBadge>

                       ))}

                     </span>

 /**

  * 여러 장을 **한 `atchFileId` 아래** 올린다 — 파일마다 `fileSn`이 1,2,3…으로 붙는다.

  * 4컷만화처럼 묶음이 하나의 콘텐츠에 매달리는 자리에 쓴다.

  */

 export async function uploadAttachments(

   files: File[],

 ): Promise<string> {

   const accessToken = await getSessionAccessToken();

     {

       method: 'POST',

       multipart,

       accessToken: accessToken ?? undefined,

       cache: 'no-store',

       timeoutMs: UPLOAD_TIMEOUT_MS,

   merchantBusiness: 'FRCS_TPBIZ_CD',

   /** 업종 세분류(4자리 = 업종 2자리 + 업태 2자리). 값이 위 그룹에 없을 때 여기서 찾는다(사용자 확정). */

   merchantBusinessDetail: 'FRCS_CD',

 } as const;

 /** 값이 없는 항목의 화면 표기. */

 /** 기획 BO-MAL-004 ② — 필수는 메뉴명·가격·노출 여부 셋. */

 export const PRODUCT_NAME_MAX_LENGTH = 100;

   | { ok: false; errors: MerchantProductFormErrors };

 export function validateMerchantProduct(

 ): ValidationResult {

   const errors: MerchantProductFormErrors = {};

     errors.description = `설명은 ${PRODUCT_DESCRIPTION_MAX_LENGTH}자 이내로 입력해 주세요.`;

   }

   if (badges.length > MAX_PRODUCT_BADGES) {

     errors.badges = `배지는 최대 ${MAX_PRODUCT_BADGES}개까지 고를 수 있습니다.`;

   }

 /**

  * 가맹몰 메뉴 — 백엔드 `TB_COM_VOUCHER_PRODUCT`(`/api/v1/mngr/voc/product`).

  * 기획(BO-MAL-004)은 「메뉴」, 백엔드는 product라 부른다. 코드는 백엔드를 따르고 화면 문구만

   isVisible: boolean;

 };

 /** 기획 BO-MAL-004 ③ [의사결정 필요] 잠정값 — 배지 동시 선택 상한. */

 export const MAX_PRODUCT_BADGES = 2;

 const BADGE_SEPARATOR = ',';

 /**

  */

 export function parseProductBadges(raw: string | null): MerchantProductBadge[] {

   if (!raw) {

   return raw

     .split(BADGE_SEPARATOR)

     .map((token) => token.trim())

 }

 export function joinProductBadges(badges: readonly MerchantProductBadge[]): string {

   return badges.join(BADGE_SEPARATOR);

 }

 }

 export const MERCHANT_PRODUCT_VISIBILITY_OPTIONS = [