File name
Commit message
Commit date
File name
Commit message
Commit date
File name
Commit message
Commit date
/**
* 꾸미기 아이템 등록/수정 입력 규칙 — 순수 검증 로직만 담는다(외부 의존 없음).
*
* 시안(ADM_ITM_102_p/103_p) 기준 필수 항목: 유형·아이템ID(등록 전용)·아이템명·카테고리·포인트.
* 설명은 선택이고, 정렬순서는 시안에 별도 필수(*) 표시가 없다 — 다만 화면이 항상 기본값(현재
* 유형의 총 등록 개수+1, 또는 수정 시 기존 값)을 채워 제출하므로 실질적으로 비어 있는 경우가
* 없고, 그래도 숫자 형식은 여기서 검증한다(Server Action은 UI를 거치지 않고 직접 호출될 수
* 있다 — 화면의 기본값 채움은 편의일 뿐 신뢰 경계가 아니다).
*
* **이 파일이 검증의 단일 진실원천이다.** Server Action(`_actions.ts`)이 저장 직전에 여기를
* 거친다.
*
* 아이템ID는 백엔드 코드 체계가 없어(사용자 확정 — 이 도메인 전체가 mock) 시안 예시
* (`ITEM-HAT-002`)를 참고한 느슨한 형식만 강제한다: 영문/숫자 세그먼트를 하이픈으로 구분.
*
* **등록과 수정의 검증을 분리한 이유**: 수정 팝업에서 아이템ID는 읽기 전용이다(시안
* ADM_ITM_103_p). 수정은 실제로 바뀔 수 있는 항목(유형/아이템명/카테고리/포인트/설명/사용여부/
* 정렬순서)만 검증한다.
*/
import {
DECORATION_ITEM_CATEGORIES,
DECORATION_ITEM_TYPE_OPTIONS,
type DecorationItemCategory,
type DecorationItemType,
} from '@/lib/domain/decoration-item';
export const DECORATION_ITEM_ID_HELP_TEXT =
'영문·숫자와 하이픈(-)으로 입력해 주세요. 예: ITEM-HAT-002';
const ITEM_ID_MIN_LENGTH = 3;
const ITEM_ID_MAX_LENGTH = 50;
const ITEM_ID_PATTERN = /^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$/;
const NAME_MAX_LENGTH = 100;
const DESCRIPTION_MAX_LENGTH = 500;
/** 등록·수정 양쪽에서 실제로 바뀔 수 있는 항목. */
export type DecorationItemEditableValues = {
itemType: DecorationItemType;
name: string;
category: DecorationItemCategory;
points: number;
description: string;
isActive: boolean;
sortOrder: number;
};
/** 등록은 위 항목에 더해 아이템ID를 입력받는다(수정에서는 읽기 전용). */
export type DecorationItemCreateValues = DecorationItemEditableValues & {
itemId: string;
};
/** 필드별 오류 메시지 — 키는 폼 필드 이름과 일치시켜 화면이 그대로 붙여 쓸 수 있게 한다. */
export type DecorationItemFormErrors = Partial<
Record<keyof DecorationItemCreateValues, string>
>;
export type ValidationResult<T> =
| { ok: true; values: T }
| { ok: false; errors: DecorationItemFormErrors };
/**
* 등록/수정 Server Action의 `useActionState` 결과 상태. 원래는 admins처럼 `_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);
}
function isDecorationItemCategory(
value: string
): value is DecorationItemCategory {
return (DECORATION_ITEM_CATEGORIES as readonly string[]).includes(value);
}
/**
* 아이템ID 형식 검증 — 문제가 있으면 안내 문구, 없으면 null. 중복 확인은 여기서 하지 않는다
* (Repository/Server Action의 몫 — `decoration-item-repository.ts` 주석 참조).
*/
export function validateDecorationItemId(itemId: string): string | null {
const value = itemId.trim();
if (!value) {
return '아이템 ID를 입력해 주세요.';
}
if (value.length < ITEM_ID_MIN_LENGTH || value.length > ITEM_ID_MAX_LENGTH) {
return `아이템 ID는 ${ITEM_ID_MIN_LENGTH}~${ITEM_ID_MAX_LENGTH}자로 입력해 주세요.`;
}
if (!ITEM_ID_PATTERN.test(value)) {
return DECORATION_ITEM_ID_HELP_TEXT;
}
return null;
}
/**
* 등록·수정 공통 항목 검증. 오류는 넘겨받은 객체에 채워 넣고, 정규화된 값을 돌려준다.
*
* `points`/`sortOrder`는 `_actions.ts`가 FormData 문자열을 숫자로 변환해 넘긴다 — 빈 문자열을
* `Number.isInteger`가 걸러낼 수 있도록 그 변환은 `Number('')`가 아니라 명시적으로 실패시키는
* 헬퍼(`_actions.ts`의 `parseFormNumber`)를 거친 값이어야 한다(빈 문자열을 그냥 `Number()`에
* 넘기면 0으로 조용히 통과해 필수 값 누락을 놓친다).
*/
function validateEditableValues(
values: DecorationItemEditableValues,
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 (!isDecorationItemCategory(values.category)) {
errors.category = '카테고리를 선택해 주세요.';
}
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 이상의 숫자로 입력해 주세요.';
}
return { ...values, name, description };
}
/** 시안 ADM_ITM_102_p — 등록 검증(아이템ID 포함). */
export function validateDecorationItemCreate(
values: DecorationItemCreateValues
): ValidationResult<DecorationItemCreateValues> {
const errors: DecorationItemFormErrors = {};
const itemIdError = validateDecorationItemId(values.itemId);
if (itemIdError) {
errors.itemId = itemIdError;
}
const editable = validateEditableValues(values, errors);
if (Object.keys(errors).length > 0) {
return { ok: false, errors };
}
return { ok: true, values: { ...editable, itemId: values.itemId.trim() } };
}
/** 시안 ADM_ITM_103_p — 수정 검증. 아이템ID는 읽기 전용이라 검증 대상이 아니다(파일 상단 주석). */
export function validateDecorationItemUpdate(
values: DecorationItemEditableValues
): ValidationResult<DecorationItemEditableValues> {
const errors: DecorationItemFormErrors = {};
const editable = validateEditableValues(values, errors);
if (Object.keys(errors).length > 0) {
return { ok: false, errors };
}
return { ok: true, values: editable };
}