sam-react-prod/claudedocs/_index.md

claudedocs 문서 맵

프로젝트 기술 문서 인덱스 (Last Updated: 2026-02-06)

빠른 참조

문서	설명
[REF] all-pages-test-urls.md	전체 페이지 테스트 URL 목록

---

폴더 구조

claudedocs/
├── _index.md            # 이 파일 - 문서 맵
├── auth/                # 인증 & 토큰 관리
├── hr/                  # 인사관리 (부서/사원)
├── item-master/         # 품목기준관리
├── production/          # 생산관리 (생산현황판/작업자화면)
├── quality/             # 품질관리 (검사관리)
├── sales/               # 판매관리 (견적/거래처/단가)
├── accounting/          # 회계관리 (매입/매출/출금)
├── construction/        # 주일 공사 MES
├── board/               # 게시판 관리
├── settings/            # 설정 관리
├── dashboard/           # 대시보드 & 사이드바
├── security/            # 보안 & 권한
├── api/                 # API 통합
├── dev/                 # 개발도구 & 테스트
├── guides/              # 범용 가이드
├── architecture/        # 아키텍처 & 시스템
├── changes/             # 변경이력
├── vehicle/             # 차량관리
├── material/            # 자재관리
├── approval/            # 결재관리
├── customer-center/     # 고객센터
└── archive/             # 레거시/완료된 문서

---

인증 & 토큰 관리 — auth/

파일	설명
[IMPL-2025-12-30] token-refresh-caching.md	토큰 갱신 캐싱 구현 (Request Coalescing 패턴)
[IMPL-2025-12-04] signup-page-blocking.md	MVP 회원가입 페이지 차단
token-management-guide.md	Access/Refresh Token 가이드
jwt-cookie-authentication-final.md	JWT + HttpOnly Cookie 구현
auth-guard-usage.md	AuthGuard 훅 사용법
route-protection-architecture.md	라우트 보호 아키텍처
middleware-issue-resolution.md	미들웨어 이슈 해결
safari-cookie-compatibility.md	Safari 쿠키 호환성
httponly-cookie-implementation.md	HttpOnly 쿠키 구현 계획
httponly-cookie-security-validation.md	보안 검증 케이스
session-migration-*.md	세션 마이그레이션 관련
nextjs15-middleware-*.md	Next.js 15 미들웨어 연구

---

인사관리 — hr/

파일	설명
[IMPL-2025-12-16] mobile-attendance.md	모바일 출퇴근 시스템 (카카오맵 GPS)
[IMPL-2025-12-05] department-management-checklist.md	부서관리 구현 체크리스트
[IMPL-2025-12-05] employee-management-checklist.md	사원관리 구현 체크리스트
[IMPL-2025-12-06] vacation-management-checklist.md	휴가관리 구현 체크리스트

---

품목기준관리 — item-master/

파일	설명
[PLAN-2025-12-16] dynamicitemform-hook-extraction.md	DynamicItemForm 훅 분리 계획서
[FIX-2025-12-16] options-details-duplicate-bug.md	options vs item_details 중복 저장 버그
[IMPL-2025-12-15] backend-item-api-migration.md	백엔드 품목 API 통합
[DESIGN-2025-12-12] item-master-form-builder-roadmap.md	Low-Code Form Builder 로드맵
[PLAN-2025-12-08] dynamic-form-separation-plan.md	DynamicItemForm 품목별 분리 계획
[REF] item-code-hardcoding.md	품목관리 하드코딩 내역 종합
[REF] items-route-consolidation.md	품목 라우트 통합
[IMPL-2025-12-02] item-code-auto-generation.md	품목코드 자동생성 구현
[PLAN-2025-12-01] service-layer-refactoring.md	서비스 레이어 리팩토링 계획
[REF-2025-12-01] state-sync-solutions.md	상태 동기화 문제 및 해결 방안
[IMPL-2025-12-02] dynamic-item-form-rebuild.md	동적 페이지 재구현
[API-REQUEST-2025-11-28] dynamic-page-rendering-api.md	동적 페이지 렌더링 API 요청서
[PLAN-2025-11-27] item-form-component-separation.md	ItemForm 컴포넌트 분리
[IMPL-2025-11-27] realtime-sync-fixes.md	실시간 동기화 수정
[IMPL-2026-01-09] item-management-api-integration.md	품목관리 API 연동
NEXT-*.md	세션 체크포인트 (다수)
API-*.md	API 명세/요청 (다수)
ANALYSIS-*.md	분석 노트 (다수)

---

생산관리 — production/

파일	설명
[IMPL-2025-12-22] production-dashboard-checklist.md	생산 현황판 구현 체크리스트 (8 Phase)
[DESIGN-2026-01-29] worker-screen-spec.md	작업자 화면 설계 스펙
[NEXT-2025-12-22] production-session-context.md	세션 체크포인트

---

품질관리 — quality/

파일	설명
[IMPL-2025-12-23] inspection-management-checklist.md	검사관리 구현 체크리스트 (7 Phase)
[PLAN-2026-02-02] document-viewer-architecture.md	문서 뷰어 아키텍처
[PLAN-2026-02-04] quality-audit-document-management.md	품질심사 문서관리

---

판매관리 — sales/

파일	설명
[API-2025-12-08] pricing-api-enhancement-request.md	단가관리 API 개선 요청서
[IMPL-2025-12-05] pricing-management-migration.md	단가관리 마이그레이션
[API-2025-12-04] quote-api-request.md	견적관리 API 요청서
[PLAN-2025-12-04] quote-management-implementation.md	견적관리 작업계획서
[IMPL-2025-12-04] client-management-api-integration.md	거래처관리 API 연동
[API-2025-12-04] client-api-analysis.md	거래처 API 분석
[PLAN-2025-12-02] sales-pages-migration.md	판매 페이지 마이그레이션
[IMPL-2025-12-22] order-management-sales.md	수주관리
[IMPL-2026-01-12] quote-v2-test-pages-checklist.md	견적 v2 테스트 페이지
[IMPL-2025-12-09] pricing-api-integration-checklist.md	단가 API 연동 체크리스트
[NEXT-2026-02-04] price-distribution-session-context.md	단가배포 세션 체크포인트
[NEXT-2025-12-09] client-session-context.md	거래처 세션 체크포인트

---

회계관리 — accounting/

파일	설명
[IMPL-2025-12-18] vendor-management-checklist.md	거래처관리 구현 체크리스트
[IMPL-2025-12-18] purchase-management.md	매입관리 페이지 구현
[IMPL-2025-12-18] bill-management.md	어음관리
[IMPL-2025-12-18] expected-expense-checklist.md	지출예정 체크리스트
[IMPL-2025-12-18] receivables-status.md	미수금 현황
[IMPL-2025-12-18] vendor-ledger.md	거래처원장
[IMPL-2025-12-18] withdrawal-management-checklist.md	출금관리 체크리스트
[IMPL-2025-12-19] bad-debt-collection-management.md	부실채권 관리
[IMPL-2025-12-19] card-transaction-inquiry.md	카드거래 조회
[PLAN-2025-12-18] sales-management.md	매출관리 계획
[PLAN-2025-12-19] bank-account-transaction-inquiry.md	은행거래 조회 계획
[PLAN-2026-01-23] vendor-credit-analysis-modal.md	거래처 여신분석 모달

---

주일 공사 MES — construction/

파일	설명
[IMPL-2026-01-05] item-management-checklist.md	품목관리 구현 체크리스트
[IMPL-2026-01-05] category-management-checklist.md	카테고리관리 구현 체크리스트
[IMPL-2026-01-05] pricing-management-checklist.md	단가관리 구현 체크리스트
[IMPL-2026-01-09] partner-management-api-integration.md	거래처관리 API 연동
[IMPL-2026-01-09] site-management-api-integration.md	현장관리 API 연동
[IMPL-2026-01-12] project-detail-checklist.md	프로젝트 상세 체크리스트
[PLAN-2026-01-05] order-management-implementation.md	발주관리 구현 계획
[PLAN-2026-01-02] estimate-detail-form-refactoring.md	견적상세 폼 리팩토링
[PLAN-2026-01-05] order-detail-form-separation.md	발주상세 폼 분리
[REF] construction-project-flow.md	프로젝트 플로우
[REF] juil-project-structure.md	프로젝트 구조 가이드
[NEXT-2025-12-30] partner-management-session-context.md	세션 체크포인트

---

대시보드 & 사이드바 — dashboard/

파일	설명
[IMPL-2026-01-07] ceo-dashboard-checklist.md	대표님 전용 대시보드 (11개 섹션)
dashboard-integration-complete.md	대시보드 통합 완료
dashboard-cleanup-summary.md	정리 요약
dashboard-migration-summary.md	마이그레이션 요약
sidebar-active-menu-sync.md	사이드바 메뉴 동기화
sidebar-scroll-improvements.md	스크롤 개선

---

보안 & 권한 — security/

파일	설명
[PLAN-2025-01-20] permission-system-implementation.md	권한 시스템 구현 계획
[QA-2026-02-03] permission-verification-checklist.md	권한 검증 체크리스트
[PLAN-2025-12-12] tenant-data-isolation-implementation.md	테넌트 데이터 격리 구현
[SECURITY-2025-12-12] tenant-data-isolation-audit.md	테넌트 데이터 격리 감사

---

API 통합 — api/

파일	설명
api-requirements.md	API 요구사항
api-analysis.md	API 분석
api-route-type-safety.md	라우트 타입 안전성
api-key-management.md	API 키 관리

---

개발도구 & 테스트 — dev/

파일	설명
[REF] all-pages-test-urls.md	전체 페이지 테스트 URL 목록
[REF] construction-pages-test-urls.md	주일 페이지 테스트 URL
[REF] page-builder-implementation.md	페이지 빌더 구현 참조
[REF] chrome-devtools-mcp-emoji-issue.md	Chrome DevTools MCP 이모지 이슈
[PLAN] detail-page-pattern-classification.md	상세페이지 패턴 분류
[PLAN-2026-02-03] claude-config-optimization.md	Claude 설정 최적화
[IMPL-2025-12-29] quality-inspection-checklist.md	품질검사 체크리스트
[IMPL-2026-01-23] full-page-inspection.md	전체 페이지 검사
[FIX-2026-01-29] typecheck-errors-checklist.md	타입체크 에러 체크리스트
[HOTFIX-2026-01-27] E2E-테스트-수정계획서.md	E2E 테스트 수정 계획서

---

범용 가이드 — guides/

파일	설명
UI 컴포넌트
[DESIGN-2026-01-14] universal-list-component.md	UniversalListPage 설계
[IMPL-2026-01-14] universal-list-component-checklist.md	UniversalListPage 구현 체크리스트
[PLAN] universal-detail-component.md	UniversalDetail 컴포넌트 계획
[REF] UniversalListPage-QA-patterns.md	UniversalListPage QA 패턴
UniversalListPage-검색기능-수정내역.md	검색 기능 수정 내역
UniversalListPage-검색리렌더링-해결가이드.md	검색 리렌더링 해결
[DESIGN-2026-01-02] document-modal-common-component.md	문서 모달 공통 컴포넌트
badge-commonization-guide.md	배지 공통화 가이드
공통화 & 마이그레이션
[ANALYSIS-2025-12-23] common-component-extraction-candidates.md	공통 컴포넌트 추출 후보 분석
[ANALYSIS] common-component-patterns.md	공통 컴포넌트 패턴
[PLAN-2025-12-23] common-component-extraction-plan.md	공통 컴포넌트 추출 계획
[IMPL-2025-01-26] list-page-ui-standardization-checklist.md	리스트 페이지 UI 표준화
[IMPL-2026-01-23] button-navigation-checklist.md	버튼 네비게이션 체크리스트
[IMPL-2026-01-23] mode-migration-checklist.md	모드 마이그레이션 체크리스트
[IMPL-2026-01-23] mode-navigation-full-checklist.md	모드 네비게이션 전체 체크리스트
[IMPL-2026-01-21] utility-input-migration-checklist.md	유틸리티 입력 마이그레이션
[IMPL-2026-02-06] datepicker-migration-checklist.md	DatePicker 마이그레이션
[REF-2026-01-09] server-to-client-component-migration-checklist.md	Server→Client 마이그레이션
모바일
[GUIDE] mobile-responsive-patterns.md	모바일 반응형 패턴
[IMPL-2026-01-13] mobile-filter-migration-checklist.md	모바일 필터 마이그레이션
[PLAN-2026-01-20] mobile-card-infinity-scroll.md	모바일 카드 무한스크롤
[PLAN] mobile-overflow-testing.md	모바일 오버플로우 테스트
[QA-2026-01-21] mobile-infinity-scroll-inspection.md	모바일 무한스크롤 검사
[REF] mobile-zoom-fix-guide.md	모바일 줌 수정 가이드
[REF] mobile-zoom-prevention-guide.md	모바일 줌 방지 가이드
[FIX-2026-02-04] mobile-zoom-panning.md	모바일 줌 패닝 수정
[GUIDE] foldable-device-layout-fix.md	폴더블 기기 레이아웃
프로젝트 헬스 & 문서 시스템
[PLAN-2025-12-19] project-health-improvement.md	프로젝트 헬스 개선 계획
[PLAN-2025-12-19] page-layout-standardization.md	페이지 레이아웃 표준화
[PLAN-2025-01-21] document-system-integration.md	문서 시스템 통합
[QA-2025-01-21] document-system-inspection.md	문서 시스템 검사
[QA-2026-01-15] universal-list-page-inspection.md	UniversalListPage 검사
기술 가이드
[GUIDE] print-area-utility.md	인쇄 printArea 유틸리티
[GUIDE-2025-12-29] vercel-deployment.md	Vercel 배포 가이드
[GUIDE-2025-12-16] options-vs-flattened-data.md	options vs 평탄화 데이터 패턴
[GUIDE] large-file-handling-strategy.md	대용량 파일 처리 전략
[FIX-2025-12-05] radix-ui-select-controlled-mode-bug.md	Radix UI Select 버그 해결
[GUIDE] CSS-MIGRATION-WORKFLOW.md	CSS 마이그레이션 워크플로우
[GUIDE] LARGE-FILE-WORKFLOW.md	대용량 파일 작업 워크플로우
[GUIDE] ZOD-VALIDATION-TROUBLESHOOTING.md	Zod 유효성 검사 트러블슈팅
[REF] nextjs-error-handling-guide.md	Next.js 에러 처리
[REF-2026-01-07] nextjs-security-update-and-migration-plan.md	Next.js 보안 업데이트 계획
[GUIDE] collaboration-with-claude.md	Claude 협업 가이드
[IMPL-2025-11-06] i18n-usage-guide.md	다국어 사용 가이드
[IMPL-2025-11-07] form-validation-guide.md	폼 유효성 검사
[IMPL-2026-01-05] stat-cards-grid-layout.md	스탯 카드 그리드 레이아웃
[NEXT-2026-01-14] UniversalListPage-pilot-session-context.md	세션 체크포인트

---

아키텍처 & 시스템 — architecture/

파일	설명
리팩토링 로드맵
[PLAN-2026-02-06] refactoring-roadmap.md	리팩토링 종합 로드맵 (5 Phase)
[PLAN-2026-02-06] multi-tenancy-optimization-roadmap.md	멀티테넌시 최적화 로드맵 (8 Phase)
공통화 & 마이그레이션 분석
[ANALYSIS-2026-01-20] 공통화-현황-분석.md	공통화 현황 분석
[ANALYSIS-2026-02-05] SAM-ERP-MES-정체성-분석.md	SAM ERP/MES 정체성 분석
[ANALYSIS-2026-02-05] list-page-commonization-status.md	리스트 페이지 공통화 현황
컴포넌트 아키텍처
[PLAN-2026-01-22] ui-component-abstraction.md	UI 컴포넌트 추상화
[IMPL-2026-01-21] input-form-componentization.md	입력폼 컴포넌트화
[IMPL-2026-01-21] phase4-input-migration-rollout.md	Phase 4 입력 마이그레이션
[IMPL-2026-02-05] detail-hooks-migration-plan.md	상세 훅 마이그레이션
[IMPL-2026-02-05] formatter-commonization-plan.md	formatter 공통화 계획
[IMPL] IntegratedDetailTemplate-checklist.md	통합 상세 템플릿 체크리스트
[REF] template-migration-status.md	템플릿 마이그레이션 현황
시스템 설계
[PLAN-2026-01-16] layout-restructure.md	레이아웃 구조 변경
[PLAN-2025-12-29] dynamic-menu-refresh.md	동적 메뉴 갱신 시스템
[FIX-2026-01-29] masterdata-cache-tenant-isolation.md	masterData 캐시 테넌트 격리
[DESIGN-2025-12-20] item-master-zustand-refactoring.md	Zustand 리팩토링 설계
[REF-2025-11-19] multi-tenancy-implementation.md	멀티테넌시 구현
[TEST-2025-11-19] multi-tenancy-test-guide.md	멀티테넌시 테스트 가이드
[IMPL-2025-11-13] browser-support-policy.md	브라우저 지원 정책
[IMPL-2025-11-18] ssr-hydration-fix.md	SSR 하이드레이션 수정
[REF] architecture-integration-risks.md	통합 리스크
[NEXT-2025-12-20] zustand-refactoring-session-context.md	세션 체크포인트

---

게시판 관리 — board/

파일	설명
[PLAN-2025-12-19] board-management-implementation.md	게시판 구현 계획서

---

설정 관리 — settings/

파일	설명
[IMPL-2025-12-19] company-info.md	회사정보 구현
[IMPL-2025-12-19] popup-management.md	팝업관리 구현

---

archive/ - 레거시/완료된 문서

완료되거나 더 이상 활성화되지 않은 문서들. 참조용으로 보관. 테스트 스크린샷(qa-*.png)도 여기에 보관.

---

문서 작성 규칙

파일명 컨벤션

[TYPE-YYYY-MM-DD] description.md

TYPE 종류:

• IMPL - 구현 문서
• API - API 명세/요청
• GUIDE - 사용 가이드
• REF - 참조 문서
• ANALYSIS - 분석 노트
• PLAN - 계획 문서
• DESIGN - 설계 문서
• TEST - 테스트 가이드
• NEXT - 다음 작업 목록
• FIX - 버그 해결 문서
• QA - 품질 검사 문서
• HOTFIX - 긴급 수정 문서

폴더 배치 기준

1. 기능/도메인 우선: 문서 주제에 맞는 폴더에 배치
2. 범용 가이드: 여러 기능에 적용되면 guides/에 배치
3. 시스템 전체: 아키텍처/리팩토링은 architecture/에 배치
4. 개발도구: 테스트 URL, 빌드, 설정은 dev/에 배치
5. 완료된 작업: 더 이상 활성화되지 않으면 archive/로 이동