docs: [system] 프로젝트 규모 현황 문서 추가

- 순수 개발자 코드 113만행, 5,114파일 규모 조사
- MNG/API/React/Docs 프로젝트별 레이어 상세 분석
- 조사 이력 테이블로 변화 추적 가능

INDEX.md

@@ -1,7 +1,7 @@
 # SAM 문서 인덱스 (Claude Code용)
 
 > 작업 유형에 맞는 문서를 먼저 읽고 시작하세요.
-> 최종 갱신: 2026-03-13 (API 라우트 개선 계획 추가)
+> 최종 갱신: 2026-03-13 (프로젝트 규모 현황 추가)
 
 ---
 
@@ -87,6 +87,7 @@ docs/
 | [untitled-ui-evaluation.md](system/untitled-ui-evaluation.md) | Untitled UI 도입 검토 (Figma/React UI Kit 평가) |
 | [board-system-spec.md](system/board-system-spec.md) | 게시판 시스템 설계 |
 | [migration-status.md](system/migration-status.md) | MNG→API+React 이관 현황 및 로드맵 (Phase 1~4) |
+| [project-scale.md](system/project-scale.md) | 프로젝트 규모 현황 (코드 행 수, 파일 수) |
 | [item-master-integration.md](system/item-master-integration.md) | 품목 마스터 통합 설계 |
 | [erp-analysis/](system/erp-analysis/) | ERP 스토리보드 분석 |
 

system/project-scale.md

@@ -0,0 +1,100 @@
+# SAM 프로젝트 규모 현황
+
+> **최종 조사일**: 2026-03-13
+> **조사 방법**: 순수 개발자 코드만 집계 (vendor, node_modules, .next, public 등 프레임워크/패키지 제외)
+
+---
+
+## 1. 전체 요약
+
+| 프로젝트 | 행 수 | 파일 수 | 주요 언어 |
+|----------|------:|--------:|----------|
+| **MNG** (관리자) | 383,485 | 1,284 | PHP + Blade |
+| **API** (서버) | 225,168 | 1,823 | PHP |
+| **React** (프론트) | 320,340 | 1,518 | TypeScript/TSX |
+| **Docs** (문서) | 203,944 | 489 | Markdown |
+| **합계** | **1,132,937** | **5,114** | |
+
+---
+
+## 2. MNG 상세 (383,485행 / 1,284파일)
+
+| 레이어 | 행 수 | 비율 |
+|--------|------:|-----:|
+| Blade Views | 236,652 | 62% |
+| Controllers | 58,612 | 15% |
+| Services | 44,946 | 12% |
+| Models | 22,718 | 6% |
+| Database | 7,577 | 2% |
+| Config | 3,517 | 1% |
+| Routes | 3,473 | 1% |
+
+> Blade 뷰가 23만행으로 최대 비중 — HTMX 기반 UI가 서버 렌더링이라 Blade에 HTML/JS가 집중되어 있다.
+
+---
+
+## 3. API 상세 (225,168행 / 1,823파일)
+
+| 레이어 | 행 수 | 비율 |
+|--------|------:|-----:|
+| Services | 71,540 | 32% |
+| Migrations | 29,541 | 13% |
+| Models | 27,043 | 12% |
+| Controllers | 16,026 | 7% |
+| Requests (FormRequest) | 12,967 | 6% |
+| Routes | 2,420 | 1% |
+| Config | 2,217 | 1% |
+| Blade Views (PDF 등) | 2,609 | 1% |
+
+> Service 레이어에 7만행 집중 — Service-First 아키텍처 준수. Controller는 얇고(16K) 비즈니스 로직은 Service에 있다.
+
+### API 라우트 현황
+
+| 항목 | 수치 |
+|------|------|
+| 총 API v1 라우트 | 1,099개 |
+| 리소스(컨트롤러) 그룹 | 115개 |
+
+> 상세 분석: [api-route-improvement-plan.md](../dev/dev_plans/api-route-improvement-plan.md)
+
+---
+
+## 4. React 상세 (320,340행 / 1,518파일)
+
+| 레이어 | 행 수 | 비율 |
+|--------|------:|-----:|
+| Components | 254,807 | 80% |
+| Pages (app/) | 33,982 | 11% |
+| Lib (유틸) | 15,961 | 5% |
+| Hooks | 4,540 | 1% |
+| Stores | 3,303 | 1% |
+| Types | 2,313 | 1% |
+
+> 컴포넌트가 25만행으로 80% — UI 중심 프로젝트의 전형적인 분포.
+
+---
+
+## 5. Docs (203,944행 / 489파일)
+
+프로젝트 문서, 기획서, 개발 표준, 비즈니스 규칙 등을 포함한다.
+
+---
+
+## 6. 조사 이력
+
+| 조사일 | 합계 행 수 | 합계 파일 수 | 비고 |
+|--------|----------:|------------:|------|
+| 2026-03-13 | 1,132,937 | 5,114 | 최초 조사 |
+
+---
+
+## 관련 문서
+
+- [overview.md](overview.md) — 전체 시스템 아키텍처
+- [api-structure.md](api-structure.md) — API 서버 구조
+- [react-structure.md](react-structure.md) — React 프론트엔드 구조
+- [mng-structure.md](mng-structure.md) — MNG 관리자 패널 구조
+
+---
+
+**최종 업데이트**: 2026-03-13