@axboot-mcp/mcp-server 1.0.0

package/src/templates/index.ts

@@ -0,0 +1,107 @@
+import { unifiedTemplate } from './unified.js';
+
+export interface TemplateVariables {
+  STORE_NAME: string;
+  STORE_NAME_PASCAL: string;
+  STORE_INTERFACE: string;
+  SERVICE_NAME: string;
+  LIST_METHOD_NAME: string;
+  DELETE_METHOD_NAME?: string | null;
+  SAVE_METHOD_NAME?: string | null;
+  DETAIL_METHOD_NAME?: string | null;
+  DELETE_API_CALL?: string;
+  SAVE_API_CALL?: string;
+  LIST_REQUEST: string;
+  LIST_REQUEST_EXTENDS: string; // 'extends XXX' or empty string
+  LIST_RESPONSE: string;
+  ACTIONS_EXTENDS: string; // Actions interface extends clause
+  DELETE_REQUEST: string;
+  DELETE_REQUEST_EXTENDS: string; // 'extends XXX' or empty string
+  SAVE_REQUEST: string;
+  SAVE_REQUEST_EXTENDS: string; // 'extends XXX' or empty string
+  SAVE_PARAM_TYPE: string; // Save 메서드 파라미터 타입 (배열: DtoItem[], 단일: DtoItem)
+  DTO_ITEM: string;
+  DTO_ITEM_LOWER: string;
+  HAS_PAGE: boolean; // 페이징 여부
+  HAS_SAVE: boolean; // 저장 API 여부
+  HAS_DELETE: boolean; // 삭제 API 여부
+  HAS_DETAIL: boolean; // 상세 조회 API 여부
+  HAS_LIST: boolean; // 리스트 존재 여부 (선택 패턴 적용용)
+  HAS_REORDER: boolean; // 재정렬 기능 여부 (드래그 앤 드롭)
+  HAS_LIST_REQUEST_PARAMS: boolean; // List API에 요청 파라미터가 있는지 여부 (void가 아닌 경우)
+  HAS_LIST_RESPONSE: boolean; // 응답 타입이 void가 아닌지 여부 (response.ds 접근용)
+  HAS_PAGE_IN_REQUEST: boolean; // Request에 pageNumber/pageSize 필드가 있는지 (listRequestValue 초기값 결정용)
+  HAS_DATE_RANGE: boolean; // dateRange 패턴 존재 여부 (쌍이 모두 있는 경우)
+  HAS_DAY_JS: boolean; // dayjs import 필요 여부 (Dt/Dtm 필드가 1개 이상 있는 경우)
+  IS_BGNDTM: boolean; // bgnDtm/endDtm 패턴 여부 (아니면 startDateTime/endDateTime)
+  ID_FIELD: string; // __status__ 패턴용 ID 필드 (예: id, bbscttNo)
+  ID_FIELD_TYPE?: string; // ID 필드의 실제 타입 (예: 'string', 'number', 'string | undefined')
+  ID_FIELD_NEEDS_STRING_CONVERSION: boolean; // ID 필드 타입에 number가 포함되어 String() 변환이 필요한지 여부
+  ID_FIELD_VALUE?: string; // id 변수의 변환된 값 ('id' 또는 'String(id)')
+  ID_FIELD_KEY_VALUE?: string; // key 변수의 변환된 값 ('key' 또는 'String(key)')
+  REQUIRED_FIELDS_DEFAULTS?: string; // Request 필수 필드 기본값
+  HAS_EXCEL?: boolean; // 엑셀 다운로드 API 존재 여부
+  EXCEL_METHOD_NAME?: string | null; // 엑셀 메서드 이름
+  EXCEL_PARAM_TYPE?: string; // 엑셀 메서드 파라미터 타입 (배열: DtoItem[], 단일: ListRequest)
+  IS_EXCEL_REQUEST_ARRAY?: boolean; // 엑셀 메서드 Request가 배열인지 여부
+  IS_DELETE_REQUEST_ARRAY?: boolean; // 삭제 메서드 Request가 배열인지 여부
+  HAS_ARRAY_DELETE_API?: boolean; // 다른 삭제 메서드 중 배열이 있는지 (callMultiDeleteApi 생성용)
+  DELETE_PARAM_TYPE?: string; // 삭제 메서드 파라미터 타입 (배열: React.Key[], 단일: number | string)
+  DELETE_PARAM_NAME?: string; // 삭제 메서드 파라미터 이름 (배열: ids, 단일: id)
+  IMPORTS: string;
+  LIST_METHOD_COMMENT?: string; // List 메서드 주석
+  DELETE_METHOD_COMMENT?: string; // Delete 메서드 주석
+  SAVE_METHOD_COMMENT?: string; // Save 메서드 주석
+  DETAIL_METHOD_COMMENT?: string; // Detail 메서드 주석
+  CALL_DELETE_API_DECLARATION?: string; // callDeleteApi Actions interface 선언
+
+  // === 응답 필드 정보 ===
+  LIST_RESPONSE_FIELD?: string; // 리스트 응답 필드명 (ds, list 등)
+  DETAIL_RESPONSE_FIELD?: string; // 상세 응답 필드명 (rs, detail 등)
+  IS_DIRECT_RESPONSE?: boolean; // 응답이 직접 객체인지 여부 (result 자체를 사용)
+
+  // === 요청 필드 정보 ===
+  REQUEST_FIELDS?: string; // 요청 필드 JSON 문자열 (SearchParams 생성용)
+
+  // === 다중 리스트 관련 변수 ===
+  HAS_MULTI_LIST?: boolean; // 다중 리스트 여부 (왼쪽/상단/하단 목록 등)
+  SUB_LIST_DTO_ITEM?: string; // 서브 리스트 DTO 타입
+  SUB_LIST_METHOD_NAME?: string; // 서브 리스트 메서드 이름
+  SUB_LIST_REQUEST_EXTENDS?: string; // SubListRequest extends 절
+  SUB_LIST_RESPONSE_FIELD?: string; // 서브 리스트 응답 필드명
+  IS_SUB_LIST_PARENT_KEY?: boolean; // 서브 리스트에 상위 키 필드 사용 여부
+  PARENT_KEY_FIELD?: string; // 상위 키 필드명 (예: groupCd, categoryCd)
+  HAS_SUB_LIST_CHECKBOX?: boolean; // 서브 리스트 체크박스 여부
+  HAS_SUB_LIST_EXCEL?: boolean; // 서브 리스트 엑셀 다운로드 여부
+  HAS_FORM?: boolean; // 폼 여부 (다중 리스트에서 저장 기능 사용 시)
+  HAS_AUTO_LOAD?: boolean; // 자동 로드 여부 (listSelectedRowKey 변경 시 자동으로 서브 리스트 로드)
+  SUB_LIST_REQUIRED_FIELDS_DEFAULTS?: string; // 서브 리스트 필수 필드 기본값
+
+  // === docs 기반 추가 변수 ===
+  METADATA_FIELDS?: string;
+  METADATA_REQUIRED?: string;
+  METADATA_OPTIONAL?: string;
+  STATES_REQUIRED?: string;
+  STATES_OPTIONAL?: string;
+  ACTIONS_REQUIRED?: string;
+  ACTIONS_OPTIONAL?: string;
+  SUBSCRIBE_SELECTOR?: string;
+  CREATE_STATE_FIELDS?: string;
+  CALL_LIST_API_TEMPLATE?: string;
+  DOCS_REFERENCE?: string;
+  STORE_TYPE_NAME?: string;
+  STORE_TYPE_DESCRIPTION?: string;
+}
+
+/**
+ * 통합 템플릿 export
+ */
+export { unifiedTemplate };
+
+/**
+ * 통합 템플릿 반환 함수
+ * 모든 타입에 대해 unified 템플릿을 사용합니다.
+ */
+export function getTemplate(storeType: number): string {
+  return unifiedTemplate;
+}

package/src/templates/unified.ts

@@ -0,0 +1,462 @@
+/**
+ * 통합 템플릿 (Unified Template)
+ * type11 기반으로 모든 기능을 포함하는 단일 템플릿
+ *
+ * 지원 기능:
+ * - 리스트 조회 (LIST)
+ * - 마스터-디테일 (MASTER_DETAIL)
+ * - 페이지네이션 (HAS_PAGE)
+ * - 모달 (MODAL)
+ * - 삭제 (DELETE)
+ * - 저장 (SAVE)
+ * - 상세 조회 (DETAIL)
+ * - 엑셀 다운로드 (EXCEL)
+ * - 체크박스 (CHECKBOX)
+ * - 날짜 범위 검색 (DATE_RANGE)
+ * - 재정렬 (REORDER)
+ * - 트리 (TREE)
+ * - 다중 리스트 (HAS_MULTI_LIST): 왼쪽/상단/하단 목록 등 2개 이상의 리스트
+ */
+export const unifiedTemplate = `import { AXDGDataItem{{#HAS_PAGE}}, AXDGPage{{/HAS_PAGE}}, AXDGSortParam } from "@axboot/datagrid";
+{{#HAS_PAGE}}import { pageStoreActions } from "@core/stores/pageStoreActions";
+{{/HAS_PAGE}}import { StoreActions } from "@core/stores/types";
+{{#HAS_PAGE}}import { PageStoreActions } from "@core/stores/types";
+{{/HAS_PAGE}}import { deleteEmptyValue } from "@core/utils/object";
+{{#HAS_SAVE}}import { errorHandling } from "utils";{{/HAS_SAVE}}
+{{#HAS_DAY_JS}}import { DT_FORMAT } from "@types";
+{{/HAS_DAY_JS}}import { ProgramFn } from "@types";
+{{#HAS_DAY_JS}}import dayjs from "dayjs";{{/HAS_DAY_JS}}
+{{IMPORTS}}
+{{#HAS_DATE_RANGE}}import { dateRangeToDts } from "utils";{{/HAS_DATE_RANGE}}
+import { getTabStoreListener } from "stores";
+import { create } from "zustand";
+import { subscribeWithSelector } from "zustand/middleware";
+import { shallow } from "zustand/shallow";
+
+interface ListRequest {{LIST_REQUEST_EXTENDS}}{
+  {{#HAS_DATE_RANGE}}dateRange?: [string, string];{{/HAS_DATE_RANGE}}
+}
+
+interface DtoItem extends {{DTO_ITEM}} {}
+
+// ========== interface MetaData ==========
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  {{#HAS_PAGE}}listSelectedRowKey?: React.Key;
+  listCheckedIndexes?: number[];{{/HAS_PAGE}}
+  {{#HAS_SAVE}}modalOpen: boolean;{{/HAS_SAVE}}
+
+  // 다중 리스트 (왼쪽/상단/하단 목록 등)
+  {{#HAS_MULTI_LIST}}subListRequestValue: SubListRequest;
+  subListColWidths: number[];
+  subListSortParams: AXDGSortParam[];
+  subListSelectedRowKey?: React.Key;{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_SUB_LIST_CHECKBOX}}subListCheckedIndexes?: number[];{{/HAS_SUB_LIST_CHECKBOX}}{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_FORM}}formActive: boolean;
+  saveRequestValue?: SaveRequest;
+  detail?: DetailResponse;{{/HAS_FORM}}{{/HAS_MULTI_LIST}}
+}
+
+// ========== interface States ==========
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  {{#HAS_EXCEL}}excelSpinning: boolean;{{/HAS_EXCEL}}
+  {{#HAS_DELETE}}deleteSpinning: boolean;{{/HAS_DELETE}}
+  {{#HAS_SAVE}}saveSpinning: boolean;{{/HAS_SAVE}}
+  {{#HAS_DETAIL}}detailSpinning: boolean;{{/HAS_DETAIL}}
+  listData: AXDGDataItem<DtoItem>[];
+  {{#HAS_PAGE}}listPage: AXDGPage;{{/HAS_PAGE}}
+
+  // 마스터-디테일 (오른쪽 상세)
+  {{#HAS_LIST}}selectedItem?: DtoItem;{{/HAS_LIST}}
+  {{#HAS_DETAIL}}detail?: DtoItem;{{/HAS_DETAIL}}
+  {{#HAS_REORDER}}isReordered: boolean;{{/HAS_REORDER}}
+
+  // 체크박스
+  {{#HAS_PAGE}}checkedRowKeys: React.Key[];{{/HAS_PAGE}}
+
+  // 다중 리스트
+  {{#HAS_MULTI_LIST}}subListSpinning: boolean;
+  subListData: AXDGDataItem<SubDtoItem>[];{{/HAS_MULTI_LIST}}
+}
+
+// ========== const createState ==========
+const createState: States = {
+  listRequestValue: {{#HAS_PAGE_IN_REQUEST}}{
+    pageNumber: 1,
+    pageSize: 100,
+{{REQUIRED_FIELDS_DEFAULTS}}
+    {{#HAS_DATE_RANGE}}dateRange: [
+      dayjs().add(-1, "month").startOf("day").format(DT_FORMAT.DATETIME_HHMM),
+      dayjs().endOf("day").format(DT_FORMAT.DATETIME_HHMM),
+    ],{{/HAS_DATE_RANGE}}
+  },{{/HAS_PAGE_IN_REQUEST}}{{^HAS_PAGE_IN_REQUEST}}{},{{/HAS_PAGE_IN_REQUEST}}
+  listColWidths: [],
+  listSpinning: false,
+  {{#HAS_EXCEL}}excelSpinning: false,{{/HAS_EXCEL}}
+  {{#HAS_DELETE}}deleteSpinning: false,{{/HAS_DELETE}}
+  {{#HAS_SAVE}}saveSpinning: false,{{/HAS_SAVE}}
+  {{#HAS_DETAIL}}detailSpinning: false,{{/HAS_DETAIL}}
+  listData: [],
+  {{#HAS_PAGE}}listPage: {
+    currentPage: 0,
+    totalPages: 0,
+  },{{/HAS_PAGE}}
+  listSortParams: [],
+  {{#HAS_REORDER}}isReordered: false,{{/HAS_REORDER}}
+  {{#HAS_LIST}}selectedItem: undefined,{{/HAS_LIST}}
+  {{#HAS_DETAIL}}detail: undefined,{{/HAS_DETAIL}}
+  {{#HAS_SAVE}}modalOpen: false,{{/HAS_SAVE}}
+  {{#HAS_PAGE}}checkedRowKeys: [],
+  listSelectedRowKey: "",{{/HAS_PAGE}}
+
+  // 다중 리스트 초기값
+  {{#HAS_MULTI_LIST}}subListRequestValue: {},
+  subListColWidths: [],
+  subListSortParams: [],
+  subListSelectedRowKey: undefined,{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_SUB_LIST_CHECKBOX}}subListCheckedIndexes: [],{{/HAS_SUB_LIST_CHECKBOX}}{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_FORM}}formActive: true,
+  saveRequestValue: { {{SUB_LIST_REQUIRED_FIELDS_DEFAULTS}} },
+  detail: { {{SUB_LIST_REQUIRED_FIELDS_DEFAULTS}} },{{/HAS_FORM}}{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}subListSpinning: false,
+  subListData: [],{{/HAS_MULTI_LIST}}
+};
+
+// ========== interface Actions ==========
+interface Actions {{ACTIONS_EXTENDS}}{
+  setListRequestValue: (requestValue: ListRequest) => void;
+  setListColWidths: (colWidths: number[]) => void;
+  setListSortParams: (sortParams: AXDGSortParam[]) => void;
+  setListSpinning: (spinning: boolean) => void;
+  callListApi: (request?: ListRequest) => Promise<void>;
+  {{#HAS_EXCEL}}callExcelDownloadApi: (request?: {{EXCEL_PARAM_TYPE}}) => Promise<void>;{{/HAS_EXCEL}}
+  {{CALL_DELETE_API_DECLARATION}}
+  {{^IS_DELETE_REQUEST_ARRAY}}{{#HAS_ARRAY_DELETE_API}}callMultiDeleteApi: (keys: React.Key[]) => Promise<void>;{{/HAS_ARRAY_DELETE_API}}{{/IS_DELETE_REQUEST_ARRAY}}
+  {{#HAS_SAVE}}callSaveApi: (request?: {{SAVE_PARAM_TYPE}}) => Promise<void>;{{/HAS_SAVE}}
+  {{#HAS_PAGE}}changeListPage: (currentPage: number, pageSize?: number) => Promise<void>;
+  setListSelectedRowKey: (key?: React.Key) => void;{{/HAS_PAGE}}
+  {{#HAS_LIST}}setSelectedItem: (selectedItem?: DtoItem) => void;{{/HAS_LIST}}
+  {{#HAS_DETAIL}}setDetail: (detail?: DtoItem) => void;
+  callDetailApi: (id: number | string) => Promise<void>;{{/HAS_DETAIL}}
+  {{#HAS_SAVE}}setModalOpen: (open: boolean) => void;{{/HAS_SAVE}}
+  {{#HAS_PAGE}}setCheckedRowKeys: (checkedRowKeys: React.Key[]) => void;{{/HAS_PAGE}}
+  {{#HAS_REORDER}}setListData: (listData: AXDGDataItem<DtoItem>[]) => void;
+  saveReorder: () => Promise<void>;{{/HAS_REORDER}}
+
+  // 다중 리스트 액션
+  {{#HAS_MULTI_LIST}}callSubListApi: (request?: SubListRequest) => Promise<void>;
+  setSubListRequestValue: (requestValue: SubListRequest) => void;
+  setSubListColWidths: (colWidths: number[]) => void;
+  setSubListSortParams: (sortParams: AXDGSortParam[]) => void;
+  setSubListSpinning: (spinning: boolean) => void;
+  setSubListSelectedRowKey: (key?: React.Key) => void;{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_SUB_LIST_CHECKBOX}}setSubListCheckedIndexes: (indexes?: number[]) => void;
+  addSubListData: (list: SubDtoItem[]) => void;
+  delSubListData: (indexes: number[]) => void;
+  setSubListData: (list: AXDGDataItem<SubDtoItem>[], reset?: boolean) => void;{{/HAS_SUB_LIST_CHECKBOX}}{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_FORM}}cancelFormActive: () => void;
+  setFormActive: () => void;{{/HAS_FORM}}{{/HAS_MULTI_LIST}}
+}
+
+// ========== const createActions ==========
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  {{#HAS_PAGE}}...pageStoreActions(set, get, { createState }),
+  syncMetadata: (s = createState) => set(s),
+  onMountApp: async () => {},{{/HAS_PAGE}}
+  setListRequestValue: (requestValues) => set({ listRequestValue: requestValues }),
+  setListColWidths: (colWidths) => set({ listColWidths: colWidths }),
+  setListSortParams: (sortParams) => set({ listSortParams: sortParams }),
+  setListSpinning: (spinning) => set({ listSpinning: spinning }),
+
+  {{LIST_METHOD_COMMENT}}
+  callListApi: async (request) => {
+    if (get().listSpinning) return;
+    set({ listSpinning: true });
+
+    try {
+      {{#HAS_LIST_REQUEST_PARAMS}}{{#HAS_PAGE}}const apiParam: ListRequest = { ...get().listRequestValue, ...request };{{/HAS_PAGE}}
+      {{^HAS_PAGE}}const apiParam: ListRequest = request ?? ({} as ListRequest);{{/HAS_PAGE}}
+
+      {{#HAS_PAGE}}{{#HAS_DATE_RANGE}}const response = await {{SERVICE_NAME}}.{{LIST_METHOD_NAME}}(
+        deleteEmptyValue({
+          ...apiParam,
+          ...dateRangeToDts(apiParam.dateRange, {
+            {{#IS_BGNDTM}}bgnDtm: DT_FORMAT.DATE + " 00:00:00",endDtm: DT_FORMAT.DATE + " 23:59:59",{{/IS_BGNDTM}}
+            {{^IS_BGNDTM}}startDateTime: DT_FORMAT.DATETIME_HHMMSS,endDateTime: DT_FORMAT.DATE + " 23:59:59",{{/IS_BGNDTM}}
+          }),
+        })
+      );{{/HAS_DATE_RANGE}}{{^HAS_DATE_RANGE}}const response = await {{SERVICE_NAME}}.{{LIST_METHOD_NAME}}(
+        deleteEmptyValue(apiParam)
+      );{{/HAS_DATE_RANGE}}{{/HAS_PAGE}}
+      {{^HAS_PAGE}}const response = await {{SERVICE_NAME}}.{{LIST_METHOD_NAME}}(
+        deleteEmptyValue(apiParam)
+      );{{/HAS_PAGE}}{{/HAS_LIST_REQUEST_PARAMS}}
+      {{^HAS_LIST_REQUEST_PARAMS}}const apiParam = {} as ListRequest;
+      const response = await {{SERVICE_NAME}}.{{LIST_METHOD_NAME}}();{{/HAS_LIST_REQUEST_PARAMS}}
+
+      set({
+        {{#HAS_PAGE_IN_REQUEST}}listRequestValue: apiParam,{{/HAS_PAGE_IN_REQUEST}}
+        {{#HAS_LIST_RESPONSE}}listData: response.{{LIST_RESPONSE_FIELD}}.map((values) => ({ values })),{{/HAS_LIST_RESPONSE}}
+        {{^HAS_LIST_RESPONSE}}listData: [],{{/HAS_LIST_RESPONSE}}
+        {{#HAS_REORDER}}isReordered: false,{{/HAS_REORDER}}
+        {{#HAS_PAGE}}listPage: {
+          currentPage: response.page.pageNumber ?? 1,
+          pageSize: response.page.pageSize ?? 0,
+          totalPages: response.page.pageCount ?? 0,
+          totalElements: response.page?.totalCount,
+        },{{/HAS_PAGE}}
+      });
+    }{{#HAS_SAVE}} catch (err) {
+      await errorHandling(err);
+    }{{/HAS_SAVE}} finally {
+      set({ listSpinning: false });
+    }
+  },
+
+  {{#HAS_PAGE}}changeListPage: async (pageNumber, pageSize) => {
+    await get().callListApi({ ...get().listRequestValue, pageNumber, pageSize });
+  },
+
+  setListSelectedRowKey: (key) => set({ listSelectedRowKey: key }),{{/HAS_PAGE}}
+
+  {{#HAS_REORDER}}setListData: (listData) => set({ listData, isReordered: true }),
+
+  saveReorder: async () => {
+    set({ listSpinning: true });
+    try {
+      // TODO: 재정렬 저장 API 호출 구현 필요
+      // const sortedData = get().listData.map((item, index) => ({
+      //   ...item.values,
+      //   sortOrdr: index + 1,
+      // }));
+      // await {{SERVICE_NAME}}.saveSortOrder(sortedData);
+      set({ isReordered: false });
+    }{{#HAS_SAVE}} catch (err) {
+      await errorHandling(err);
+    }{{/HAS_SAVE}} finally {
+      set({ listSpinning: false });
+    }
+  },{{/HAS_REORDER}}
+
+  {{#HAS_LIST}}setSelectedItem: (selectedItem) => {
+    set({ selectedItem{{#HAS_DETAIL}}, detailSpinning: true{{/HAS_DETAIL}} });
+    {{#HAS_SAVE}}if (!selectedItem || (selectedItem as any)["__status__"] === "C") {
+      set({ modalOpen: false });
+    }{{/HAS_SAVE}}
+    {{#HAS_DETAIL}}set({ detailSpinning: false });{{/HAS_DETAIL}}
+  },{{/HAS_LIST}}
+
+  {{#HAS_DETAIL}}setDetail: (detail) => {
+    set({ detail });
+  },{{/HAS_DETAIL}}
+
+  {{#HAS_SAVE}}setModalOpen: (open) => set({ modalOpen: open }),{{/HAS_SAVE}}
+
+  {{#HAS_EXCEL}}{{LIST_METHOD_COMMENT}}
+  callExcelDownloadApi: async (request) => {
+    if (get().excelSpinning) return;
+    set({ excelSpinning: true });
+
+    try {
+{{#IS_EXCEL_REQUEST_ARRAY}}
+      if (!request) return;
+      await {{SERVICE_NAME}}.{{EXCEL_METHOD_NAME}}(request);
+{{/IS_EXCEL_REQUEST_ARRAY}}
+{{^IS_EXCEL_REQUEST_ARRAY}}
+      const { pageNumber, pageSize, ...restParams }: ListRequest = {
+        {{#HAS_PAGE}}...get().listRequestValue,{{/HAS_PAGE}}
+        ...request,
+      };
+      await {{SERVICE_NAME}}.{{EXCEL_METHOD_NAME}}(deleteEmptyValue(restParams));
+{{/IS_EXCEL_REQUEST_ARRAY}}
+    } finally {
+      set({ excelSpinning: false });
+    }
+  },{{/HAS_EXCEL}}
+
+  {{#HAS_DELETE}}{{DELETE_METHOD_COMMENT}}
+  callDeleteApi: async ({{DELETE_PARAM_NAME}}) => {
+    if (get().deleteSpinning) return;
+
+    try {
+      set({ deleteSpinning: true });
+      {{DELETE_API_CALL}}
+      await get().callListApi();
+    }{{#HAS_SAVE}} catch (err) {
+      await errorHandling(err);
+    }{{/HAS_SAVE}} finally {
+      set({ deleteSpinning: false });
+    }
+  },{{/HAS_DELETE}}
+
+  {{^IS_DELETE_REQUEST_ARRAY}}{{#HAS_ARRAY_DELETE_API}}{{DELETE_METHOD_COMMENT}}
+  callMultiDeleteApi: async (keys: React.Key[]) => {
+    if (get().deleteSpinning || keys.length === 0) return;
+
+    try {
+      set({ deleteSpinning: true });
+      for (const key of keys) {
+        await {{SERVICE_NAME}}.{{DELETE_METHOD_NAME}}({ {{#HAS_PAGE}}...get().listRequestValue,{{/HAS_PAGE}} {{ID_FIELD}}: {{ID_FIELD_KEY_VALUE}} });
+      }
+      await get().callListApi();
+    }{{#HAS_SAVE}} catch (err) {
+      await errorHandling(err);
+    }{{/HAS_SAVE}} finally {
+      set({ deleteSpinning: false });
+    }
+  },{{/HAS_ARRAY_DELETE_API}}{{/IS_DELETE_REQUEST_ARRAY}}
+
+  {{#HAS_SAVE}}{{SAVE_METHOD_COMMENT}}
+  callSaveApi: async (request) => {
+    if (get().saveSpinning) return;
+    if (!request) return;
+
+    try {
+      set({ saveSpinning: true });
+      {{SAVE_API_CALL}}
+      await get().callListApi();
+      set({ modalOpen: false });
+    } catch (err) {
+      await errorHandling(err);
+    } finally {
+      set({ saveSpinning: false });
+    }
+  },{{/HAS_SAVE}}
+
+  {{#HAS_DETAIL}}{{DETAIL_METHOD_COMMENT}}
+  callDetailApi: async (id) => {
+    if (get().detailSpinning) return;
+    set({ detailSpinning: true });
+
+    try {
+      const result = await {{SERVICE_NAME}}.{{DETAIL_METHOD_NAME}}({
+        {{#HAS_PAGE_IN_REQUEST}}...get().listRequestValue,{{/HAS_PAGE_IN_REQUEST}}
+        {{ID_FIELD}}: {{ID_FIELD_VALUE}}
+      });
+      {{#IS_DIRECT_RESPONSE}}set({ detail: result });{{/IS_DIRECT_RESPONSE}}
+      {{^IS_DIRECT_RESPONSE}}set({ detail: result.{{DETAIL_RESPONSE_FIELD}} });{{/IS_DIRECT_RESPONSE}}
+    }{{#HAS_SAVE}} catch (err) {
+      await errorHandling(err);
+    }{{/HAS_SAVE}} finally {
+      set({ detailSpinning: false });
+    }
+  },{{/HAS_DETAIL}}
+
+  {{#HAS_PAGE}}setCheckedRowKeys: (checkedRowKeys) => set({ checkedRowKeys }),{{/HAS_PAGE}}
+
+  // ========== 다중 리스트 액션 ==========
+  {{#HAS_MULTI_LIST}}setSubListRequestValue: (requestValues) => set({ subListRequestValue: requestValues }),
+  setSubListColWidths: (colWidths) => set({ subListColWidths: colWidths }),
+  setSubListSortParams: (sortParams) => set({ subListSortParams: sortParams }),
+  setSubListSpinning: (spinning) => set({ subListSpinning: spinning }),
+
+  callSubListApi: async (request) => {
+    set({ subListSpinning: true, subListData: [], subListSelectedRowKey: "" });
+
+    try {
+      {{#HAS_PAGE}}if (!get().listSelectedRowKey) return;{{/HAS_PAGE}}
+
+      const apiParam = request ?? {
+        {{#HAS_PAGE}}{{#IS_SUB_LIST_PARENT_KEY}}{{PARENT_KEY_FIELD}}: get().listSelectedRowKey,{{/IS_SUB_LIST_PARENT_KEY}}{{/HAS_PAGE}}
+        {{^HAS_PAGE}}// TODO: 상위 키 필드 설정 필요{{/HAS_PAGE}}
+      };
+      const response = await {{SERVICE_NAME}}.{{SUB_LIST_METHOD_NAME}}(deleteEmptyValue(apiParam));
+
+      set({
+        subListData: (response.{{SUB_LIST_RESPONSE_FIELD}} ?? []).map((values: {{SUB_LIST_DTO_ITEM}}) => ({
+          values,
+        })),
+      });
+    }{{#HAS_SAVE}} catch (err) {
+      await errorHandling(err);
+    }{{/HAS_SAVE}} finally {
+      set({ subListSpinning: false });
+    }
+  },
+
+  setSubListSelectedRowKey: (key) => set({ subListSelectedRowKey: key }),{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_SUB_LIST_CHECKBOX}}setSubListCheckedIndexes: (indexes) => set({ subListCheckedIndexes: indexes }),
+
+  addSubListData: (list) => {
+    const addDataGridList = (await import("@core/utils")).addDataGridList;
+    const listData = addDataGridList<{{SUB_LIST_DTO_ITEM}}>(get().subListData ?? [], list);
+    set({ subListData: [...listData] });
+  },
+
+  delSubListData: (indexes) => {
+    const delDataGridList = (await import("@core/utils")).delDataGridList;
+    const listData = delDataGridList(get().subListData ?? [], indexes);
+    set({ subListData: [...listData], subListCheckedIndexes: [] });
+  },
+
+  setSubListData: (list, reset) => {
+    if (reset) {
+      set({
+        subListCheckedIndexes: [],
+        subListSelectedRowKey: undefined,
+        subListData: list,
+      });
+    } else {
+      set({ subListData: list });
+    }
+  },{{/HAS_SUB_LIST_CHECKBOX}}{{/HAS_MULTI_LIST}}
+  {{#HAS_MULTI_LIST}}{{#HAS_FORM}}cancelFormActive: () => {
+    set({ formActive: false, listSelectedRowKey: undefined });
+  },
+
+  setFormActive: () => {
+    set({ formActive: true, detail: undefined, saveRequestValue: undefined });
+  },{{/HAS_FORM}}{{/HAS_MULTI_LIST}}
+});
+
+// ========== export ==========
+export interface {{STORE_INTERFACE}} extends States, Actions{{#HAS_PAGE}}
+  , PageStoreActions<States>{{/HAS_PAGE}} {}
+
+export const {{STORE_NAME}} = create(
+  subscribeWithSelector<{{STORE_INTERFACE}}>((set, get) => ({
+    ...createState,
+    ...createActions(set, get),
+  })),
+);
+
+// ========== Store.subscribe ==========
+{{STORE_NAME}}.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    listSortParams: s.listSortParams,
+    {{#HAS_PAGE}}listSelectedRowKey: s.listSelectedRowKey,
+    listCheckedIndexes: s.listCheckedIndexes,{{/HAS_PAGE}}
+    {{#HAS_SAVE}}modalOpen: s.modalOpen{{/HAS_SAVE}}
+    {{#HAS_MULTI_LIST}},
+    subListRequestValue: s.subListRequestValue,
+    subListColWidths: s.subListColWidths,
+    subListSortParams: s.subListSortParams,
+    subListSelectedRowKey: s.subListSelectedRowKey{{/HAS_MULTI_LIST}}
+    {{#HAS_MULTI_LIST}}{{#HAS_SUB_LIST_CHECKBOX}},
+    subListCheckedIndexes: s.subListCheckedIndexes{{/HAS_SUB_LIST_CHECKBOX}}{{/HAS_MULTI_LIST}}
+    {{#HAS_MULTI_LIST}}{{#HAS_FORM}},
+    formActive: s.formActive,
+    saveRequestValue: s.saveRequestValue,
+    detail: s.detail{{/HAS_FORM}}{{/HAS_MULTI_LIST}}
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+
+{{#HAS_AUTO_LOAD}}
+{{STORE_NAME}}.subscribe(
+  (s) => [s.listSelectedRowKey],
+  ([listSelectedRowKey]) => {
+    {{STORE_NAME}}.getState().callSubListApi();
+  },
+  { equalityFn: shallow },
+);{{/HAS_AUTO_LOAD}};
+`;