import { revalidatePath } from 'next/cache';

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

 import {

   createDecorationItem,

   deleteDecorationItem,

   updateDecorationItem,

   uploadDecorationItemImage,

 } from '@/lib/data/repositories/decoration-item-repository';

 import type { DecorationItemType } from '@/lib/domain/decoration-item';

 import {

   validateDecorationItemCreate,

  * POST될 수 있어 이 확인이 유일한 최종 방어선이다(설계서 §3 SRP 체크).

  *

  * 검증은 화면이 아니라 여기서 확정한다(`lib/domain/decoration-item-form.ts`의 규칙을 호출) —

  *

  * **이미지 업로드도 이 계층을 지난다** — 브라우저는 백엔드를 직접 호출하지 않으므로(토큰이

  * httpOnly 세션 안에만 있다) 폼이 실어 보낸 File을 여기서 받아 Repository를 통해 백엔드에

     readEditableValues(

       formData,

       newFile ? PENDING_UPLOAD_PLACEHOLDER : currentImageFileId

   );

   if (!validation.ok) {

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

     readEditableValues(

       formData,

       newFile ? PENDING_UPLOAD_PLACEHOLDER : currentImageFileId

   );

   if (!validation.ok) {

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

 import { FoxInput } from '@fox/core/components/fox-input';

 import { FoxModal } from '@fox/core/components/fox-modal';

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

 import type { DecorationItemType } from '@/lib/domain/decoration-item';

 import { INITIAL_DECORATION_ITEM_FORM_STATE } from '@/lib/domain/decoration-item-form';

 import { createDecorationItemAction } from '../_actions';

   /** 등록 버튼을 누른 시점의 활성 탭(유형) — 폼의 유형 기본값으로 쓴다. */

   defaultItemType: DecorationItemType;

   typeTotalCount: number;

   onClose: () => void;

 }

 export function DecorationItemCreateModal({

   defaultItemType,

   typeTotalCount,

   onClose,

 }: DecorationItemCreateModalProps) {

   const { showToast } = useFeedback();

         <DecorationItemFormFields

           defaultItemType={defaultItemType}

           typeTotalCount={typeTotalCount}

           errors={errors}

           itemIdField={

             <FoxInput

 import { FoxInput } from '@fox/core/components/fox-input';

 import { FoxModal } from '@fox/core/components/fox-modal';

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

 import type { DecorationItem } from '@/lib/domain/decoration-item';

 import { INITIAL_DECORATION_ITEM_FORM_STATE } from '@/lib/domain/decoration-item-form';

 import { updateDecorationItemAction } from '../_actions';

 interface DecorationItemEditModalProps {

   item: DecorationItem;

   typeTotalCount: number;

   onClose: () => void;

 }

 export function DecorationItemEditModal({

   item,

   typeTotalCount,

   onClose,

 }: DecorationItemEditModalProps) {

   const { showToast } = useFeedback();

           item={item}

           defaultItemType={item.itemType}

           typeTotalCount={typeTotalCount}

           errors={errors}

           itemIdField={

             <FoxInput

 import { FoxTab } from '@fox/core/components/fox-tab';

 import { FoxTabItem } from '@fox/core/components/fox-tab-item';

 import { FoxToggleSwitch } from '@fox/core/components/fox-toggle-switch';

 import {

   DECORATION_ITEM_TYPE_OPTIONS,

   formatDecorationItemActiveLabel,

   type DecorationItem,

   type DecorationItemType,

   defaultItemType: DecorationItemType;

   /** 현재 유형의 전체 등록 건수(검색어 무관) — 정렬순서의 "/ 총 N개"와 기본값에 쓴다. */

   typeTotalCount: number;

   errors: DecorationItemFormErrors;

   /** 아이템ID 줄 — 등록은 자동발급 안내, 수정은 발급된 값이라 팝업마다 달라 밖에서 받는다. */

   itemIdField: ReactNode;

   item,

   defaultItemType,

   typeTotalCount,

   errors,

   itemIdField,

 }: DecorationItemFormFieldsProps) {

   const [itemType, setItemType] = useState<DecorationItemType>(

     item?.itemType ?? defaultItemType

   );

   const [categoryCode, setCategoryCode] = useState(

   );

   const [isActive, setIsActive] = useState(item?.isActive ?? true);

   // 수정 팝업에서 파일을 새로 고르지 않았을 때 유지할 기존 이미지. 썸네일을 지우면 함께 비워

           <FoxSelect

             size="md"

             label="카테고리"

               value: category.code,

               label: category.label,

             }))}

             value={categoryCode}

             onValueChange={setCategoryCode}

             error={Boolean(errors.categoryCode)}

 import { FoxTab } from '@fox/core/components/fox-tab';

 import { FoxTabItem } from '@fox/core/components/fox-tab-item';

 import { FoxPlusIcon } from '@fox/core/icons';

 import {

   DECORATION_ITEM_TYPE_OPTIONS,

   EMPTY_FIELD_PLACEHOLDER,

   totalCount: number;

   /** 현재 유형(개별/셋트)의 검색어 무관 전체 건수 — 등록·수정 팝업의 정렬순서 힌트에 쓴다. */

   typeTotalCount: number;

 }

 /**

   totalPages,

   totalCount,

   typeTotalCount,

 }: DecorationItemListProps) {

   const router = useRouter();

   const [isCreateOpen, setIsCreateOpen] = useState(false);

       header: '관리',

       width: 160,

       render: (row) => (

       ),

     },

   ];

         <DecorationItemCreateModal

           defaultItemType={query.itemType}

           typeTotalCount={typeTotalCount}

           onClose={() => setIsCreateOpen(false)}

         />

       )}

 import { FoxIconButton } from '@fox/core/components/fox-icon-button';

 import { FoxPencilSimpleIcon, FoxTrashIcon } from '@fox/core/icons';

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

 import type { DecorationItem } from '@/lib/domain/decoration-item';

 import { deleteDecorationItemAction } from '../_actions';

 import { DecorationItemEditModal } from './decoration-item-edit-modal';

   item: DecorationItem;

   /** 수정 팝업의 "/ 총 N개" 힌트로 그대로 흘려보낸다(현재 유형 전체 등록 건수). */

   typeTotalCount: number;

 }

 /**

 export function DecorationItemRowActions({

   item,

   typeTotalCount,

 }: DecorationItemRowActionsProps) {

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

   const [isEditOpen, setIsEditOpen] = useState(false);

         <DecorationItemEditModal

           item={item}

           typeTotalCount={typeTotalCount}

           onClose={() => setIsEditOpen(false)}

         />

       )}

 import type { Metadata } from 'next';

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

 import { fetchDecorationItems } from '@/lib/data/repositories/decoration-item-repository';

 import { parseDecorationItemQuery } from '@/lib/domain/decoration-item-query';

 import { DecorationItemList } from './_components/decoration-item-list';

   await verifySession();

   const query = parseDecorationItemQuery(await searchParams);

   // 전체 건수가 확정되지 않았다면(백엔드가 count를 주지 않아 하한값만 아는 상태) 다음 페이지를

   // 한 칸 열어 둔다 — 열어 두지 않으면 가득 찬 페이지 뒤의 데이터에 접근할 방법이 없어진다

       totalPages={totalPages}

       totalCount={totalCount}

       typeTotalCount={typeTotalCount}

     />

   );

 }

  * **이 파일이 검증의 단일 진실원천이다.** Server Action(`_actions.ts`)이 저장 직전에 여기를 거친다.

  */

 import {

   DECORATION_ITEM_TYPE_OPTIONS,

   type DecorationItemType,

 } from '@/lib/domain/decoration-item';

   return DECORATION_ITEM_TYPE_OPTIONS.some((option) => option.value === value);

 }

 /**

  * 등록·수정 공통 검증. 오류는 넘겨받은 객체에 채워 넣고, 정규화된 값을 돌려준다.

  *

  */

 function validateEditableValues(

   values: DecorationItemEditableValues,

   errors: DecorationItemFormErrors

 ): DecorationItemEditableValues {

   const name = values.name.trim();

     errors.name = `아이템명은 ${NAME_MAX_LENGTH}자 이내로 입력해 주세요.`;

   }

     errors.categoryCode = '카테고리를 선택해 주세요.';

   }

   return { ...values, name, description };

 }

 export function validateDecorationItemCreate(

 ): ValidationResult<DecorationItemEditableValues> {

   const errors: DecorationItemFormErrors = {};

   if (Object.keys(errors).length > 0) {

     return { ok: false, errors };

 /** 시안 ADM_ITM_103_p — 수정 검증. 아이템ID는 읽기 전용이라 검증 대상이 아니다. */

 export function validateDecorationItemUpdate(

 ): ValidationResult<DecorationItemEditableValues> {

 }

 export const DEFAULT_DECORATION_ITEM_TYPE: DecorationItemType = 'individual';

 export type DecorationItem = {

   /**

    * 백엔드 `itemSn` — 자동증가 PK이자 화면의 "아이템ID"로 그대로 노출하는 값(사용자 확정 사항).

   itemSn: number;

   itemType: DecorationItemType;

   name: string;

   categoryCode: string;

   categoryName: string | null;

   /** 백엔드 `itemAmount` — 오픈 가능한 포인트. */

   points: number;

 }

 /**

  */

 export function formatDecorationItemCategory(item: DecorationItem): string {

 }

 /** 수정일시 표기 — 백엔드가 이미 `YYYY-MM-DD`로 포맷해 주므로 그대로 쓰고 null만 보완한다. */