Commit @3902bd06ddaa3537bec0c1250f5cf2d6029eaa6b

9194d07

3902bd0

app/(protected)/(basic)/contents/_actions.ts

--- app/(protected)/(basic)/contents/_actions.ts

+++ app/(protected)/(basic)/contents/_actions.ts


 import { revalidatePath } from 'next/cache';
 import { redirect } from 'next/navigation';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { uploadAttachment } from '@/lib/data/repositories/file-repository';
 import {
   buildComicPayload,

   }
 
   const validation = validateShortsForm({
-    schoolLevel: readString(formData, 'schoolLevel'),
+    schoolCode: readString(formData, 'schoolCode'),
     grades: readGrades(formData),
     title: readString(formData, 'title'),
     subject: readString(formData, 'subject'),

     videoFileId: readString(formData, 'videoFileId'),
     thumbnailFileId: readString(formData, 'thumbnailFileId'),
     isVisible: readString(formData, 'isVisible') === 'true',
-  });
+  }, await fetchSchoolGradeCodes());
   if (!validation.ok) {
     return { status: 'error', errors: validation.errors };
   }

   }
 
   const validation = validateShortsForm({
-    schoolLevel: readString(formData, 'schoolLevel'),
+    schoolCode: readString(formData, 'schoolCode'),
     grades: readGrades(formData),
     title: readString(formData, 'title'),
     subject: readString(formData, 'subject'),

     videoFileId: readString(formData, 'videoFileId'),
     thumbnailFileId: readString(formData, 'thumbnailFileId'),
     isVisible: readString(formData, 'isVisible') === 'true',
-  });
+  }, await fetchSchoolGradeCodes());
   if (!cntntsSn) {
     return { status: 'error', message: '요청이 올바르지 않습니다.' };
   }

   }
 
   const validation = validateComicForm({
-    schoolLevel: readString(formData, 'schoolLevel'),
+    schoolCode: readString(formData, 'schoolCode'),
     grades: readGrades(formData),
     name: readString(formData, 'name'),
     subject: readString(formData, 'subject'),

     thumbnailFileId,
     cutFileIds,
     isVisible: readString(formData, 'isVisible') === 'true',
-  });
+  }, await fetchSchoolGradeCodes());
   if (!validation.ok) {
     return { status: 'error', errors: validation.errors };
   }

   }
 
   const validation = validateComicForm({
-    schoolLevel: readString(formData, 'schoolLevel'),
+    schoolCode: readString(formData, 'schoolCode'),
     grades: readGrades(formData),
     name: readString(formData, 'name'),
     subject: readString(formData, 'subject'),

     thumbnailFileId,
     cutFileIds,
     isVisible: readString(formData, 'isVisible') === 'true',
-  });
+  }, await fetchSchoolGradeCodes());
   if (!validation.ok) {
     return { status: 'error', errors: validation.errors };
   }

 
 function readQuizValues(formData: FormData) {
   return {
-    schoolLevel: readString(formData, 'schoolLevel'),
+    schoolCode: readString(formData, 'schoolCode'),
     grades: readGrades(formData),
     level: readString(formData, 'level'),
     keywords: readKeywords(formData),

 ): Promise<ContentFormState> {
   await verifySession();
 
-  const validation = validateQuizForm(readQuizValues(formData));
+  const validation = validateQuizForm(readQuizValues(formData), await fetchSchoolGradeCodes());
   if (!validation.ok) {
     return { status: 'error', errors: validation.errors };
   }

     return { status: 'error', message: '요청이 올바르지 않습니다.' };
   }
 
-  const validation = validateQuizForm(readQuizValues(formData));
+  const validation = validateQuizForm(readQuizValues(formData), await fetchSchoolGradeCodes());
   if (!validation.ok) {
     return { status: 'error', errors: validation.errors };
   }

9194d07

3902bd0

app/(protected)/(basic)/contents/_components/content-grade-field.tsx

--- app/(protected)/(basic)/contents/_components/content-grade-field.tsx

+++ app/(protected)/(basic)/contents/_components/content-grade-field.tsx


 import { FoxChipArea } from '@fox/core/components/fox-chip-area';
 import { FoxHelperText } from '@fox/core/components/fox-helper-text';
 import { FoxSelect } from '@fox/core/components/fox-select';
-import {
-  DEFAULT_SCHOOL_LEVEL,
-  SCHOOL_LEVEL_OPTIONS,
-  findSchoolLevel,
-  gradeOptionsOf,
-} from '@/lib/domain/content';
+import { gradesOf, type GradesBySchool } from '@/lib/domain/content';
+import type { CommonCode } from '@/lib/domain/common-code';
 import styles from './content-form.module.scss';
 
 interface ContentGradeFieldProps {
-  defaultSchoolLevel?: string;
+  /** 공통코드 `COM_SCHUL_CD`. */
+  schools: readonly CommonCode[];
+  /** 학교 코드 → 그 학교의 `GRD_CD` 목록. */
+  gradesBySchool: GradesBySchool;
+  defaultSchoolCode?: string;
   defaultGrades?: readonly string[];
-  schoolLevelError?: string;
+  schoolError?: string;
   gradesError?: string;
 }
 
 /**
- * 학년선택 — 학교급을 고르면 그 학교급의 학년 칩이 열리고 여러 개를 고를 수 있다.
- * 전체연령은 학년이 없어 칩을 그리지 않는다(기획 "전체 연령 선택 시 학년 선택 비활성").
+ * 학년선택 — 학교를 고르면 그 학교의 학년 코드만 칩으로 열린다.
+ * 학년이 없는 학교(전체연령 등)는 코드 목록이 비어 있어 칩을 그리지 않는다.
  */
 export function ContentGradeField({
-  defaultSchoolLevel,
+  schools,
+  gradesBySchool,
+  defaultSchoolCode,
   defaultGrades = [],
-  schoolLevelError,
+  schoolError,
   gradesError,
 }: ContentGradeFieldProps) {
-  const [schoolLevel, setSchoolLevel] = useState(
-    defaultSchoolLevel || DEFAULT_SCHOOL_LEVEL
+  const [schoolCode, setSchoolCode] = useState(
+    defaultSchoolCode || schools[0]?.code || ''
   );
   const [grades, setGrades] = useState<string[]>([...defaultGrades]);
 
-  const gradeOptions = gradeOptionsOf(schoolLevel);
-  const hasGrades = (findSchoolLevel(schoolLevel)?.gradeCount ?? 0) > 0;
+  const gradeCodes = gradesOf(gradesBySchool, schoolCode);
 
-  function changeSchoolLevel(next: string) {
-    setSchoolLevel(next);
-    // 학교급이 바뀌면 이전 학교급의 학년은 남길 수 없다(초 4학년 → 중학교).
+  function changeSchool(next: string) {
+    setSchoolCode(next);
+    // 학교가 바뀌면 이전 학교의 학년 코드는 남길 수 없다.
     setGrades([]);
   }
 
-  function toggleGrade(grade: string) {
+  function toggleGrade(code: string) {
     setGrades((current) =>
-      current.includes(grade)
-        ? current.filter((value) => value !== grade)
-        : [...current, grade].sort()
+      current.includes(code)
+        ? current.filter((value) => value !== code)
+        : [...current, code]
     );
   }
 

       <div className={styles.inline}>
         <FoxSelect
           size="md"
-          options={SCHOOL_LEVEL_OPTIONS.map((option) => ({
-            value: option.value,
-            label: option.label,
+          options={schools.map((school) => ({
+            value: school.code,
+            label: school.label,
           }))}
-          value={schoolLevel}
-          onValueChange={changeSchoolLevel}
-          error={Boolean(schoolLevelError)}
+          placeholder="학교를 선택하세요."
+          value={schoolCode}
+          onValueChange={changeSchool}
+          error={Boolean(schoolError)}
         />
-        {hasGrades && (
+        {gradeCodes.length > 0 && (
           <FoxChipArea size="md" label="학년" wrap>
-            {gradeOptions.map((grade) => (
+            {gradeCodes.map((grade) => (
               <FoxChip
-                key={grade}
+                key={grade.code}
                 type="check"
-                label={`${grade}학년`}
-                checked={grades.includes(grade)}
-                onCheckedChange={() => toggleGrade(grade)}
+                label={grade.label}
+                checked={grades.includes(grade.code)}
+                onCheckedChange={() => toggleGrade(grade.code)}
               />
             ))}
           </FoxChipArea>
         )}
       </div>
 
-      <input type="hidden" name="schoolLevel" value={schoolLevel} />
+      <input type="hidden" name="schoolCode" value={schoolCode} />
       <input type="hidden" name="grades" value={grades.join(',')} />
 
-      {(schoolLevelError || gradesError) && (
-        <FoxHelperText
-          type="danger"
-          message={schoolLevelError ?? gradesError ?? ''}
-        />
+      {(schoolError || gradesError) && (
+        <FoxHelperText type="danger" message={schoolError ?? gradesError ?? ''} />
       )}
     </div>
   );

9194d07

3902bd0

app/(protected)/(basic)/contents/_components/content-list-filters.tsx

--- app/(protected)/(basic)/contents/_components/content-list-filters.tsx

+++ app/(protected)/(basic)/contents/_components/content-list-filters.tsx


 import { FoxChipArea } from '@fox/core/components/fox-chip-area';
 import {
   QUIZ_LEVEL_OPTIONS,
-  SCHOOL_LEVEL_OPTIONS,
-  gradeOptionsOf,
+  gradesOf,
+  type GradesBySchool,
 } from '@/lib/domain/content';
+import type { CommonCode } from '@/lib/domain/common-code';
 import type { ContentQuery } from '@/lib/domain/content-query';
 
 const ALL = '';
 
 // 칩은 고른 옵션의 라벨을 칩 글자 자리에 보여 준다 — 「전체」만 적으면 어떤 필터인지 사라져서
 // 선택지 이름에 필터 이름을 붙인다.
-
 interface ContentListFiltersProps {
   query: ContentQuery;
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
   /** 난이도 칩은 금융OX퀴즈에만 있다. */
   withLevel?: boolean;
   onChange: (patch: Partial<ContentQuery>) => void;
 }
 
-/** 목록 상단 필터 — 기획의 「학교급 / 학년 / 난이도」 셀렉트. */
+/** 목록 상단 필터 — 기획의 「학교급 / 학년 / 난이도」 셀렉트. 학교·학년은 공통코드다. */
 export function ContentListFilters({
   query,
+  schools,
+  gradesBySchool,
   withLevel = false,
   onChange,
 }: ContentListFiltersProps) {
-  const gradeOptions = gradeOptionsOf(query.schoolLevel);
+  const gradeCodes = gradesOf(gradesBySchool, query.school);
 
   return (
     <FoxChipArea size="md" label="목록 필터" wrap>
       <FoxChip
         type="select"
-        label="학교급"
+        label="학교"
         options={[
-          { value: ALL, label: '학교급 전체' },
-          ...SCHOOL_LEVEL_OPTIONS.map((option) => ({
-            value: option.value,
-            label: option.label,
+          { value: ALL, label: '학교 전체' },
+          ...schools.map((school) => ({
+            value: school.code,
+            label: school.label,
           })),
         ]}
-        value={query.schoolLevel}
+        value={query.school}
         onValueChange={(value) =>
-          onChange({ schoolLevel: value, grade: ALL, page: 1 })
+          onChange({ school: value, grade: ALL, page: 1 })
         }
       />
       <FoxChip
         type="select"
         label="학년"
-        disabled={gradeOptions.length === 0}
+        disabled={gradeCodes.length === 0}
         options={[
           { value: ALL, label: '학년 전체' },
-          ...gradeOptions.map((grade) => ({
-            value: grade,
-            label: `${grade}학년`,
+          ...gradeCodes.map((grade) => ({
+            value: grade.code,
+            label: grade.label,
           })),
         ]}
         value={query.grade}

9194d07

3902bd0

app/(protected)/(basic)/contents/_components/content-list-shell.tsx

--- app/(protected)/(basic)/contents/_components/content-list-shell.tsx

+++ app/(protected)/(basic)/contents/_components/content-list-shell.tsx


   type ContentSortOption,
 } from '@/lib/domain/content-query';
 import { ContentListFilters } from './content-list-filters';
+import type { CommonCode } from '@/lib/domain/common-code';
+import type { GradesBySchool } from '@/lib/domain/content';
 
 interface ContentListShellProps<T> {
   kind: ContentKind;

   currentPage: number;
   totalPages: number;
   totalCount: number;
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
   /** 툴바 오른쪽에 덧붙일 것(금융OX퀴즈의 엑셀 버튼). */
   extraActions?: ReactNode;
 }

   currentPage,
   totalPages,
   totalCount,
+  schools,
+  gradesBySchool,
   extraActions,
 }: ContentListShellProps<T>) {
   const router = useRouter();

       filter={
         <ContentListFilters
           query={query}
+          schools={schools}
+          gradesBySchool={gradesBySchool}
           withLevel={kind === 'quiz'}
           onChange={go}
         />

9194d07

3902bd0

app/(protected)/(basic)/contents/comics/[cntntsSn]/page.tsx

--- app/(protected)/(basic)/contents/comics/[cntntsSn]/page.tsx

+++ app/(protected)/(basic)/contents/comics/[cntntsSn]/page.tsx


 import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import {
   contentCutUrls,
   contentThumbnailUrl,

 export default async function Page({ params }: PageProps) {
   await verifySession();
 
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
+
   const { cntntsSn } = await params;
   const item = await fetchContentDetail('comic', cntntsSn);
   if (!item) {

 
   return (
     <ComicForm
+      schools={schools}
+      gradesBySchool={gradesBySchool}
       item={item}
       thumbnailUrl={contentThumbnailUrl(item)}
       cutUrls={contentCutUrls(item, MIN_COMIC_CUTS)}

9194d07

3902bd0

app/(protected)/(basic)/contents/comics/_components/comic-form.tsx

--- app/(protected)/(basic)/contents/comics/_components/comic-form.tsx

+++ app/(protected)/(basic)/contents/comics/_components/comic-form.tsx


 import { FoxPageHeader } from '@fox/core/components/fox-page-header';
 import { FoxTextArea } from '@fox/core/components/fox-text-area';
 import { submitFormAction } from '@/app/_hooks/submit-form-action';
-import { THUMBNAIL_HELP_TEXT, type ContentItem } from '@/lib/domain/content';
+import {
+  THUMBNAIL_HELP_TEXT,
+  type ContentItem,
+  type GradesBySchool,
+} from '@/lib/domain/content';
 import {
   INITIAL_CONTENT_FORM_STATE,
   MESSAGE_MAX_LENGTH,

   TITLE_MAX_LENGTH,
 } from '@/lib/domain/content-form';
 import { contentBreadcrumb, contentListPath } from '@/lib/domain/content-query';
+import type { CommonCode } from '@/lib/domain/common-code';
 import { FILE_MODULE, fileModuleAccept } from '@/lib/domain/file-module';
 import { createComicAction, updateComicAction } from '../../_actions';
 import { ContentCutsField } from '../../_components/content-cuts-field';

 import styles from '../../_components/content-form.module.scss';
 
 interface ComicFormProps {
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
   item?: ContentItem;
   thumbnailUrl?: string | null;
   cutUrls?: string[];
 }
 
 /** 콘텐츠 등록·수정 (4컷금융만화) — 시안 5449:10850. */
-export function ComicForm({ item, thumbnailUrl, cutUrls = [] }: ComicFormProps) {
+export function ComicForm({
+  schools,
+  gradesBySchool,
+  item,
+  thumbnailUrl,
+  cutUrls = [],
+}: ComicFormProps) {
   const isEdit = item !== undefined;
   const [state, formAction, isPending] = useActionState(
     isEdit ? updateComicAction : createComicAction,

 
         <ContentFormRow label="학년선택" required>
           <ContentGradeField
-            defaultSchoolLevel={item?.schoolLevel}
+            schools={schools}
+            gradesBySchool={gradesBySchool}
+            defaultSchoolCode={item?.schoolCode}
             defaultGrades={item?.grades}
-            schoolLevelError={errors.schoolLevel}
+            schoolError={errors.schoolCode}
             gradesError={errors.grades}
           />
         </ContentFormRow>

9194d07

3902bd0

app/(protected)/(basic)/contents/comics/_components/comics-list.tsx

--- app/(protected)/(basic)/contents/comics/_components/comics-list.tsx

+++ app/(protected)/(basic)/contents/comics/_components/comics-list.tsx


   formatContentText,
   formatGradesLabel,
   formatKeywordsLabel,
-  formatSchoolLevelLabel,
+  formatSchoolLabel,
   formatVisibilityLabel,
   type ContentItem,
+  type GradesBySchool,
 } from '@/lib/domain/content';
+import type { CommonCode } from '@/lib/domain/common-code';
 import type { ContentQuery } from '@/lib/domain/content-query';
 import { ContentListShell } from '../../_components/content-list-shell';
 import { ContentRowActions } from '../../_components/content-row-actions';

   currentPage: number;
   totalPages: number;
   totalCount: number;
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
 }
 
 export function ComicsList({

   currentPage,
   totalPages,
   totalCount,
+  schools,
+  gradesBySchool,
 }: ComicsListProps) {
   const columns: FoxListColumn<ContentItem>[] = [
     {

       render: (_row, index) => (currentPage - 1) * query.pageSize + index + 1,
     },
     {
-      key: 'schoolLevel',
-      header: '학교급',
+      key: 'school',
+      header: '학교',
       width: 120,
-      render: (row) => formatSchoolLevelLabel(row.schoolLevel),
+      render: (row) => formatSchoolLabel(row.schoolCode, schools),
     },
     {
       key: 'grades',
       header: '학년',
       width: 100,
-      render: (row) => formatGradesLabel(row.grades),
+      render: (row) =>
+        formatGradesLabel(row.grades, gradesBySchool[row.schoolCode] ?? []),
     },
     {
       key: 'name',

       currentPage={currentPage}
       totalPages={totalPages}
       totalCount={totalCount}
+      schools={schools}
+      gradesBySchool={gradesBySchool}
     />
   );
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/comics/new/page.tsx

--- app/(protected)/(basic)/contents/comics/new/page.tsx

+++ app/(protected)/(basic)/contents/comics/new/page.tsx


 import type { Metadata } from 'next';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { ComicForm } from '../_components/comic-form';
 
 export const metadata: Metadata = { title: '콘텐츠 등록 (4컷금융만화)' };

 
 export default async function Page() {
   await verifySession();
-  return <ComicForm />;
+
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
+  return <ComicForm schools={schools} gradesBySchool={gradesBySchool} />;
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/comics/page.tsx

--- app/(protected)/(basic)/contents/comics/page.tsx

+++ app/(protected)/(basic)/contents/comics/page.tsx


 import type { Metadata } from 'next';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { fetchContents } from '@/lib/data/repositories/content-repository';
 import { parseContentQuery } from '@/lib/domain/content-query';
 import { ComicsList } from './_components/comics-list';

 
 export default async function Page({ searchParams }: PageProps) {
   await verifySession();
+
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
 
   const query = parseContentQuery('comic', await searchParams);
   const { items, totalCount, isTotalCountExact } = await fetchContents('comic', query);

       currentPage={currentPage}
       totalPages={totalPages}
       totalCount={totalCount}
+      schools={schools}
+      gradesBySchool={gradesBySchool}
     />
   );
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/quizzes/[quizSn]/page.tsx

--- app/(protected)/(basic)/contents/quizzes/[quizSn]/page.tsx

+++ app/(protected)/(basic)/contents/quizzes/[quizSn]/page.tsx


 import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { fetchQuizDetail } from '@/lib/data/repositories/content-quiz-repository';
 import { QuizForm } from '../_components/quiz-form';
 

 export default async function Page({ params }: PageProps) {
   await verifySession();
 
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
+
   const { quizSn } = await params;
   const item = await fetchQuizDetail(quizSn);
   if (!item) {
     notFound();
   }
 
-  return <QuizForm item={item} />;
+  return <QuizForm schools={schools} gradesBySchool={gradesBySchool} item={item} />;
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/quizzes/_components/quiz-form.tsx

--- app/(protected)/(basic)/contents/quizzes/_components/quiz-form.tsx

+++ app/(protected)/(basic)/contents/quizzes/_components/quiz-form.tsx


   QUIZ_ANSWER_OPTIONS,
   QUIZ_LEVEL_OPTIONS,
   type QuizItem,
+  type GradesBySchool,
 } from '@/lib/domain/content';
 import {
   ANSWER_MESSAGE_MAX_LENGTH,

   QUESTION_MAX_LENGTH,
 } from '@/lib/domain/content-form';
 import { contentBreadcrumb, contentListPath } from '@/lib/domain/content-query';
+import type { CommonCode } from '@/lib/domain/common-code';
 import { createQuizAction, updateQuizAction } from '../../_actions';
 import { ContentFormActions } from '../../_components/content-form-actions';
 import { ContentFormRow } from '../../_components/content-form-row';

 import styles from '../../_components/content-form.module.scss';
 
 interface QuizFormProps {
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
   item?: QuizItem;
 }
 

  * 정답여부는 O·X 두 줄이고, 고른 쪽에서만 「사용자에게 노출할 문구」를 정한다(기획 ③).
  * 「기타」를 고르면 문구를 직접 적는다.
  */
-export function QuizForm({ item }: QuizFormProps) {
+export function QuizForm({ schools, gradesBySchool, item }: QuizFormProps) {
   const isEdit = item !== undefined;
   const [state, formAction, isPending] = useActionState(
     isEdit ? updateQuizAction : createQuizAction,

 
         <ContentFormRow label="학년선택" required>
           <ContentGradeField
-            schoolLevelError={errors.schoolLevel}
+            schools={schools}
+            gradesBySchool={gradesBySchool}
+            schoolError={errors.schoolCode}
             gradesError={errors.grades}
           />
         </ContentFormRow>

9194d07

3902bd0

app/(protected)/(basic)/contents/quizzes/_components/quizzes-list.tsx

--- app/(protected)/(basic)/contents/quizzes/_components/quizzes-list.tsx

+++ app/(protected)/(basic)/contents/quizzes/_components/quizzes-list.tsx


   formatContentText,
   formatQuizLevelLabel,
   formatVisibilityLabel,
+  type GradesBySchool,
   type QuizItem,
 } from '@/lib/domain/content';
+import type { CommonCode } from '@/lib/domain/common-code';
 import type { ContentQuery } from '@/lib/domain/content-query';
 import { ContentListShell } from '../../_components/content-list-shell';
 import { ContentRowActions } from '../../_components/content-row-actions';

   currentPage: number;
   totalPages: number;
   totalCount: number;
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
 }
 
 export function QuizzesList({

   currentPage,
   totalPages,
   totalCount,
+  schools,
+  gradesBySchool,
 }: QuizzesListProps) {
   const columns: FoxListColumn<QuizItem>[] = [
     {

       currentPage={currentPage}
       totalPages={totalPages}
       totalCount={totalCount}
+      schools={schools}
+      gradesBySchool={gradesBySchool}
       extraActions={<QuizExcelActions />}
     />
   );

9194d07

3902bd0

app/(protected)/(basic)/contents/quizzes/new/page.tsx

--- app/(protected)/(basic)/contents/quizzes/new/page.tsx

+++ app/(protected)/(basic)/contents/quizzes/new/page.tsx


 import type { Metadata } from 'next';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { QuizForm } from '../_components/quiz-form';
 
 export const metadata: Metadata = { title: '콘텐츠 등록 (금융OX퀴즈)' };

 
 export default async function Page() {
   await verifySession();
-  return <QuizForm />;
+
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
+  return <QuizForm schools={schools} gradesBySchool={gradesBySchool} />;
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/quizzes/page.tsx

--- app/(protected)/(basic)/contents/quizzes/page.tsx

+++ app/(protected)/(basic)/contents/quizzes/page.tsx


 import type { Metadata } from 'next';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { fetchQuizzes } from '@/lib/data/repositories/content-quiz-repository';
 import { parseContentQuery } from '@/lib/domain/content-query';
 import { QuizzesList } from './_components/quizzes-list';

 
 export default async function Page({ searchParams }: PageProps) {
   await verifySession();
+
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
 
   const query = parseContentQuery('quiz', await searchParams);
   const { items, totalCount, isTotalCountExact } = await fetchQuizzes(query);

       currentPage={currentPage}
       totalPages={totalPages}
       totalCount={totalCount}
+      schools={schools}
+      gradesBySchool={gradesBySchool}
     />
   );
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/shorts/[cntntsSn]/page.tsx

--- app/(protected)/(basic)/contents/shorts/[cntntsSn]/page.tsx

+++ app/(protected)/(basic)/contents/shorts/[cntntsSn]/page.tsx


 import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import {
   contentThumbnailUrl,
   fetchContentDetail,

 export default async function Page({ params }: PageProps) {
   await verifySession();
 
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
+
   const { cntntsSn } = await params;
   const item = await fetchContentDetail('shorts', cntntsSn);
   if (!item) {
     notFound();
   }
 
-  return <ShortsForm item={item} thumbnailUrl={contentThumbnailUrl(item)} />;
+  return (
+    <ShortsForm
+      schools={schools}
+      gradesBySchool={gradesBySchool}
+      item={item}
+      thumbnailUrl={contentThumbnailUrl(item)}
+    />
+  );
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/shorts/_components/shorts-form.tsx

--- app/(protected)/(basic)/contents/shorts/_components/shorts-form.tsx

+++ app/(protected)/(basic)/contents/shorts/_components/shorts-form.tsx


 import {
   THUMBNAIL_HELP_TEXT,
   type ContentItem,
+  type GradesBySchool,
 } from '@/lib/domain/content';
 import {
   INITIAL_CONTENT_FORM_STATE,

   TITLE_MAX_LENGTH,
 } from '@/lib/domain/content-form';
 import { contentBreadcrumb, contentListPath } from '@/lib/domain/content-query';
+import type { CommonCode } from '@/lib/domain/common-code';
 import { FILE_MODULE, fileModuleAccept } from '@/lib/domain/file-module';
 import { createShortsAction, updateShortsAction } from '../../_actions';
 import { ContentFormActions } from '../../_components/content-form-actions';

 import styles from '../../_components/content-form.module.scss';
 
 interface ShortsFormProps {
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
   /** 수정 화면에서만 넘어온다. 없으면 등록이다. */
   item?: ContentItem;
   thumbnailUrl?: string | null;
 }
 
 /** 콘텐츠 등록·수정 (금융쇼츠) — 시안 5402:10628. */
-export function ShortsForm({ item, thumbnailUrl }: ShortsFormProps) {
+export function ShortsForm({
+  schools,
+  gradesBySchool,
+  item,
+  thumbnailUrl,
+}: ShortsFormProps) {
   const isEdit = item !== undefined;
   const [state, formAction, isPending] = useActionState(
     isEdit ? updateShortsAction : createShortsAction,

 
         <ContentFormRow label="학년선택" required>
           <ContentGradeField
-            defaultSchoolLevel={item?.schoolLevel}
+            schools={schools}
+            gradesBySchool={gradesBySchool}
+            defaultSchoolCode={item?.schoolCode}
             defaultGrades={item?.grades}
-            schoolLevelError={errors.schoolLevel}
+            schoolError={errors.schoolCode}
             gradesError={errors.grades}
           />
         </ContentFormRow>

9194d07

3902bd0

app/(protected)/(basic)/contents/shorts/_components/shorts-list.tsx

--- app/(protected)/(basic)/contents/shorts/_components/shorts-list.tsx

+++ app/(protected)/(basic)/contents/shorts/_components/shorts-list.tsx


   formatContentText,
   formatGradesLabel,
   formatKeywordsLabel,
-  formatSchoolLevelLabel,
+  formatSchoolLabel,
   formatVisibilityLabel,
   type ContentItem,
+  type GradesBySchool,
 } from '@/lib/domain/content';
+import type { CommonCode } from '@/lib/domain/common-code';
 import type { ContentQuery } from '@/lib/domain/content-query';
 import { ContentListShell } from '../../_components/content-list-shell';
 import { ContentRowActions } from '../../_components/content-row-actions';

   currentPage: number;
   totalPages: number;
   totalCount: number;
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
 }
 
 export function ShortsList({

   currentPage,
   totalPages,
   totalCount,
+  schools,
+  gradesBySchool,
 }: ShortsListProps) {
   const columns: FoxListColumn<ContentItem>[] = [
     {

       render: (_row, index) => (currentPage - 1) * query.pageSize + index + 1,
     },
     {
-      key: 'schoolLevel',
-      header: '학교급',
+      key: 'school',
+      header: '학교',
       width: 120,
-      render: (row) => formatSchoolLevelLabel(row.schoolLevel),
+      render: (row) => formatSchoolLabel(row.schoolCode, schools),
     },
     {
       key: 'grades',
       header: '학년',
       width: 100,
-      render: (row) => formatGradesLabel(row.grades),
+      render: (row) =>
+        formatGradesLabel(row.grades, gradesBySchool[row.schoolCode] ?? []),
     },
     {
       key: 'title',

       currentPage={currentPage}
       totalPages={totalPages}
       totalCount={totalCount}
+      schools={schools}
+      gradesBySchool={gradesBySchool}
     />
   );
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/shorts/new/page.tsx

--- app/(protected)/(basic)/contents/shorts/new/page.tsx

+++ app/(protected)/(basic)/contents/shorts/new/page.tsx


 import type { Metadata } from 'next';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { ShortsForm } from '../_components/shorts-form';
 
 export const metadata: Metadata = { title: '콘텐츠 등록 (금융쇼츠)' };

 
 export default async function Page() {
   await verifySession();
-  return <ShortsForm />;
+
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
+  return <ShortsForm schools={schools} gradesBySchool={gradesBySchool} />;
 }

9194d07

3902bd0

app/(protected)/(basic)/contents/shorts/page.tsx

--- app/(protected)/(basic)/contents/shorts/page.tsx

+++ app/(protected)/(basic)/contents/shorts/page.tsx


 import type { Metadata } from 'next';
 import { verifySession } from '@/lib/auth/dal';
+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
 import { fetchContents } from '@/lib/data/repositories/content-repository';
 import { parseContentQuery } from '@/lib/domain/content-query';
 import { ShortsList } from './_components/shorts-list';

 
 export default async function Page({ searchParams }: PageProps) {
   await verifySession();
+
+  const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
 
   const query = parseContentQuery('shorts', await searchParams);
   const { items, totalCount, isTotalCountExact } = await fetchContents('shorts', query);

       currentPage={currentPage}
       totalPages={totalPages}
       totalCount={totalCount}
+      schools={schools}
+      gradesBySchool={gradesBySchool}
     />
   );
 }

9194d07

3902bd0

lib/data/repositories/common-code-repository.ts

--- lib/data/repositories/common-code-repository.ts

+++ lib/data/repositories/common-code-repository.ts


 import { cache } from 'react';
 import { getSessionAccessToken } from '@/lib/auth/dal';
 import { BackendRequestError, backendFetch } from '@/lib/http/backend-fetch';
-import type {
-  CommonCode,
-  CommonCodeDetail,
-  CommonCodeGroup,
+import {
+  CODE_GROUP,
+  type CommonCode,
+  type CommonCodeDetail,
+  type CommonCodeGroup,
 } from '@/lib/domain/common-code';
 import type {
   CommonCodeDetailValues,

   return rows.flatMap(toGroup);
 });
 
-/** 한 그룹의 상세코드 전체. */
+/**
+ * 한 그룹의 상세코드 전체.
+ *
+ * `atrbNm`을 주면 백엔드가 `ATRB_NM1 = #{atrbNm}`으로 걸러 준다 — 학년(`GRD_CD`)처럼 상위
+ * 코드에 딸린 목록을 뽑을 때 쓴다(학교 코드를 넣으면 그 학교의 학년만 온다).
+ */
 export const fetchCodeDetails = cache(async function fetchCodeDetails(
-  comCd: string
+  comCd: string,
+  atrbNm?: string
 ): Promise<CommonCodeDetail[]> {
+  const query = atrbNm ? `?atrbNm=${encodeURIComponent(atrbNm)}` : '';
   const rows = await requestList(
-    `${CODE_PATH}/list/${encodeURIComponent(comCd)}`
+    `${CODE_PATH}/list/${encodeURIComponent(comCd)}${query}`
   );
   return rows.flatMap(toDetail);
 });

  * 다른 화면이 선택지로 쓰는 최소 표현. 상세코드 조회를 그대로 쓰되 화면이 알 필요 없는 것을
  * 덜어 낸다 — 같은 `cache()`를 타므로 한 요청 안에서 왕복이 늘지 않는다.
  */
-export async function fetchCommonCodes(groupCode: string): Promise<CommonCode[]> {
-  const details = await fetchCodeDetails(groupCode);
+export async function fetchCommonCodes(
+  groupCode: string,
+  atrbNm?: string
+): Promise<CommonCode[]> {
+  const details = await fetchCodeDetails(groupCode, atrbNm);
   return details.map((detail) => ({ code: detail.comDtlCd, label: detail.name }));
 }
 
+export type SchoolGradeCodes = {
+  /** `COM_SCHUL_CD` — 학교 선택지. */
+  schools: CommonCode[];
+  /** 학교 코드 → 그 학교의 `GRD_CD` 목록. 학년이 없는 학교는 빈 배열이다. */
+  gradesBySchool: Record<string, CommonCode[]>;
+};
+
+/**
+ * 학교와 학교별 학년을 함께 가져온다.
+ *
+ * 학년 조회에 학교 코드가 필요해 학교 수만큼 왕복한다 — 상세 목록 SQL이 `ATRB_NM1`을 select하지
+ * 않아 한 번에 받아 화면에서 가르는 방법이 없다. 학교는 몇 개뿐이고 `cache()`가 한 요청 안의
+ * 중복 호출을 막는다.
+ */
+export async function fetchSchoolGradeCodes(): Promise<SchoolGradeCodes> {
+  const schools = await fetchCommonCodes(CODE_GROUP.school);
+
+  const grades = await Promise.all(
+    schools.map((school) => fetchCommonCodes(CODE_GROUP.grade, school.code))
+  );
+
+  return {
+    schools,
+    gradesBySchool: Object.fromEntries(
+      schools.map((school, index) => [school.code, grades[index]])
+    ),
+  };
+}
+
 /*
  * ─── 쓰기 경로 ────────────────────────────────────────────────────────────────
  * 상세 등록만 form이고 나머지는 JSON이다(파일 상단 주석 참조).

9194d07

3902bd0

lib/data/repositories/content-quiz-repository.ts

--- lib/data/repositories/content-quiz-repository.ts

+++ lib/data/repositories/content-quiz-repository.ts


  *
  * 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약으로
  *   미리 맞춰 둔 것이라 백엔드가 생기기 전에는 실패한다.
- * 이슈: 학교급·학년은 컬럼이 없다. 검색 VO에 `searchSchul`/`searchGrade`가 있지만 매퍼의
- *   `<if>` 블록이 비어 있어 필터가 조용히 무시된다.
+ * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼이 없다. 검색 VO에 `searchSchul`/
+ *   `searchGrade`가 있지만 매퍼의 `<if>` 블록이 비어 있어 필터가 조용히 무시된다.
  * 이슈: 키워드가 별도 테이블이 아니라 `quiz_title` 한 칸이다. 목록의 「키워드」 열이 이 값이고,
  *   기획의 "키워드+설명 쌍"을 담을 자리는 아직 없다.
  * 이슈: 정답 노출 문구(기획 "기본 3종 + 기타")를 담을 컬럼이 없다.

   const keyword = query.keyword.trim();
 
   return {
-    searchSchul: query.schoolLevel,
+    searchSchul: query.school,
     searchGrade: query.grade,
     searchLevel: query.level,
     searchCondition: keyword ? '1' : '',

 export async function fetchQuizDetail(quizSn: string): Promise<QuizItem | null> {
   const { items } = await requestList(
     {
-      schoolLevel: '',
+      school: '',
       grade: '',
       level: '',
       searchField: '',

     quizQuestion: values.question,
     quizExplan: values.explanation,
     quizAnswer: values.answer,
-    schulGradeCd: values.schoolLevel,
+    schulCd: values.schoolCode,
     gradeCd: values.grades.join(','),
     answerMssageCd: values.answerMessageCode,
     answerMssage: values.answerMessageText,

9194d07

3902bd0

lib/data/repositories/content-repository.ts

--- lib/data/repositories/content-repository.ts

+++ lib/data/repositories/content-repository.ts


  * 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약
  *   (`POST {base}` / `PUT {base}/{sn}` / `DELETE {base}/{sn}`)으로 미리 맞춰 둔 것이라
  *   백엔드가 생기기 전에는 실패한다.
- * 이슈: 학교급·학년은 컬럼도 SQL도 없다(검색 VO에 파라미터만 있고 매퍼의 `<if>`가 비어 있다).
- *   주제·전달메시지도 컬럼이 없어 목록·상세에서 늘 빈 값이다.
+ * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼도 필터 SQL도 없다 — 검색 VO에 파라미터만
+ *   있고 매퍼의 `<if>`가 비어 있다. 주제·전달메시지도 컬럼이 없어 목록·상세에서 늘 빈 값이다.
  * 이슈: toon 매퍼의 검색 조건이 금칙어 테이블 컬럼(`BEN_WORD_NM`)을 보고 있어 검색어가 걸리면
  *   SQL이 깨진다. 그래서 검색어는 보내되 백엔드 수정 전까지는 결과를 신뢰할 수 없다.
  * 이슈: 목록 SQL이 키워드를 LEFT JOIN해 행이 키워드 수만큼 늘어나는데 count는 조인 없이 센다.

     title: readString(raw, 'cntntsTitle') ?? '',
     subject: readString(raw, 'cntntsSbjct') ?? '',
     message: readString(raw, 'cntntsMssage') ?? '',
-    schoolLevel: readString(raw, 'schulGradeCd') ?? '',
+    schoolCode: readString(raw, 'schulCd') ?? '',
     grades: (readString(raw, 'gradeCd') ?? '')
       .split(',')
       .map((grade) => grade.trim())

   const keyword = query.keyword.trim();
 
   return {
-    searchSchulGradeCd: query.schoolLevel,
+    searchSchulGradeCd: query.school,
     searchGradeCd: query.grade,
     searchCondition: keyword ? '1' : '',
     searchKeyword: keyword,

   const { items } = await requestList(
     kind,
     {
-      schoolLevel: '',
+      school: '',
       grade: '',
       level: '',
       searchField: '',

   cntntsTitle: string;
   cntntsSbjct: string;
   cntntsMssage: string;
-  schulGradeCd: string;
+  schulCd: string;
   gradeCd: string;
   atchFileId: string;
   thumbAtchFileId: string;

     cntntsTitle: values.title,
     cntntsSbjct: values.subject,
     cntntsMssage: values.message,
-    schulGradeCd: values.schoolLevel,
+    schulCd: values.schoolCode,
     gradeCd: values.grades.join(','),
     atchFileId: values.videoFileId,
     thumbAtchFileId: values.thumbnailFileId,

     cntntsTitle: values.name,
     cntntsSbjct: values.subject,
     cntntsMssage: values.message,
-    schulGradeCd: values.schoolLevel,
+    schulCd: values.schoolCode,
     gradeCd: values.grades.join(','),
     // 이슈: 기획은 "각 컷을 개별 이미지로 업로드"인데 백엔드 컬럼은 `atchFileId` 한 칸뿐이라
     // 컷 묶음을 여러 개 연결할 자리가 없다. 지금은 첫 묶음만 저장된다.

9194d07

3902bd0

lib/domain/common-code.ts

--- lib/domain/common-code.ts

+++ lib/domain/common-code.ts


   decorationItemCategory: 'ITEM_CATE_CD',
   /** 1:1문의 진행상태. */
   inquiryAnswerStatus: 'BBS_ANS_CD',
+  /** 학교(학교급). */
+  school: 'COM_SCHUL_CD',
+  /** 학년. 학교마다 다르므로 `atrbNm`에 학교 코드를 넣어 조회한다. */
+  grade: 'GRD_CD',
 } as const;
 
 /** 값이 없는 항목의 화면 표기. */

9194d07

3902bd0

lib/domain/content-form.ts

--- lib/domain/content-form.ts

+++ lib/domain/content-form.ts


   MIN_COMIC_CUTS,
   QUIZ_ANSWER_OPTIONS,
   QUIZ_LEVEL_OPTIONS,
-  findSchoolLevel,
-  gradeOptionsOf,
+  gradesOf,
   type ContentKeyword,
+  type GradesBySchool,
 } from '@/lib/domain/content';
+import type { CommonCode } from '@/lib/domain/common-code';
 
 export const TITLE_MAX_LENGTH = 200;
 export const SUBJECT_MAX_LENGTH = 200;

 export const INITIAL_CONTENT_FORM_STATE: ContentFormState = { status: 'idle' };
 
 export type GradeSelection = {
-  schoolLevel: string;
+  /** `COM_SCHUL_CD` 코드값. */
+  schoolCode: string;
+  /** `GRD_CD` 코드값 — 백엔드가 받는 것도 이 값이다. */
   grades: string[];
+};
+
+/** 학년 검증에 필요한 코드표. Server Action이 저장 직전에 다시 조회해 넘긴다. */
+export type SchoolGradeOptions = {
+  schools: readonly CommonCode[];
+  gradesBySchool: GradesBySchool;
 };
 
 export type ShortsFormValues = GradeSelection & {

 
 function validateGrades(
   values: GradeSelection,
+  codes: SchoolGradeOptions,
   errors: ContentFormErrors
 ): void {
-  const level = findSchoolLevel(values.schoolLevel);
-  if (!level) {
-    errors.schoolLevel = '학교급을 선택해 주세요.';
+  if (!codes.schools.some((school) => school.code === values.schoolCode)) {
+    errors.schoolCode = '학교를 선택해 주세요.';
     return;
   }
-  if (level.gradeCount === 0) {
+
+  const allowed = gradesOf(codes.gradesBySchool, values.schoolCode);
+  // 학년 코드가 하나도 없는 학교(전체연령 등)는 학년을 고르지 않는다.
+  if (allowed.length === 0) {
     return;
   }
-  const allowed = gradeOptionsOf(values.schoolLevel);
   if (values.grades.length === 0) {
     errors.grades = '학년을 하나 이상 선택해 주세요.';
     return;
   }
-  if (values.grades.some((grade) => !allowed.includes(grade))) {
+  if (
+    values.grades.some(
+      (grade) => !allowed.some((option) => option.code === grade)
+    )
+  ) {
     errors.grades = '선택할 수 없는 학년이 포함돼 있습니다.';
   }
 }

 }
 
 export function validateShortsForm(
-  values: ShortsFormValues
+  values: ShortsFormValues,
+  codes: SchoolGradeOptions
 ): ValidationResult<ShortsFormValues> {
   const errors: ContentFormErrors = {};
-  validateGrades(values, errors);
+  validateGrades(values, codes, errors);
 
   const title = requireText(
     values.title,

 }
 
 export function validateComicForm(
-  values: ComicFormValues
+  values: ComicFormValues,
+  codes: SchoolGradeOptions
 ): ValidationResult<ComicFormValues> {
   const errors: ContentFormErrors = {};
-  validateGrades(values, errors);
+  validateGrades(values, codes, errors);
 
   const name = requireText(
     values.name,

 }
 
 export function validateQuizForm(
-  values: QuizFormValues
+  values: QuizFormValues,
+  codes: SchoolGradeOptions
 ): ValidationResult<QuizFormValues> {
   const errors: ContentFormErrors = {};
-  validateGrades(values, errors);
+  validateGrades(values, codes, errors);
 
   if (!QUIZ_LEVEL_OPTIONS.some((option) => option.value === values.level)) {
     errors.level = '난이도를 선택해 주세요.';

9194d07

3902bd0

lib/domain/content-query.ts

--- lib/domain/content-query.ts

+++ lib/domain/content-query.ts


 const MAX_KEYWORD_LENGTH = 100;
 
 export type ContentQuery = {
-  schoolLevel: string;
+  /** 공통코드 `COM_SCHUL_CD` 코드값. 빈 값이면 전체. */
+  school: string;
+  /** 공통코드 `GRD_CD` 코드값. 빈 값이면 전체. */
   grade: string;
   /** 금융OX퀴즈 전용 난이도 필터. 다른 화면에서는 늘 빈 값이다. */
   level: string;

   const pageSize = Number(readParam(searchParams, 'pageSize'));
 
   return {
-    schoolLevel: readParam(searchParams, 'schoolLevel'),
+    school: readParam(searchParams, 'school'),
     grade: readParam(searchParams, 'grade'),
     level: kind === 'quiz' ? readParam(searchParams, 'level') : '',
     searchField: fields.some((field) => field.value === searchField)

   const params = new URLSearchParams();
   const defaultField = CONTENT_SEARCH_FIELDS[kind][0].value;
 
-  if (merged.schoolLevel) params.set('schoolLevel', merged.schoolLevel);
+  if (merged.school) params.set('school', merged.school);
   if (merged.grade) params.set('grade', merged.grade);
   if (merged.level) params.set('level', merged.level);
   if (merged.searchField !== defaultField) {

9194d07

3902bd0

lib/domain/content.ts

--- lib/domain/content.ts

+++ lib/domain/content.ts


  * 쇼츠·만화(`TB_COM_CNTNTS`)와 퀴즈(`TB_COM_QUIZ`)로 갈린다.
  */
 
-import { EMPTY_FIELD_PLACEHOLDER } from '@/lib/domain/common-code';
+import {
+  EMPTY_FIELD_PLACEHOLDER,
+  formatCommonCode,
+  type CommonCode,
+} from '@/lib/domain/common-code';
 
 export const CONTENT_KINDS = ['shorts', 'quiz', 'comic'] as const;
 export type ContentKind = (typeof CONTENT_KINDS)[number];

   comic: 'T',
 };
 
-export type SchoolLevelOption = {
-  value: string;
-  label: string;
-  /** 학년 칩 개수. 0이면 학년을 고르지 않는다(전체연령). */
-  gradeCount: number;
-};
+/** 학교 코드 → 그 학교의 학년 목록. 학년이 없는 학교(전체연령 등)는 빈 배열이다. */
+export type GradesBySchool = Record<string, readonly CommonCode[]>;
 
-// TODO: 학교급 코드값이 백엔드에 없다(검색 파라미터만 있고 컬럼·SQL이 없음). 잠정값이다.
-export const SCHOOL_LEVEL_OPTIONS: readonly SchoolLevelOption[] = [
-  { value: 'ELEM', label: '초등학교', gradeCount: 6 },
-  { value: 'MIDD', label: '중학교', gradeCount: 3 },
-  { value: 'HIGH', label: '고등학교', gradeCount: 3 },
-  { value: 'ALL', label: '전체연령', gradeCount: 0 },
-];
-
-export const DEFAULT_SCHOOL_LEVEL = SCHOOL_LEVEL_OPTIONS[0].value;
-
-export function findSchoolLevel(value: string): SchoolLevelOption | undefined {
-  return SCHOOL_LEVEL_OPTIONS.find((option) => option.value === value);
-}
-
-export function gradeOptionsOf(schoolLevel: string): readonly string[] {
-  const count = findSchoolLevel(schoolLevel)?.gradeCount ?? 0;
-  return Array.from({ length: count }, (_, index) => String(index + 1));
+export function gradesOf(
+  gradesBySchool: GradesBySchool,
+  schoolCode: string
+): readonly CommonCode[] {
+  return gradesBySchool[schoolCode] ?? [];
 }
 
 /** 난이도 — 백엔드 `MngrQuizVo.quizLev` 주석(1:하, 2:중, 3:상)에서 확인한 실제 코드값. */

   title: string;
   subject: string;
   message: string;
-  schoolLevel: string;
+  /** 공통코드 `COM_SCHUL_CD` 코드값. */
+  schoolCode: string;
+  /** 공통코드 `GRD_CD` 코드값. */
   grades: string[];
   keywords: ContentKeyword[];
   /** 만화의 컷 이미지·쇼츠의 영상이 묶인 첨부 ID. */

   modifiedAt: string | null;
 };
 
-export function formatSchoolLevelLabel(value: string): string {
-  return findSchoolLevel(value)?.label ?? (value || EMPTY_FIELD_PLACEHOLDER);
+export function formatSchoolLabel(
+  code: string,
+  schools: readonly CommonCode[]
+): string {
+  return code ? formatCommonCode(schools, code) : EMPTY_FIELD_PLACEHOLDER;
 }
 
-export function formatGradesLabel(grades: readonly string[]): string {
-  return grades.length > 0 ? grades.join(',') : EMPTY_FIELD_PLACEHOLDER;
+/** 학년 코드값 목록 → 코드명. 표에 없는 코드는 지어내지 않고 코드 그대로 보여준다. */
+export function formatGradesLabel(
+  grades: readonly string[],
+  gradeCodes: readonly CommonCode[]
+): string {
+  if (grades.length === 0) {
+    return EMPTY_FIELD_PLACEHOLDER;
+  }
+  return grades.map((grade) => formatCommonCode(gradeCodes, grade)).join(', ');
 }
 
 export function formatKeywordsLabel(keywords: readonly ContentKeyword[]): string {

...	...	@@ -3,6 +3,7 @@
3	3	import { revalidatePath } from 'next/cache';
4	4	import { redirect } from 'next/navigation';
5	5	import { verifySession } from '@/lib/auth/dal';
	6	+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
6	7	import { uploadAttachment } from '@/lib/data/repositories/file-repository';
7	8	import {
8	9	buildComicPayload,
...	...	@@ -117,7 +118,7 @@
117	118	}
118	119
119	120	const validation = validateShortsForm({
120		- schoolLevel: readString(formData, 'schoolLevel'),
	121	+ schoolCode: readString(formData, 'schoolCode'),
121	122	grades: readGrades(formData),
122	123	title: readString(formData, 'title'),
123	124	subject: readString(formData, 'subject'),
...	...	@@ -126,7 +127,7 @@
126	127	videoFileId: readString(formData, 'videoFileId'),
127	128	thumbnailFileId: readString(formData, 'thumbnailFileId'),
128	129	isVisible: readString(formData, 'isVisible') === 'true',
129		- });
	130	+ }, await fetchSchoolGradeCodes());
130	131	if (!validation.ok) {
131	132	return { status: 'error', errors: validation.errors };
132	133	}
...	...	@@ -165,7 +166,7 @@
165	166	}
166	167
167	168	const validation = validateShortsForm({
168		- schoolLevel: readString(formData, 'schoolLevel'),
	169	+ schoolCode: readString(formData, 'schoolCode'),
169	170	grades: readGrades(formData),
170	171	title: readString(formData, 'title'),
171	172	subject: readString(formData, 'subject'),
...	...	@@ -174,7 +175,7 @@
174	175	videoFileId: readString(formData, 'videoFileId'),
175	176	thumbnailFileId: readString(formData, 'thumbnailFileId'),
176	177	isVisible: readString(formData, 'isVisible') === 'true',
177		- });
	178	+ }, await fetchSchoolGradeCodes());
178	179	if (!cntntsSn) {
179	180	return { status: 'error', message: '요청이 올바르지 않습니다.' };
180	181	}
...	...	@@ -240,7 +241,7 @@
240	241	}
241	242
242	243	const validation = validateComicForm({
243		- schoolLevel: readString(formData, 'schoolLevel'),
	244	+ schoolCode: readString(formData, 'schoolCode'),
244	245	grades: readGrades(formData),
245	246	name: readString(formData, 'name'),
246	247	subject: readString(formData, 'subject'),
...	...	@@ -249,7 +250,7 @@
249	250	thumbnailFileId,
250	251	cutFileIds,
251	252	isVisible: readString(formData, 'isVisible') === 'true',
252		- });
	253	+ }, await fetchSchoolGradeCodes());
253	254	if (!validation.ok) {
254	255	return { status: 'error', errors: validation.errors };
255	256	}
...	...	@@ -293,7 +294,7 @@
293	294	}
294	295
295	296	const validation = validateComicForm({
296		- schoolLevel: readString(formData, 'schoolLevel'),
	297	+ schoolCode: readString(formData, 'schoolCode'),
297	298	grades: readGrades(formData),
298	299	name: readString(formData, 'name'),
299	300	subject: readString(formData, 'subject'),
...	...	@@ -302,7 +303,7 @@
302	303	thumbnailFileId,
303	304	cutFileIds,
304	305	isVisible: readString(formData, 'isVisible') === 'true',
305		- });
	306	+ }, await fetchSchoolGradeCodes());
306	307	if (!validation.ok) {
307	308	return { status: 'error', errors: validation.errors };
308	309	}
...	...	@@ -319,7 +320,7 @@
319	320
320	321	function readQuizValues(formData: FormData) {
321	322	return {
322		- schoolLevel: readString(formData, 'schoolLevel'),
	323	+ schoolCode: readString(formData, 'schoolCode'),
323	324	grades: readGrades(formData),
324	325	level: readString(formData, 'level'),
325	326	keywords: readKeywords(formData),
...	...	@@ -338,7 +339,7 @@
338	339	): Promise<ContentFormState> {
339	340	await verifySession();
340	341
341		- const validation = validateQuizForm(readQuizValues(formData));
	342	+ const validation = validateQuizForm(readQuizValues(formData), await fetchSchoolGradeCodes());
342	343	if (!validation.ok) {
343	344	return { status: 'error', errors: validation.errors };
344	345	}
...	...	@@ -364,7 +365,7 @@
364	365	return { status: 'error', message: '요청이 올바르지 않습니다.' };
365	366	}
366	367
367		- const validation = validateQuizForm(readQuizValues(formData));
	368	+ const validation = validateQuizForm(readQuizValues(formData), await fetchSchoolGradeCodes());
368	369	if (!validation.ok) {
369	370	return { status: 'error', errors: validation.errors };
370	371	}

...	...	@@ -2,10 +2,11 @@
2	2	import { cache } from 'react';
3	3	import { getSessionAccessToken } from '@/lib/auth/dal';
4	4	import { BackendRequestError, backendFetch } from '@/lib/http/backend-fetch';
5		-import type {
6		- CommonCode,
7		- CommonCodeDetail,
8		- CommonCodeGroup,
	5	+import {
	6	+ CODE_GROUP,
	7	+ type CommonCode,
	8	+ type CommonCodeDetail,
	9	+ type CommonCodeGroup,
9	10	} from '@/lib/domain/common-code';
10	11	import type {
11	12	CommonCodeDetailValues,
...	...	@@ -135,12 +136,19 @@
135	136	return rows.flatMap(toGroup);
136	137	});
137	138
138		-/** 한 그룹의 상세코드 전체. */
	139	+/**
	140	+ * 한 그룹의 상세코드 전체.
	141	+ *
	142	+ * `atrbNm`을 주면 백엔드가 `ATRB_NM1 = #{atrbNm}`으로 걸러 준다 — 학년(`GRD_CD`)처럼 상위
	143	+ * 코드에 딸린 목록을 뽑을 때 쓴다(학교 코드를 넣으면 그 학교의 학년만 온다).
	144	+ */
139	145	export const fetchCodeDetails = cache(async function fetchCodeDetails(
140		- comCd: string
	146	+ comCd: string,
	147	+ atrbNm?: string
141	148	): Promise<CommonCodeDetail[]> {
	149	+ const query = atrbNm ? `?atrbNm=${encodeURIComponent(atrbNm)}` : '';
142	150	const rows = await requestList(
143		- `${CODE_PATH}/list/${encodeURIComponent(comCd)}`
	151	+ `${CODE_PATH}/list/${encodeURIComponent(comCd)}${query}`
144	152	);
145	153	return rows.flatMap(toDetail);
146	154	});
...	...	@@ -149,11 +157,43 @@
149	157	* 다른 화면이 선택지로 쓰는 최소 표현. 상세코드 조회를 그대로 쓰되 화면이 알 필요 없는 것을
150	158	* 덜어 낸다 — 같은 `cache()`를 타므로 한 요청 안에서 왕복이 늘지 않는다.
151	159	*/
152		-export async function fetchCommonCodes(groupCode: string): Promise<CommonCode[]> {
153		- const details = await fetchCodeDetails(groupCode);
	160	+export async function fetchCommonCodes(
	161	+ groupCode: string,
	162	+ atrbNm?: string
	163	+): Promise<CommonCode[]> {
	164	+ const details = await fetchCodeDetails(groupCode, atrbNm);
154	165	return details.map((detail) => ({ code: detail.comDtlCd, label: detail.name }));
155	166	}
156	167
	168	+export type SchoolGradeCodes = {
	169	+ /** `COM_SCHUL_CD` — 학교 선택지. */
	170	+ schools: CommonCode[];
	171	+ /** 학교 코드 → 그 학교의 `GRD_CD` 목록. 학년이 없는 학교는 빈 배열이다. */
	172	+ gradesBySchool: Record<string, CommonCode[]>;
	173	+};
	174	+
	175	+/**
	176	+ * 학교와 학교별 학년을 함께 가져온다.
	177	+ *
	178	+ * 학년 조회에 학교 코드가 필요해 학교 수만큼 왕복한다 — 상세 목록 SQL이 `ATRB_NM1`을 select하지
	179	+ * 않아 한 번에 받아 화면에서 가르는 방법이 없다. 학교는 몇 개뿐이고 `cache()`가 한 요청 안의
	180	+ * 중복 호출을 막는다.
	181	+ */
	182	+export async function fetchSchoolGradeCodes(): Promise<SchoolGradeCodes> {
	183	+ const schools = await fetchCommonCodes(CODE_GROUP.school);
	184	+
	185	+ const grades = await Promise.all(
	186	+ schools.map((school) => fetchCommonCodes(CODE_GROUP.grade, school.code))
	187	+ );
	188	+
	189	+ return {
	190	+ schools,
	191	+ gradesBySchool: Object.fromEntries(
	192	+ schools.map((school, index) => [school.code, grades[index]])
	193	+ ),
	194	+ };
	195	+}
	196	+
157	197	/*
158	198	* ─── 쓰기 경로 ────────────────────────────────────────────────────────────────
159	199	* 상세 등록만 form이고 나머지는 JSON이다(파일 상단 주석 참조).

...	...	@@ -16,8 +16,8 @@
16	16	*
17	17	* 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약으로
18	18	* 미리 맞춰 둔 것이라 백엔드가 생기기 전에는 실패한다.
19		- * 이슈: 학교급·학년은 컬럼이 없다. 검색 VO에 `searchSchul`/`searchGrade`가 있지만 매퍼의
20		- * `<if>` 블록이 비어 있어 필터가 조용히 무시된다.
	19	+ * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼이 없다. 검색 VO에 `searchSchul`/
	20	+ * `searchGrade`가 있지만 매퍼의 `<if>` 블록이 비어 있어 필터가 조용히 무시된다.
21	21	* 이슈: 키워드가 별도 테이블이 아니라 `quiz_title` 한 칸이다. 목록의 「키워드」 열이 이 값이고,
22	22	* 기획의 "키워드+설명 쌍"을 담을 자리는 아직 없다.
23	23	* 이슈: 정답 노출 문구(기획 "기본 3종 + 기타")를 담을 컬럼이 없다.
...	...	@@ -76,7 +76,7 @@
76	76	const keyword = query.keyword.trim();
77	77
78	78	return {
79		- searchSchul: query.schoolLevel,
	79	+ searchSchul: query.school,
80	80	searchGrade: query.grade,
81	81	searchLevel: query.level,
82	82	searchCondition: keyword ? '1' : '',
...	...	@@ -148,7 +148,7 @@
148	148	export async function fetchQuizDetail(quizSn: string): Promise<QuizItem \| null> {
149	149	const { items } = await requestList(
150	150	{
151		- schoolLevel: '',
	151	+ school: '',
152	152	grade: '',
153	153	level: '',
154	154	searchField: '',
...	...	@@ -171,7 +171,7 @@
171	171	quizQuestion: values.question,
172	172	quizExplan: values.explanation,
173	173	quizAnswer: values.answer,
174		- schulGradeCd: values.schoolLevel,
	174	+ schulCd: values.schoolCode,
175	175	gradeCd: values.grades.join(','),
176	176	answerMssageCd: values.answerMessageCode,
177	177	answerMssage: values.answerMessageText,

...	...	@@ -25,8 +25,8 @@
25	25	* 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약
26	26	* (`POST {base}` / `PUT {base}/{sn}` / `DELETE {base}/{sn}`)으로 미리 맞춰 둔 것이라
27	27	* 백엔드가 생기기 전에는 실패한다.
28		- * 이슈: 학교급·학년은 컬럼도 SQL도 없다(검색 VO에 파라미터만 있고 매퍼의 `<if>`가 비어 있다).
29		- * 주제·전달메시지도 컬럼이 없어 목록·상세에서 늘 빈 값이다.
	28	+ * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼도 필터 SQL도 없다 — 검색 VO에 파라미터만
	29	+ * 있고 매퍼의 `<if>`가 비어 있다. 주제·전달메시지도 컬럼이 없어 목록·상세에서 늘 빈 값이다.
30	30	* 이슈: toon 매퍼의 검색 조건이 금칙어 테이블 컬럼(`BEN_WORD_NM`)을 보고 있어 검색어가 걸리면
31	31	* SQL이 깨진다. 그래서 검색어는 보내되 백엔드 수정 전까지는 결과를 신뢰할 수 없다.
32	32	* 이슈: 목록 SQL이 키워드를 LEFT JOIN해 행이 키워드 수만큼 늘어나는데 count는 조인 없이 센다.
...	...	@@ -90,7 +90,7 @@
90	90	title: readString(raw, 'cntntsTitle') ?? '',
91	91	subject: readString(raw, 'cntntsSbjct') ?? '',
92	92	message: readString(raw, 'cntntsMssage') ?? '',
93		- schoolLevel: readString(raw, 'schulGradeCd') ?? '',
	93	+ schoolCode: readString(raw, 'schulCd') ?? '',
94	94	grades: (readString(raw, 'gradeCd') ?? '')
95	95	.split(',')
96	96	.map((grade) => grade.trim())
...	...	@@ -112,7 +112,7 @@
112	112	const keyword = query.keyword.trim();
113	113
114	114	return {
115		- searchSchulGradeCd: query.schoolLevel,
	115	+ searchSchulGradeCd: query.school,
116	116	searchGradeCd: query.grade,
117	117	searchCondition: keyword ? '1' : '',
118	118	searchKeyword: keyword,
...	...	@@ -203,7 +203,7 @@
203	203	const { items } = await requestList(
204	204	kind,
205	205	{
206		- schoolLevel: '',
	206	+ school: '',
207	207	grade: '',
208	208	level: '',
209	209	searchField: '',
...	...	@@ -225,7 +225,7 @@
225	225	cntntsTitle: string;
226	226	cntntsSbjct: string;
227	227	cntntsMssage: string;
228		- schulGradeCd: string;
	228	+ schulCd: string;
229	229	gradeCd: string;
230	230	atchFileId: string;
231	231	thumbAtchFileId: string;
...	...	@@ -248,7 +248,7 @@
248	248	cntntsTitle: values.title,
249	249	cntntsSbjct: values.subject,
250	250	cntntsMssage: values.message,
251		- schulGradeCd: values.schoolLevel,
	251	+ schulCd: values.schoolCode,
252	252	gradeCd: values.grades.join(','),
253	253	atchFileId: values.videoFileId,
254	254	thumbAtchFileId: values.thumbnailFileId,
...	...	@@ -263,7 +263,7 @@
263	263	cntntsTitle: values.name,
264	264	cntntsSbjct: values.subject,
265	265	cntntsMssage: values.message,
266		- schulGradeCd: values.schoolLevel,
	266	+ schulCd: values.schoolCode,
267	267	gradeCd: values.grades.join(','),
268	268	// 이슈: 기획은 "각 컷을 개별 이미지로 업로드"인데 백엔드 컬럼은 `atchFileId` 한 칸뿐이라
269	269	// 컷 묶음을 여러 개 연결할 자리가 없다. 지금은 첫 묶음만 저장된다.

...	...	@@ -9,10 +9,11 @@
9	9	MIN_COMIC_CUTS,
10	10	QUIZ_ANSWER_OPTIONS,
11	11	QUIZ_LEVEL_OPTIONS,
12		- findSchoolLevel,
13		- gradeOptionsOf,
	12	+ gradesOf,
14	13	type ContentKeyword,
	14	+ type GradesBySchool,
15	15	} from '@/lib/domain/content';
	16	+import type { CommonCode } from '@/lib/domain/common-code';
16	17
17	18	export const TITLE_MAX_LENGTH = 200;
18	19	export const SUBJECT_MAX_LENGTH = 200;
...	...	@@ -32,8 +33,16 @@
32	33	export const INITIAL_CONTENT_FORM_STATE: ContentFormState = { status: 'idle' };
33	34
34	35	export type GradeSelection = {
35		- schoolLevel: string;
	36	+ /** `COM_SCHUL_CD` 코드값. */
	37	+ schoolCode: string;
	38	+ /** `GRD_CD` 코드값 — 백엔드가 받는 것도 이 값이다. */
36	39	grades: string[];
	40	+};
	41	+
	42	+/** 학년 검증에 필요한 코드표. Server Action이 저장 직전에 다시 조회해 넘긴다. */
	43	+export type SchoolGradeOptions = {
	44	+ schools: readonly CommonCode[];
	45	+ gradesBySchool: GradesBySchool;
37	46	};
38	47
39	48	export type ShortsFormValues = GradeSelection & {
...	...	@@ -87,22 +96,28 @@
87	96
88	97	function validateGrades(
89	98	values: GradeSelection,
	99	+ codes: SchoolGradeOptions,
90	100	errors: ContentFormErrors
91	101	): void {
92		- const level = findSchoolLevel(values.schoolLevel);
93		- if (!level) {
94		- errors.schoolLevel = '학교급을 선택해 주세요.';
	102	+ if (!codes.schools.some((school) => school.code === values.schoolCode)) {
	103	+ errors.schoolCode = '학교를 선택해 주세요.';
95	104	return;
96	105	}
97		- if (level.gradeCount === 0) {
	106	+
	107	+ const allowed = gradesOf(codes.gradesBySchool, values.schoolCode);
	108	+ // 학년 코드가 하나도 없는 학교(전체연령 등)는 학년을 고르지 않는다.
	109	+ if (allowed.length === 0) {
98	110	return;
99	111	}
100		- const allowed = gradeOptionsOf(values.schoolLevel);
101	112	if (values.grades.length === 0) {
102	113	errors.grades = '학년을 하나 이상 선택해 주세요.';
103	114	return;
104	115	}
105		- if (values.grades.some((grade) => !allowed.includes(grade))) {
	116	+ if (
	117	+ values.grades.some(
	118	+ (grade) => !allowed.some((option) => option.code === grade)
	119	+ )
	120	+ ) {
106	121	errors.grades = '선택할 수 없는 학년이 포함돼 있습니다.';
107	122	}
108	123	}
...	...	@@ -131,10 +146,11 @@
131	146	}
132	147
133	148	export function validateShortsForm(
134		- values: ShortsFormValues
	149	+ values: ShortsFormValues,
	150	+ codes: SchoolGradeOptions
135	151	): ValidationResult<ShortsFormValues> {
136	152	const errors: ContentFormErrors = {};
137		- validateGrades(values, errors);
	153	+ validateGrades(values, codes, errors);
138	154
139	155	const title = requireText(
140	156	values.title,
...	...	@@ -169,10 +185,11 @@
169	185	}
170	186
171	187	export function validateComicForm(
172		- values: ComicFormValues
	188	+ values: ComicFormValues,
	189	+ codes: SchoolGradeOptions
173	190	): ValidationResult<ComicFormValues> {
174	191	const errors: ContentFormErrors = {};
175		- validateGrades(values, errors);
	192	+ validateGrades(values, codes, errors);
176	193
177	194	const name = requireText(
178	195	values.name,
...	...	@@ -213,10 +230,11 @@
213	230	}
214	231
215	232	export function validateQuizForm(
216		- values: QuizFormValues
	233	+ values: QuizFormValues,
	234	+ codes: SchoolGradeOptions
217	235	): ValidationResult<QuizFormValues> {
218	236	const errors: ContentFormErrors = {};
219		- validateGrades(values, errors);
	237	+ validateGrades(values, codes, errors);
220	238
221	239	if (!QUIZ_LEVEL_OPTIONS.some((option) => option.value === values.level)) {
222	240	errors.level = '난이도를 선택해 주세요.';

...	...	@@ -5,50 +5,51 @@
5	5	import { FoxChipArea } from '@fox/core/components/fox-chip-area';
6	6	import { FoxHelperText } from '@fox/core/components/fox-helper-text';
7	7	import { FoxSelect } from '@fox/core/components/fox-select';
8		-import {
9		- DEFAULT_SCHOOL_LEVEL,
10		- SCHOOL_LEVEL_OPTIONS,
11		- findSchoolLevel,
12		- gradeOptionsOf,
13		-} from '@/lib/domain/content';
	8	+import { gradesOf, type GradesBySchool } from '@/lib/domain/content';
	9	+import type { CommonCode } from '@/lib/domain/common-code';
14	10	import styles from './content-form.module.scss';
15	11
16	12	interface ContentGradeFieldProps {
17		- defaultSchoolLevel?: string;
	13	+ /** 공통코드 `COM_SCHUL_CD`. */
	14	+ schools: readonly CommonCode[];
	15	+ /** 학교 코드 → 그 학교의 `GRD_CD` 목록. */
	16	+ gradesBySchool: GradesBySchool;
	17	+ defaultSchoolCode?: string;
18	18	defaultGrades?: readonly string[];
19		- schoolLevelError?: string;
	19	+ schoolError?: string;
20	20	gradesError?: string;
21	21	}
22	22
23	23	/**
24		- * 학년선택 — 학교급을 고르면 그 학교급의 학년 칩이 열리고 여러 개를 고를 수 있다.
25		- * 전체연령은 학년이 없어 칩을 그리지 않는다(기획 "전체 연령 선택 시 학년 선택 비활성").
	24	+ * 학년선택 — 학교를 고르면 그 학교의 학년 코드만 칩으로 열린다.
	25	+ * 학년이 없는 학교(전체연령 등)는 코드 목록이 비어 있어 칩을 그리지 않는다.
26	26	*/
27	27	export function ContentGradeField({
28		- defaultSchoolLevel,
	28	+ schools,
	29	+ gradesBySchool,
	30	+ defaultSchoolCode,
29	31	defaultGrades = [],
30		- schoolLevelError,
	32	+ schoolError,
31	33	gradesError,
32	34	}: ContentGradeFieldProps) {
33		- const [schoolLevel, setSchoolLevel] = useState(
34		- defaultSchoolLevel \|\| DEFAULT_SCHOOL_LEVEL
	35	+ const [schoolCode, setSchoolCode] = useState(
	36	+ defaultSchoolCode \|\| schools[0]?.code \|\| ''
35	37	);
36	38	const [grades, setGrades] = useState<string[]>([...defaultGrades]);
37	39
38		- const gradeOptions = gradeOptionsOf(schoolLevel);
39		- const hasGrades = (findSchoolLevel(schoolLevel)?.gradeCount ?? 0) > 0;
	40	+ const gradeCodes = gradesOf(gradesBySchool, schoolCode);
40	41
41		- function changeSchoolLevel(next: string) {
42		- setSchoolLevel(next);
43		- // 학교급이 바뀌면 이전 학교급의 학년은 남길 수 없다(초 4학년 → 중학교).
	42	+ function changeSchool(next: string) {
	43	+ setSchoolCode(next);
	44	+ // 학교가 바뀌면 이전 학교의 학년 코드는 남길 수 없다.
44	45	setGrades([]);
45	46	}
46	47
47		- function toggleGrade(grade: string) {
	48	+ function toggleGrade(code: string) {
48	49	setGrades((current) =>
49		- current.includes(grade)
50		- ? current.filter((value) => value !== grade)
51		- : [...current, grade].sort()
	50	+ current.includes(code)
	51	+ ? current.filter((value) => value !== code)
	52	+ : [...current, code]
52	53	);
53	54	}
54	55
...	...	@@ -57,37 +58,35 @@
57	58	<div className={styles.inline}>
58	59	<FoxSelect
59	60	size="md"
60		- options={SCHOOL_LEVEL_OPTIONS.map((option) => ({
61		- value: option.value,
62		- label: option.label,
	61	+ options={schools.map((school) => ({
	62	+ value: school.code,
	63	+ label: school.label,
63	64	}))}
64		- value={schoolLevel}
65		- onValueChange={changeSchoolLevel}
66		- error={Boolean(schoolLevelError)}
	65	+ placeholder="학교를 선택하세요."
	66	+ value={schoolCode}
	67	+ onValueChange={changeSchool}
	68	+ error={Boolean(schoolError)}
67	69	/>
68		- {hasGrades && (
	70	+ {gradeCodes.length > 0 && (
69	71	<FoxChipArea size="md" label="학년" wrap>
70		- {gradeOptions.map((grade) => (
	72	+ {gradeCodes.map((grade) => (
71	73	<FoxChip
72		- key={grade}
	74	+ key={grade.code}
73	75	type="check"
74		- label={`${grade}학년`}
75		- checked={grades.includes(grade)}
76		- onCheckedChange={() => toggleGrade(grade)}
	76	+ label={grade.label}
	77	+ checked={grades.includes(grade.code)}
	78	+ onCheckedChange={() => toggleGrade(grade.code)}
77	79	/>
78	80	))}
79	81	</FoxChipArea>
80	82	)}
81	83	</div>
82	84
83		- <input type="hidden" name="schoolLevel" value={schoolLevel} />
	85	+ <input type="hidden" name="schoolCode" value={schoolCode} />
84	86	<input type="hidden" name="grades" value={grades.join(',')} />
85	87
86		- {(schoolLevelError \|\| gradesError) && (
87		- <FoxHelperText
88		- type="danger"
89		- message={schoolLevelError ?? gradesError ?? ''}
90		- />
	88	+ {(schoolError \|\| gradesError) && (
	89	+ <FoxHelperText type="danger" message={schoolError ?? gradesError ?? ''} />
91	90	)}
92	91	</div>
93	92	);

...	...	@@ -4,57 +4,61 @@
4	4	import { FoxChipArea } from '@fox/core/components/fox-chip-area';
5	5	import {
6	6	QUIZ_LEVEL_OPTIONS,
7		- SCHOOL_LEVEL_OPTIONS,
8		- gradeOptionsOf,
	7	+ gradesOf,
	8	+ type GradesBySchool,
9	9	} from '@/lib/domain/content';
	10	+import type { CommonCode } from '@/lib/domain/common-code';
10	11	import type { ContentQuery } from '@/lib/domain/content-query';
11	12
12	13	const ALL = '';
13	14
14	15	// 칩은 고른 옵션의 라벨을 칩 글자 자리에 보여 준다 — 「전체」만 적으면 어떤 필터인지 사라져서
15	16	// 선택지 이름에 필터 이름을 붙인다.
16		-
17	17	interface ContentListFiltersProps {
18	18	query: ContentQuery;
	19	+ schools: readonly CommonCode[];
	20	+ gradesBySchool: GradesBySchool;
19	21	/** 난이도 칩은 금융OX퀴즈에만 있다. */
20	22	withLevel?: boolean;
21	23	onChange: (patch: Partial<ContentQuery>) => void;
22	24	}
23	25
24		-/** 목록 상단 필터 — 기획의 「학교급 / 학년 / 난이도」 셀렉트. */
	26	+/** 목록 상단 필터 — 기획의 「학교급 / 학년 / 난이도」 셀렉트. 학교·학년은 공통코드다. */
25	27	export function ContentListFilters({
26	28	query,
	29	+ schools,
	30	+ gradesBySchool,
27	31	withLevel = false,
28	32	onChange,
29	33	}: ContentListFiltersProps) {
30		- const gradeOptions = gradeOptionsOf(query.schoolLevel);
	34	+ const gradeCodes = gradesOf(gradesBySchool, query.school);
31	35
32	36	return (
33	37	<FoxChipArea size="md" label="목록 필터" wrap>
34	38	<FoxChip
35	39	type="select"
36		- label="학교급"
	40	+ label="학교"
37	41	options={[
38		- { value: ALL, label: '학교급 전체' },
39		- ...SCHOOL_LEVEL_OPTIONS.map((option) => ({
40		- value: option.value,
41		- label: option.label,
	42	+ { value: ALL, label: '학교 전체' },
	43	+ ...schools.map((school) => ({
	44	+ value: school.code,
	45	+ label: school.label,
42	46	})),
43	47	]}
44		- value={query.schoolLevel}
	48	+ value={query.school}
45	49	onValueChange={(value) =>
46		- onChange({ schoolLevel: value, grade: ALL, page: 1 })
	50	+ onChange({ school: value, grade: ALL, page: 1 })
47	51	}
48	52	/>
49	53	<FoxChip
50	54	type="select"
51	55	label="학년"
52		- disabled={gradeOptions.length === 0}
	56	+ disabled={gradeCodes.length === 0}
53	57	options={[
54	58	{ value: ALL, label: '학년 전체' },
55		- ...gradeOptions.map((grade) => ({
56		- value: grade,
57		- label: `${grade}학년`,
	59	+ ...gradeCodes.map((grade) => ({
	60	+ value: grade.code,
	61	+ label: grade.label,
58	62	})),
59	63	]}
60	64	value={query.grade}

...	...	@@ -26,6 +26,8 @@
26	26	type ContentSortOption,
27	27	} from '@/lib/domain/content-query';
28	28	import { ContentListFilters } from './content-list-filters';
	29	+import type { CommonCode } from '@/lib/domain/common-code';
	30	+import type { GradesBySchool } from '@/lib/domain/content';
29	31
30	32	interface ContentListShellProps<T> {
31	33	kind: ContentKind;
...	...	@@ -36,6 +38,8 @@
36	38	currentPage: number;
37	39	totalPages: number;
38	40	totalCount: number;
	41	+ schools: readonly CommonCode[];
	42	+ gradesBySchool: GradesBySchool;
39	43	/** 툴바 오른쪽에 덧붙일 것(금융OX퀴즈의 엑셀 버튼). */
40	44	extraActions?: ReactNode;
41	45	}
...	...	@@ -50,6 +54,8 @@
50	54	currentPage,
51	55	totalPages,
52	56	totalCount,
	57	+ schools,
	58	+ gradesBySchool,
53	59	extraActions,
54	60	}: ContentListShellProps<T>) {
55	61	const router = useRouter();
...	...	@@ -71,6 +77,8 @@
71	77	filter={
72	78	<ContentListFilters
73	79	query={query}
	80	+ schools={schools}
	81	+ gradesBySchool={gradesBySchool}
74	82	withLevel={kind === 'quiz'}
75	83	onChange={go}
76	84	/>

...	...	@@ -1,6 +1,7 @@
1	1	import type { Metadata } from 'next';
2	2	import { notFound } from 'next/navigation';
3	3	import { verifySession } from '@/lib/auth/dal';
	4	+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
4	5	import {
5	6	contentCutUrls,
6	7	contentThumbnailUrl,
...	...	@@ -19,6 +20,8 @@
19	20	export default async function Page({ params }: PageProps) {
20	21	await verifySession();
21	22
	23	+ const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
	24	+
22	25	const { cntntsSn } = await params;
23	26	const item = await fetchContentDetail('comic', cntntsSn);
24	27	if (!item) {
...	...	@@ -27,6 +30,8 @@
27	30
28	31	return (
29	32	<ComicForm
	33	+ schools={schools}
	34	+ gradesBySchool={gradesBySchool}
30	35	item={item}
31	36	thumbnailUrl={contentThumbnailUrl(item)}
32	37	cutUrls={contentCutUrls(item, MIN_COMIC_CUTS)}

...	...	@@ -7,7 +7,11 @@
7	7	import { FoxPageHeader } from '@fox/core/components/fox-page-header';
8	8	import { FoxTextArea } from '@fox/core/components/fox-text-area';
9	9	import { submitFormAction } from '@/app/_hooks/submit-form-action';
10		-import { THUMBNAIL_HELP_TEXT, type ContentItem } from '@/lib/domain/content';
	10	+import {
	11	+ THUMBNAIL_HELP_TEXT,
	12	+ type ContentItem,
	13	+ type GradesBySchool,
	14	+} from '@/lib/domain/content';
11	15	import {
12	16	INITIAL_CONTENT_FORM_STATE,
13	17	MESSAGE_MAX_LENGTH,
...	...	@@ -15,6 +19,7 @@
15	19	TITLE_MAX_LENGTH,
16	20	} from '@/lib/domain/content-form';
17	21	import { contentBreadcrumb, contentListPath } from '@/lib/domain/content-query';
	22	+import type { CommonCode } from '@/lib/domain/common-code';
18	23	import { FILE_MODULE, fileModuleAccept } from '@/lib/domain/file-module';
19	24	import { createComicAction, updateComicAction } from '../../_actions';
20	25	import { ContentCutsField } from '../../_components/content-cuts-field';
...	...	@@ -26,13 +31,21 @@
26	31	import styles from '../../_components/content-form.module.scss';
27	32
28	33	interface ComicFormProps {
	34	+ schools: readonly CommonCode[];
	35	+ gradesBySchool: GradesBySchool;
29	36	item?: ContentItem;
30	37	thumbnailUrl?: string \| null;
31	38	cutUrls?: string[];
32	39	}
33	40
34	41	/** 콘텐츠 등록·수정 (4컷금융만화) — 시안 5449:10850. */
35		-export function ComicForm({ item, thumbnailUrl, cutUrls = [] }: ComicFormProps) {
	42	+export function ComicForm({
	43	+ schools,
	44	+ gradesBySchool,
	45	+ item,
	46	+ thumbnailUrl,
	47	+ cutUrls = [],
	48	+}: ComicFormProps) {
36	49	const isEdit = item !== undefined;
37	50	const [state, formAction, isPending] = useActionState(
38	51	isEdit ? updateComicAction : createComicAction,
...	...	@@ -62,9 +75,11 @@
62	75
63	76	<ContentFormRow label="학년선택" required>
64	77	<ContentGradeField
65		- defaultSchoolLevel={item?.schoolLevel}
	78	+ schools={schools}
	79	+ gradesBySchool={gradesBySchool}
	80	+ defaultSchoolCode={item?.schoolCode}
66	81	defaultGrades={item?.grades}
67		- schoolLevelError={errors.schoolLevel}
	82	+ schoolError={errors.schoolCode}
68	83	gradesError={errors.grades}
69	84	/>
70	85	</ContentFormRow>

...	...	@@ -6,10 +6,12 @@
6	6	formatContentText,
7	7	formatGradesLabel,
8	8	formatKeywordsLabel,
9		- formatSchoolLevelLabel,
	9	+ formatSchoolLabel,
10	10	formatVisibilityLabel,
11	11	type ContentItem,
	12	+ type GradesBySchool,
12	13	} from '@/lib/domain/content';
	14	+import type { CommonCode } from '@/lib/domain/common-code';
13	15	import type { ContentQuery } from '@/lib/domain/content-query';
14	16	import { ContentListShell } from '../../_components/content-list-shell';
15	17	import { ContentRowActions } from '../../_components/content-row-actions';
...	...	@@ -20,6 +22,8 @@
20	22	currentPage: number;
21	23	totalPages: number;
22	24	totalCount: number;
	25	+ schools: readonly CommonCode[];
	26	+ gradesBySchool: GradesBySchool;
23	27	}
24	28
25	29	export function ComicsList({
...	...	@@ -28,6 +32,8 @@
28	32	currentPage,
29	33	totalPages,
30	34	totalCount,
	35	+ schools,
	36	+ gradesBySchool,
31	37	}: ComicsListProps) {
32	38	const columns: FoxListColumn<ContentItem>[] = [
33	39	{
...	...	@@ -37,16 +43,17 @@
37	43	render: (_row, index) => (currentPage - 1) * query.pageSize + index + 1,
38	44	},
39	45	{
40		- key: 'schoolLevel',
41		- header: '학교급',
	46	+ key: 'school',
	47	+ header: '학교',
42	48	width: 120,
43		- render: (row) => formatSchoolLevelLabel(row.schoolLevel),
	49	+ render: (row) => formatSchoolLabel(row.schoolCode, schools),
44	50	},
45	51	{
46	52	key: 'grades',
47	53	header: '학년',
48	54	width: 100,
49		- render: (row) => formatGradesLabel(row.grades),
	55	+ render: (row) =>
	56	+ formatGradesLabel(row.grades, gradesBySchool[row.schoolCode] ?? []),
50	57	},
51	58	{
52	59	key: 'name',
...	...	@@ -105,6 +112,8 @@
105	112	currentPage={currentPage}
106	113	totalPages={totalPages}
107	114	totalCount={totalCount}
	115	+ schools={schools}
	116	+ gradesBySchool={gradesBySchool}
108	117	/>
109	118	);
110	119	}

...	...	@@ -1,5 +1,6 @@
1	1	import type { Metadata } from 'next';
2	2	import { verifySession } from '@/lib/auth/dal';
	3	+import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
3	4	import { ComicForm } from '../_components/comic-form';
4	5
5	6	export const metadata: Metadata = { title: '콘텐츠 등록 (4컷금융만화)' };
...	...	@@ -7,5 +8,7 @@
7	8
8	9	export default async function Page() {
9	10	await verifySession();
10		- return <ComicForm />;
	11	+
	12	+ const { schools, gradesBySchool } = await fetchSchoolGradeCodes();
	13	+ return <ComicForm schools={schools} gradesBySchool={gradesBySchool} />;
11	14	}

...	...	@@ -15,6 +15,7 @@
15	15	QUIZ_ANSWER_OPTIONS,
16	16	QUIZ_LEVEL_OPTIONS,
17	17	type QuizItem,
	18	+ type GradesBySchool,
18	19	} from '@/lib/domain/content';
19	20	import {
20	21	ANSWER_MESSAGE_MAX_LENGTH,
...	...	@@ -23,6 +24,7 @@
23	24	QUESTION_MAX_LENGTH,
24	25	} from '@/lib/domain/content-form';
25	26	import { contentBreadcrumb, contentListPath } from '@/lib/domain/content-query';
	27	+import type { CommonCode } from '@/lib/domain/common-code';
26	28	import { createQuizAction, updateQuizAction } from '../../_actions';
27	29	import { ContentFormActions } from '../../_components/content-form-actions';
28	30	import { ContentFormRow } from '../../_components/content-form-row';
...	...	@@ -32,6 +34,8 @@
32	34	import styles from '../../_components/content-form.module.scss';
33	35
34	36	interface QuizFormProps {
	37	+ schools: readonly CommonCode[];
	38	+ gradesBySchool: GradesBySchool;
35	39	item?: QuizItem;
36	40	}
37	41
...	...	@@ -41,7 +45,7 @@
41	45	* 정답여부는 O·X 두 줄이고, 고른 쪽에서만 「사용자에게 노출할 문구」를 정한다(기획 ③).
42	46	* 「기타」를 고르면 문구를 직접 적는다.
43	47	*/
44		-export function QuizForm({ item }: QuizFormProps) {
	48	+export function QuizForm({ schools, gradesBySchool, item }: QuizFormProps) {
45	49	const isEdit = item !== undefined;
46	50	const [state, formAction, isPending] = useActionState(
47	51	isEdit ? updateQuizAction : createQuizAction,
...	...	@@ -74,7 +78,9 @@
74	78
75	79	<ContentFormRow label="학년선택" required>
76	80	<ContentGradeField
77		- schoolLevelError={errors.schoolLevel}
	81	+ schools={schools}
	82	+ gradesBySchool={gradesBySchool}
	83	+ schoolError={errors.schoolCode}
78	84	gradesError={errors.grades}
79	85	/>
80	86	</ContentFormRow>

...	...	@@ -7,8 +7,10 @@
7	7	formatContentText,
8	8	formatQuizLevelLabel,
9	9	formatVisibilityLabel,
	10	+ type GradesBySchool,
10	11	type QuizItem,
11	12	} from '@/lib/domain/content';
	13	+import type { CommonCode } from '@/lib/domain/common-code';
12	14	import type { ContentQuery } from '@/lib/domain/content-query';
13	15	import { ContentListShell } from '../../_components/content-list-shell';
14	16	import { ContentRowActions } from '../../_components/content-row-actions';
...	...	@@ -20,6 +22,8 @@
20	22	currentPage: number;
21	23	totalPages: number;
22	24	totalCount: number;
	25	+ schools: readonly CommonCode[];
	26	+ gradesBySchool: GradesBySchool;
23	27	}
24	28
25	29	export function QuizzesList({
...	...	@@ -28,6 +32,8 @@
28	32	currentPage,
29	33	totalPages,
30	34	totalCount,
	35	+ schools,
	36	+ gradesBySchool,
31	37	}: QuizzesListProps) {
32	38	const columns: FoxListColumn<QuizItem>[] = [
33	39	{
...	...	@@ -112,6 +118,8 @@
112	118	currentPage={currentPage}
113	119	totalPages={totalPages}
114	120	totalCount={totalCount}
	121	+ schools={schools}
	122	+ gradesBySchool={gradesBySchool}
115	123	extraActions={<QuizExcelActions />}
116	124	/>
117	125	);

...	...	@@ -10,6 +10,7 @@
10	10	import {
11	11	THUMBNAIL_HELP_TEXT,
12	12	type ContentItem,
	13	+ type GradesBySchool,
13	14	} from '@/lib/domain/content';
14	15	import {
15	16	INITIAL_CONTENT_FORM_STATE,
...	...	@@ -18,6 +19,7 @@
18	19	TITLE_MAX_LENGTH,
19	20	} from '@/lib/domain/content-form';
20	21	import { contentBreadcrumb, contentListPath } from '@/lib/domain/content-query';
	22	+import type { CommonCode } from '@/lib/domain/common-code';
21	23	import { FILE_MODULE, fileModuleAccept } from '@/lib/domain/file-module';
22	24	import { createShortsAction, updateShortsAction } from '../../_actions';
23	25	import { ContentFormActions } from '../../_components/content-form-actions';
...	...	@@ -29,13 +31,20 @@
29	31	import styles from '../../_components/content-form.module.scss';
30	32
31	33	interface ShortsFormProps {
	34	+ schools: readonly CommonCode[];
	35	+ gradesBySchool: GradesBySchool;
32	36	/** 수정 화면에서만 넘어온다. 없으면 등록이다. */
33	37	item?: ContentItem;
34	38	thumbnailUrl?: string \| null;
35	39	}
36	40
37	41	/** 콘텐츠 등록·수정 (금융쇼츠) — 시안 5402:10628. */
38		-export function ShortsForm({ item, thumbnailUrl }: ShortsFormProps) {
	42	+export function ShortsForm({
	43	+ schools,
	44	+ gradesBySchool,
	45	+ item,
	46	+ thumbnailUrl,
	47	+}: ShortsFormProps) {
39	48	const isEdit = item !== undefined;
40	49	const [state, formAction, isPending] = useActionState(
41	50	isEdit ? updateShortsAction : createShortsAction,
...	...	@@ -65,9 +74,11 @@
65	74
66	75	<ContentFormRow label="학년선택" required>
67	76	<ContentGradeField
68		- defaultSchoolLevel={item?.schoolLevel}
	77	+ schools={schools}
	78	+ gradesBySchool={gradesBySchool}
	79	+ defaultSchoolCode={item?.schoolCode}
69	80	defaultGrades={item?.grades}
70		- schoolLevelError={errors.schoolLevel}
	81	+ schoolError={errors.schoolCode}
71	82	gradesError={errors.grades}
72	83	/>
73	84	</ContentFormRow>

...	...	@@ -23,6 +23,10 @@
23	23	decorationItemCategory: 'ITEM_CATE_CD',
24	24	/** 1:1문의 진행상태. */
25	25	inquiryAnswerStatus: 'BBS_ANS_CD',
	26	+ /** 학교(학교급). */
	27	+ school: 'COM_SCHUL_CD',
	28	+ /** 학년. 학교마다 다르므로 `atrbNm`에 학교 코드를 넣어 조회한다. */
	29	+ grade: 'GRD_CD',
26	30	} as const;
27	31
28	32	/** 값이 없는 항목의 화면 표기. */

...	...	@@ -82,7 +82,9 @@
82	82	const MAX_KEYWORD_LENGTH = 100;
83	83
84	84	export type ContentQuery = {
85		- schoolLevel: string;
	85	+ /** 공통코드 `COM_SCHUL_CD` 코드값. 빈 값이면 전체. */
	86	+ school: string;
	87	+ /** 공통코드 `GRD_CD` 코드값. 빈 값이면 전체. */
86	88	grade: string;
87	89	/** 금융OX퀴즈 전용 난이도 필터. 다른 화면에서는 늘 빈 값이다. */
88	90	level: string;
...	...	@@ -112,7 +114,7 @@
112	114	const pageSize = Number(readParam(searchParams, 'pageSize'));
113	115
114	116	return {
115		- schoolLevel: readParam(searchParams, 'schoolLevel'),
	117	+ school: readParam(searchParams, 'school'),
116	118	grade: readParam(searchParams, 'grade'),
117	119	level: kind === 'quiz' ? readParam(searchParams, 'level') : '',
118	120	searchField: fields.some((field) => field.value === searchField)
...	...	@@ -136,7 +138,7 @@
136	138	const params = new URLSearchParams();
137	139	const defaultField = CONTENT_SEARCH_FIELDS[kind][0].value;
138	140
139		- if (merged.schoolLevel) params.set('schoolLevel', merged.schoolLevel);
	141	+ if (merged.school) params.set('school', merged.school);
140	142	if (merged.grade) params.set('grade', merged.grade);
141	143	if (merged.level) params.set('level', merged.level);
142	144	if (merged.searchField !== defaultField) {

...	...	@@ -5,7 +5,11 @@
5	5	* 쇼츠·만화(`TB_COM_CNTNTS`)와 퀴즈(`TB_COM_QUIZ`)로 갈린다.
6	6	*/
7	7
8		-import { EMPTY_FIELD_PLACEHOLDER } from '@/lib/domain/common-code';
	8	+import {
	9	+ EMPTY_FIELD_PLACEHOLDER,
	10	+ formatCommonCode,
	11	+ type CommonCode,
	12	+} from '@/lib/domain/common-code';
9	13
10	14	export const CONTENT_KINDS = ['shorts', 'quiz', 'comic'] as const;
11	15	export type ContentKind = (typeof CONTENT_KINDS)[number];
...	...	@@ -22,30 +26,14 @@
22	26	comic: 'T',
23	27	};
24	28
25		-export type SchoolLevelOption = {
26		- value: string;
27		- label: string;
28		- /** 학년 칩 개수. 0이면 학년을 고르지 않는다(전체연령). */
29		- gradeCount: number;
30		-};
	29	+/** 학교 코드 → 그 학교의 학년 목록. 학년이 없는 학교(전체연령 등)는 빈 배열이다. */
	30	+export type GradesBySchool = Record<string, readonly CommonCode[]>;
31	31
32		-// TODO: 학교급 코드값이 백엔드에 없다(검색 파라미터만 있고 컬럼·SQL이 없음). 잠정값이다.
33		-export const SCHOOL_LEVEL_OPTIONS: readonly SchoolLevelOption[] = [
34		- { value: 'ELEM', label: '초등학교', gradeCount: 6 },
35		- { value: 'MIDD', label: '중학교', gradeCount: 3 },
36		- { value: 'HIGH', label: '고등학교', gradeCount: 3 },
37		- { value: 'ALL', label: '전체연령', gradeCount: 0 },
38		-];
39		-
40		-export const DEFAULT_SCHOOL_LEVEL = SCHOOL_LEVEL_OPTIONS[0].value;
41		-
42		-export function findSchoolLevel(value: string): SchoolLevelOption \| undefined {
43		- return SCHOOL_LEVEL_OPTIONS.find((option) => option.value === value);
44		-}
45		-
46		-export function gradeOptionsOf(schoolLevel: string): readonly string[] {
47		- const count = findSchoolLevel(schoolLevel)?.gradeCount ?? 0;
48		- return Array.from({ length: count }, (_, index) => String(index + 1));
	32	+export function gradesOf(
	33	+ gradesBySchool: GradesBySchool,
	34	+ schoolCode: string
	35	+): readonly CommonCode[] {
	36	+ return gradesBySchool[schoolCode] ?? [];
49	37	}
50	38
51	39	/** 난이도 — 백엔드 `MngrQuizVo.quizLev` 주석(1:하, 2:중, 3:상)에서 확인한 실제 코드값. */
...	...	@@ -91,7 +79,9 @@
91	79	title: string;
92	80	subject: string;
93	81	message: string;
94		- schoolLevel: string;
	82	+ /** 공통코드 `COM_SCHUL_CD` 코드값. */
	83	+ schoolCode: string;
	84	+ /** 공통코드 `GRD_CD` 코드값. */
95	85	grades: string[];
96	86	keywords: ContentKeyword[];
97	87	/** 만화의 컷 이미지·쇼츠의 영상이 묶인 첨부 ID. */
...	...	@@ -115,12 +105,22 @@
115	105	modifiedAt: string \| null;
116	106	};
117	107
118		-export function formatSchoolLevelLabel(value: string): string {
119		- return findSchoolLevel(value)?.label ?? (value \|\| EMPTY_FIELD_PLACEHOLDER);
	108	+export function formatSchoolLabel(
	109	+ code: string,
	110	+ schools: readonly CommonCode[]
	111	+): string {
	112	+ return code ? formatCommonCode(schools, code) : EMPTY_FIELD_PLACEHOLDER;
120	113	}
121	114
122		-export function formatGradesLabel(grades: readonly string[]): string {
123		- return grades.length > 0 ? grades.join(',') : EMPTY_FIELD_PLACEHOLDER;
	115	+/** 학년 코드값 목록 → 코드명. 표에 없는 코드는 지어내지 않고 코드 그대로 보여준다. */
	116	+export function formatGradesLabel(
	117	+ grades: readonly string[],
	118	+ gradeCodes: readonly CommonCode[]
	119	+): string {
	120	+ if (grades.length === 0) {
	121	+ return EMPTY_FIELD_PLACEHOLDER;
	122	+ }
	123	+ return grades.map((grade) => formatCommonCode(gradeCodes, grade)).join(', ');
124	124	}
125	125
126	126	export function formatKeywordsLabel(keywords: readonly ContentKeyword[]): string {

Delete comment