From 9447e608969bd157755d8b5c61feaec673515d6c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Fri, 13 Mar 2026 21:15:27 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[system]=20=ED=94=84=EB=A1=9C=EC=A0=9D?= =?UTF-8?q?=ED=8A=B8=20=EA=B7=9C=EB=AA=A8=20=ED=98=84=ED=99=A9=20=EB=AC=B8?= =?UTF-8?q?=EC=84=9C=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 순수 개발자 코드 113만행, 5,114파일 규모 조사 - MNG/API/React/Docs 프로젝트별 레이어 상세 분석 - 조사 이력 테이블로 변화 추적 가능 --- INDEX.md | 3 +- system/project-scale.md | 100 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 102 insertions(+), 1 deletion(-) create mode 100644 system/project-scale.md diff --git a/INDEX.md b/INDEX.md index 12ea2f2..997d563 100644 --- a/INDEX.md +++ b/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 스토리보드 분석 | diff --git a/system/project-scale.md b/system/project-scale.md new file mode 100644 index 0000000..ef96883 --- /dev/null +++ b/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