@axboot-mcp/mcp-server 1.0.0

package/src/docs//354/202/254/354/232/251/353/262/225//355/231/224/353/251/264/355/203/200/354/236/205/353/263/204-/352/260/234/353/260/234-/355/224/204/353/241/254/355/224/204/355/212/270-/352/260/200/354/235/264/353/223/234.md

@@ -0,0 +1,946 @@
+# 화면 타입별 개발 프롬프트 가이드
+
+AXBoot 프로젝트에서 각 화면 타입별로 최적화된 개발 프롬프트를 제공합니다. API Repository, Interface, DTO 명세를 활용하여 정확하고 효율적인 개발을 위한 상세 가이드입니다.
+
+## 프로젝트 구조 이해
+
+### API 계층 구조
+```typescript
+// 서비스 계층: /src/services/index.ts
+export const MemberService = new MemberRepository(apiWrapper);
+
+// Repository 계층: /src/services/@interface/repository/MemberRepository.ts
+export class MemberRepository extends APIRepository implements MemberInterface
+
+// Interface 계층: /src/services/@interface/interface/MemberInterface.ts
+export abstract class MemberInterface
+
+// DTO 계층: /src/services/@interface/dto/Member.ts
+export interface Member extends DefaultDto
+```
+
+### 요청/응답 패턴
+- **Request**: `Post{Domain}{Action}Request` extends 기본 DTO
+- **Response**: `Post{Domain}{Action}Response` 구조체
+- **Method**: `post{Domain}{Action}` 형태의 메서드명
+
+---
+
+## 1. 기본 목록형 (List Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} 목록 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service (예: MemberService)
+   - 목록 조회 메서드: post{도메인명}List{기능명}
+   - 엑셀 다운로드 메서드: post{도메인명}List{기능명}Excel
+   - Request DTO: Post{도메인명}List{기능명}Request
+   - Response DTO: Post{도메인명}List{기능명}Response
+
+2. **검색 폼 구성**
+   - SearchParams 컴포넌트 사용
+   - 검색 조건: {구체적인 검색 필드 나열}
+   - 날짜 범위: {필요시 지정}
+   - 상태 필터: {필요시 지정}
+
+3. **데이터 그리드 구성**
+   - 컬럼 정의: {필요한 컬럼 리스트}
+   - 정렬 기능: {정렬 가능한 컬럼}
+   - 페이지네이션: 기본 설정
+   - 체크박스 선택: {필요시}
+
+4. **액션 버튼**
+   - 조회 버튼
+   - 엑셀 다운로드 버튼
+   - {기타 필요한 버튼}
+
+**DTO 활용 정보:**
+- 기본 DTO: {기본DTO명} (예: Member)
+- 검색 조건 포함 필드: {구체적 필드명}
+- 페이지네이션: pageNumber, pageSize
+- 응답 구조: page, ds 배열
+
+**화면 경로:** {URL경로}
+**참고 화면:** {기존 유사 화면 경로}
+
+**요청사항:**
+- TypeScript 타입 안전성 확보
+- 에러 처리 및 로딩 상태 관리
+- 반응형 레이아웃 고려
+- 접근성 고려한 UI 구성
+```
+
+### 실제 사용 예시
+
+```
+회원 목록 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: MemberService
+   - 목록 조회 메서드: postMemberListMember
+   - 엑셀 다운로드 메서드: postMemberListMemberExcel
+   - Request DTO: PostMemberListMemberRequest extends MemberSearch
+   - Response DTO: PostMemberListMemberResponse { page: DataGridPageResponse, ds: MemberRes[] }
+
+2. **검색 폼 구성**
+   - SearchParams 컴포넌트 사용
+   - 검색 조건: 사용자명(usrNm), 로그인ID(usrLoginId), 이메일(usrEmailAddr), 휴대폰번호(usrHpNo)
+   - 날짜 범위: 가입일(creatDtm), 최종로그인일시(lastLoginDtm)
+   - 상태 필터: 사용자상태(usrSttusTpcd), 휴면회원여부(drmncyMberYn)
+
+3. **데이터 그리드 구성**
+   - 컬럼 정의: 사용자번호, 로그인ID, 사용자명, 이메일, 휴대폰번호, 가입일, 최종로그인일시, 상태
+   - 정렬 기능: 사용자번호, 가입일, 최종로그인일시
+   - 페이지네이션: 기본 설정 (20개씩)
+   - 체크박스 선택: 다중 선택 지원
+
+4. **액션 버튼**
+   - 조회 버튼
+   - 엑셀 다운로드 버튼
+   - 회원 상세보기 버튼
+
+**DTO 활용 정보:**
+- 기본 DTO: Member interface (54개 필드)
+- 검색 조건 포함 필드: MemberSearch 상속
+- 페이지네이션: pageNumber, pageSize
+- 응답 구조: { page: DataGridPageResponse, ds: MemberRes[] }
+
+**화면 경로:** /member/list
+**참고 화면:** 기존 회원관리 > 회원목록
+
+**요청사항:**
+- TypeScript 타입 안전성 확보
+- 에러 처리 및 로딩 상태 관리
+- 반응형 레이아웃 고려
+- 접근성 고려한 UI 구성
+```
+
+---
+
+## 2. 상세 보기형 (Detail Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} 상세 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service
+   - 상세 조회 메서드: post{도메인명}Dtl{기능명}
+   - 수정 메서드: post{도메인명}Upt{기능명}
+   - Request DTO: Post{도메인명}Dtl{기능명}Request
+   - Response DTO: Post{도메인명}Dtl{기능명}Response
+
+2. **폼 구성**
+   - 기본 정보 섹션: {필드 리스트}
+   - 상세 정보 섹션: {필드 리스트}
+   - 첨부파일 섹션: {필요시}
+   - 이력 정보 섹션: {필요시}
+
+3. **폼 컨트롤**
+   - 입력 필드: {수정 가능한 필드}
+   - 읽기 전용 필드: {수정 불가능한 필드}
+   - 선택 필드: {드롭다운, 라디오, 체크박스}
+   - 날짜 선택: {날짜 필드}
+
+4. **액션 버튼**
+   - 수정 버튼
+   - 취소 버튼
+   - 목록 돌아가기 버튼
+   - {기타 필요한 버튼}
+
+5. **유효성 검증**
+   - 필수 입력 필드: {필수 필드 리스트}
+   - 형식 검증: {이메일, 전화번호 등}
+   - 중복 검증: {필요시}
+
+**DTO 활용 정보:**
+- 기본 DTO: {기본DTO명}
+- 요청 파라미터: {키 필드명} (예: usrNo)
+- 응답 구조: { rs: {기본DTO명} }
+
+**화면 경로:** {URL경로}
+**진입 경로:** {어디서 접근하는지}
+
+**요청사항:**
+- 폼 상태 관리 (수정모드/읽기모드)
+- 변경사항 감지 및 저장 확인
+- 낙관적 잠금 처리
+- 입력 유효성 실시간 피드백
+```
+
+### 실제 사용 예시
+
+```
+회원 상세 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: MemberService
+   - 상세 조회 메서드: postMemberDtlInfoMember
+   - 수정 메서드: postMemberUptMember
+   - Request DTO: PostMemberDtlInfoMemberRequest extends MemberSearch
+   - Response DTO: PostMemberDtlInfoMemberResponse { rs: Member }
+
+2. **폼 구성**
+   - 기본 정보 섹션: 사용자번호, 로그인ID, 사용자명, 이메일주소, 휴대폰번호
+   - 상세 정보 섹션: 성별, 연령대, 가입경로, 마케팅수신동의
+   - 주소 정보 섹션: 우편번호, 기본주소, 상세주소
+   - 상태 정보 섹션: 사용자상태, 휴면회원여부, 최종로그인일시
+
+3. **폼 컨트롤**
+   - 입력 필드: 사용자명, 이메일주소, 휴대폰번호, 상세주소
+   - 읽기 전용 필드: 사용자번호, 로그인ID, 가입일, 최종로그인일시
+   - 선택 필드: 성별구분코드, 연령대구분코드, 사용자상태유형코드
+   - 체크박스: 마케팅수신동의, SMS수신동의, 이메일수신동의
+
+4. **액션 버튼**
+   - 수정 버튼
+   - 취소 버튼
+   - 목록 돌아가기 버튼
+   - 비밀번호 변경 버튼
+
+5. **유효성 검증**
+   - 필수 입력 필드: 사용자명, 이메일주소, 휴대폰번호
+   - 형식 검증: 이메일 형식, 휴대폰번호 형식
+   - 중복 검증: 이메일주소, 휴대폰번호
+
+**DTO 활용 정보:**
+- 기본 DTO: Member interface
+- 요청 파라미터: usrNo (사용자번호)
+- 응답 구조: { rs: Member }
+
+**화면 경로:** /member/detail/:usrNo
+**진입 경로:** 회원목록에서 상세보기 클릭
+
+**요청사항:**
+- 폼 상태 관리 (수정모드/읽기모드)
+- 변경사항 감지 및 저장 확인
+- 낙관적 잠금 처리
+- 입력 유효성 실시간 피드백
+```
+
+---
+
+## 3. 모달 폼형 (Modal Form Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} {동작명} 모달을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service
+   - {동작명} 메서드: post{도메인명}{동작명}{기능명}
+   - Request DTO: Post{도메인명}{동작명}{기능명}Request
+   - Response DTO: Post{도메인명}{동작명}{기능명}Response
+
+2. **모달 구성**
+   - 모달 크기: {small/medium/large/fullscreen}
+   - 제목: {모달 제목}
+   - 폼 레이아웃: {단일컬럼/2컬럼/탭형태}
+
+3. **폼 필드 구성**
+   - 입력 필드: {필드 리스트와 타입}
+   - 선택 필드: {드롭다운/라디오/체크박스 필드}
+   - 파일 업로드: {필요시}
+   - 연관 데이터 선택: {필요시}
+
+4. **모달 액션**
+   - 저장/수정 버튼
+   - 취소 버튼
+   - {기타 액션 버튼}
+
+5. **유효성 검증**
+   - 필수 입력 필드: {필수 필드}
+   - 형식 검증: {검증 규칙}
+   - 비즈니스 로직 검증: {특별한 검증 규칙}
+
+6. **모달 상태 관리**
+   - 입력 모드: {신규등록/수정/복사}
+   - 초기값 설정: {모드별 초기값}
+   - 데이터 바인딩: {기존 데이터 로드}
+
+**DTO 활용 정보:**
+- 기본 DTO: {기본DTO명}
+- 요청 구조: {Request DTO 구조}
+- 응답 구조: {Response DTO 구조}
+- 연관 DTO: {필요시 관련 DTO}
+
+**호출 위치:** {어디서 호출되는지}
+**완료 후 동작:** {저장 후 처리}
+
+**요청사항:**
+- 모달 라이프사이클 관리
+- 폼 데이터 초기화/재설정
+- 에러 핸들링 및 사용자 피드백
+- 키보드 내비게이션 지원
+```
+
+### 실제 사용 예시
+
+```
+회원 정보 수정 모달을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: MemberService
+   - 수정 메서드: postMemberUptMember
+   - Request DTO: PostMemberUptMemberRequest extends Member
+   - Response DTO: PostMemberUptMemberResponse { rs: MemberErrRes }
+
+2. **모달 구성**
+   - 모달 크기: large (800px)
+   - 제목: "회원 정보 수정"
+   - 폼 레이아웃: 2컬럼 형태
+
+3. **폼 필드 구성**
+   - 입력 필드: 사용자명(usrNm), 이메일주소(usrEmailAddr), 휴대폰번호(usrHpNo), 상세주소(dtlAddr)
+   - 선택 필드: 성별구분코드(sexdstnClcd), 사용자상태유형코드(usrSttusTpcd)
+   - 체크박스 필드: 마케팅수신동의(marktRecptnAgreYn), SMS수신(smsRecptnYn), 이메일수신(emailRecptnYn)
+   - 주소 검색: 우편번호(zipNo), 기본주소(bassAddr)
+
+4. **모달 액션**
+   - 저장 버튼
+   - 취소 버튼
+
+5. **유효성 검증**
+   - 필수 입력 필드: 사용자명, 이메일주소, 휴대폰번호
+   - 형식 검증: 이메일 형식, 휴대폰번호 형식 (01X-XXXX-XXXX)
+   - 비즈니스 로직 검증: 이메일 중복 체크
+
+6. **모달 상태 관리**
+   - 입력 모드: 수정 모드
+   - 초기값 설정: 기존 회원 데이터로 폼 초기화
+   - 데이터 바인딩: usrNo로 회원 정보 조회 후 바인딩
+
+**DTO 활용 정보:**
+- 기본 DTO: Member interface
+- 요청 구조: Member 전체 필드 포함
+- 응답 구조: { rs: MemberErrRes } (에러 정보 포함)
+- 연관 DTO: MemberRes (조회용)
+
+**호출 위치:** 회원 목록에서 수정 버튼 클릭 시
+**완료 후 동작:** 목록 새로고침, 성공 메시지 표시
+
+**요청사항:**
+- 모달 라이프사이클 관리
+- 폼 데이터 초기화/재설정
+- 에러 핸들링 및 사용자 피드백
+- 키보드 내비게이션 지원
+```
+
+---
+
+## 4. 대시보드형 (Dashboard Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} 대시보드 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service
+   - 통계 조회 메서드: post{도메인명}Stats{기능명}
+   - 목록 조회 메서드: post{도메인명}List{기능명}
+   - Request DTO: {각 API별 Request DTO}
+   - Response DTO: {각 API별 Response DTO}
+
+2. **대시보드 레이아웃**
+   - 상단 통계 카드: {통계 항목들}
+   - 차트 영역: {차트 타입과 데이터}
+   - 최근 데이터 테이블: {테이블 구성}
+   - 퀵 액션 버튼: {주요 액션들}
+
+3. **통계 카드 구성**
+   - 카드별 지표: {각 카드의 표시 내용}
+   - 전일 대비 증감: {필요시}
+   - 클릭 액션: {카드 클릭 시 동작}
+
+4. **차트 구성**
+   - 차트 라이브러리: recharts/antd charts
+   - 차트 타입: {라인/바/파이/도넛}
+   - 데이터 필터링: {기간별/카테고리별}
+   - 범례 및 툴팁: 상세 정보 표시
+
+5. **데이터 테이블**
+   - 컬럼 구성: {주요 컬럼들}
+   - 정렬 기능: {정렬 가능한 컬럼}
+   - 페이지네이션: {페이지 크기}
+   - 액션 버튼: {각 행별 액션}
+
+6. **새로고침 및 필터**
+   - 자동 새로고침: {새로고침 주기}
+   - 날짜 범위 선택: {기본 범위}
+   - 필터 옵션: {카테고리/상태 필터}
+
+**DTO 활용 정보:**
+- 통계 DTO: {통계 응답 DTO}
+- 목록 DTO: {목록 응답 DTO}
+- 필터 조건: {검색/필터 조건}
+
+**화면 경로:** {URL 경로}
+**권한 관리:** {접근 권한 수준}
+
+**요청사항:**
+- 반응형 레이아웃 (모바일 대응)
+- 실시간 데이터 업데이트
+- 로딩 상태 표시
+- 에러 상황 대응
+- 성능 최적화 (차트 렌더링)
+```
+
+### 실제 사용 예시
+
+```
+회원 관리 대시보드 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: MemberService
+   - 통계 조회 메서드: postMemberStatsDaBdMember
+   - 최근 가입 조회: postMemberListDaBdMember
+   - 최근 탈퇴 조회: postMemberListDaBdMemberSecsn
+   - Request DTO: PostMemberStatsDaBdMemberRequest extends MemberSearch
+   - Response DTO: PostMemberStatsDaBdMemberResponse { rs: MemberRes }
+
+2. **대시보드 레이아웃**
+   - 상단 통계 카드: 총 회원수, 오늘 신규가입, 오늘 탈퇴, 휴면회원수
+   - 차트 영역: 월별 가입/탈퇴 추이 라인차트, 가입경로별 파이차트
+   - 최근 데이터 테이블: 최근 가입회원 (10건), 최근 탈퇴회원 (10건)
+   - 퀵 액션 버튼: 회원등록, 회원목록, 탈퇴관리
+
+3. **통계 카드 구성**
+   - 총 회원수: 전체 활성 회원 수, 전일 대비 증감
+   - 오늘 신규가입: 금일 가입자 수, 시간별 분포
+   - 오늘 탈퇴: 금일 탈퇴자 수, 사유별 분포
+   - 휴면회원수: 휴면 상태 회원 수, 휴면 예정자 수
+
+4. **차트 구성**
+   - 라이브러리: recharts
+   - 월별 추이: 라인차트 (가입/탈퇴 이중축)
+   - 가입경로별: 도넛차트 (웹/앱/기타)
+   - 데이터 필터링: 최근 12개월, 6개월, 3개월
+   - 툴팁: 정확한 수치와 비율 표시
+
+5. **데이터 테이블**
+   - 최근 가입: 로그인ID, 사용자명, 가입일시, 가입경로
+   - 최근 탈퇴: 로그인ID, 사용자명, 탈퇴일시, 탈퇴사유
+   - 정렬: 가입일시/탈퇴일시 역순
+   - 액션: 상세보기 버튼
+
+6. **새로고침 및 필터**
+   - 자동 새로고침: 5분마다
+   - 날짜 범위: 기본 오늘, 어제, 최근 7일, 30일
+   - 필터: 가입경로별, 회원상태별
+
+**DTO 활용 정보:**
+- 통계 DTO: MemberRes (통계 필드들)
+- 목록 DTO: Member[] (기본 회원 정보)
+- 필터 조건: 날짜범위, 상태코드, 가입경로
+
+**화면 경로:** /member/dashboard
+**권한 관리:** 회원관리 읽기 권한 이상
+
+**요청사항:**
+- 반응형 레이아웃 (모바일 대응)
+- 실시간 데이터 업데이트
+- 로딩 상태 표시
+- 에러 상황 대응
+- 성능 최적화 (차트 렌더링)
+```
+
+---
+
+## 5. 트리 관리형 (Tree Management Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} 트리 관리 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service
+   - 트리 조회 메서드: post{도메인명}List{기능명}
+   - 노드 추가 메서드: post{도메인명}Add{기능명}
+   - 노드 수정 메서드: post{도메인명}Upt{기능명}
+   - 노드 삭제 메서드: post{도메인명}Del{기능명}
+   - 순서 변경 메서드: post{도메인명}UptOrder{기능명}
+
+2. **트리 구조 정의**
+   - 루트 노드: {루트 레벨 정의}
+   - 최대 깊이: {허용 깊이}
+   - 노드 타입: {노드별 타입 구분}
+   - 계층 관계: {부모-자식 관계 필드}
+
+3. **트리 컴포넌트 구성**
+   - 트리 라이브러리: antd Tree
+   - 드래그 앤 드롭: 순서/계층 변경
+   - 확장/축소: 기본 상태 설정
+   - 노드 선택: 단일/다중 선택
+   - 검색 기능: 노드명 검색
+
+4. **노드 액션**
+   - 우클릭 컨텍스트 메뉴: 추가/수정/삭제/이동
+   - 인라인 편집: {편집 가능한 필드}
+   - 순서 변경: 드래그 앤 드롭
+   - 복사/붙여넣기: {필요시}
+
+5. **폼 모달 구성**
+   - 노드 추가 모달: {추가시 필요한 필드}
+   - 노드 수정 모달: {수정시 필요한 필드}
+   - 유효성 검증: {트리 구조 검증}
+
+6. **사이드 패널/상세 영역**
+   - 선택된 노드 상세정보: {상세 정보 표시}
+   - 관련 데이터 목록: {하위 데이터}
+   - 액션 버튼: {노드별 특수 액션}
+
+**DTO 활용 정보:**
+- 트리 노드 DTO: {노드 기본 구조}
+- 계층 구조 필드: parentId, depth, sortOrder
+- 트리 관련 필드: hasChildren, expanded
+- 경로 정보: fullPath, breadcrumb
+
+**화면 경로:** {URL 경로}
+**데이터 구조:** {실제 데이터 예시}
+
+**요청사항:**
+- 트리 상태 관리 (확장/선택 상태)
+- 대용량 데이터 지연 로딩
+- 드래그 앤 드롭 제약사항 처리
+- 키보드 내비게이션 지원
+- 트리 구조 무결성 검증
+```
+
+### 실제 사용 예시
+
+```
+카테고리 관리 트리 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: CategoryService
+   - 트리 조회 메서드: postCategoryListTree
+   - 노드 추가 메서드: postCategoryAddCategory
+   - 노드 수정 메서드: postCategoryUptCategory
+   - 노드 삭제 메서드: postCategoryDelCategory
+   - 순서 변경 메서드: postCategoryUptSortOrder
+
+2. **트리 구조 정의**
+   - 루트 노드: 상품 카테고리 (depth: 0)
+   - 최대 깊이: 4단계 (대분류-중분류-소분류-세분류)
+   - 노드 타입: CATEGORY, LEAF
+   - 계층 관계: parentCategoryId, depth, sortOrder
+
+3. **트리 컴포넌트 구성**
+   - 트리 라이브러리: antd Tree
+   - 드래그 앤 드롭: 같은 레벨 내 순서 변경, 상위 카테고리로 이동
+   - 확장/축소: 1-2단계 기본 확장
+   - 노드 선택: 단일 선택
+   - 검색 기능: 카테고리명 실시간 검색
+
+4. **노드 액션**
+   - 우클릭 컨텍스트 메뉴: 하위 추가, 수정, 삭제, 위로 이동, 아래로 이동
+   - 인라인 편집: 카테고리명 더블클릭 편집
+   - 순서 변경: 동일 부모 내 드래그 앤 드롭
+   - 복사/붙여넣기: 카테고리 구조 복사
+
+5. **폼 모달 구성**
+   - 노드 추가 모달: 카테고리명, 표시명, 설명, 사용여부, 정렬순서
+   - 노드 수정 모달: 기본 정보 + 상위 카테고리 변경
+   - 유효성 검증: 중복명 체크, 순환참조 방지
+
+6. **사이드 패널/상세 영역**
+   - 선택된 카테고리 상세정보: 기본정보, 통계정보
+   - 관련 상품 목록: 해당 카테고리 상품 (상위 10개)
+   - 액션 버튼: 상품 연결, 카테고리 이미지 관리
+
+**DTO 활용 정보:**
+- 트리 노드 DTO: Category { id, name, parentId, depth, sortOrder, useYn }
+- 계층 구조 필드: parentCategoryId, depth, sortOrder
+- 트리 관련 필드: hasChildren, expanded, leaf
+- 경로 정보: categoryPath, breadcrumbs
+
+**화면 경로:** /product/category/tree
+**데이터 구조:**
+```json
+{
+  "key": "cat_001",
+  "title": "전자제품",
+  "children": [
+    {
+      "key": "cat_001_001",
+      "title": "TV/오디오",
+      "children": []
+    }
+  ]
+}
+```
+
+**요청사항:**
+- 트리 상태 관리 (확장/선택 상태)
+- 대용량 데이터 지연 로딩 (1000개 이상 노드)
+- 드래그 앤 드롭 제약사항 처리 (깊이 제한, 순환참조 방지)
+- 키보드 내비게이션 지원 (화살표, Enter, Delete)
+- 트리 구조 무결성 검증 (부모-자식 관계, 정렬순서)
+```
+
+---
+
+## 6. 인라인 편집형 (Inline Edit Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} 인라인 편집 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service
+   - 목록 조회 메서드: post{도메인명}List{기능명}
+   - 인라인 수정 메서드: post{도메인명}UptInline{기능명}
+   - 벌크 수정 메서드: post{도메인명}UptBulk{기능명}
+   - Request DTO: {각 메서드별 DTO}
+   - Response DTO: {응답 구조}
+
+2. **그리드 구성**
+   - 편집 가능한 컬럼: {인라인 편집 대상 컬럼}
+   - 읽기 전용 컬럼: {편집 불가 컬럼}
+   - 편집 컨트롤: {Input/Select/DatePicker/Switch}
+   - 체크박스 선택: 다중 행 선택
+
+3. **인라인 편집 기능**
+   - 편집 모드 진입: {클릭/더블클릭/버튼}
+   - 편집 상태 표시: {시각적 피드백}
+   - 저장 트리거: {Enter/Tab/포커스아웃}
+   - 취소 기능: {ESC/취소버튼}
+
+4. **유효성 검증**
+   - 실시간 검증: {입력 중 검증}
+   - 필수값 검증: {필수 필드}
+   - 형식 검증: {데이터 형식}
+   - 비즈니스 룰 검증: {도메인 규칙}
+
+5. **벌크 편집 기능**
+   - 다중 선택: 체크박스 선택
+   - 일괄 적용: {공통 값 적용}
+   - 일괄 저장: {선택된 행들 한번에 저장}
+   - 진행상황 표시: {저장 진행률}
+
+6. **변경사항 관리**
+   - 변경 감지: {수정된 셀 표시}
+   - 임시 저장: {로컬 상태 관리}
+   - 되돌리기: {변경사항 취소}
+   - 자동 저장: {일정 시간 후 자동 저장}
+
+**DTO 활용 정보:**
+- 기본 DTO: {기본 데이터 구조}
+- 인라인 수정 DTO: {수정할 필드들}
+- 벌크 수정 DTO: {다중 수정 구조}
+- 에러 응답: {검증 실패시 응답}
+
+**화면 경로:** {URL 경로}
+**편집 권한:** {편집 가능한 사용자 권한}
+
+**요청사항:**
+- 편집 상태 시각화 (색상, 아이콘)
+- 키보드 내비게이션 (Tab, Enter, Arrow)
+- 성능 최적화 (대용량 데이터)
+- 동시 편집 충돌 방지
+- 에러 처리 및 롤백
+```
+
+### 실제 사용 예시
+
+```
+상품 가격 관리 인라인 편집 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: ProductService
+   - 목록 조회 메서드: postProductListPrice
+   - 인라인 수정 메서드: postProductUptInlinePrice
+   - 벌크 수정 메서드: postProductUptBulkPrice
+   - Request DTO: PostProductUptInlinePriceRequest extends Product
+   - Response DTO: PostProductUptInlinePriceResponse { rs: ProductErrRes[] }
+
+2. **그리드 구성**
+   - 편집 가능한 컬럼: 판매가격(salePrice), 할인가격(discountPrice), 할인율(discountRate), 판매상태(saleStatus)
+   - 읽기 전용 컬럼: 상품코드, 상품명, 카테고리, 등록일
+   - 편집 컨트롤: 가격(NumberInput), 할인율(NumberInput %), 상태(Select)
+   - 체크박스 선택: 다중 상품 선택
+
+3. **인라인 편집 기능**
+   - 편집 모드 진입: 셀 더블클릭
+   - 편집 상태 표시: 테두리 하이라이트, 연필 아이콘
+   - 저장 트리거: Enter키 또는 다른 셀 클릭시
+   - 취소 기능: ESC키 또는 취소 아이콘
+
+4. **유효성 검증**
+   - 실시간 검증: 가격 범위 체크 (0 이상), 할인율 범위 (0-100%)
+   - 필수값 검증: 판매가격 필수입력
+   - 형식 검증: 숫자형식, 소수점 둘째자리까지
+   - 비즈니스 룰 검증: 할인가격 < 판매가격
+
+5. **벌크 편집 기능**
+   - 다중 선택: 체크박스로 상품 선택
+   - 일괄 적용: 할인율 일괄 적용, 판매상태 일괄 변경
+   - 일괄 저장: 선택된 상품들 한번에 가격 업데이트
+   - 진행상황 표시: 저장 진행률 프로그레스바
+
+6. **변경사항 관리**
+   - 변경 감지: 수정된 셀 배경색 변경 (연한 노란색)
+   - 임시 저장: 편집 중인 데이터 로컬 상태 관리
+   - 되돌리기: 행별 되돌리기 버튼
+   - 자동 저장: 편집 완료 5초 후 자동 저장
+
+**DTO 활용 정보:**
+- 기본 DTO: Product interface
+- 인라인 수정 DTO: { productId, salePrice, discountPrice, discountRate, saleStatus }
+- 벌크 수정 DTO: { productIds: number[], updateFields: Partial<Product> }
+- 에러 응답: { productId, fieldName, errorMessage }[]
+
+**화면 경로:** /product/price/inline
+**편집 권한:** 상품관리 수정 권한 이상
+
+**요청사항:**
+- 편집 상태 시각화 (색상, 아이콘)
+- 키보드 내비게이션 (Tab으로 다음 편집 가능 셀)
+- 성능 최적화 (1000개 이상 상품 데이터)
+- 동시 편집 충돌 방지 (낙관적 잠금)
+- 에러 처리 및 롤백 (실패시 원래 값으로 복원)
+```
+
+---
+
+## 7. 파일 업로드형 (File Upload Type)
+
+### 프롬프트 템플릿
+
+```
+{도메인명} 파일 업로드 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: {도메인명}Service, UploadService
+   - 파일 업로드 메서드: postUploadFile
+   - 데이터 저장 메서드: post{도메인명}Save{기능명}
+   - 파일 삭제 메서드: deleteUploadFile
+   - Request DTO: {업로드 관련 DTO}
+   - Response DTO: {업로드 응답 DTO}
+
+2. **업로드 영역 구성**
+   - 드래그 앤 드롭 영역: {업로드 방식}
+   - 파일 선택 버튼: {브라우저 다이얼로그}
+   - 파일 타입 제한: {허용 확장자}
+   - 파일 크기 제한: {최대 크기}
+   - 다중 파일 지원: {단일/다중}
+
+3. **업로드 진행 표시**
+   - 진행률 바: {개별/전체 진행률}
+   - 파일별 상태: {대기/업로드중/완료/실패}
+   - 미리보기: {이미지/문서 미리보기}
+   - 취소 기능: {업로드 중 취소}
+
+4. **파일 목록 관리**
+   - 업로드된 파일 목록: {파일명, 크기, 상태}
+   - 파일 액션: {다운로드/삭제/재업로드}
+   - 순서 변경: {드래그 앤 드롭}
+   - 파일 설명 입력: {파일별 메모}
+
+5. **유효성 검증**
+   - 파일 형식 검증: {MIME 타입 체크}
+   - 파일 크기 검증: {개별/전체 크기}
+   - 파일 개수 제한: {최대 업로드 개수}
+   - 중복 파일 검증: {동일명 체크}
+
+6. **에러 처리**
+   - 업로드 실패 처리: {재시도 옵션}
+   - 네트워크 오류: {자동 재시도}
+   - 서버 오류: {오류 메시지 표시}
+   - 부분 실패: {성공/실패 분리 표시}
+
+**DTO 활용 정보:**
+- 업로드 DTO: {파일 정보 구조}
+- 파일 메타데이터: {파일명, 크기, 타입, 경로}
+- 연관 데이터: {파일과 연결된 비즈니스 데이터}
+
+**파일 저장 위치:** {서버 저장 경로}
+**CDN 연동:** {필요시 CDN 설정}
+
+**요청사항:**
+- 대용량 파일 처리 (청크 업로드)
+- 백그라운드 업로드 지원
+- 업로드 일시정지/재개
+- 파일 압축 및 최적화
+- 보안 검증 (악성 파일 체크)
+```
+
+### 실제 사용 예시
+
+```
+상품 이미지 업로드 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: ProductService, UploadService
+   - 파일 업로드 메서드: postUploadProductImage
+   - 이미지 저장 메서드: postProductSaveImages
+   - 파일 삭제 메서드: deleteUploadProductImage
+   - Request DTO: PostUploadProductImageRequest { productId, files }
+   - Response DTO: PostUploadProductImageResponse { fileIds: string[], urls: string[] }
+
+2. **업로드 영역 구성**
+   - 드래그 앤 드롭 영역: 이미지 파일 드롭 지원
+   - 파일 선택 버튼: "이미지 선택" 버튼
+   - 파일 타입 제한: jpg, jpeg, png, webp (최대 10MB)
+   - 파일 크기 제한: 개별 10MB, 전체 50MB
+   - 다중 파일 지원: 최대 20개 이미지
+
+3. **업로드 진행 표시**
+   - 진행률 바: 개별 파일별 + 전체 진행률
+   - 파일별 상태: 대기(회색), 업로드중(파란색), 완료(초록색), 실패(빨간색)
+   - 미리보기: 썸네일 이미지 표시 (150x150)
+   - 취소 기능: 업로드 중 X 버튼으로 취소
+
+4. **파일 목록 관리**
+   - 업로드된 파일 목록: 썸네일, 파일명, 크기, 업로드 시간
+   - 파일 액션: 원본보기, 삭제, 재업로드, 메인이미지 설정
+   - 순서 변경: 드래그 앤 드롭으로 표시 순서 변경
+   - 파일 설명 입력: 이미지별 ALT 텍스트 입력
+
+5. **유효성 검증**
+   - 파일 형식 검증: 이미지 MIME 타입 체크
+   - 파일 크기 검증: 개별 10MB, 전체 50MB 제한
+   - 파일 개수 제한: 최대 20개 이미지
+   - 중복 파일 검증: 파일명 + 크기로 중복 체크
+
+6. **에러 처리**
+   - 업로드 실패 처리: "재시도" 버튼 제공
+   - 네트워크 오류: 3회 자동 재시도
+   - 서버 오류: 구체적인 오류 메시지 표시
+   - 부분 실패: 성공한 이미지와 실패한 이미지 분리 표시
+
+**DTO 활용 정보:**
+- 업로드 DTO: { productId: number, imageFiles: File[] }
+- 파일 메타데이터: { fileId, fileName, fileSize, mimeType, url, thumbnailUrl }
+- 연관 데이터: { productId, sortOrder, isMainImage, altText }
+
+**파일 저장 위치:** /uploads/products/{productId}/images/
+**CDN 연동:** AWS CloudFront 연동 (이미지 최적화)
+
+**요청사항:**
+- 대용량 파일 처리 (10MB 이상 청크 업로드)
+- 백그라운드 업로드 지원 (페이지 이동해도 계속 업로드)
+- 업로드 일시정지/재개 기능
+- 이미지 자동 리사이징 (원본, 썸네일, 중간크기)
+- 보안 검증 (이미지 헤더 검증, 악성 스크립트 체크)
+```
+
+---
+
+## 공통 개발 가이드라인
+
+### 프롬프트 작성 시 주의사항
+
+1. **구체적인 정보 제공**
+   - 정확한 서비스명과 메서드명 명시
+   - DTO 구조와 필드명 상세 기재
+   - 실제 화면 경로와 권한 정보 포함
+
+2. **API 명세 활용**
+   - `/src/services/@interface/` 경로의 실제 인터페이스 참조
+   - Request/Response DTO의 정확한 구조 확인
+   - 에러 응답 구조도 함께 명시
+
+3. **비즈니스 로직 명시**
+   - 유효성 검증 규칙 상세 기재
+   - 권한별 접근 제한사항 명시
+   - 데이터 연관관계 및 제약사항 포함
+
+4. **UX/UI 요구사항**
+   - 사용자 경험 시나리오 구체화
+   - 에러 상황 및 로딩 상태 처리 방안
+   - 키보드 접근성 및 반응형 요구사항
+
+### 개발 시 체크리스트
+
+- [ ] 서비스 import 확인 (`/src/services/index.ts`)
+- [ ] DTO 타입 정의 확인 (`/src/services/@interface/`)
+- [ ] API 메서드 시그니처 일치 확인
+- [ ] 에러 처리 및 로딩 상태 구현
+- [ ] TypeScript 타입 안전성 확보
+- [ ] 반응형 레이아웃 적용
+- [ ] 접근성 가이드라인 준수
+- [ ] 성능 최적화 (메모이제이션, 지연 로딩)
+- [ ] 테스트 코드 작성 (단위 테스트, 통합 테스트)
+
+## 8. 실제 프롬프트 검증 예시
+
+### 회원 목록 화면 개발 프롬프트 실제 적용
+
+위에서 제시한 "기본 목록형" 프롬프트 템플릿을 실제 프로젝트에 적용한 예시입니다:
+
+**생성된 프롬프트:**
+```
+회원 목록 화면을 AXBoot 프레임워크로 개발해주세요.
+
+**필수 구현 요소:**
+1. **API 연동 정보**
+   - 서비스: MemberService
+   - 목록 조회 메서드: postMemberListMember
+   - 엑셀 다운로드 메서드: postMemberListMemberExcel
+   - Request DTO: PostMemberListMemberRequest extends MemberSearch
+   - Response DTO: PostMemberListMemberResponse { page: DataGridPageResponse, ds: MemberRes[] }
+```
+
+**실제 구현된 코드 검증:**
+```typescript
+// /src/pages/resources/NH/member.list/App.tsx (실제 파일)
+import { MemberService, PntAccmlService } from "../../../../services";
+
+// Store에서 API 호출
+const callListApi = useMemberListStore((s) => s.callListApi);
+
+// 실제 사용된 서비스와 메서드명이 프롬프트와 일치함을 확인
+```
+
+**검증 결과:**
+✅ **정확도 높음**: 실제 프로젝트에서 사용하는 서비스명과 구조가 프롬프트와 일치
+✅ **적용 가능성**: 제안한 프롬프트 템플릿이 실제 개발에 바로 활용 가능
+✅ **구체성**: DTO 구조와 API 메서드명이 실제 구현과 정확히 매칭
+
+### 개선된 프롬프트 작성 가이드라인
+
+1. **정확한 서비스 참조**
+   ```typescript
+   // /src/services/index.ts에서 실제 export된 서비스명 확인
+   export const MemberService = new MemberRepository(apiWrapper);
+   ```
+
+2. **실제 DTO 구조 활용**
+   ```typescript
+   // /src/services/@interface/interface/MemberInterface.ts에서 확인
+   export interface PostMemberListMemberRequest extends MemberSearch {
+     pageNumber?: number;
+     pageSize?: number;
+   }
+   ```
+
+3. **기존 화면 패턴 분석**
+   ```typescript
+   // 기존 회원 목록 화면의 실제 구조를 참조하여 프롬프트 정확도 향상
+   import { useMemberListStore } from "./useMemberListStore";
+   ```
+
+이 가이드를 활용하여 각 화면 타입별로 정확하고 효율적인 개발 프롬프트를 작성하시기 바랍니다.