# Step 0.1: 기존 시스템 분석 전략 **목표:** 기존 API 및 mes_react 프로젝트의 MD 문서를 먼저 검토하고, 컨텍스트 누락 방지를 위해 쪼개서 문서화 **작업 방식:** 문서 우선 검토 → 코드 분석 → 쪼개서 저장 → 후속 단계에서 활용 --- ## 📚 발견된 기존 문서 목록 ### API 프로젝트 문서 (api/) **핵심 분석 문서:** 1. `claudedocs/SAM_Item_DB_API_Analysis_v3_FINAL.md` ⭐ 최신 품목 분석 2. `claudedocs/SAM_Item_Management_DB_Modeling_Analysis.md` ⭐ DB 모델링 분석 3. `claudedocs/SAM_Item_DB_API_Analysis_v2.md` (v2 버전) 4. `LOGICAL_RELATIONSHIPS_SIMPLE.md` (관계 다이어그램) **Swagger 문서:** 5. `claudedocs/SWAGGER_PHASE3_1_PRODUCT.md` (제품 API) 6. `claudedocs/SWAGGER_PHASE3_2_MATERIAL.md` (자재 API) 7. `claudedocs/SWAGGER_PHASE3_3_CLIENT.md` (고객 API) 8. `claudedocs/SWAGGER_AUDIT.md` (Swagger 감사) **기타:** 9. `REMOTE_WORK_SETUP.md` 10. `resources/markdown/terms.md` 11. `resources/markdown/policy.md` --- ### MES React 프로젝트 문서 (mes_react/src/) **시스템 아키텍처 (우선순위 높음):** 1. `ATOMIC_DESIGN_SYSTEM.md` ⭐ (40KB - Atomic Design 전체 구조) 2. `DEVELOPMENT_GUIDELINES.md` ⭐ (26KB - 개발 가이드라인) 3. `TECH_STACK.md` ⭐ (기술 스택) 4. `DEVELOPMENT_ENVIRONMENT.md` (개발 환경) 5. `QUICK_START.md` (빠른 시작 가이드) **화면 설계 (품목 관련):** 6. `SCREEN_DESIGN_SPECIFICATION.md` ⭐ (41KB - 화면 설계 명세) 7. `ERP_QUOTATION_GUIDE.md` ⭐ (견적 시스템 가이드) 8. `USER_STORY_GUIDE.md` (사용자 스토리) **디자인 시스템:** 9. `DESIGN_SYSTEM_README.md` 10. `DESIGN_SYSTEM_QUICK_REFERENCE.md` 11. `DESIGN_SYSTEM_STANDARDIZATION_GUIDE.md` 12. `DESIGN_SYSTEM_COMPLETION_SUMMARY.md` 13. `DESIGN_STANDARDIZATION_PROGRESS.md` **페이지 포맷:** 14. `STANDARD_PAGE_FORMAT.md` 15. `UNIFIED_PAGE_FORMAT_SUMMARY.md` 16. `PAGE_FORMAT_IMPLEMENTATION_GUIDE.md` **테이블 시스템:** 17. `TABLE_DESIGN_SYSTEM.md` 18. `TABLE_SYSTEM_IMPLEMENTATION.md` **컴포넌트:** 19. `COMMON_COMPONENTS_GUIDE.md` 20. `COMPONENT_HIERARCHY_REFERENCE.md` 21. `COMPONENT_CONSOLIDATION_PLAN.md` **기타:** 22. `FORM_VALIDATION_GUIDE.md` 23. `DATA_INTEGRATION_GUIDE.md` 24. `MENU_ACCESS_GUIDE.md` 25. `ICON_STANDARDIZATION_CHECKLIST.md` 26. `ALL_PAGES_REFACTORING_PROGRESS.md` 27. `ATOMIC_DESIGN_MIGRATION_SUMMARY.md` 28. `CONSOLIDATION_PROGRESS.md` 29. `DESIGN_AUDIT_REPORT.md` 30. `FINAL_COMPLETION_SUMMARY.md` 31. `IMPLEMENTATION_SUMMARY.md` 32. `PHASE3_FINAL_SUMMARY.md` 33. `TITLE_STRUCTURE_STANDARDIZATION.md` --- ## 🎯 분석 전략: 3단계 접근법 ### Phase A: 문서 우선 검토 및 매핑 **목표:** 기존 문서를 통해 전체 시스템 구조 파악 **Step A.1: 핵심 문서 검토 (우선순위)** 1. **API 분석 문서 (3개)** - `SAM_Item_DB_API_Analysis_v3_FINAL.md` (최신 버전 우선) - `SAM_Item_Management_DB_Modeling_Analysis.md` - `LOGICAL_RELATIONSHIPS_SIMPLE.md` 2. **React 아키텍처 문서 (3개)** - `ATOMIC_DESIGN_SYSTEM.md` - `DEVELOPMENT_GUIDELINES.md` - `SCREEN_DESIGN_SPECIFICATION.md` 3. **비즈니스 로직 문서 (2개)** - `ERP_QUOTATION_GUIDE.md` - `USER_STORY_GUIDE.md` **Step A.2: 문서 내용 쪼개기** - 각 대형 문서(>10KB)를 주제별로 분리 - 쪼갠 문서를 `00_baseline/docs_breakdown/` 폴더에 저장 - 메타데이터 추가 (출처, 작성일, 관련 모듈) **산출물:** ``` 00_baseline/docs_breakdown/ ├─ api_item_analysis_summary.md # API 분석 요약 ├─ api_db_modeling.md # DB 모델링 ├─ api_swagger_status.md # Swagger 현황 ├─ react_architecture.md # React 아키텍처 ├─ react_design_system.md # 디자인 시스템 ├─ react_screen_specs.md # 화면 명세 ├─ business_quotation.md # 견적 비즈니스 로직 └─ document_cross_reference.md # 문서 간 연관관계 ``` --- ### Phase B: 코드 레벨 분석 **목표:** 실제 구현 코드 분석 및 문서와의 일치성 검증 **Step B.1: API 프로젝트 구조 분석** - Routes 분석 (`routes/api.php`) - Controllers 분석 (`app/Http/Controllers/Api/V1/`) - Services 분석 (`app/Services/`) - Models 분석 (`app/Models/`) - Migrations 분석 (`database/migrations/`) **Step B.2: mes_react 프로젝트 구조 분석** - 라우팅 구조 (`src/routes/`) - 페이지 컴포넌트 (`src/pages/`) - 공통 컴포넌트 (`src/components/`) - API 연동 (`src/api/`, `src/hooks/`) - 상태 관리 (`src/store/`, `src/contexts/`) **산출물:** ``` 00_baseline/ ├─ api_code_structure.md # API 코드 구조 ├─ api_routes_inventory.md # API 엔드포인트 목록 ├─ api_models_inventory.md # 모델 목록 ├─ react_code_structure.md # React 코드 구조 ├─ react_pages_inventory.md # 페이지 목록 └─ react_components_inventory.md # 컴포넌트 목록 ``` --- ### Phase C: 통합 및 갭 분석 **목표:** 문서와 코드의 차이점 파악, 개발 범위 명확화 **Step C.1: 문서 vs 코드 매칭** - 문서에 있지만 코드에 없는 기능 (TODO 목록) - 코드에 있지만 문서에 없는 기능 (문서화 필요) - 문서와 코드가 일치하는 기능 (재사용 가능) **Step C.2: 품목 기준관리 요구사항 도출** - mes_react 화면 명세 기반 요구사항 - 현재 API 상태 - 신규 개발 필요 범위 **산출물:** ``` 00_baseline/ ├─ gap_analysis.md # 문서-코드 갭 분석 ├─ existing_features.md # 재사용 가능한 기존 기능 ├─ new_features_required.md # 신규 개발 필요 기능 └─ item_management_requirements.md # 품목 기준관리 요구사항 ``` --- ## 📋 컨텍스트 누락 방지 전략 ### 1. 문서 쪼개기 원칙 **큰 문서 (>20KB) 처리 방법:** ``` ATOMIC_DESIGN_SYSTEM.md (40KB) → atomic_design_overview.md (5KB - 개요) → atomic_design_atoms.md (8KB - Atoms) → atomic_design_molecules.md (10KB - Molecules) → atomic_design_organisms.md (10KB - Organisms) → atomic_design_templates.md (7KB - Templates/Pages) ``` **쪼개기 기준:** - 주제별 분리 (섹션 단위) - 각 파일 5-10KB 권장 - 파일 간 연관관계 명시 - 원본 문서 링크 포함 ### 2. 메타데이터 추가 각 쪼갠 문서 상단에 메타데이터 포함: ```markdown --- source: ATOMIC_DESIGN_SYSTEM.md section: Molecules created: 2025-11-10 related: - atomic_design_atoms.md - COMMON_COMPONENTS_GUIDE.md tags: [react, design-system, molecules, components] --- # Atomic Design - Molecules (내용...) ``` ### 3. 교차 참조 맵 생성 **문서 간 연관관계 시각화:** ``` document_cross_reference.md ├─ API 문서 그룹 │ ├─ SAM_Item_DB_API_Analysis_v3_FINAL.md │ │ → 참조: SAM_Item_Management_DB_Modeling_Analysis.md │ │ → 참조: LOGICAL_RELATIONSHIPS_SIMPLE.md │ └─ SWAGGER_PHASE3_1_PRODUCT.md │ → 참조: SAM_Item_DB_API_Analysis_v3_FINAL.md │ ├─ React 문서 그룹 │ ├─ ATOMIC_DESIGN_SYSTEM.md │ │ → 참조: DESIGN_SYSTEM_README.md │ │ → 참조: COMMON_COMPONENTS_GUIDE.md │ └─ SCREEN_DESIGN_SPECIFICATION.md │ → 참조: STANDARD_PAGE_FORMAT.md │ → 참조: ERP_QUOTATION_GUIDE.md │ └─ 교차 참조 └─ SCREEN_DESIGN_SPECIFICATION.md (React) → 연동: SAM_Item_DB_API_Analysis_v3_FINAL.md (API) ``` ### 4. 분석 세션별 체크포인트 **각 분석 세션 종료 시:** ```json { "session": "Phase A - Step A.1 완료", "completed_docs": [ "SAM_Item_DB_API_Analysis_v3_FINAL.md", "SAM_Item_Management_DB_Modeling_Analysis.md" ], "breakdown_created": [ "api_item_analysis_summary.md", "api_db_modeling.md" ], "next_session": "Phase A - Step A.2", "context_preserved": true } ``` --- ## 🔄 후속 단계에서 활용 방법 ### Phase 1 (품목 기준관리) 에서 활용 **Step 1.1 (화면 분석) 참조 문서:** - `react_screen_specs.md` (쪼갠 문서) - `business_quotation.md` (쪼갠 문서) - `SCREEN_DESIGN_SPECIFICATION.md` (원본, 필요시) **Step 1.3 (데이터 모델 설계) 참조 문서:** - `api_db_modeling.md` (쪼갠 문서) - `api_models_inventory.md` (코드 분석 결과) - `existing_features.md` (재사용 가능 기능) **Step 1.4 (API 설계) 참조 문서:** - `api_item_analysis_summary.md` (쪼갠 문서) - `api_routes_inventory.md` (코드 분석 결과) - `api_swagger_status.md` (Swagger 현황) ### Phase 2 (견적 시스템) 에서 활용 **Step 2.1 (화면 분석) 참조 문서:** - `business_quotation.md` (쪼갠 문서) - `ERP_QUOTATION_GUIDE.md` (원본) --- ## ✅ 실행 체크리스트 ### Phase A: 문서 우선 검토 - [ ] A.1 핵심 문서 8개 검토 - [ ] A.2 대형 문서 쪼개기 - [ ] A.3 메타데이터 추가 - [ ] A.4 교차 참조 맵 생성 ### Phase B: 코드 분석 - [ ] B.1 API 코드 구조 분석 - [ ] B.2 React 코드 구조 분석 - [ ] B.3 코드 인벤토리 생성 ### Phase C: 통합 및 갭 분석 - [ ] C.1 문서-코드 매칭 - [ ] C.2 품목 기준관리 요구사항 도출 - [ ] C.3 개발 범위 명확화 --- ## 📊 예상 산출물 구조 ``` claudedocs/mes/00_baseline/ ├─ STEP_0_1_ANALYSIS_STRATEGY.md # 이 문서 ├─ docs_breakdown/ # 쪼갠 문서 │ ├─ api_item_analysis_summary.md │ ├─ api_db_modeling.md │ ├─ api_swagger_status.md │ ├─ react_architecture.md │ ├─ react_design_system.md │ ├─ react_screen_specs.md │ ├─ business_quotation.md │ └─ document_cross_reference.md ├─ code_analysis/ # 코드 분석 결과 │ ├─ api_code_structure.md │ ├─ api_routes_inventory.md │ ├─ api_models_inventory.md │ ├─ react_code_structure.md │ ├─ react_pages_inventory.md │ └─ react_components_inventory.md ├─ integration/ # 통합 분석 │ ├─ gap_analysis.md │ ├─ existing_features.md │ ├─ new_features_required.md │ └─ item_management_requirements.md └─ existing_api_analysis.md # 최종 통합 문서 ``` --- ## 🚀 다음 단계 실행 방법 **Step A.1 시작:** ``` "Phase A - Step A.1 시작해줘" 또는 "/sc:analyze를 사용해서 핵심 문서 8개 분석해줘" ``` **예상 소요 시간:** - Phase A: 2-3시간 - Phase B: 3-4시간 - Phase C: 2-3시간 - **총 7-10시간** (여러 세션으로 나누어 진행) --- ## 📌 중요 원칙 1. **문서 우선:** 코드보다 문서 먼저 검토 2. **쪼개서 저장:** 큰 문서는 반드시 주제별로 분리 3. **메타데이터:** 모든 쪼갠 문서에 출처와 연관관계 명시 4. **교차 참조:** 문서 간 연결고리 명확히 기록 5. **점진적 분석:** 한 번에 모두 하지 말고 Phase 단위로 진행 6. **컨텍스트 보존:** 각 세션 종료 시 체크포인트 저장 --- **작성일:** 2025-11-12 **다음 작업:** Phase A - Step A.1 (핵심 문서 검토)