Files
sam-docs/system/project-scale.md
김보곤 9447e60896 docs: [system] 프로젝트 규모 현황 문서 추가
- 순수 개발자 코드 113만행, 5,114파일 규모 조사
- MNG/API/React/Docs 프로젝트별 레이어 상세 분석
- 조사 이력 테이블로 변화 추적 가능
2026-03-13 21:15:27 +09:00

101 lines
2.7 KiB
Markdown

# 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