@axboot-mcp/mcp-server 1.0.0

package/src/docs/store-patterns-usage-guide.md

@@ -0,0 +1,1835 @@
+# NH-FE-B Store 패턴별 사용법 가이드
+
+> MCP-AXBoot로 Store 생성 후 참고하여 수정할 수 있는 가이드입니다.
+
+---
+
+## 목차
+
+1. [패턴 분류 기준](#1-패턴-분류-기준)
+2. [Store 타입별 패턴](#2-store-타입별-패턴)
+3. [MetaData 필드 조합표](#3-metadata-필드-조합표)
+4. [States 필드별 초기값 패턴](#4-states-필드별-초기값-패턴)
+5. [createActions 패턴별 구현](#5-createactions-패턴별-구현)
+6. [Store.subscribe 패턴별 구현](#6-storesubscribe-패턴별-구현)
+7. [MCP-AXBoot 사용 후 수정 가이드](#7-mcp-axboot-사용-후-수정-가이드)
+
+---
+
+## 1. 패턴 분류 기준
+
+Store 패턴은 다음 기준으로 분류됩니다:
+
+1. **데이터 구조**: 단일 리스트 vs 다중 리스트 vs 트리 vs 대시보드
+2. **기능**: 조회만 vs CRUD vs 상세보기 vs 엑셀 다운로드
+3. **선택 방식**: 단일 선택 vs 다중 선택 vs 미사용
+4. **UI 패턴**: 트리+폼, 마스터-디테일, 탭 기반 등
+
+---
+
+## 2. Store 타입별 패턴
+
+### Type 1: 기본 리스트형 (Basic List)
+
+**사용처**: 단순 조회 페이지
+
+**예시 파일**: `useDepartmentStore.ts`, `useKdhFinancialHighlightsStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  setListRequestValue: (requestValue: ListRequest, changedValues?: ListRequest) => void;
+  setListColWidths: (colWidths: number[]) => void;
+  setListSpinning: (spinning: boolean) => void;
+  setListSortParams: (sortParams: AXDGSortParam[]) => void;
+  callListApi: (request?: ListRequest) => Promise<void>;
+  changeListPage: (currentPage: number, pageSize?: number) => Promise<void>;
+}
+```
+
+#### Store.subscribe
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+### Type 2: 리스트 + 엑셀 다운로드 (List + Excel)
+
+**사용처**: 조회 + 엑셀 다운로드
+
+**예시 파일**: `useProductReviewStore.ts`, `useProductQnaAnswerTemplateStore.ts`, `useBenefitMileageHistoryStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+}
+```
+
+#### States (excelSpinning 추가)
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  excelSpinning: boolean;  // 추가
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+}
+```
+
+#### Actions (callExcelDownloadApi 추가)
+```typescript
+interface Actions extends PageStoreActions<States> {
+  // ... 기본 액션들
+  setExcelSpinning: (spinning: boolean) => void;  // 추가
+  callExcelDownloadApi: (request?: ListRequest) => Promise<void>;  // 추가
+}
+```
+
+#### Store.subscribe
+```typescript
+// Type 1과 동일
+```
+
+---
+
+### Type 3: 리스트 + 상세/폼 (List + Detail)
+
+**사용처**: 조회 + 상세보기/편집
+
+**예시 파일**: `useMemberListStore.ts`, `useBenefitCouponStore.ts`, `useBenefitEventStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  saveRequestValue: SaveRequest;  // 추가
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  selectedItem?: DtoItem;       // 추가
+  detailLoading: boolean;        // 추가
+  checkedRowKeys: React.Key[];   // 추가 (선택사항)
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  // ... 기본 액션들
+  setSelectedItem: (selectedItem?: DtoItem) => Promise<void>;  // 추가
+  setSaveRequestValue: (saveRequestValue: SaveRequest) => void;  // 추가
+  setCheckedRowKeys: (checkedRowKeys: React.Key[]) => void;     // 추가
+}
+```
+
+#### Store.subscribe
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    saveRequestValue: s.saveRequestValue,  // 추가
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+### Type 4: 마스터-디테일 (Master-Detail)
+
+**사용처**: 마스터 리스트 선택 시 디테일 표시
+
+**예시 파일**: `useProductMasterStore.ts`, `useOrderPaymentAllStore.ts`, `useOrderClaimReturnStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  listSelectedRowKey?: React.Key;        // 추가
+  listCheckedIndexes?: number[];         // 추가 (다중 선택시)
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  checkedRowKeys: React.Key[];           // 추가
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  // ... 기본 액션들
+  setListSelectedRowKey: (key?: React.Key) => void;      // 추가
+  setCheckedRowKeys: (checkedRowKeys: React.Key[]) => void;  // 추가
+  setListCheckedIndexes: (indexes?: number[]) => void;   // 추가
+}
+```
+
+#### Store.subscribe
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    listSelectedRowKey: s.listSelectedRowKey,        // 추가
+    listCheckedIndexes: s.listCheckedIndexes,       // 추가 (사용시)
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+### Type 5: CRUD (Create + Read + Update + Delete)
+
+**사용처**: 전체 기능 (생성, 조회, 수정, 삭제)
+
+**예시 파일**: `useSystemBbsStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  listSelectedRowKey?: React.Key;
+  flexGrow: number;                    // 추가
+  saveRequestValue: SaveRequest;       // 추가
+  detail?: SaveRequest;                // 추가
+  formActive: boolean;                 // 추가
+  listCheckedKeys: React.Key[];        // 추가
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  saveSpinning: boolean;               // 추가
+  detailSpinning: boolean;             // 추가
+  deleteSpinning: boolean;             // 추가
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  // ... 기본 액션들
+  setListSelectedRowKey: (key?: React.Key, detail?: DtoItem) => void;  // 추가
+  setSaveRequestValue: (saveRequestValue: SaveRequest) => void;       // 추가
+  setSaveSpinning: (spinning: boolean) => void;                       // 추가
+  callSaveApi: (request?: SaveRequest) => Promise<void>;              // 추가
+  callDeleteApi: (request?: RemoveRequest) => Promise<void>;          // 추가
+  cancelFormActive: () => void;                                       // 추가
+  setFormActive: () => void;                                          // 추가
+  setListCheckedKeys: (checkedKeys: React.Key[]) => void;             // 추가
+  setFlexGrow: (flexGlow: number) => void;                            // 추가
+}
+```
+
+#### Store.subscribe
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    listSelectedRowKey: s.listSelectedRowKey,
+    flexGrow: s.flexGrow,
+    saveRequestValue: s.saveRequestValue,
+    detail: s.detail,
+    formActive: s.formActive,
+    listCheckedKeys: s.listCheckedKeys,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+### Type 6: 트리 + 폼 (Tree + Form)
+
+**사용처**: 트리 구조 + 선택된 항목 편집
+
+**예시 파일**: `useProductCategoryStore.ts`, `useDisplayGnbMenuStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  flexGrow: number;                    // 추가
+  selectedItem?: DtoItem;              // 추가
+  saveRequestValues?: DtoItem;         // 추가
+  expandedKeys: number[] | string[];   // 추가
+  categorySearch?: boolean;            // 추가 (선택사항)
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  treeSpinning: boolean;               // listSpinning 대신
+  treeData: DtoItem[];                 // listData 대신
+  saveSpinning: boolean;               // 추가 (저장시)
+  isDirty: boolean;                    // 추가 (수정사항 체크)
+  isFormDirty: boolean;                // 추가
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  setFlexGrow: (flexGlow: number) => void;              // 추가
+  callTreeApi: (request?: ListRequest) => Promise<void>;  // callListApi 대신
+  setSelectedItem: (item?: DtoItem) => void;             // 추가
+  setTreeData: (treeData: DtoItem[]) => void;            // 추가
+  setExpandedKeys: (expandedKeys: number[]) => void;     // 추가
+  setSaveRequestValues: (saveRequestValues: DtoItem) => void;  // 추가
+  setListRequestValue: (requestValue: ListRequest, changedValues?: ListRequest) => void;  // 추가
+  callTreeSaveApi: (treeData?: DtoItem[]) => Promise<void>;  // 추가
+  setIsDirty: (dirty: boolean) => void;                   // 추가
+}
+```
+
+#### Store.subscribe
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    flexGrow: s.flexGrow,
+    selectedItem: s.selectedItem,
+    saveRequestValues: s.saveRequestValues,
+    expandedKeys: s.expandedKeys,
+    listRequestValue: s.listRequestValue,
+    categorySearch: s.categorySearch,  // 사용시
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+### Type 7: 대시보드 (Dashboard)
+
+**사용처**: 여러 데이터 요약 + 여러 리스트
+
+**예시 파일**: `useMemberDashboardStore.ts`, `useBenefitProductStore.ts`, `useDisplayMainStore.ts`
+
+#### MetaData (다중 데이터)
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  summaryRequestValue: SummaryRequest;    // 요약 요청
+  listRequest01Value: ListRequest01;      // 리스트1 요청
+  listRequest02Value: ListRequest02;      // 리스트2 요청
+  activeTabKey: PanelType;                // 활성 탭
+  list01SortParams: AXDGSortParam[];      // 리스트1 정렬
+  list02SortParams: AXDGSortParam[];      // 리스트2 정렬
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  spinning: boolean;                      // 또는 summarySpinning
+  summaryData: DtoItem;                   // 요약 데이터
+  list01Data: AXDGDataItem<DtoItem01>[];  // 리스트1 데이터
+  list01Page: AXDGPage;
+  list02Data: AXDGDataItem<DtoItem02>[];  // 리스트2 데이터
+  list02Page: AXDGPage;
+  summarySpinning: boolean;
+  list01Spinning: boolean;
+  list02Spinning: boolean;
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  callSummaryApi: (requestValue: SummaryRequest) => Promise<void>;  // 추가
+  callList01Api: (requestValue: ListRequest01) => Promise<void>;    // 추가
+  callList02Api: (requestValue: ListRequest02) => Promise<void>;    // 추가
+  setRequestValue: (requestValue: SummaryRequest, changedValues?: SummaryRequest) => void;  // 추가
+  setRequest01Value: (requestValue: ListRequest01, changedValues?: ListRequest01) => void;  // 추가
+  setRequest02Value: (requestValue: ListRequest02, changedValues?: ListRequest02) => void;  // 추가
+  setActiveTabKey: (key: PanelType) => void;  // 추가
+  setList01SortParams: (sortParams: AXDGSortParam[]) => void;  // 추가
+  setList02SortParams: (sortParams: AXDGSortParam[]) => void;  // 추가
+  changeList01Page: (currentPage: number, pageSize?: number) => Promise<void>;  // 추가
+  changeList02Page: (currentPage: number, pageSize?: number) => Promise<void>;  // 추가
+  setListSpinning: (spinning: boolean, target?: string) => void;  // 동적 스피닝
+}
+```
+
+#### Store.subscribe
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    summaryRequestValue: s.summaryRequestValue,
+    listRequest01Value: s.listRequest01Value,
+    listRequest02Value: s.listRequest02Value,
+    activeTabKey: s.activeTabKey,
+    list01SortParams: s.list01SortParams,
+    list02SortParams: s.list02SortParams,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+### Type 8: 모달 기반 (Modal Based)
+
+**사용처**: 리스트 + 모달로 상세/작업
+
+**예시 파일**: `useB2BProductStore.ts`, `useB2BEstimateConsultingStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  listSelectedRowKey?: React.Key;
+  listCheckedIndexes?: number[];
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  selectedItem?: DtoItem;
+  detail?: DtoItem;
+  checkedRowKeys: React.Key[];
+  detailSpinning: boolean;
+  deleteSpinning: boolean;
+  modalOpen: boolean;                   // 추가
+  excelSpinning: boolean;               // 추가 (엑셀시)
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  // ... 기본 액션들
+  setDetail: (detail?: DtoItem) => void;        // 추가
+  setModalOpen: (open: boolean) => void;        // 추가
+  callDeleteApi: (id: number) => Promise<void>; // 추가
+  callExcelDownloadApi: (request?: ListRequest) => Promise<void>;  // 추가
+}
+```
+
+---
+
+### Type 9: 상태 변경 (Status Change)
+
+**사용처**: 다중 선택 후 일괄 상태 변경
+
+**예시 파일**: `useProductSingleStore.ts`, `useProductPackageStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  listSelectedRowKey?: React.Key;
+  listCheckedIndexes?: number[];
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  updateSpinning: boolean;              // 추가 (상태 변경 스피닝)
+  deleteSpinning: boolean;              // 추가 (삭제 스피닝)
+  copySpinning: boolean;                // 추가 (복사 스피닝)
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  selectedItem?: DtoItem;
+  checkedRowKeys: React.Key[];
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  // ... 기본 액션들
+  callChangeStatusApi: (changeStatus: string) => void;  // 추가
+  callDeleteApi: (selectedItems: string | React.Key[]) => void;  // 추가
+  callDataCopyApi: (prdCd: string) => Promise<void>;    // 추가
+}
+```
+
+---
+
+### Type 10: 고정값 기반 (Fixed Value Based)
+
+**사용처**: bbsNo, cntntsBbsKncd 등 고정값이 필요한 페이지
+
+**예시 파일**: `useKdhFinancialHighlightsStore.ts` (bbsNo), `useCsManualStore.ts` (cntntsBbsKncd)
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+}
+```
+
+#### States (고정값 추가)
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  bbsNo: number;                        // 추가 (고정값)
+  // 또는
+  cntntsBbsKncd: string;                // 추가 (고정값)
+  // 또는
+  reprtTpcd: string;                    // 추가 (고정값)
+  // 또는
+  langKncd: string;                     // 추가 (고정값)
+}
+```
+
+#### createState (고정값 초기화)
+```typescript
+const bbsNo = 26;  // 고정값 상수 선언
+const createState: States = {
+  bbsNo,
+  listRequestValue: {
+    bbsNo,  // listRequestValue에도 포함
+    pageNumber: 1,
+    pageSize: 100,
+  },
+  // ...
+};
+```
+
+#### Actions (고정값 사용)
+```typescript
+callListApi: async (request) => {
+  // ...
+  const response = await XXXService.postXXXList({
+    ...apiParam,
+    bbsNo: get().bbsNo,  // 고정값 사용
+    // 또는
+    cntntsBbsKncd: get().cntntsBbsKncd,
+    // 또는
+    reprtTpcd: get().reprtTpcd,
+  });
+  // ...
+}
+```
+
+---
+
+### Type 11: 전시 폼 (Display Form)
+
+**사용처**: 메인 전시 관리 등 폼 기반 구성
+
+**예시 파일**: `useDisplayMainStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  flexGrow: number;
+  activeTabId: ActiveTabId;            // 추가
+  mdiaClcd: string;                    // 추가 (미디어 코드)
+  formValues: DtoItem;                 // 추가 (폼 값)
+  formValueChanged: boolean;           // 추가 (폼 변경 여부)
+  selectedSctnTpcd?: MainDspySctnType;  // 추가
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  spinning: boolean;                   // listSpinning 대신
+}
+```
+
+#### Actions
+```typescript
+interface Actions extends PageStoreActions<States> {
+  callDetailApi: () => Promise<void>;              // 추가
+  callConfirmApi: () => Promise<void>;             // 추가
+  setFormValues: (formValues: DtoItem) => void;    // 추가
+  setActiveTabId: (activeTabId: ActiveTabId) => void;  // 추가
+  setMdiaClcd: (mdiaClcd: string) => void;         // 추가
+  setListColWidths: (colWidths: number[]) => void;
+  setListSortParams: (sortParams: AXDGSortParam[]) => void;
+  setFlexGrow: (flexGlow: number) => void;
+  setDspySortArray: (arr: MainDspySctnDspySort[]) => void;  // 추가
+  deleteSctnBanner: (sctnBanner: MainDspyBanner) => Promise<void>;  // 추가
+  setSelectedSctnTpcd: (selectedSctnTpcd?: MainDspySctnType) => void;  // 추가
+}
+```
+
+---
+
+### Type 12: 약관/정책 (Terms/Policy)
+
+**사용처**: 약관, 정책 등 상세 내용 저장
+
+**예시 파일**: `useSystemTermsConditionsStore.ts`
+
+#### MetaData
+```typescript
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  detail?: SaveRequest;                // 추가
+}
+```
+
+#### States
+```typescript
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+}
+```
+
+#### createState (detail 초기값 포함)
+```typescript
+const createState: States = {
+  listRequestValue: {
+    // ...
+  },
+  listColWidths: [],
+  listSpinning: false,
+  listData: [],
+  listPage: { currentPage: 0, totalPages: 0 },
+  listSortParams: [],
+  detail: {  // 상세 초기값
+    stplatDescCtnts: "",
+    stplatVerNo: "",
+    stplatPolicyTpcd: "",
+    dspyPdBgnDtm: "",
+    stplatSjNm: "",
+    dspyPdEndDtm: "",
+    useYn: TypeYn.Y,
+  },
+};
+```
+
+---
+
+## 3. MetaData 필드 조합표
+
+| 필드명 | 타입 | 설명 | 사용 패턴 |
+|--------|------|------|----------|
+| `programFn` | `ProgramFn \| undefined` | 프로그램 함수 참조 | **모든 패턴 필수** |
+| `listRequestValue` | `ListRequest` | 리스트 요청값 | 리스트형 패턴 (1-5, 8-10, 12) |
+| `listColWidths` | `number[]` | 컬럼 너비 배열 | 리스트형 패턴 (1-5, 8-10, 12) |
+| `listSortParams` | `AXDGSortParam[]` | 정렬 파라미터 | 리스트형 패턴 (1-5, 8-10, 12) |
+| `saveRequestValue` | `SaveRequest` | 저장/상세 요청값 | 3, 5, 12 |
+| `selectedItem` | `DtoItem \| undefined` | 선택된 아이템 | 3, 6 |
+| `listSelectedRowKey` | `React.Key \| undefined` | 선택된 행 키 | 4, 5, 8 |
+| `listCheckedIndexes` | `number[] \| undefined` | 체크된 인덱스 | 4, 8, 9 |
+| `checkedRowKeys` | `React.Key[]` | 체크된 행 키 | 3, 4, 8, 9 |
+| `listCheckedKeys` | `React.Key[]` | 체크된 키 | 5 |
+| `flexGrow` | `number` | 플렉스 성장 비율 | 5, 6, 11 |
+| `detail` | `SaveRequest \| undefined` | 상세 데이터 | 5, 12 |
+| `formActive` | `boolean` | 폼 활성화 상태 | 5 |
+| `activeTabKey` | `string` | 활성 탭 키 | 7, 11 |
+| `summaryRequestValue` | `SummaryRequest` | 요약 요청값 | 7 |
+| `listRequest01Value` | `ListRequest01` | 리스트1 요청값 | 7 |
+| `listRequest02Value` | `ListRequest02` | 리스트2 요청값 | 7 |
+| `list01SortParams` | `AXDGSortParam[]` | 리스트1 정렬 | 7 |
+| `list02SortParams` | `AXDGSortParam[]` | 리스트2 정렬 | 7 |
+| `expandedKeys` | `number[] \| string[]` | 트리 확장 키 | 6 |
+| `saveRequestValues` | `DtoItem` | 저장 요청값 (트리) | 6 |
+| `categorySearch` | `boolean` | 카테고리 검색 여부 | 6 |
+| `mdiaClcd` | `string` | 미디어 코드 | 11 |
+| `formValues` | `DtoItem` | 폼 값 | 11 |
+| `formValueChanged` | `boolean` | 폼 변경 여부 | 11 |
+| `selectedSctnTpcd` | `string` | 선택된 섹션 타입 | 11 |
+| `langKncd` | `string` | 언어 코드 | 10 |
+
+---
+
+## 4. States 필드별 초기값 패턴
+
+### 기본 States 필드
+```typescript
+interface States {
+  routePath?: string;          // 초기값: undefined
+  listSpinning: boolean;       // 초기값: false
+  listData: AXDGDataItem<DtoItem>[];  // 초기값: []
+  listPage: AXDGPage;          // 초기값: { currentPage: 0, totalPages: 0 }
+}
+```
+
+### 추가 States 필드별 초기값
+
+| 필드명 | 초기값 | 설명 |
+|--------|--------|------|
+| `listColWidths` | `[]` | 빈 배열 |
+| `listSortParams` | `[]` | 빈 배열 |
+| `listSelectedRowKey` | `""` | 빈 문자열 |
+| `checkedRowKeys` | `[]` | 빈 배열 |
+| `listCheckedIndexes` | `undefined` |
+| `listCheckedKeys` | `[]` | 빈 배열 |
+| `selectedItem` | `undefined` |
+| `detail` | `undefined` |
+| `detailLoading` | `false` |
+| `saveRequestValue` | `{}` 또는 상세 초기값 |
+| `formActive` | `false` |
+| `flexGrow` | `40`, `400`, `450` 등 (레이아웃에 따라) |
+| `expandedKeys` | `[]` |
+| `saveRequestValues` | `undefined` |
+| `categorySearch` | `false` |
+| `modalOpen` | `false` |
+| `excelSpinning` | `false` |
+| `saveSpinning` | `false` |
+| `deleteSpinning` | `false` |
+| `updateSpinning` | `false` |
+| `copySpinning` | `false` |
+| `treeSpinning` | `false` |
+| `activeTabId` | `"banner"`, `"pg1"` 등 |
+| `mdiaClcd` | `"10"` (PC) |
+| `isDirty` | `false` |
+| `isFormDirty` | `false` |
+| `formValueChanged` | `false` |
+| `statData` | `[]` |
+| `statSpinning` | `false` |
+| `bbsNo` | `26` 등 (고정값) |
+| `cntntsBbsKncd` | `"MAN"` 등 (고정값) |
+| `reprtTpcd` | `"20"` 등 (고정값) |
+| `langKncd` | `"KR"` (기본값) |
+
+### createState 초기화 패턴 예시
+
+```typescript
+const createState: States = {
+  // 1) 고정값이 있는 경우 (Type 10)
+  bbsNo: 26,
+  cntntsBbsKncd: "MAN",
+  reprtTpcd: "20",
+  langKncd: "KR",
+
+  // 2) 리스트 요청값 초기화
+  listRequestValue: {
+    pageNumber: 1,
+    pageSize: 100,
+    // 추가 검색조건...
+  },
+
+  // 3) UI 상태 초기화
+  listColWidths: [],
+  listSpinning: false,
+  listData: [],
+  listPage: { currentPage: 0, totalPages: 0 },
+  listSortParams: [],
+
+  // 4) 선택 관련 초기화
+  listSelectedRowKey: "",
+  checkedRowKeys: [],
+  listCheckedIndexes: undefined,
+
+  // 5) 스피닝 초기화
+  excelSpinning: false,
+  saveSpinning: false,
+  deleteSpinning: false,
+  updateSpinning: false,
+  copySpinning: false,
+  detailSpinning: false,
+  detailLoading: false,
+
+  // 6) 폼/상세 초기화
+  saveRequestValue: {},
+  detail: undefined,
+  selectedItem: undefined,
+  formActive: false,
+  modalOpen: false,
+
+  // 7) 트리 관련 초기화
+  treeData: [],
+  treeSpinning: false,
+  expandedKeys: [],
+
+  // 8) 대시보드 관련 초기화
+  activeTabKey: "pg1",
+  summaryData: {},
+  list01Data: [],
+  list01Page: { currentPage: 0, totalPages: 0 },
+  list02Data: [],
+  list02Page: { currentPage: 0, totalPages: 0 },
+  summarySpinning: false,
+  list01Spinning: false,
+  list02Spinning: false,
+
+  // 9) 기타 초기화
+  flexGrow: 400,
+  isDirty: false,
+  isFormDirty: false,
+  formValueChanged: false,
+};
+```
+
+---
+
+## 5. createActions 패턴별 구현
+
+### 공통 필수 액션 (모든 패턴)
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // 1) 메타데이터 동기화
+  syncMetadata: (s = createState) => set(s),
+
+  // 2) 앱 마운트 시 실행
+  onMountApp: async () => {
+    // onDidMount and store initialized
+  },
+
+  // 3) Setter들
+  setListRequestValue: (requestValues) => {
+    set({ listRequestValue: requestValues });
+    // 또는 병합 방식
+    set({
+      listRequestValue: {
+        ...get().listRequestValue,
+        ...requestValues,
+      },
+    });
+  },
+  setListColWidths: (colWidths) => set({ listColWidths: colWidths }),
+  setListSpinning: (spinning) => set({ listSpinning: spinning }),
+  setListSortParams: (sortParams) => set({ listSortParams: sortParams }),
+
+  // 4) pageStoreActions 확장 (항상 마지막에)
+  ...pageStoreActions(set, get, { createState }),
+});
+```
+
+### Type 1: 기본 리스트형 전체 구현
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  ...pageStoreActions(set, get, { createState }),
+  syncMetadata: (s = createState) => set(s),
+  onMountApp: async () => {},
+  setListRequestValue: (requestValues) => {
+    set({ listRequestValue: requestValues });
+  },
+  setListColWidths: (colWidths) => set({ listColWidths: colWidths }),
+  setListSpinning: (spinning) => set({ listSpinning: spinning }),
+  setListSortParams: (sortParams) => set({ listSortParams: sortParams }),
+
+  callListApi: async (request) => {
+    if (get().listSpinning) return;
+    set({ listSpinning: true });
+
+    try {
+      const apiParam: ListRequest = { ...get().listRequestValue, ...request };
+      const response = await XXXService.postXXXList(
+        deleteEmptyValue({ ...apiParam })
+      );
+
+      set({
+        listRequestValue: apiParam,
+        listData: response.ds.map((values) => ({ values })),
+        listPage: {
+          currentPage: response.page.pageNumber ?? 1,
+          pageSize: response.page.pageSize ?? 0,
+          totalPages: response.page.pageCount ?? 0,
+          totalElements: response.page?.totalCount,
+        },
+      });
+    } finally {
+      set({ listSpinning: false });
+    }
+  },
+
+  changeListPage: async (pageNumber, pageSize) => {
+    await get().callListApi({ pageNumber, pageSize });
+  },
+});
+```
+
+### Type 2: 엑셀 다운로드 추가
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // ... 기본 액션들
+
+  setExcelSpinning: (spinning) => set({ excelSpinning: spinning }),
+
+  callExcelDownloadApi: async (request) => {
+    if (get().excelSpinning) return;
+    set({ excelSpinning: true });
+
+    try {
+      const { pageNumber, pageSize, ...restParams }: ListRequest = {
+        ...get().listRequestValue,
+        ...request,
+      };
+
+      await XXXService.postXXXListExcel(
+        deleteEmptyValue({ ...restParams })
+      );
+    } finally {
+      set({ excelSpinning: false });
+    }
+  },
+});
+```
+
+### Type 3: 상세/폼 관련 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // ... 기본 액션들
+
+  setSelectedItem: async (selectedItem) => {
+    set({ selectedItem, detailLoading: true });
+
+    if (!selectedItem || selectedItem["__status__"] === "C") {
+      set({ saveRequestValue: {} });
+    }
+
+    await delay(300);  // 선택사항
+
+    set({ detailLoading: false });
+  },
+
+  setSaveRequestValue: (saveRequestValue) => set({ saveRequestValue }),
+
+  setCheckedRowKeys: (checkedRowKeys) => set({ checkedRowKeys }),
+});
+```
+
+### Type 4: 마스터-디테일 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // ... 기본 액션들
+
+  setListSelectedRowKey: (key) => {
+    set({ listSelectedRowKey: key });
+  },
+
+  setCheckedRowKeys: (checkedRowKeys) => set({ checkedRowKeys }),
+
+  setListCheckedIndexes: (indexes) => set({ listCheckedIndexes: indexes }),
+});
+```
+
+### Type 5: CRUD 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // ... 기본 액션들
+
+  setListSelectedRowKey: async (key, detail) => {
+    if (detail) {
+      set({ listSelectedRowKey: key, detail, saveRequestValue: { ...detail } });
+    } else {
+      set({ listSelectedRowKey: undefined, detail: undefined, saveRequestValue: undefined });
+    }
+  },
+
+  setSaveRequestValue: (saveRequestValue) => {
+    set({ saveRequestValue });
+  },
+
+  setSaveSpinning: (saveSpinning) => set({ saveSpinning: saveSpinning }),
+
+  callSaveApi: async (request) => {
+    if (get().saveSpinning) return;
+    set({ saveSpinning: true });
+
+    try {
+      const apiParam: SaveRequest = {
+        ...get().saveRequestValue,
+        ...request,
+      };
+
+      apiParam.__status__ = get().listSelectedRowKey ? "U" : "C";
+
+      const { rs } = await XXXService.postXXXSave(apiParam);
+      set({ saveRequestValue: rs, detail: rs });
+    } finally {
+      set({ saveSpinning: false });
+    }
+  },
+
+  cancelFormActive: () => {
+    set({ formActive: false, listSelectedRowKey: undefined });
+  },
+
+  setFormActive: () => {
+    set({ formActive: true, detail: undefined, saveRequestValue: undefined });
+  },
+
+  callDeleteApi: async (request) => {
+    if (get().deleteSpinning) return;
+    set({ deleteSpinning: true });
+
+    try {
+      const apiParam: RemoveRequest = {
+        ...get().saveRequestValue,
+        ...request,
+        __status__: "D",
+      };
+
+      await XXXService.postXXXDelete(apiParam);
+    } finally {
+      set({ deleteSpinning: false });
+    }
+  },
+
+  setListCheckedKeys: (checkedKeys) => {
+    set({ listCheckedKeys: checkedKeys });
+  },
+
+  setFlexGrow: (flexGlow) => {
+    set({ flexGrow: flexGlow });
+  },
+});
+```
+
+### Type 6: 트리 관련 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  onMountApp: async () => {},
+  syncMetadata: (s = createState) => set(s),
+
+  setFlexGrow: (flexGrow) => set({ flexGrow }),
+
+  callTreeApi: async (request) => {
+    set({ treeSpinning: true });
+    try {
+      // 검색어가 있으면 리스트 조회
+      if (request?.ctgrNm && request.ctgrNm !== "") {
+        const { ds: list } = await CategoryService.postCategoryListCtgr({
+          ctgrNm: request.ctgrNm,
+          pathDelim: " > ",
+        });
+        set({ listData: list, categorySearch: true });
+      } else {
+        // 없으면 트리 조회
+        const { ds: tree } = await CategoryService.postCategoryListCtgrTree({});
+        set({ treeData: tree, categorySearch: false });
+      }
+    } finally {
+      set({ treeSpinning: false });
+    }
+  },
+
+  setSelectedItem: (item) => {
+    set({ selectedItem: item, saveRequestValues: { ...item } });
+  },
+
+  setTreeData: (treeData) => {
+    set({ treeData });
+  },
+
+  setExpandedKeys: (expandedKeys) => {
+    set({ expandedKeys });
+  },
+
+  setSaveRequestValues: (saveRequestValues) => {
+    set({ saveRequestValues });
+  },
+
+  setListRequestValue: (requestValues) => {
+    set({ listRequestValue: requestValues });
+  },
+
+  setCategorySearch: (search) => set({ categorySearch: search }),
+
+  ...pageStoreActions(set, get, { createState }),
+});
+```
+
+### Type 7: 대시보드 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  syncMetadata: (s = createState) => set(s),
+  onMountApp: async () => {},
+
+  callSummaryApi: async (requestValue) => {
+    if (get().summarySpinning) return;
+    set({ summarySpinning: true });
+
+    try {
+      const apiParam: SummaryRequest = { ...get().summaryRequestValue, ...requestValue };
+      const response = await MemberService.postMemberStatsDaBdMember(
+        deleteEmptyValue({ ...apiParam })
+      );
+
+      set({ summaryData: response.rs });
+    } finally {
+      set({ summarySpinning: false });
+    }
+  },
+
+  callList01Api: async (requestValue) => {
+    if (get().list01Spinning) return;
+    set({ list01Spinning: true });
+
+    try {
+      const apiParam: ListRequest01 = { ...get().listRequest01Value, ...requestValue };
+      const response = await MemberService.postMemberListDaBdMember(
+        deleteEmptyValue({ ...apiParam })
+      );
+
+      set({
+        listRequest01Value: apiParam,
+        list01Data: response.ds.map((values) => ({ values })),
+        list01Page: {
+          currentPage: response.page.pageNumber ?? 1,
+          pageSize: response.page.pageSize ?? 0,
+          totalPages: response.page.pageCount ?? 0,
+          totalElements: response.page?.totalCount,
+        },
+      });
+    } finally {
+      set({ list01Spinning: false });
+    }
+  },
+
+  callList02Api: async (requestValue) => {
+    // callList01Api와 유사
+  },
+
+  setRequestValue: (requestValues) => set({ summaryRequestValue: requestValues }),
+  setRequest01Value: (requestValues) => set({ listRequest01Value: requestValues }),
+  setRequest02Value: (requestValues) => set({ listRequest02Value: requestValues }),
+  setActiveTabKey: (key) => set({ activeTabKey: key }),
+  setList01SortParams: (sortParams) => set({ list01SortParams: sortParams }),
+  setList02SortParams: (sortParams) => set({ list02SortParams: sortParams }),
+
+  changeList01Page: async (pageNumber, pageSize) => {
+    await get().callList01Api({ pageNumber, pageSize });
+  },
+
+  changeList02Page: async (pageNumber, pageSize) => {
+    await get().callList02Api({ pageNumber, pageSize });
+  },
+
+  setListSpinning: (spinning, target = "01") =>
+    set({ [`list${target}Spinning`]: spinning }),
+
+  ...pageStoreActions(set, get, { createState }),
+});
+```
+
+### Type 9: 상태 변경 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // ... 기본 액션들
+
+  callChangeStatusApi: async (changeStatus) => {
+    const selectedPrdCds = get().checkedRowKeys as string[];
+    if (!selectedPrdCds || selectedPrdCds.length === 0) return;
+
+    if (get().updateSpinning) return;
+    set({ updateSpinning: true });
+
+    try {
+      switch (changeStatus) {
+        case "전시":
+          await ProductService.postProductSavePrdDspyY({ prdCds: selectedPrdCds });
+          break;
+        case "비전시":
+          await ProductService.postProductSavePrdDspN({ prdCds: selectedPrdCds });
+          break;
+        case "판매중":
+          await ProductService.postProductSavePrdSleSttus10({ prdCds: selectedPrdCds });
+          break;
+        case "품절":
+          await ProductService.postProductSavePrdSleSttus20({ prdCds: selectedPrdCds });
+          break;
+        case "판매중지":
+          await ProductService.postProductSavePrdSleSttus50({ prdCds: selectedPrdCds });
+          break;
+        default:
+          console.warn("알 수 없는 상태 변경 요청:", changeStatus);
+      }
+    } finally {
+      set({ updateSpinning: false });
+    }
+  },
+
+  callDeleteApi: async (selectedItems) => {
+    if (get().deleteSpinning) return;
+    set({ deleteSpinning: true });
+
+    try {
+      const apiParam = Array.isArray(selectedItems)
+        ? { prdCds: selectedItems as string[] }
+        : { prdCd: selectedItems };
+
+      await ProductService.postProductDeletePrd(apiParam);
+      get().setCheckedRowKeys([]);
+    } finally {
+      set({ deleteSpinning: false });
+    }
+  },
+
+  callDataCopyApi: async (prdCd) => {
+    if (get().copySpinning) return;
+    set({ copySpinning: true });
+
+    try {
+      const response = await ProductService.postProductCopyPrd({ prdCd });
+      const copiedData = response.rs;
+
+      set({ selectedItem: { ...copiedData, __status__: "D" } });
+    } finally {
+      set({ copySpinning: false });
+    }
+  },
+});
+```
+
+### Type 10: 고정값 사용 액션
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  syncMetadata: (s = createState) => set(s),
+  onMountApp: async () => {},
+  setListRequestValue: (requestValues) => {
+    set({
+      listRequestValue: {
+        ...get().listRequestValue,
+        ...requestValues,
+      },
+    });
+  },
+  setListColWidths: (colWidths) => set({ listColWidths: colWidths }),
+  setListSpinning: (spinning) => set({ listSpinning: spinning }),
+  setListSortParams: (sortParams) => set({ listSortParams: sortParams }),
+
+  callListApi: async (request) => {
+    if (get().listSpinning) return;
+    set({ listSpinning: true });
+
+    try {
+      const apiParam: ListRequest = {
+        ...get().listRequestValue,
+        ...request,
+        bbsNo: get().bbsNo,  // 고정값 사용
+      };
+
+      const response = await BbsPostService.postBbsPostList(
+        deleteEmptyValue({ ...apiParam })
+      );
+
+      set({
+        listData: response.ds.map((values) => ({ values })),
+        listPage: {
+          currentPage: response.page.pageNumber ?? 1,
+          pageSize: response.page.pageSize ?? 0,
+          totalPages: response.page.pageCount ?? 0,
+          totalElements: response.page?.totalCount,
+        },
+      });
+    } finally {
+      set({ listSpinning: false });
+    }
+  },
+
+  changeListPage: async (pageNumber, pageSize) => {
+    await get().callListApi({ pageNumber, pageSize });
+  },
+
+  ...pageStoreActions(set, get, { createState }),
+});
+```
+
+---
+
+## 6. Store.subscribe 패턴별 구현
+
+### Type 1: 기본 (가장 일반적)
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 2: 엑셀 추가 (Type 1과 동일)
+```typescript
+// Type 1과 동일
+```
+
+### Type 3: 상세/폼 추가
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    saveRequestValue: s.saveRequestValue,  // 추가
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 4: 마스터-디테일
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    listSelectedRowKey: s.listSelectedRowKey,        // 추가
+    listCheckedIndexes: s.listCheckedIndexes,       // 선택사항
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 5: CRUD
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    listSelectedRowKey: s.listSelectedRowKey,
+    flexGrow: s.flexGrow,
+    saveRequestValue: s.saveRequestValue,
+    detail: s.detail,
+    formActive: s.formActive,
+    listCheckedKeys: s.listCheckedKeys,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 6: 트리 + 폼
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    flexGrow: s.flexGrow,
+    selectedItem: s.selectedItem,
+    saveRequestValues: s.saveRequestValues,
+    expandedKeys: s.expandedKeys,
+    listRequestValue: s.listRequestValue,
+    categorySearch: s.categorySearch,  // 선택사항
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 7: 대시보드
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    summaryRequestValue: s.summaryRequestValue,
+    listRequest01Value: s.listRequest01Value,
+    listRequest02Value: s.listRequest02Value,
+    activeTabKey: s.activeTabKey,
+    list01SortParams: s.list01SortParams,
+    list02SortParams: s.list02SortParams,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 8: 모달 기반
+```typescript
+// Type 4와 동일
+```
+
+### Type 9: 상태 변경
+```typescript
+// Type 4와 동일
+```
+
+### Type 10: 고정값
+```typescript
+// MetaData에 고정값이 없는 경우 Type 1과 동일
+```
+
+### Type 11: 전시 폼
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listColWidths: s.listColWidths,
+    listSortParams: s.listSortParams,
+    activeTabId: s.activeTabId,
+    mdiaClcd: s.mdiaClcd,
+    flexGrow: s.flexGrow,
+    formValues: s.formValues,
+    formValueChanged: s.formValueChanged,
+    selectedSctnTpcd: s.selectedSctnTpcd,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Type 12: 약관/정책
+```typescript
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    detail: s.detail,  // 추가
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+## 7. MCP-AXBoot 사용 후 수정 가이드
+
+### Step 1: MCP-AXBoot로 Store 생성
+
+```bash
+# MCP-AXBoot를 사용하여 기본 Store 생성
+mcp-axboot generate-store --interface-path="/path/to/XXXRepository.ts" --output-path="/path/to/useXXXStore.ts"
+```
+
+### Step 2: 생성된 Store 확인 및 수정
+
+#### 2.1 Type 확인 후 필요한 필드 추가
+
+MCP-AXBoot로 생성된 Store는 기본 패턴(Type 1)으로 생성됩니다. 필요한 타입에 따라 다음 필드를 추가하세요:
+
+| 추가가 필요한 경우 | 추가할 필드 |
+|------------------|------------|
+| 엑셀 다운로드 필요 | `excelSpinning`, `callExcelDownloadApi`, `setExcelSpinning` |
+| 상세/폼 필요 | `saveRequestValue`, `selectedItem`, `detailLoading`, `setSelectedItem`, `setSaveRequestValue` |
+| 마스터-디테일 | `listSelectedRowKey`, `setCheckedRowKeys`, `setListSelectedRowKey` |
+| CRUD | Type 5의 모든 필드 추가 |
+| 트리 구조 | `treeData`, `treeSpinning`, `expandedKeys`, `selectedItem`, `saveRequestValues` |
+| 대시보드 | 다중 요청/데이터/스피닝 필드 추가 |
+| 고정값 필요 | `bbsNo`, `cntntsBbsKncd` 등 추가 |
+
+#### 2.2 MetaData 수정
+
+```typescript
+// 수정 전 (MCP-AXBoot 생성 기본값)
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+}
+
+// 수정 후 (예: 상세/폼 추가)
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  saveRequestValue: SaveRequest;  // 추가
+}
+```
+
+#### 2.3 States 수정
+
+```typescript
+// 수정 전
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+}
+
+// 수정 후 (예: 상세/폼 추가)
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+  selectedItem?: DtoItem;       // 추가
+  detailLoading: boolean;        // 추가
+  checkedRowKeys: React.Key[];   // 추가
+}
+```
+
+#### 2.4 createState 수정
+
+```typescript
+// 수정 전
+const createState: States = {
+  listRequestValue: {
+    pageNumber: 1,
+    pageSize: 100,
+  },
+  listColWidths: [],
+  listSpinning: false,
+  listData: [],
+  listPage: { currentPage: 0, totalPages: 0 },
+  listSortParams: [],
+};
+
+// 수정 후 (예: 상세/폼 추가)
+const createState: States = {
+  listRequestValue: {
+    pageNumber: 1,
+    pageSize: 100,
+  },
+  listColWidths: [],
+  listSpinning: false,
+  listData: [],
+  listPage: { currentPage: 0, totalPages: 0 },
+  listSortParams: [],
+  saveRequestValue: {},          // 추가
+  selectedItem: undefined,       // 추가
+  detailLoading: false,          // 추가
+  checkedRowKeys: [],            // 추가
+};
+```
+
+#### 2.5 Actions 인터페이스 수정
+
+```typescript
+// 수정 전
+interface Actions extends PageStoreActions<States> {
+  setListRequestValue: (requestValue: ListRequest, changedValues?: ListRequest) => void;
+  setListColWidths: (colWidths: number[]) => void;
+  setListSpinning: (spinning: boolean) => void;
+  setListSortParams: (sortParams: AXDGSortParam[]) => void;
+  callListApi: (request?: ListRequest) => Promise<void>;
+  changeListPage: (currentPage: number, pageSize?: number) => Promise<void>;
+}
+
+// 수정 후 (예: 상세/폼 추가)
+interface Actions extends PageStoreActions<States> {
+  setListRequestValue: (requestValue: ListRequest, changedValues?: ListRequest) => void;
+  setListColWidths: (colWidths: number[]) => void;
+  setListSpinning: (spinning: boolean) => void;
+  setListSortParams: (sortParams: AXDGSortParam[]) => void;
+  callListApi: (request?: ListRequest) => Promise<void>;
+  changeListPage: (currentPage: number, pageSize?: number) => Promise<void>;
+  setSelectedItem: (selectedItem?: DtoItem) => Promise<void>;  // 추가
+  setSaveRequestValue: (saveRequestValue: SaveRequest) => void;  // 추가
+  setCheckedRowKeys: (checkedRowKeys: React.Key[]) => void;     // 추가
+}
+```
+
+#### 2.6 createActions 수정
+
+```typescript
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  // ... 기존 액션들
+
+  // 추가할 액션들
+  setSelectedItem: async (selectedItem) => {
+    set({ selectedItem, detailLoading: true });
+
+    if (!selectedItem || selectedItem["__status__"] === "C") {
+      set({ saveRequestValue: {} });
+    }
+
+    await delay(300);
+
+    set({ detailLoading: false });
+  },
+
+  setSaveRequestValue: (saveRequestValue) => set({ saveRequestValue }),
+  setCheckedRowKeys: (checkedRowKeys) => set({ checkedRowKeys }),
+});
+```
+
+#### 2.7 Store.subscribe 수정
+
+```typescript
+// 수정 전
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+
+// 수정 후 (예: 상세/폼 추가)
+useXXXStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+    saveRequestValue: s.saveRequestValue,  // 추가
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+### Step 3: 패턴별 체크리스트
+
+#### Type 1: 기본 리스트형
+- [ ] MetaData: 기본 4개 필드 확인
+- [ ] States: 기본 States 확인
+- [ ] Actions: 기본 6개 액션 확인
+- [ ] Store.subscribe: 기본 패턴 확인
+
+#### Type 2: 리스트 + 엑셀
+- [ ] States: `excelSpinning` 추가
+- [ ] Actions: `setExcelSpinning`, `callExcelDownloadApi` 추가
+
+#### Type 3: 리스트 + 상세/폼
+- [ ] MetaData: `saveRequestValue` 추가
+- [ ] States: `selectedItem`, `detailLoading`, `checkedRowKeys` 추가
+- [ ] Actions: `setSelectedItem`, `setSaveRequestValue`, `setCheckedRowKeys` 추가
+- [ ] Store.subscribe: `saveRequestValue` 추가
+
+#### Type 4: 마스터-디테일
+- [ ] MetaData: `listSelectedRowKey`, `listCheckedIndexes` 추가
+- [ ] States: `checkedRowKeys` 추가
+- [ ] Actions: `setListSelectedRowKey`, `setCheckedRowKeys`, `setListCheckedIndexes` 추가
+- [ ] Store.subscribe: `listSelectedRowKey`, `listCheckedIndexes` 추가
+
+#### Type 5: CRUD
+- [ ] MetaData: 모든 CRUD 필드 추가
+- [ ] States: 관련 스피닝 필드 추가
+- [ ] Actions: 저장/삭제/폼 액션 추가
+- [ ] Store.subscribe: 모든 필드 추가
+
+#### Type 6: 트리 + 폼
+- [ ] MetaData: 트리 관련 필드로 교체
+- [ ] States: `treeData`, `treeSpinning` 등으로 교체
+- [ ] Actions: 트리 액션으로 교체
+- [ ] Store.subscribe: 트리 필드로 교체
+
+#### Type 7: 대시보드
+- [ ] MetaData: 다중 요청/정렬 필드 추가
+- [ ] States: 다중 데이터/스피닝 필드 추가
+- [ ] Actions: 다중 API/페이지 액션 추가
+- [ ] Store.subscribe: 다중 필드 추가
+
+#### Type 8-12: 해당 패턴별 필드 확인
+
+---
+
+## 부록: 전체 예시
+
+### Type 1 전체 예시 (useDepartmentStore.ts)
+```typescript
+import { AXDGDataItem, AXDGPage, AXDGSortParam } from "@axboot/datagrid";
+import { pageStoreActions } from "@core/stores/pageStoreActions";
+import { PageStoreActions, StoreActions } from "@core/stores/types";
+import { deleteEmptyValue } from "@core/utils/object";
+import { ProgramFn } from "@types";
+import { PostTrtmntDeptListTrtmntDeptRequest, TrtmntDept, TrtmntDeptService } from "services";
+import { getTabStoreListener } from "stores";
+import { create } from "zustand";
+import { subscribeWithSelector } from "zustand/middleware";
+import { shallow } from "zustand/shallow";
+
+interface ListRequest extends PostTrtmntDeptListTrtmntDeptRequest {}
+interface DtoItem extends TrtmntDept {}
+
+interface MetaData {
+  programFn?: ProgramFn;
+  listRequestValue: ListRequest;
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+}
+
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  listData: AXDGDataItem<DtoItem>[];
+  listPage: AXDGPage;
+}
+
+const createState: States = {
+  listRequestValue: {
+    pageNumber: 1,
+    pageSize: 100,
+    srchwrdType: "DEPT_NM",
+  },
+  listColWidths: [],
+  listSpinning: false,
+  listData: [],
+  listPage: { currentPage: 0, totalPages: 0 },
+  listSortParams: [],
+};
+
+interface Actions extends PageStoreActions<States> {
+  setListRequestValue: (requestValue: ListRequest, changedValues?: ListRequest) => void;
+  setListColWidths: (colWidths: number[]) => void;
+  setListSpinning: (spinning: boolean) => void;
+  setListSortParams: (sortParams: AXDGSortParam[]) => void;
+  callListApi: (request?: ListRequest) => Promise<void>;
+  changeListPage: (currentPage: number, pageSize?: number) => Promise<void>;
+}
+
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  ...pageStoreActions(set, get, { createState }),
+  syncMetadata: (s = createState) => set(s),
+  onMountApp: async () => {},
+  setListRequestValue: (requestValues) => {
+    set({ listRequestValue: requestValues });
+  },
+  setListColWidths: (colWidths) => set({ listColWidths: colWidths }),
+  setListSpinning: (spinning) => set({ listSpinning: spinning }),
+  setListSortParams: (sortParams) => set({ listSortParams: sortParams }),
+  callListApi: async (request) => {
+    if (get().listSpinning) return;
+    set({ listSpinning: true });
+
+    try {
+      const apiParam: ListRequest = { ...get().listRequestValue, ...request };
+      const response = await TrtmntDeptService.postTrtmntDeptListTrtmntDept(
+        deleteEmptyValue({ ...apiParam })
+      );
+
+      set({
+        listRequestValue: apiParam,
+        listData: response.ds.map((values) => ({ values })),
+        listPage: {
+          currentPage: response.page.pageNumber ?? 1,
+          pageSize: response.page.pageSize ?? 0,
+          totalPages: response.page.pageCount ?? 0,
+          totalElements: response.page?.totalCount,
+        },
+      });
+    } finally {
+      set({ listSpinning: false });
+    }
+  },
+  changeListPage: async (pageNumber, pageSize) => {
+    await get().callListApi({ pageNumber, pageSize });
+  },
+});
+
+export interface departmentStore extends States, Actions, PageStoreActions<States> {}
+
+export const useDepartmentStore = create(
+  subscribeWithSelector<departmentStore>((set, get) => ({
+    ...createState,
+    ...createActions(set, get),
+  })),
+);
+
+useDepartmentStore.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listSortParams: s.listSortParams,
+    listRequestValue: s.listRequestValue,
+    listColWidths: s.listColWidths,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);
+```
+
+---
+
+*이 문서는 NH-FE-B 프로젝트의 Store 패턴을 분석하여 MCP-AXBoot로 생성된 Store를 수정할 때 참고할 수 있도록 작성되었습니다.*