@axboot-mcp/mcp-server 1.0.0

package/src/docs/NH_STORE_PATTERNS.md

@@ -0,0 +1,297 @@
+# NH Store 패턴 분석
+
+이 문서는 NH 프로젝트의 Store 파일들을 모듈별로 분석하여 중복 케이스를 제거하고 고유한 패턴만을 정리한 것입니다.
+
+## Store 패턴 유형
+
+| Type | 이름 | 설명 | 주요 States | 주요 Actions |
+|------|------|------|-------------|--------------|
+| Type 1 | 기본 리스트 + 상세 | 선택된 아이템의 상세 정보 표시, 저장/수정 지원 | selectedItem, detailLoading, saveRequestValue | setSelectedItem, callSaveApi |
+| Type 2 | 마스터-디테일 + 모달 + 삭제 | 왼쪽 리스트, 오른쪽 상세, 모달, 삭제 기능 | selectedItem, detail, detailSpinning, modalOpen | callDeleteApi |
+| Type 3 | 트리 기반 | 트리 구조 데이터, 펼치기/접기, 저장 지원 | treeData, listData, expandedKeys, selectedItem | callTreeApi, callSaveApi |
+| Type 4 | 대시보드 | 여러 개의 리스트와 요약 정보, 탭 전환 | statData, statSpinning, listData | callStatApi, callListApi |
+| Type 5 | 단순 리스트 | 최소한의 기능만 있는 단순 리스트 | listData, listSpinning, listPage | callListApi |
+| Type 6 | 재정렬 가능 리스트 | 드래그 앤 드롭으로 순서 변경 가능 | formValues, formValueChanged, setDspySortArray | setDspySortArray |
+| Type 7 | 마스터-디테일 + 모달 + 삭제 + 엑셀 | 왼쪽 리스트, 오른쪽 상세, 모달, 삭제, 엑셀 다운로드 | selectedItem, detailSpinning, modalOpen, deleteSpinning | callDeleteApi, callExcelDownloadApi |
+| Type 8 | 리스트 + 선택 + 엑셀 다운로드 | 선택 아이템, 체크박스, 엑셀 다운로드 (상세 없음) | checkedRowKeys, excelSpinning | callExcelDownloadApi |
+| Type 9 | 마스터-디테일 + 모달 + 상세조회 API | 왼쪽 리스트, 오른쪽 상세, 모달, 상세 조회 API 호출 | selectedItem, detailLoading, saveRequestValue | setSelectedItem(상세조회), callSaveApi |
+| Type 10 | 마스터-디테일 + 엑셀 다운로드 | 선택된 행 표시, 엑셀 다운로드 (상세/모달 없음) | listSelectedRowKey, excelSpinning | callExcelDownloadApi |
+| Multi-List | 다중 리스트 통합 | 여러 리스트를 하나의 Store로 통합 | mainListData, topListData, bottomListData, ... | callMainListApi, callTopListApi, ... |
+
+---
+
+## 모듈별 Store 패턴
+
+### B2B 모듈
+
+**고유 패턴:** 3개 (Type 1, Type 5, Type 7)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useB2BConsultingDeptConfigStore | Type 1 | B2B 상담 부서 설정 (상품 리스트, 파트너십 리스트 저장) |
+| useB2BEstimateConsultingStore | Type 7 | B2B 견적 상담 (삭제, 엑셀 다운로드 포함) |
+| useB2BIntroCaseStore | Type 5 | B2B 소개 케이스 (단순 리스트) |
+
+**중복 제거 대상:** useB2BPartnershipInquiryStore, useB2BProductStore, useB2BMngDeptStore → Type 5 (useB2BIntroCaseStore와 동일)
+
+---
+
+### Benefit 모듈
+
+**고유 패턴:** 4개 (Type 1, Type 4, Type 5, Type 9)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useBenefitEventStore | Type 1 | 혜택 이벤트 (상세, 저장) |
+| useBenefitProductStore | Type 4 | 혜택 상품 대시보드 (통계 데이터 + 리스트) |
+| useBenefitCouponHistoryStore | Type 5 | 혜택 쿠폰 내역 (단순 리스트) |
+| useBenefitCouponStore | Type 9 | 혜택 쿠폰 관리 (상세조회 API + 저장) |
+| useBenefitGifticonStore | Type 9 | 혜택 기프티콘 관리 (상세조회 API + 저장) |
+
+**중복 제거 대상:** useBenefitGificonHistoryStore, useBenefitLiveDealStore, useBenefitMileageDailySummaryStore, useBenefitMileageHistoryStore, useBenefitMileageUsageHistoryStore, useBenefitPointHistoryStore, useBenefitPointHurdleStore, useBenefitPointStore → Type 5 (useBenefitCouponHistoryStore와 동일)
+
+---
+
+### CS 모듈
+
+**고유 패턴:** 2개 (Type 3, Type 5)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useCsCategoryGuideStore | Type 3 | CS 카테고리 가이드 (트리 구조) |
+| useCsAsStatusStore | Type 5 | CS AS 현황 (단순 리스트) |
+
+**중복 제거 대상:** useCsConsultationStore, useCsFaqStore, useCsManualStore, useCsNavienStoryStore, useCsUserGuideStore → Type 5 (useCsAsStatusStore와 동일)
+
+---
+
+### Department 모듈
+
+**고유 패턴:** 1개 (Type 5)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useDepartmentStore | Type 5 | 부서 관리 (단순 리스트) |
+
+---
+
+### Display 모듈
+
+**고유 패턴:** 2개 (Type 5, Type 6)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useDisplayBannerMenuStore | Type 5 | 디스플레이 배너 메뉴 (단순 리스트) |
+| useDisplayMainStore | Type 6 | 디스플레이 메인 (재정렬 가능 리스트) |
+
+**중복 제거 대상:** useDisplayGnbMenuStore, useDisplayPackageRecommendedStore, useDisplayPopupMenuStore, useDisplayProductRecommendedStore, useDisplayQuickMenuStore, useDisplayToastMenuStore → Type 5 (useDisplayBannerMenuStore와 동일)
+
+---
+
+### KDH 모듈
+
+**고유 패턴:** 1개 (Type 5)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useKdhArchivePolicyStore | Type 5 | KDH 아카이브 정책 (단순 리스트) |
+
+**중복 제거 대상:** useKdhArchiveReportsStore, useKdhAuditOrgStore, useKdhAuditReportsStore, useKdhBoardActivityStore, useKdhBusinessAreaManageStore, useKdhBusinessReportsStore, useKdhCompanyHistoryManageStore, useKdhDigitalGoodsStore, useKdhDividendStatusStore, useKdhFinancialHighlightsAbroadStore, useKdhFinancialHighlightsStore, useKdhIRContactStore, useKdhMediaLibraryStore, useKdhPopupManageStore, useKdhPressReleaseStore, useKdhPrivacyPolicyStore, useKdhPublicNoticesStore, useKdhShareHolderStatusStore, useKdhShareholdersMeetingStore → Type 5 (useKdhArchivePolicyStore와 동일)
+
+---
+
+### Member 모듈
+
+**고유 패턴:** 3개 (Type 5, Type 9, Multi-List)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useMemberCompListStore | Type 5 | 회원사 리스트 (단순 리스트) |
+| useMemberListStore | Type 9 | 회원 목록 관리 (상세조회 API + 저장) |
+| useMemberDashboardStore | Multi-List | 회원 대시보드 (요약 + 리스트1 + 리스트2 통합) |
+
+**중복 제거 대상:** useMemberEmployeeStatusHistoryStore, useMemberImpossibleRegisterStore, useMemberInstallerListStore, useMemberLeaveStore → Type 5 (useMemberCompListStore와 동일)
+
+---
+
+### Navien 모듈
+
+**고유 패턴:** 1개 (Type 5)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useNavienNoticeStore | Type 5 | 네비엔 공지사항 (단순 리스트) |
+
+---
+
+### Order 모듈
+
+**고유 패턴:** 4개 (Type 5, Type 7, Type 9, Type 10)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useOrderPaymentAllStore | Type 5 | 주문 전체 조회 (단순 리스트) |
+| useOrderClaimCancelStore | Type 7 | 주문 취소 (삭제 + 엑셀 다운로드) |
+| useOrderPaymentDetailStore | Type 9 | 주문 상세 (상세조회 API + 저장) |
+| useOrderClaimRefundStore | Type 10 | 주문 환불 (엑셀 다운로드) |
+
+**중복 제거 대상:**
+- Type 5: useOrderClaimChangeStore, useOrderClaimReturnStore, useOrderEmployeePurchaseStore, useOrderInstallCounselStore, useOrderPaymentInTransitInstallStore, useOrderPaymentInTransitStore, useOrderPaymentMngStore, useOrderPaymentPaymentCompletedStore, useOrderPaymentPreparingShipmentStore, useOrderPurchaseConfirmedStore, useOrderSubscriptionConsultationStore, useOrderSubscriptionDirectRentalStore → Type 5 (useOrderPaymentAllStore와 동일)
+- Type 7: useOrderClaimChangeStore, useOrderClaimReturnStore → Type 7 (useOrderClaimCancelStore와 동일)
+
+---
+
+### Personal 모듈
+
+**고유 패턴:** 1개 (Type 5)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| usePersonalRecommendedConditionStore | Type 5 | 개인화 추천 조건 (단순 리스트) |
+
+**중복 제거 대상:** usePersonalRecommendedProductStore → Type 5 (usePersonalRecommendedConditionStore와 동일)
+
+---
+
+### Product 모듈
+
+**고유 패턴:** 3개 (Type 3, Type 5, Type 10)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useProductAdditionalCostStore | Type 5 | 상품 추가 비용 (단순 리스트) |
+| useProductCategoryStore | Type 3 | 상품 카테고리 (트리 구조) |
+| useProductMasterStore | Type 10 | 상품 마스터 (엑셀 다운로드) |
+
+**중복 제거 대상:** useProductBasicInstallationStore, useProductCardInterestPlanStore, useProductCautionNoticeStore, useProductCertifiAwardStore, useProductCommonFilterStore, useProductCommonUspStore, useProductDeliveryConfigStore, useProductDeliveryInfoStore, useProductInfoNoticeStore, useProductInstallProcessStore, useProductLabelStore, useProductNaverEpLogStore → Type 5 (useProductAdditionalCostStore와 동일)
+
+---
+
+### Biz 모듈
+
+**고유 패턴:** 1개 (Type 5)
+
+| Store 파일명 | Type | 설명 |
+|-------------|------|------|
+| useBizMemberListStore | Type 5 | 비즈니스 회원 목록 (단순 리스트) |
+
+---
+
+## 요약 통계
+
+### Type별 사용 현황
+
+| Type | 사용 모듈 수 | 대표 모듈 |
+|------|--------------|-----------|
+| Type 5 (단순 리스트) | 11개 | 전체 모듈 |
+| Type 7 (마스터-디테일 + 모달 + 삭제 + 엑셀) | 2개 | B2B, Order |
+| Type 9 (마스터-디테일 + 모달 + 상세조회 API) | 2개 | Benefit, Member |
+| Type 3 (트리 기반) | 2개 | CS, Product |
+| Type 10 (마스터-디테일 + 엑셀 다운로드) | 2개 | Order, Product |
+| Type 1 (기본 리스트 + 상세) | 2개 | B2B, Benefit |
+| Type 4 (대시보드) | 1개 | Benefit |
+| Type 6 (재정렬 가능 리스트) | 1개 | Display |
+| Multi-List (다중 리스트 통합) | 1개 | Member |
+| Type 2 (마스터-디테일 + 모달 + 삭제) | 0개 | - |
+| Type 8 (리스트 + 선택 + 엑셀 다운로드) | 0개 | - |
+
+### 모듈별 고유 패턴 수
+
+| 모듈 | 고유 패턴 수 | 사용 Type |
+|------|-------------|-----------|
+| B2B | 3개 | Type 1, 5, 7 |
+| Benefit | 4개 | Type 1, 4, 5, 9 |
+| CS | 2개 | Type 3, 5 |
+| Department | 1개 | Type 5 |
+| Display | 2개 | Type 5, 6 |
+| KDH | 1개 | Type 5 |
+| Member | 3개 | Type 5, 9, Multi-List |
+| Navien | 1개 | Type 5 |
+| Order | 4개 | Type 5, 7, 9, 10 |
+| Personal | 1개 | Type 5 |
+| Product | 3개 | Type 3, 5, 10 |
+| Biz | 1개 | Type 5 |
+
+---
+
+## Repository를 보고 Store 구현 프롬프트
+
+### MCP 도구 사용 예시
+
+```bash
+# 1. Repository 분석
+analyze_interface({
+  interfacePath: "/path/to/MemberRepository.ts"
+})
+
+# 2. 요구사항 기반 Store 생성 (자동 타입 선택)
+generate_store_from_requirements({
+  interfacePath: "/path/to/MemberRepository.ts",
+  outputPath: "/path/to/useMemberListStore.ts",
+  requirements: "회원 목록 조회하고 선택하면 상세 보이고 저장도 해줘"
+})
+
+# 3. 다중 리스트 Store 생성
+generate_multi_stores({
+  interfacePath: "/path/to/OrderRepository.ts",
+  outputPath: "/path/to/useOrderStore.ts",
+  requirements: "왼쪽 목록, 상단 디테일 목록, 하단 디테일 목록, 각 목록은 검색과 엑셀 다운로드, 하단은 체크박스",
+  baseStoreName: "useOrderStore"
+})
+```
+
+### 모듈별 Store 생성 가이드
+
+#### Type 1 (기본 리스트 + 상세) - B2B, Benefit
+```
+리스트 조회하고 선택하면 상세 보이고 저장도 해줘
+```
+
+#### Type 3 (트리 기반) - CS, Product
+```
+카테고리 트리 구조로 보여주고 저장할 수 있게 해줘
+```
+
+#### Type 4 (대시보드) - Benefit
+```
+통계 데이터와 리스트를 함께 보여줘
+```
+
+#### Type 5 (단순 리스트) - 전체 모듈
+```
+목록 조회만 해줘
+```
+
+#### Type 6 (재정렬 가능 리스트) - Display
+```
+리스트 조회하고 순서 변경할 수 있게 해줘
+```
+
+#### Type 7 (마스터-디테일 + 모달 + 삭제 + 엑셀) - B2B, Order
+```
+왼쪽에 리스트, 오른쪽에 상세, 모달로 등록하고 삭제도 하고 엑셀 다운로드도 해줘
+```
+
+#### Type 9 (마스터-디테일 + 모달 + 상세조회 API) - Benefit, Member
+```
+왼쪽에 리스트, 오른쪽에 상세, 선택하면 상세조회 API 호출하고 저장도 해줘
+```
+
+#### Type 10 (마스터-디테일 + 엑셀 다운로드) - Order, Product
+```
+리스트 조회하고 엑셀 다운로드 해줘
+```
+
+#### Multi-List (다중 리스트 통합) - Member
+```
+요약 데이터와 왼쪽 목록, 오른쪽 목록을 통합해서 보여줘
+```
+
+---
+
+## 사용되지 않는 Type
+
+- **Type 2 (마스터-디테일 + 모달 + 삭제)**: NH 프로젝트에서 사용되지 않음
+- **Type 8 (리스트 + 선택 + 엑셀 다운로드)**: NH 프로젝트에서 사용되지 않음
+
+이 Type들은 템플릿에는 존재하지만, 실제 NH 프로젝트에서는 사용되지 않는 패턴입니다.

package/src/docs/README.md

@@ -0,0 +1,216 @@
+# MCP-AXBoot 문서 인덱스
+
+> MCP-AXBoot의 모든 문서를 쉽게 찾아볼 수 있는 인덱스입니다.
+
+## 빠른 링크
+
+### 🚀 시작하기
+- [빠른 시작 가이드](./quick-start.md) - 5분 만에 MCP-AXBoot 사용법 배우기
+
+### 📖 사용 가이드
+- [요구사항 분석 가이드](./requirements-analysis-guide.md) - 자연어 요구사항 분석 방법
+- [타입 선택 가이드](./type-selection-guide.md) - 올바른 Store 타입 선택하기
+- [Store 패턴 사용 가이드](./store-patterns-usage-guide.md) - Store 패턴별 상세 가이드
+
+### 📚 레퍼런스
+- [Store 패턴 분석](./store-pattern-analysis.md) - NH-FE-B Store 패턴 분석
+- [Store 패턴 규칙](./store-patterns-rules.md) - Store 생성 규칙과 제약 조건
+
+### 💡 실전 가이드
+- [실전 예제 모음](./practical-examples.md) - 실제 프로젝트 예제 모음
+- [문제 해결 가이드](./troubleshooting.md) - 흔한 문제와 해결 방법
+
+---
+
+## 문서별 상세 설명
+
+### 빠른 시작 가이드 (quick-start.md)
+
+**대상**: MCP-AXBoot를 처음 사용하는 분
+**내용**:
+- 설치 및 설정 방법
+- 기본 사용법
+- 5분 만에 Store 만들기
+- 자주 묻는 질문
+
+**필독 시점**: MCP-AXBoot 설치 직후
+
+---
+
+### 요구사항 분석 가이드 (requirements-analysis-guide.md)
+
+**대상**: 자연어 요구사항으로 Store를 생성하려는 분
+**내용**:
+- 분석 원리와 키워드 매칭
+- 효과적인 요구사항 작성법
+- 시나리오별 예제
+- 분석 결과 해석 방법
+
+**필독 시점**: 자연어 요구사항으로 Store 생성 전
+
+---
+
+### 타입 선택 가이드 (type-selection-guide.md)
+
+**대상**: 어떤 Store 타입을 선택할지 고민인 분
+**내용**:
+- 타입 선택 결정 트리
+- 10가지 타입별 상세 비교
+- 선택 시 고려사항
+- 타입 변환 가이드
+
+**필독 시점**: Store 생성 전 타입 결정 시
+
+---
+
+### Store 패턴 사용 가이드 (store-patterns-usage-guide.md)
+
+**대상**: 생성된 Store를 수정하고 싶은 분
+**내용**:
+- 12가지 Store 타입별 패턴
+- MetaData 필드 조합표
+- States 필드별 초기값 패턴
+- createActions 패턴별 구현
+- Store.subscribe 패턴별 구현
+- MCP-AXBoot 사용 후 수정 가이드
+
+**필독 시점**: Store 생성 후 수정 시
+
+---
+
+### Store 패턴 분석 (store-pattern-analysis.md)
+
+**대상**: NH-FE-B Store 패턴을 이해하고 싶은 분
+**내용**:
+- 전체 파일 구조
+- createActions 패턴 상세 분석
+- Store.subscribe 패턴 상세 분석
+- 필드별 초기값 패턴
+
+**필독 시점**: Store 구조를 깊이 이해하고 싶을 때
+
+---
+
+### Store 패턴 규칙 (store-patterns-rules.md)
+
+**대상**: Store 생성 시 준수해야 할 규칙을 알고 싶은 분
+**내용**:
+- 필수 규칙
+- MetaData/States/Actions 제약 조건
+- 네이밍 규칙
+- 타입 제약 조건
+- 필드 조합 규칙
+- 금지 패턴
+
+**필독 시점**: Store 직접 작성 시 또는 품질 검토 시
+
+---
+
+### 실전 예제 모음 (practical-examples.md)
+
+**대상**: 실제 프로젝트 예제를 참고하고 싶은 분
+**내용**:
+- 예제 1: 회원 관리 (CRUD)
+- 예제 2: 상품 카테고리 (트리)
+- 예제 3: 주문 관리 (마스터-디테일)
+- 예제 4: 대시보드 (다중 데이터)
+- 예제 5: 배치 처리 (체크박스)
+- 예제 6: 게시판 (고정값)
+
+**필독 시점**: 유사한 기능을 구현할 때
+
+---
+
+### 문제 해결 가이드 (troubleshooting.md)
+
+**대상**: 문제가 발생하여 해결 방법을 찾는 분
+**내용**:
+- 빌드/설치 문제
+- Store 생성 문제
+- 타입 오류
+- 런타임 오류
+- 품질 개선 팁
+- 디버깅 팁
+
+**필독 시점**: 에러 발생 시 또는 문제 예방 목적
+
+---
+
+## 사용 시나리오별 추천 문서
+
+### 시나리오 1: "처음 사용해봐"
+
+1. [빠른 시작 가이드](./quick-start.md) - 설치부터 기본 사용까지
+
+### 시나리오 2: "요구사항으로 Store 만들어봐"
+
+1. [요구사항 분석 가이드](./requirements-analysis-guide.md) - 요구사항 작성법
+2. [타입 선택 가이드](./type-selection-guide.md) - 타입 결정
+
+### 시나리오 3: "생성된 Store를 수정하고 싶어"
+
+1. [Store 패턴 사용 가이드](./store-patterns-usage-guide.md) - 수정 방법
+2. [Store 패턴 규칙](./store-patterns-rules.md) - 준수 사항 확인
+
+### 시나리오 4: "비슷한 예제가 있나?"
+
+1. [실전 예제 모음](./practical-examples.md) - 시나리오별 예제 참조
+
+### 시나리오 5: "에러가 발생했어"
+
+1. [문제 해결 가이드](./troubleshooting.md) - 해결 방법 찾기
+
+### 시나리오 6: "Store 구조를 깊이 이해하고 싶어"
+
+1. [Store 패턴 분석](./store-pattern-analysis.md) - 패턴 분석
+2. [Store 패턴 규칙](./store-patterns-rules.md) - 규칙 학습
+
+---
+
+## 문서 간 관계도
+
+```
+시작
+  ↓
+[quick-start.md]
+  ↓
+요구사항 작성
+  ↓
+[requirements-analysis-guide.md] ← [type-selection-guide.md]
+  ↓                                 ↓
+Store 생성 ←→ [store-patterns-rules.md]
+  ↓
+[store-patterns-usage-guide.md]
+  ↓
+문제 발생 시 → [troubleshooting.md]
+  ↓
+[practical-examples.md] (참고용)
+
+[store-pattern-analysis.md] (이해를 돕는 레퍼런스)
+```
+
+---
+
+## 주요 키워드별 문서 맵핑
+
+| 키워드 | 관련 문서 |
+|-------|---------|
+| 설치 | quick-start |
+| 분석 | requirements-analysis-guide |
+| 타입 | type-selection-guide |
+| 수정 | store-patterns-usage-guide |
+| 규칙 | store-patterns-rules |
+| 예제 | practical-examples |
+| 에러 | troubleshooting |
+| 패턴 | store-pattern-analysis |
+
+---
+
+## 업데이트 내역
+
+문서는 프로젝트가 업데이트됨에 따라 함께 업데이트됩니다. 최신 문서를 확인하세요.
+
+**최근 업데이트**: 2025-01-12
+- docs 폴더 문서 추가
+- JSON 패턴 파일 구조화
+- 다양한 사용 가이드 추가

package/src/docs/index.ts

@@ -0,0 +1,28 @@
+export {
+  loadDocs,
+  getStoreTypeInfo,
+  getFieldCombinations,
+  getInitialValues,
+  getStoreTypeFields,
+  getMetadataFields,
+  getStatesFields,
+  getActions,
+  getSubscribeSelector,
+  getAllFields,
+  getValidationRules,
+  getForbiddenPatterns,
+  getChecklist,
+  getRequiredImports,
+  getNamingRules,
+  getImplementationRules,
+  getFieldOrder,
+  getDependencies,
+  suggestStoreType,
+  getCachedDocs,
+  isComplexRequest,
+  getComplexRequestContext,
+  getSimpleRequestContext,
+  getContextualDocumentation,
+  type DocsContent,
+  type LoadedDocs
+} from './loader.js';