/**
 * 꾸미기 아이템 도메인 타입 — 순수 데이터 표현, 외부 의존 없음.
 *
 * 데이터 출처는 백엔드(edupay-backend)의 `/api/v1/mngr/item/**`(ROLE_ADMIN 전용)이며,
 * `lib/data/repositories/decoration-item-repository.ts`가 응답을 이 타입으로 매핑한다.
 * 백엔드 테이블은 `TB_COM_ITEM`이다.
 */

/**
 * 유형 — 개별아이템 / 셋트아이템. 시안(ADM_ITM_101, ADM_ITM_102_p) 두 곳 모두 "셋트아이템도
 * 동일한 항목으로 처리하며 별도 화면이 없다"고 명시한다 — 목록의 유형 탭과 등록/수정 폼의 값이
 * 모두 이 타입 하나를 공유한다.
 *
 * 값 자체는 화면·URL용 표현이고, 백엔드 코드값(개별 `N` / 셋트 `S`, 사용자 확정 사항)으로의
 * 변환은 Repository가 담당한다 — URL(`?itemType=set`)을 읽을 수 있게 유지하기 위해서다.
 */
export type DecorationItemType = 'individual' | 'set';

export const DECORATION_ITEM_TYPE_OPTIONS: ReadonlyArray<{
  value: DecorationItemType;
  label: string;
}> = [
  { value: 'individual', label: '개별아이템' },
  { value: 'set', label: '셋트아이템' },
];

export const DEFAULT_DECORATION_ITEM_TYPE: DecorationItemType = 'individual';

export type DecorationItem = {
  /**
   * 백엔드 `itemSn` — 자동증가 PK이자 화면의 "아이템ID"로 그대로 노출하는 값(사용자 확정 사항).
   * 시안은 `ITEM-HAT-001` 형식의 자동발급 ID를 그리지만 백엔드에 그런 컬럼이 없다.
   * 목록 행의 key이자 수정/삭제 API의 경로 변수다.
   */
  itemSn: number;
  itemType: DecorationItemType;
  name: string;
  /** 백엔드 `itemCateCd` — 저장·전송에 쓰는 코드값(공통코드 `ITEM_CATE_CD`의 상세코드). */
  categoryCode: string;
  /** 백엔드 `itemCateNm` — 공통코드테이블 조인 결과. 코드가 코드테이블에 없으면 null이다. */
  categoryName: string | null;
  /** 백엔드 `itemAmount` — 오픈 가능한 포인트. */
  points: number;
  /** 백엔드 `itemExplan`. */
  description: string | null;
  /** 백엔드 `useYn`('Y'/'N') — 표에서는 O/X로 표기한다. */
  isActive: boolean;
  /** 백엔드 `sortOrdr` — 목록 기본 정렬 기준(시안 ADM_ITM_101). */
  sortOrder: number;
  /** 백엔드 `atchFileId` — 업로드된 이미지의 파일 ID. 등록하지 않았으면 null. */
  imageFileId: string | null;
  /** 위 파일 ID로 만든 백엔드 이미지 URL(공개 GET). 파일이 없으면 null. */
  imageUrl: string | null;
  /** 백엔드 `lastMdfcnDt` — `YYYY-MM-DD`(백엔드가 이 형식으로 포맷해 내려준다). 미수정이면 null. */
  updatedAt: string | null;
};

/** 값이 없는 항목의 화면 표기. */
export const EMPTY_FIELD_PLACEHOLDER = '-';

/** 사용여부 → 화면 표기(시안 ADM_ITM_101: 점 + "사용"/"미사용"). */
export function formatDecorationItemActiveLabel(isActive: boolean): string {
  return isActive ? '사용' : '미사용';
}

/** 포인트 → 화면 표기(시안: "100 P" 형태). */
export function formatDecorationItemPoints(points: number): string {
  return `${points.toLocaleString('ko-KR')} P`;
}

/**
 * 카테고리 표기 — 목록 SQL이 코드테이블을 조인해 내려 준 이름을 쓴다. 코드가 코드테이블에서
 * 지워졌거나 값 자체가 비었을 때만 코드값·`-`로 떨어진다(이름을 지어내지 않는다).
 */
export function formatDecorationItemCategory(item: DecorationItem): string {
  return item.categoryName || item.categoryCode || EMPTY_FIELD_PLACEHOLDER;
}

/** 수정일시 표기 — 백엔드가 이미 `YYYY-MM-DD`로 포맷해 주므로 그대로 쓰고 null만 보완한다. */
export function formatDecorationItemUpdatedAt(
  updatedAt: string | null
): string {
  return updatedAt ?? EMPTY_FIELD_PLACEHOLDER;
}