6ed5d4ffb3
- DynamicItemForm 컴포넌트 구조 생성 - DynamicField: 필드 타입별 렌더링 - DynamicSection: 섹션 단위 렌더링 - DynamicFormRenderer: 페이지 전체 렌더링 - 필드 타입별 컴포넌트 (TextField, NumberField, DropdownField, CheckboxField, DateField, FileField, CustomField) - 커스텀 훅 (useDynamicFormState, useFormStructure, useConditionalFields) - DataTable 공통 컴포넌트 (테이블, 페이지네이션, 검색, 탭필터, 통계카드) - ItemFormWrapper: Feature Flag 기반 폼 선택 - 타입 정의 및 문서화 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
5.1 KiB
5.1 KiB
claudedocs 문서 맵
프로젝트 기술 문서 인덱스 (Last Updated: 2025-11-28)
폴더 구조
claudedocs/
├── _index.md # 이 파일 - 문서 맵
├── auth/ # 🔐 인증 & 토큰 관리
├── item-master/ # 📦 품목기준관리
├── dashboard/ # 📊 대시보드 & 사이드바
├── api/ # 🔌 API 통합
├── guides/ # 📚 범용 가이드
├── architecture/ # 🏗️ 아키텍처 & 시스템
└── archive/ # 📁 레거시/완료된 문서
🔐 auth/ - 인증 & 토큰 관리
| 파일 | 설명 |
|---|---|
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 미들웨어 연구 |
📦 item-master/ - 품목기준관리
| 파일 | 설명 |
|---|---|
[PLAN-2025-11-28] dynamic-item-form-implementation.md |
✅ Phase 1-6 완료 - 품목관리 동적 렌더링 구현 (타입, 훅, 필드, 렌더러, 메인폼, Feature Flag) |
[API-REQUEST-2025-11-28] dynamic-page-rendering-api.md |
⭐ v3.1 - 동적 페이지 렌더링 API 요청서 (ID 기반 통일) |
[PLAN-2025-11-27] item-form-component-separation.md |
✅ 완료 - ItemForm 컴포넌트 분리 (1607→415줄, 74% 감소) |
[IMPL-2025-11-27] realtime-sync-fixes.md |
실시간 동기화 수정 (BOM, 섹션 복제, 항목 수정, 페이지 삭제 시 섹션 동기화 2025-11-28) |
item-master-api-pending-tasks.md |
진행중인 API 연동 작업 |
item-master-pending-integration.md |
대기중인 통합 작업 |
item-master-specification.md |
API 명세 |
item-master-backend-requirements.md |
백엔드 요구사항 |
item-management-dynamic-api-spec.md |
동적 필드 API 스펙 |
item-management-dynamic-frontend.md |
동적 필드 프론트엔드 설계 |
item-master-data-management.md |
데이터 관리 분석 |
item-master-hooks-refactoring.md |
Hooks 리팩토링 |
ITEM-MANAGEMENT-MIGRATION.md |
마이그레이션 가이드 |
📊 dashboard/ - 대시보드 & 사이드바
| 파일 | 설명 |
|---|---|
dashboard-integration-complete.md |
대시보드 통합 완료 |
dashboard-cleanup-summary.md |
정리 요약 |
dashboard-migration-summary.md |
마이그레이션 요약 |
sidebar-active-menu-sync.md |
사이드바 메뉴 동기화 |
sidebar-scroll-improvements.md |
스크롤 개선 |
🔌 api/ - API 통합
| 파일 | 설명 |
|---|---|
api-requirements.md |
API 요구사항 |
api-analysis.md |
API 분석 |
api-route-type-safety.md |
라우트 타입 안전성 |
api-key-management.md |
API 키 관리 |
📚 guides/ - 범용 가이드
| 파일 | 설명 |
|---|---|
i18n-usage-guide.md |
다국어 사용 가이드 |
form-validation-guide.md |
폼 유효성 검사 |
CSS-MIGRATION-WORKFLOW.md |
CSS 마이그레이션 워크플로우 |
LARGE-FILE-WORKFLOW.md |
대용량 파일 작업 워크플로우 |
ZOD-VALIDATION-TROUBLESHOOTING.md |
Zod 유효성 검사 트러블슈팅 |
nextjs-error-handling-guide.md |
Next.js 에러 처리 |
🏗️ architecture/ - 아키텍처 & 시스템
| 파일 | 설명 |
|---|---|
multi-tenancy-implementation.md |
멀티테넌시 구현 |
multi-tenancy-test-guide.md |
멀티테넌시 테스트 |
architecture-integration-risks.md |
통합 리스크 |
browser-support-policy.md |
브라우저 지원 정책 |
ssr-hydration-fix.md |
SSR 하이드레이션 수정 |
📁 archive/ - 레거시/완료된 문서
완료되거나 더 이상 활성화되지 않은 문서들. 참조용으로 보관.
문서 작성 규칙
파일명 컨벤션
[TYPE-YYYY-MM-DD] description.md
TYPE 종류:
IMPL- 구현 문서API- API 명세/요청GUIDE- 사용 가이드REF- 참조 문서ANALYSIS- 분석 노트PLAN- 계획 문서DESIGN- 설계 문서TEST- 테스트 가이드NEXT- 다음 작업 목록
폴더 배치 기준
- 기능/도메인 우선: 문서 주제에 맞는 폴더에 배치
- 범용 가이드: 여러 기능에 적용되면
guides/에 배치 - 완료된 작업: 더 이상 활성화되지 않으면
archive/로 이동 - 신규 도메인: 3개 이상 문서가 생기면 새 폴더 생성 고려
문서 업데이트
- 중요 변경 시 문서 상단에 날짜와 함께 변경사항 기록
_index.md에 새 문서 추가 시 테이블 업데이트