master_api_sum

- 2025-12-28 고객센터 시스템 게시판 API 연동 수정 기록 - 날짜 범위 필터 초기값 변경 내용 문서화 fix: 고객센터 목록 날짜 범위 초기값 변경 - EventList, InquiryList, NoticeList 날짜 범위 초기값 빈 문자열로 변경 - 페이지 진입 시 전체 데이터 조회 가능하도록 수정 feat: 1:1 문의 댓글 기능 API 연동 - 댓글 CRUD API 함수 구현 (shared/actions.ts) - getComments, createComment, updateComment, deleteComment - CommentApiData 타입 및 transformApiToComment 변환 함수 추가 - InquiryDetail 컴포넌트 callback props 방식으로 변경 - user.id localStorage 저장으로 본인 글 수정/삭제 버튼 표시 - page.tsx에서 댓글 API 호출 및 상태 관리 feat(WEB): 게시판 시스템 Mock → API 연동 (Phase J) - BoardList: getPosts, getMyPosts API 연동 - BoardDetail: getPost API 연동, 새 라우트 구조 적용 - BoardForm: getBoards, createPost, updatePost API 연동 - 라우트 변경: /board/[id] → /board/[boardCode]/[postId] - Toast 라이브러리 sonner로 통일 - MOCK_BOARDS 완전 제거, types.ts 정리 chore: 작업 현황 업데이트 refactor: BoardForm 부서 Mock 데이터 분리 - types.ts에서 MOCK_DEPARTMENTS 제거 - BoardForm 내부에 임시 Mock 데이터 정의 - TODO: API에서 부서 목록 연동 필요 feat: 종합현황 반려 사유 입력 Dialog 추가 - 반려 시 사유 입력 Dialog 표시 - 사유 미입력 시 toast 에러 메시지 - rejectIssue 함수에 reason 파라미터 추가 feat: 고객센터 Mock → API 연동 완료 - shared/actions.ts: 공통 게시글 API 액션 추가 - shared/types.ts: 공통 타입 정의 - InquiryList: Mock → API 연동, transform 함수 추가 - FAQList: Mock → API 연동, transform 함수 추가 - 상세 페이지: API 연동 (notices, events, inquiries) - 각 types.ts: transformPost 함수 추가 fix: 고객센터 board_code 불일치 수정 - 공지사항: notice → notices - 이벤트: event → events - DB 시스템 게시판 코드와 일치하도록 수정 feat: 결재 문서 작성 파일 첨부 기능 구현 - UploadedFile 타입 추가 및 ProposalData/ExpenseReportData에 uploadedFiles 필드 추가 - uploadFiles() 함수 구현 (/api/v1/files/upload API 연동) - createApproval/updateApproval에서 파일 업로드 후 저장 처리 - ProposalForm/ExpenseReportForm에 첨부파일 UI 개선 - 기존 업로드 파일 표시 (파일 보기/삭제 기능) - 새 첨부 파일 목록 표시 및 삭제 기능 - DraftBox에서 결재자 부서/직책 정보 표시 - 문서 상세 모달에서 실제 API 데이터 표시 (목업 데이터 제거) - 수정 모드 상신 시 PATCH 메서드 사용 (405 에러 수정) feat: [mock-migration] Phase J-4 게시판 관리 Mock → API 연동 완료 - types.ts: BoardApiData, BoardExtraSettings API 타입 추가 - actions.ts: Server Actions 생성 (CRUD, 변환 함수) - index.tsx: Mock 데이터 → API 호출로 전환 - [id]/page.tsx: 상세 페이지 API 연동 - [id]/edit/page.tsx: 수정 페이지 API 연동 - new/page.tsx: 등록 페이지 API 연동 주요 정책: - /boards/tenant 엔드포인트로 테넌트 게시판만 조회 - 수정 시 board_code 전송 안함 (코드 변경 불가) - extra_settings 내 target/target_name 저장 feat: 매입유형(purchase_type) 필드 저장 기능 추가 - actions.ts: API 응답/요청에 purchase_type 매핑 추가 - PurchaseDetail.tsx: 저장 시 purchaseType 포함하도록 수정 fix(salary): 직책/직급 매핑 수정 (사원관리 기준 통일) - transformApiToFrontend: position → job_title_label (직책), rank → rank (직급) - transformApiToDetail: 동일하게 수정 - 기존 잘못된 매핑: position_label(직위) → 직책, job_title_label(직책) → 직급 feat: [mock-migration] Phase M 잔여 Mock/TODO 제거 완료 - M-1: 매입 상세 모달 MOCK_ACCOUNTS, MOCK_VENDORS → API 연동 - M-2: 직원 관리 파일 업로드 API 연동 (uploadProfileImage) - M-4: 결재 문서 생성 MOCK_EMPLOYEES 제거 → getEmployees API - M-5: 결재함/기안함 console.log 제거 → 승인/반려 API 연동 - M-6: 구독 관리 TODO 제거 → requestDataExport, cancelSubscription - M-7: 계정 정보 TODO 제거 → withdrawAccount, suspendTenant docs: 휴가관리 사용현황 동기화 수정 작업 기록 - 2025-12-26 휴가 사용현황 동기화 수정 내용 추가 - fetchUsageData 호출 추가, 부여일수 계산 수정 문서화 feat: Phase G 생산관리/품질검사 Mock → API 연동 완료 G-1 작업지시관리: - WorkOrderList: getWorkOrders, getWorkOrderStats API - WorkOrderDetail: getWorkOrderById API - WorkOrderCreate: createWorkOrder API - SalesOrderSelectModal: getSalesOrdersForWorkOrder API G-2 작업실적관리: - WorkResultList: getWorkResults, getWorkResultStats API G-3 생산대시보드: - actions.ts 생성, getDashboardData API G-4 작업자화면: - actions.ts 생성 - getMyWorkOrders, completeWorkOrder API - MaterialInputModal: getMaterialsForWorkOrder, registerMaterialInput API - ProcessDetailSection: getProcessSteps, requestInspection API G-5 품질검사: - actions.ts 생성 - InspectionList: getInspections, getInspectionStats API - InspectionDetail: getInspectionById, updateInspection API - InspectionCreate: createInspection API fix: [vacation] 휴가 사용현황 동기화 및 부여일수 계산 수정 - 승인 후 fetchUsageData() 호출 추가로 사용현황 즉시 반영 - baseVacation: 동적 totalDays → 고정 '15일' (기본 연차) - grantedVacation: 하드코딩 '0일' → Math.max(0, totalDays-15) 계산 - useCallback dependencies에 fetchUsageData 추가 feat: Phase I Excel/PDF 다운로드 API 연동 - ReceivablesStatus: 채권현황 엑셀 다운로드 API 연동 - VendorLedger: 거래처원장 목록 엑셀, 상세 PDF 다운로드 API 연동 - DailyReport: 일일일보 엑셀 다운로드 API 연동 - Blob 다운로드 패턴 및 toast 알림 적용 feat: L-2 견적 관리 Mock → API 연동 ## 변경사항 - SAMPLE_QUOTES Mock 데이터 제거 - Server Actions 생성 (CRUD + 특수 기능 14개) - QuoteManagementClient 분리 (SSR/CSR 패턴) - Quote 타입 및 변환 함수 정의 ## 추가된 API 연동 - 목록/상세/등록/수정/삭제/일괄삭제 - 최종확정/확정취소/수주전환 - PDF 생성/이메일/카카오 발송 - 견적번호 미리보기/요약 통계 feat: 공정관리 페이지 및 컴포넌트 추가 - 공정관리 목록/상세/등록/수정 페이지 구현 - ProcessListClient, ProcessDetail, ProcessForm 컴포넌트 추가 - ProcessWorkLogPreviewModal, RuleModal 추가 - MobileCard 공통 컴포넌트 추가 - WorkLogModal.tsx 개선 - .gitignore 업데이트 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> (cherry picked from commit f0c0de2ecd) chore: React 공통 컴포넌트 업데이트 - VacationManagement: API 연동 개선 - WorkOrders: 작업자 선택 모달 개선 - TypeScript 빌드 설정 업데이트 feat: I-8 휴가 정책 관리 API 연동 - actions.ts: 휴가 정책 CRUD Server Actions - LeavePolicyManagement 컴포넌트 API 연동 feat: I-7 종합분석 API 연동 - actions.ts: 종합분석 조회 Server Actions - ComprehensiveAnalysis 컴포넌트 API 연동 feat: I-6 일일 생산현황 API 연동 - actions.ts: 일일 리포트 조회 Server Actions - DailyReport 컴포넌트 API 연동 feat: I-5 미수금 현황 API 연동 - actions.ts: 미수금 조회 Server Actions - ReceivablesStatus 컴포넌트 API 연동 feat: I-4 거래통장 조회 API 연동 - actions.ts: 은행 거래내역 조회 Server Actions - BankTransactionInquiry 컴포넌트 API 연동 feat: I-3 법인카드 사용내역 API 연동 - actions.ts: 카드 거래내역 조회 Server Actions - CardTransactionInquiry 컴포넌트 API 연동 feat: I-2 거래처 원장 API 연동 - actions.ts: 거래처 원장 조회 Server Actions - VendorLedger 컴포넌트 API 연동 - VendorLedgerDetail 상세 조회 연동 feat: H-3 출하 관리 API 연동 - actions.ts: Server Actions (CRUD, 상태 변경) - ShipmentList: 출하 목록 API 연동 - ShipmentCreate: 출하 등록 API 연동 - ShipmentEdit: 출하 수정 API 연동 - ShipmentDetail: 출하 상세 API 연동 feat: G-2 작업실적 관리 API 연동 - types.ts API 타입 추가 (WorkResultApi, WorkResultStatsApi 등) - transformApiToFrontend/transformFrontendToApi 변환 함수 추가 - actions.ts 서버 액션 생성 (8개 함수) - index.ts 액션 exports 추가 Server Actions: - getWorkResults: 목록 조회 (페이징, 필터링) - getWorkResultStats: 통계 조회 - getWorkResultById: 상세 조회 - createWorkResult: 등록 - updateWorkResult: 수정 - deleteWorkResult: 삭제 - toggleInspection: 검사 상태 토글 - togglePackaging: 포장 상태 토글 fix: StockStatusList Hook 순서 오류 수정 - 조건부 return 전에 모든 Hooks(useCallback, useMemo) 선언 - React Rules of Hooks 준수 feat: H-2 재고현황 Mock → API 연동 완료 - StockStatusDetail.tsx: 상세 조회 API 연동 - StockStatusList.tsx: 목록 조회 API 연동 (이전 세션) - actions.ts: 재고 현황 Server Actions 구현 feat: H-1 입고 관리 Mock → API 연동 완료 - ReceivingDetail.tsx: 상세 조회 및 입고처리 API 연동 - ReceivingProcessDialog.tsx: 폼 데이터 API 전달 구조로 변경 - InspectionCreate.tsx: 검사 대상 목록 API 조회 적용 - ReceivingList.tsx: 미사용 타입 import 정리 feat: G-1 작업지시 관리 API 연동 - actions.ts 서버 액션 11개 함수 구현 - types.ts API 타입 및 변환 함수 추가 - index.ts 액션 함수 export 추가 Server Actions: - getWorkOrders (목록) - getWorkOrderStats (통계) - getWorkOrderById (상세) - createWorkOrder (등록) - updateWorkOrder (수정) - deleteWorkOrder (삭제) - updateWorkOrderStatus (상태변경) - assignWorkOrder (담당자배정) - toggleBendingField (벤딩토글) - addWorkOrderIssue (이슈등록) - resolveWorkOrderIssue (이슈해결) feat: I-1 미지급비용 관리 React 연동 - Server Actions 패턴으로 API 연동 구현 (actions.ts) - Mock 데이터 제거, props 기반 데이터 주입 - Server Component로 초기 데이터 로딩 - 삭제/지급일 변경 등 CRUD 액션 연동 feat: HR 모듈 API 연동 완료 및 휴가관리 버그 수정 ## 휴가관리 (VacationManagement) - 휴가 부여 API 연동: createLeaveGrant 호출 추가 - 휴가 신청 시 선택된 사원 userId 전달 (잔여휴가 오류 수정) - LeaveType 타입 분리 (VacationType과 구분) - VacationGrantDialog에 부여일(grantDate) 필드 추가 ## 근태관리 (AttendanceManagement) - actions.ts 추가: API 호출 함수 분리 - 타입 정의 확장 및 개선 ## 기타 개선 - CardManagement, SalaryManagement: actions 개선 - DocumentCreate: 전자결재 actions 및 index 개선 - GoogleMap: 지도 컴포넌트 개선 feat: Phase E 인사관리 Mock → API 마이그레이션 - E-1 법인카드 관리 API 연동 - actions.ts 생성 (getCards, createCard, updateCard, deleteCard, toggleCardStatus) - CardForm, 페이지 컴포넌트 API 연동 - E-2 급여 관리 API 연동 - actions.ts 생성 (getSalaries, getSalary, updateSalaryStatus, bulkUpdateSalaryStatus) - 급여 목록 컴포넌트 API 연동 - 결재 시스템 actions.ts 추가 (ApprovalBox, DraftBox, ReferenceBox, DocumentCreate) - DepositManagement actions.ts 페이지네이션 응답 구조 수정 - 부서 관리, 휴가 관리 actions.ts 개선 - API URL에 /api prefix 추가 회계 및 설정 모듈 리팩토링: actions 분리, 타입 정의 개선 feat: 휴가 부여현황 Mock 데이터 제거 및 API 연동 - getLeaveGrants, createLeaveGrant, deleteLeaveGrant API 함수 추가 - LeaveGrantType, LeaveGrantRecord, CreateLeaveGrantRequest 타입 추가 - generateGrantData Mock 함수 제거 - fetchGrantData로 실제 API 호출 - grantData 상태를 API 데이터로 갱신 feat: 휴가 사용현황 Mock 데이터 제거 및 API 연동 - getLeaveBalances() API 함수 추가 - LeaveBalanceRecord, GetLeaveBalancesParams 타입 정의 - generateUsageData() Mock 함수 제거 - fetchUsageData()로 실제 API 호출 - hireDate 날짜 포맷팅 예외 처리 추가 feat: C-4 부서 관리 Mock → API 연동 - actions.ts 생성 (getDepartmentTree, createDepartment, updateDepartment, deleteDepartment, deleteDepartmentsMany) - index.tsx Mock 데이터 제거 및 API 연동 - 트리 구조 CRUD 완전 연동 ⚠️ .env.local에 API_URL=https://api.sam.kr/api 설정 필요 (Server Actions용) feat: C-3 휴가 관리 Mock → API 연동 - actions.ts 생성: getLeaves, createLeave, approveLeave, rejectLeave, cancelLeave 등 - index.tsx 수정: 신청현황 탭 Mock 데이터 → API 호출 전환 - 일괄 승인/반려 API 연동 (approveLeavesMany, rejectLeavesMany) - 휴가 신청 다이얼로그 createLeave API 연동 feat: C-2 근태 관리 Mock → API 연동 - actions.ts 생성 (checkIn/checkOut/getTodayAttendance) - GoogleMap.tsx userLocation 콜백 추가 - page.tsx Mock console.log 제거 + API 연동 - 처리중 상태 및 버튼 텍스트 추가 feat: C-1 직원 관리 Mock → API 연동 - actions.ts 생성 (CRUD + 통계 + 일괄삭제 Server Actions) - utils.ts 생성 (API ↔ Frontend 데이터 변환) - index.tsx Mock 데이터 제거, API 연동 - [id]/page.tsx 상세 페이지 API 연동 - [id]/edit/page.tsx 수정 페이지 API 연동 - new/page.tsx 등록 페이지 API 연동 API Endpoints: - GET/POST /api/v1/employees - GET/PATCH/DELETE /api/v1/employees/{id} - POST /api/v1/employees/bulk-delete - GET /api/v1/employees/stats feat: Daum 우편번호 서비스 연동 및 악성채권 UI 개선 - useDaumPostcode 공통 훅 생성 (Daum Postcode API 연동) - 우편번호 찾기 기능 적용: 악성채권, 거래처, 직원, 회사정보, 주문등록 - 악성채권 페이지 토글 순서 변경 (라벨 → 토글) - 악성채권 토글 기능 수정 (매출/매입 → 등록/해제) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> (cherry picked from commit 41ef0bdd86) feat: A-2 팝업 관리 Mock → API 연동 - 상세 조회 페이지: MOCK_POPUPS → getPopupById() API - 수정 페이지: MOCK_POPUPS → getPopupById() API + 로딩 상태 - PopupForm: console.log → createPopup/updatePopup Server Actions - 삭제 기능: deletePopup() API 연동 + 로딩 상태 - 데이터 변환 유틸리티 추가 (API ↔ Frontend) feat: A-1 악성채권 관리 Mock → API 연동 완료 - 상세 페이지 서버 컴포넌트 전환 ([id]/page.tsx, [id]/edit/page.tsx) - BadDebtDetail.tsx: CRUD API 연동 (createBadDebt, updateBadDebt, deleteBadDebt) - actions.ts: 메모 API 추가 (addBadDebtMemo, deleteBadDebtMemo) feat: 매입 관리 Mock → API 전환 및 세금계산서 토글 연동 - index.tsx: Mock 데이터 제거, API 데이터 로딩으로 전환 - actions.ts: getPurchases(), togglePurchaseTaxInvoice() 서버 액션 추가 - vendorOptions 빈 문자열 필터링 (Select.Item 에러 수정) feat: 매출 상세 페이지 API 연동 - 목데이터(MOCK_VENDORS, fetchSalesDetail) 제거 - getSaleById, createSale, updateSale, deleteSale API 연동 - getClients로 거래처 목록 로드 - 상태 관리 개선 (clients, isLoading, isSaving) fix: Mock 데이터를 실제 API 연동으로 복원 - 팝업 관리, 결제 내역, 구독 관리, 알림 설정 API 연동 - 입금/출금/거래처 관리 API 연동 - page.tsx를 서버 컴포넌트로 변환 - actions.ts 서버 액션 추가
2025-12-24 14:04:36 +09:00
parent 69832b4c58
commit 8af838ab55
276 changed files with 62126 additions and 7007 deletions
--- a/DOCUMENTATION-MAP.md
+++ b/DOCUMENTATION-MAP.md
@@ -0,0 +1,260 @@
+# 📚 프로젝트 문서 구조 및 인덱스
+
+> **프로젝트**: Next.js 15 + Laravel 하이브리드 아키텍처
+> **프론트엔드**: Next.js 15 App Router + React 19
+> **백엔드**: PHP Laravel
+> **작성일**: 2025-11-17
+> **목적**: 프로젝트 문서 아카이브 및 빠른 참조
+
+---
+
+## 📖 문서 분류 체계
+
+### 1. [GUIDE] - 개발 가이드
+프로젝트 개발 시 참고해야 할 표준 워크플로우 및 가이드 문서
+
+### 2. [IMPL-YYYY-MM-DD] - 구현 기록
+특정 기능 구현 과정과 결과를 시간순으로 기록한 문서
+
+### 3. [REF] - 참고 자료
+아키텍처 분석, 리서치 결과, API 요구사항 등 참고용 문서
+
+### 4. [PLAN] - 미래 계획
+향후 구현 예정이거나 검토 중인 기능에 대한 계획 문서
+
+### 5. [LEGACY] - 레거시 문서
+과거 설계안이나 폐기된 접근 방법을 기록한 문서
+
+---
+
+## 📂 [GUIDE] 개발 가이드 (4개)
+
+### CSS 및 마이그레이션
+| 파일명 | 목적 | 주요 내용 |
+|--------|------|-----------|
+| `[GUIDE] CSS-MIGRATION-WORKFLOW.md` | React → Next.js CSS 마이그레이션 표준 프로세스 | 페이지별 CSS 비교/동기화 워크플로우, 체크리스트 기반 구현 |
+| `[GUIDE] LARGE-FILE-WORKFLOW.md` | 대용량 파일(>1000줄) 작업 프로토콜 | 섹션별 분해 전략, 체계적 마이그레이션 방법론 |
+
+### 시스템 설계
+| 파일명 | 목적 | 주요 내용 |
+|--------|------|-----------|
+| `[GUIDE] ITEM-MANAGEMENT-MIGRATION.md` | 품목관리 시스템 마이그레이션 종합 가이드 | 하이브리드 아키텍처, 데이터 구조, API 연동 전략 |
+
+### 기술 문제 해결
+| 파일명 | 목적 | 주요 내용 |
+|--------|------|-----------|
+| `[GUIDE] ZOD-VALIDATION-TROUBLESHOOTING.md` | Zod 검증 라이브러리 문제 해결 | 영어 에러 메시지 문제, z.preprocess 패턴, 필수 필드 처리 |
+
+---
+
+## 🛠️ [IMPL] 구현 기록 (25개)
+
+### 2025-11-06 (1개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-06] i18n-usage-guide.md` | 다국어(i18n) 시스템 구현 |
+
+### 2025-11-07 (7개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-07] api-key-management.md` | API 키 관리 시스템 |
+| `[IMPL-2025-11-07] auth-guard-usage.md` | 인증 가드 사용 방법 |
+| `[IMPL-2025-11-07] authentication-implementation-guide.md` | 인증 시스템 구현 가이드 |
+| `[IMPL-2025-11-07] form-validation-guide.md` | 폼 검증 시스템 |
+| `[IMPL-2025-11-07] jwt-cookie-authentication-final.md` | JWT 쿠키 인증 최종 구현 |
+| `[IMPL-2025-11-07] middleware-issue-resolution.md` | 미들웨어 이슈 해결 |
+| `[IMPL-2025-11-07] route-protection-architecture.md` | 라우트 보호 아키텍처 |
+| `[IMPL-2025-11-07] seo-bot-blocking-configuration.md` | SEO 봇 차단 설정 |
+
+### 2025-11-10 (2개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-10] dashboard-integration-complete.md` | 대시보드 통합 완료 |
+| `[IMPL-2025-11-10] token-management-guide.md` | 토큰 관리 시스템 |
+
+### 2025-11-11 (5개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-11] api-route-type-safety.md` | API 라우트 타입 안전성 |
+| `[IMPL-2025-11-11] chart-warning-fix.md` | 차트 경고 수정 |
+| `[IMPL-2025-11-11] dashboard-cleanup-summary.md` | 대시보드 정리 요약 |
+| `[IMPL-2025-11-11] error-pages-configuration.md` | 에러 페이지 설정 |
+| `[IMPL-2025-11-11] sidebar-active-menu-sync.md` | 사이드바 활성 메뉴 동기화 |
+
+### 2025-11-12 (1개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-12] modal-select-layout-shift-fix.md` | 모달 Select 레이아웃 시프트 수정 |
+
+### 2025-11-13 (3개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-13] browser-support-policy.md` | 브라우저 지원 정책 |
+| `[IMPL-2025-11-13] safari-cookie-compatibility.md` | Safari 쿠키 호환성 |
+| `[IMPL-2025-11-13] sidebar-scroll-improvements.md` | 사이드바 스크롤 개선 |
+
+### 2025-11-17 (1개)
+| 파일명 | 구현 내용 |
+|--------|-----------|
+| `[IMPL-2025-11-17] item-list-css-sync.md` | 품목 리스트 CSS 동기화 |
+
+---
+
+## 📋 [REF] 참고 자료 (14개)
+
+### 프로젝트 컨텍스트
+| 파일명 | 내용 |
+|--------|------|
+| `[REF] project-context.md` | 프로젝트 전체 컨텍스트 및 아키텍처 개요 |
+| `[REF] architecture-integration-risks.md` | 아키텍처 통합 리스크 분석 |
+| `[REF] code-quality-report.md` | 코드 품질 리포트 |
+| `[REF] communication_improvement_guide.md` | 커뮤니케이션 개선 가이드 |
+
+### API 및 백엔드
+| 파일명 | 내용 |
+|--------|------|
+| `[REF] api-requirements.md` | API 요구사항 (일반) |
+| `[REF] api-requirements-items.md` | 품목관리 API 요구사항 |
+| `[REF] api-analysis.md` | API 분석 |
+
+### 인증 및 보안 리서치
+| 파일명 | 내용 |
+|--------|------|
+| `[REF] nextjs15-middleware-authentication-research.md` | Next.js 15 미들웨어 인증 리서치 |
+| `[REF] token-security-nextjs15-research.md` | 토큰 보안 리서치 |
+
+### 마이그레이션 및 세션 관리
+| 파일명 | 내용 |
+|--------|------|
+| `[REF] dashboard-migration-summary.md` | 대시보드 마이그레이션 요약 |
+| `[REF] session-migration-backend.md` | 세션 마이그레이션 (백엔드) |
+| `[REF] session-migration-frontend.md` | 세션 마이그레이션 (프론트엔드) |
+| `[REF] session-migration-summary.md` | 세션 마이그레이션 요약 |
+
+### 컴포넌트 및 배포
+| 파일명 | 내용 |
+|--------|------|
+| `[REF] component-usage-analysis.md` | 컴포넌트 사용 분석 |
+| `[REF] nextjs-error-handling-guide.md` | Next.js 에러 핸들링 가이드 |
+| `[REF] production-deployment-checklist.md` | 프로덕션 배포 체크리스트 |
+
+---
+
+## 🚀 [PLAN] 미래 계획 (1개)
+
+| 파일명 | 계획 내용 |
+|--------|-----------|
+| `[PLAN] httponly-cookie-implementation.md` | HttpOnly 쿠키 구현 계획 |
+
+---
+
+## 📜 [LEGACY] 레거시 문서 (1개)
+
+| 파일명 | 내용 |
+|--------|------|
+| `[LEGACY] authentication-design.md` | 초기 인증 시스템 설계안 (폐기) |
+
+---
+
+## 🔍 빠른 검색 가이드
+
+### 상황별 문서 찾기
+
+#### 1. React → Next.js 마이그레이션 작업 시
+```
+[GUIDE] CSS-MIGRATION-WORKFLOW.md         # CSS 마이그레이션 표준 프로세스
+[GUIDE] LARGE-FILE-WORKFLOW.md             # 대용량 파일 작업 방법
+[GUIDE] ITEM-MANAGEMENT-MIGRATION.md       # 품목관리 시스템 전체 설계
+```
+
+#### 2. 품목관리 기능 개발 시
+```
+[REF] api-requirements-items.md            # 백엔드 API 요구사항
+[GUIDE] ITEM-MANAGEMENT-MIGRATION.md       # 시스템 아키텍처 및 데이터 구조
+[IMPL-2025-11-17] item-list-css-sync.md    # 품목 리스트 CSS 동기화 구현
+```
+
+#### 3. 인증/보안 관련 작업 시
+```
+[IMPL-2025-11-07] jwt-cookie-authentication-final.md  # JWT 쿠키 인증 구현
+[IMPL-2025-11-07] route-protection-architecture.md    # 라우트 보호
+[REF] token-security-nextjs15-research.md             # 토큰 보안 리서치
+```
+
+#### 4. 폼 검증 문제 해결 시
+```
+[GUIDE] ZOD-VALIDATION-TROUBLESHOOTING.md  # Zod 검증 문제 해결
+[IMPL-2025-11-07] form-validation-guide.md # 폼 검증 구현 가이드
+```
+
+#### 5. UI/UX 이슈 해결 시
+```
+[IMPL-2025-11-12] modal-select-layout-shift-fix.md    # 모달 레이아웃 시프트
+[IMPL-2025-11-13] safari-cookie-compatibility.md      # Safari 호환성
+[IMPL-2025-11-13] sidebar-scroll-improvements.md      # 사이드바 스크롤
+```
+
+#### 6. 배포 준비 시
+```
+[REF] production-deployment-checklist.md   # 배포 체크리스트
+[IMPL-2025-11-13] browser-support-policy.md # 브라우저 지원 정책
+[REF] code-quality-report.md               # 코드 품질 리포트
+```
+
+---
+
+## 📊 문서 통계
+
+| 카테고리 | 문서 수 | 비율 |
+|----------|---------|------|
+| [GUIDE] | 4 | 8.7% |
+| [IMPL] | 25 | 54.3% |
+| [REF] | 14 | 30.4% |
+| [PLAN] | 1 | 2.2% |
+| [LEGACY] | 1 | 2.2% |
+| [INDEX] | 1 | 2.2% |
+| **합계** | **46** | **100%** |
+
+---
+
+## 🎯 문서 작성 원칙
+
+### 1. 명명 규칙
+- **[GUIDE]**: 대문자, 하이픈으로 단어 구분
+- **[IMPL-YYYY-MM-DD]**: 구현 날짜 포함, 소문자, 하이픈 구분
+- **[REF]**: 소문자, 하이픈 구분
+
+### 2. 문서 구조
+- 명확한 목차
+- 코드 예제 포함
+- 실행 가능한 명령어
+- 트러블슈팅 섹션
+
+### 3. 유지보수
+- 구현 완료 시 즉시 [IMPL] 문서 작성
+- 워크플로우 개선 시 [GUIDE] 업데이트
+- 레거시 문서는 [LEGACY]로 이동, 삭제 금지
+
+---
+
+## 📝 문서 업데이트 이력
+
+| 날짜 | 변경 내용 |
+|------|-----------|
+| 2025-11-17 | 초기 인덱스 문서 작성 |
+| 2025-11-17 | 모든 문서 명명 규칙 통일 |
+
+---
+
+## 🔗 관련 리소스
+
+- **프로젝트 루트**: `/Users/byeongcheolryu/codebridgex/sam_project/sam-next/sma-next-project/sam-react-prod`
+- **문서 디렉토리**: `claudedocs/`
+- **React 소스**: `sma-react-v2.0/`
+- **Next.js 소스**: `src/`
+
+---
+
+**마지막 업데이트**: 2025-11-17
+**문서 버전**: 1.0.0
+**관리자**: Claude + Development Team