File name
Commit message
Commit date
File name
Commit message
Commit date
09-03
File name
Commit message
Commit date
/**
* 꾸미기 아이템 등록/수정 입력 규칙 — 순수 검증 로직만 담는다(외부 의존 없음).
*
* 시안(ADM_ITM_102_p/103_p) 기준 필수 항목: 유형·아이템명·카테고리·포인트·썸네일 이미지.
* 설명은 선택이고, 정렬순서는 별도 필수(*) 표시가 없다 — 다만 화면이 항상 기본값을 채워
* 제출하므로 실질적으로 비는 경우가 없고, 그래도 숫자 형식은 여기서 검증한다(Server Action은
* UI를 거치지 않고 직접 호출될 수 있다 — 화면의 기본값 채움은 편의일 뿐 신뢰 경계가 아니다).
*
* **아이템ID는 입력 항목이 아니다** — 시안이 "등록 후 자동발급됩니다(Read Only)"로 명시하고,
* 백엔드도 `itemSn`을 자동증가로 채운다. 그래서 등록·수정의 검증 대상이 동일하다(예전 mock
* 구현은 사용자가 직접 입력하는 값이었으나 실제 백엔드에는 그런 컬럼이 없다).
*
* **이 파일이 검증의 단일 진실원천이다.** Server Action(`_actions.ts`)이 저장 직전에 여기를 거친다.
*/
import { isKnownCommonCode, type CommonCode } from '@/lib/domain/common-code';
import {
DECORATION_ITEM_TYPE_OPTIONS,
type DecorationItemType,
} from '@/lib/domain/decoration-item';
const NAME_MAX_LENGTH = 100;
const DESCRIPTION_MAX_LENGTH = 500;
/**
* 썸네일 규칙 — **시안 안내문과 검사가 같은 값을 본다.** 화면은 `IMAGE_HELP_TEXT`를 그대로
* 보여주고, Server Action은 업로드 직전에 아래 `validateDecorationItemImage`로 같은 값을 잰다.
*
* 백엔드에도 저장소 설정(`FileStrgStng`)에 확장자·크기 제한이 있지만 그 값은 DB에 있어 코드에서
* 알 수 없고, 걸리면 "이미지를 업로드하지 못했습니다."라는 뭉뚱그린 문구만 남는다. 시안이 이미
* 한도를 못박아 두었으니 화면에서 먼저 잡아 어디가 잘못됐는지 알려 준다.
*/
const IMAGE_MAX_BYTES = 5 * 1024 * 1024;
const IMAGE_ALLOWED_TYPES = ['image/jpeg', 'image/png'];
export const IMAGE_HELP_TEXT =
'JPG, PNG 파일만 가능 (권장 사이즈: 1280x720px, 최대 5MB)';
/** 고른 파일이 규칙에 맞는지. 문제가 있으면 안내 문구, 없으면 null. */
export function validateDecorationItemImage(file: File): string | null {
if (!IMAGE_ALLOWED_TYPES.includes(file.type)) {
return 'JPG 또는 PNG 파일만 등록할 수 있습니다.';
}
if (file.size > IMAGE_MAX_BYTES) {
return `이미지는 ${IMAGE_MAX_BYTES / 1024 / 1024}MB 이하만 등록할 수 있습니다.`;
}
return null;
}
/** 등록·수정 양쪽에서 실제로 바뀔 수 있는 항목(= 백엔드 쓰기 API가 받는 항목). */
export type DecorationItemEditableValues = {
itemType: DecorationItemType;
name: string;
categoryCode: string;
points: number;
description: string;
isActive: boolean;
sortOrder: number;
/**
* 업로드된 이미지의 파일 ID. 등록 시에는 새로 업로드한 값, 수정 시에는 새로 올리지 않았다면
* 기존 값이 그대로 들어온다(화면이 hidden 필드로 유지한다).
*/
imageFileId: string;
};
/** 필드별 오류 메시지 — 키는 폼 필드 이름과 일치시켜 화면이 그대로 붙여 쓸 수 있게 한다. */
export type DecorationItemFormErrors = Partial<
Record<keyof DecorationItemEditableValues, string>
>;
export type ValidationResult<T> =
| { ok: true; values: T }
| { ok: false; errors: DecorationItemFormErrors };
/**
* 등록/수정 Server Action의 `useActionState` 결과 상태. 원래는 `_actions.ts`(`'use server'` 파일)에
* 두려 했지만, Next.js는 **`'use server'` 파일이 async 함수 외의 값을 export하는 것을 런타임에
* 거부한다**("A 'use server' file can only export async functions, found object" —
* `INITIAL_DECORATION_ITEM_FORM_STATE`처럼 일반 객체 상수를 함께 export하면 그 파일의 Server
* Action을 호출하는 즉시 500으로 깨진다. 빌드/타입체크는 통과하고 실제로 폼을 제출해야만
* 드러나는 런타임 전용 제약이라 여기로 옮겼다 — domain 계층은 `'use server'`가 없어 값 export에
* 제약이 없다).
*/
export type DecorationItemFormState =
| { status: 'idle' }
| { status: 'error'; message?: string; errors?: DecorationItemFormErrors }
| { status: 'success' };
export const INITIAL_DECORATION_ITEM_FORM_STATE: DecorationItemFormState = {
status: 'idle',
};
function isDecorationItemType(value: string): value is DecorationItemType {
return DECORATION_ITEM_TYPE_OPTIONS.some((option) => option.value === value);
}
/**
* 등록·수정 공통 검증. 오류는 넘겨받은 객체에 채워 넣고, 정규화된 값을 돌려준다.
*
* `points`/`sortOrder`는 `_actions.ts`가 FormData 문자열을 숫자로 변환해 넘긴다 — 빈 문자열을
* `Number.isInteger`가 걸러낼 수 있도록 그 변환은 `Number('')`가 아니라 명시적으로 실패시키는
* 헬퍼(`_actions.ts`의 `parseFormNumber`)를 거친 값이어야 한다(빈 문자열을 그냥 `Number()`에
* 넘기면 0으로 조용히 통과해 필수 값 누락을 놓친다).
*/
function validateEditableValues(
values: DecorationItemEditableValues,
categories: readonly CommonCode[],
errors: DecorationItemFormErrors
): DecorationItemEditableValues {
const name = values.name.trim();
const description = values.description.trim();
if (!isDecorationItemType(values.itemType)) {
errors.itemType = '유형을 선택해 주세요.';
}
if (!name) {
errors.name = '아이템명을 입력해 주세요.';
} else if (name.length > NAME_MAX_LENGTH) {
errors.name = `아이템명은 ${NAME_MAX_LENGTH}자 이내로 입력해 주세요.`;
}
if (!isKnownCommonCode(categories, values.categoryCode)) {
errors.categoryCode = '카테고리를 선택해 주세요.';
}
if (!Number.isInteger(values.points) || values.points < 0) {
errors.points = '포인트는 0 이상의 숫자로 입력해 주세요.';
}
if (description.length > DESCRIPTION_MAX_LENGTH) {
errors.description = `설명은 ${DESCRIPTION_MAX_LENGTH}자 이내로 입력해 주세요.`;
}
if (!Number.isInteger(values.sortOrder) || values.sortOrder < 1) {
errors.sortOrder = '정렬순서는 1 이상의 숫자로 입력해 주세요.';
}
// 시안이 썸네일 이미지를 필수(*)로 표시한다. 업로드 자체의 실패는 Server Action이 별도
// 메시지로 처리하고, 여기서는 "결과 파일 ID가 없는 상태"만 잡는다.
if (!values.imageFileId.trim()) {
errors.imageFileId = '썸네일 이미지를 등록해 주세요.';
}
return { ...values, name, description };
}
/**
* 시안 ADM_ITM_102_p — 등록 검증.
*
* 허용 카테고리는 상수가 아니라 **인자로 받는다** — 값이 백엔드 공통코드(`ITEM_CATE_CD`)에서
* 오므로 이 파일이 알 수 없고, 알아서도 안 된다(domain 계층은 통신을 하지 않는다).
*/
export function validateDecorationItemCreate(
values: DecorationItemEditableValues,
categories: readonly CommonCode[]
): ValidationResult<DecorationItemEditableValues> {
const errors: DecorationItemFormErrors = {};
const editable = validateEditableValues(values, categories, errors);
if (Object.keys(errors).length > 0) {
return { ok: false, errors };
}
return { ok: true, values: editable };
}
/** 시안 ADM_ITM_103_p — 수정 검증. 아이템ID는 읽기 전용이라 검증 대상이 아니다. */
export function validateDecorationItemUpdate(
values: DecorationItemEditableValues,
categories: readonly CommonCode[]
): ValidationResult<DecorationItemEditableValues> {
return validateDecorationItemCreate(values, categories);
}