# React Routes Analysis

> **생성일**: 2025-12-20
> **분석 대상**: react/src/app/[locale]/

---

## 1. 라우트 구조 개요

### 1.1 전체 통계

| 항목 | 값 |
|------|-----|
| 총 페이지 수 | 107개 |
| 인증 필요 페이지 | 104개 ((protected) 그룹) |
| 공개 페이지 | 3개 (login, signup, root) |
| 주요 도메인 | 15개 |

### 1.2 라우트 그룹 분류

```
react/src/app/[locale]/
├── page.tsx                     # 루트 (→ /dashboard 리다이렉트)
├── login/page.tsx               # 로그인
├── signup/page.tsx              # 회원가입
└── (protected)/                 # 인증 필요 영역
    ├── dashboard/               # 대시보드
    ├── accounting/              # 회계 (17개 페이지)
    ├── approval/                # 결재 (4개 페이지)
    ├── board/                   # 게시판 (8개 페이지)
    ├── company-info/            # 회사정보 (1개 페이지)
    ├── customer-center/         # 고객센터 (10개 페이지)
    ├── dev/                     # 개발자 (1개 페이지)
    ├── hr/                      # 인사 (15개 페이지)
    ├── items/                   # 품목관리 (4개 페이지)
    ├── master-data/             # 마스터데이터 (1개 페이지)
    ├── payment-history/         # 결제내역 (1개 페이지)
    ├── production/              # 생산 (4개 페이지)
    ├── reports/                 # 리포트 (2개 페이지)
    ├── sales/                   # 영업 (12개 페이지)
    ├── settings/                # 설정 (17개 페이지)
    ├── subscription/            # 구독 (1개 페이지)
    └── [...slug]/               # 동적 라우트 (Catch-all)
```

---

## 2. 도메인별 라우트 상세

### 2.1 Dashboard (대시보드)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /dashboard | 대시보드 | 목록 |

### 2.2 Accounting (회계관리)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /accounting/bad-debt-collection | 대손채권회수 목록 | 목록 |
| /accounting/bad-debt-collection/new | 대손채권회수 등록 | 등록 |
| /accounting/bad-debt-collection/[id] | 대손채권회수 상세 | 상세 |
| /accounting/bad-debt-collection/[id]/edit | 대손채권회수 수정 | 수정 |
| /accounting/bank-transactions | 은행거래 | 목록 |
| /accounting/bills | 세금계산서 목록 | 목록 |
| /accounting/bills/new | 세금계산서 등록 | 등록 |
| /accounting/bills/[id] | 세금계산서 상세 | 상세 |
| /accounting/card-transactions | 카드거래 | 목록 |
| /accounting/daily-report | 일일리포트 | 목록 |
| /accounting/deposits | 입금 목록 | 목록 |
| /accounting/deposits/[id] | 입금 상세 | 상세 |
| /accounting/expected-expenses | 예상비용 | 목록 |
| /accounting/purchase | 매입 목록 | 목록 |
| /accounting/purchase/[id] | 매입 상세 | 상세 |
| /accounting/receivables-status | 미수금현황 | 목록 |
| /accounting/sales | 매출 목록 | 목록 |
| /accounting/sales/new | 매출 등록 | 등록 |
| /accounting/sales/[id] | 매출 상세 | 상세 |
| /accounting/vendor-ledger | 거래처원장 목록 | 목록 |
| /accounting/vendor-ledger/[id] | 거래처원장 상세 | 상세 |
| /accounting/vendors | 거래처 목록 | 목록 |
| /accounting/vendors/new | 거래처 등록 | 등록 |
| /accounting/vendors/[id] | 거래처 상세 | 상세 |
| /accounting/withdrawals | 출금 목록 | 목록 |
| /accounting/withdrawals/[id] | 출금 상세 | 상세 |

### 2.3 Approval (결재)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /approval/draft | 기안함 | 목록 |
| /approval/draft/new | 기안 작성 | 등록 |
| /approval/inbox | 결재함 | 목록 |
| /approval/reference | 참조함 | 목록 |

### 2.4 Board (게시판)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /board | 게시판 목록 | 목록 |
| /board/create | 게시글 작성 | 등록 |
| /board/[id] | 게시글 상세 | 상세 |
| /board/[id]/edit | 게시글 수정 | 수정 |
| /board/board-management | 게시판 관리 | 목록 |
| /board/board-management/new | 게시판 생성 | 등록 |
| /board/board-management/[id] | 게시판 설정 상세 | 상세 |
| /board/board-management/[id]/edit | 게시판 설정 수정 | 수정 |

### 2.5 Customer Center (고객센터)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /customer-center/events | 이벤트 목록 | 목록 |
| /customer-center/events/[id] | 이벤트 상세 | 상세 |
| /customer-center/faq | FAQ | 목록 |
| /customer-center/inquiries | 문의 목록 | 목록 |
| /customer-center/inquiries/create | 문의 등록 | 등록 |
| /customer-center/inquiries/[id] | 문의 상세 | 상세 |
| /customer-center/inquiries/[id]/edit | 문의 수정 | 수정 |
| /customer-center/notices | 공지사항 목록 | 목록 |
| /customer-center/notices/[id] | 공지사항 상세 | 상세 |

### 2.6 HR (인사관리)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /hr/attendance | 근태현황 | 목록 |
| /hr/attendance-management | 근태관리 | 목록 |
| /hr/card-management | 카드관리 목록 | 목록 |
| /hr/card-management/new | 카드 등록 | 등록 |
| /hr/card-management/[id] | 카드 상세 | 상세 |
| /hr/card-management/[id]/edit | 카드 수정 | 수정 |
| /hr/department-management | 부서관리 | 목록 |
| /hr/employee-management | 직원관리 목록 | 목록 |
| /hr/employee-management/new | 직원 등록 | 등록 |
| /hr/employee-management/csv-upload | CSV 업로드 | 등록 |
| /hr/employee-management/[id] | 직원 상세 | 상세 |
| /hr/employee-management/[id]/edit | 직원 수정 | 수정 |
| /hr/salary-management | 급여관리 | 목록 |
| /hr/vacation-management | 휴가관리 | 목록 |

### 2.7 Items (품목관리)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /items | 품목 목록 | 목록 |
| /items/create | 품목 등록 | 등록 |
| /items/[id] | 품목 상세 | 상세 |
| /items/[id]/edit | 품목 수정 | 수정 |

### 2.8 Production (생산관리)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /production/screen-production | 스크린 생산 목록 | 목록 |
| /production/screen-production/create | 스크린 생산 등록 | 등록 |
| /production/screen-production/[id] | 스크린 생산 상세 | 상세 |
| /production/screen-production/[id]/edit | 스크린 생산 수정 | 수정 |

### 2.9 Reports (리포트)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /reports | 리포트 | 목록 |
| /reports/comprehensive-analysis | 종합분석 | 상세 |

### 2.10 Sales (판매관리)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /sales/client-management-sales-admin | 거래처관리 목록 | 목록 |
| /sales/client-management-sales-admin/new | 거래처 등록 | 등록 |
| /sales/client-management-sales-admin/[id] | 거래처 상세 | 상세 |
| /sales/client-management-sales-admin/[id]/edit | 거래처 수정 | 수정 |
| /sales/pricing-management | 단가관리 목록 | 목록 |
| /sales/pricing-management/create | 단가 등록 | 등록 |
| /sales/pricing-management/[id]/edit | 단가 수정 | 수정 |
| /sales/quote-management | 견적관리 목록 | 목록 |
| /sales/quote-management/new | 견적 등록 | 등록 |
| /sales/quote-management/[id] | 견적 상세 | 상세 |
| /sales/quote-management/[id]/edit | 견적 수정 | 수정 |

### 2.11 Settings (설정)

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /settings/account-info | 계정정보 | 상세 |
| /settings/accounts | 계정 목록 | 목록 |
| /settings/accounts/new | 계정 등록 | 등록 |
| /settings/accounts/[id] | 계정 상세 | 상세 |
| /settings/attendance-settings | 근태설정 | 상세 |
| /settings/leave-policy | 휴가정책 | 상세 |
| /settings/notification-settings | 알림설정 | 상세 |
| /settings/permissions | 권한관리 목록 | 목록 |
| /settings/permissions/new | 권한 등록 | 등록 |
| /settings/permissions/[id] | 권한 상세 | 상세 |
| /settings/popup-management | 팝업관리 목록 | 목록 |
| /settings/popup-management/new | 팝업 등록 | 등록 |
| /settings/popup-management/[id] | 팝업 상세 | 상세 |
| /settings/popup-management/[id]/edit | 팝업 수정 | 수정 |
| /settings/ranks | 직급관리 | 목록 |
| /settings/titles | 직책관리 | 목록 |
| /settings/work-schedule | 근무일정 | 상세 |

### 2.12 기타

| 라우트 | 설명 | 타입 |
|--------|------|------|
| /company-info | 회사정보 | 상세 |
| /master-data/item-master-data-management | 품목기준관리 | 목록 |
| /payment-history | 결제내역 | 목록 |
| /subscription | 구독관리 | 상세 |
| /dev/test-urls | 개발자 테스트 | 개발 |

---

## 3. 글로벌 메뉴 vs React 라우트 Gap 분석

### 3.1 React에만 존재하는 라우트 (GlobalMenu 등록 필요)

| React 라우트 | 제안 메뉴명 | 부모 메뉴 |
|--------------|------------|----------|
| /approval/* | 결재관리 | 신규 대메뉴 |
| /board/* | 게시판 | 신규 대메뉴 |
| /customer-center/* | 고객센터 | 신규 대메뉴 |
| /hr/* | 인사관리 | 신규 대메뉴 |
| /items/* | 품목관리 | 기준정보 관리 |
| /settings/* | 설정 | 신규 대메뉴 |
| /subscription | 구독관리 | 설정 |
| /company-info | 회사정보 | 설정 |
| /payment-history | 결제내역 | 회계관리 |
| /reports/* | 리포트 | 신규 대메뉴 |

### 3.2 GlobalMenu에만 존재 (React 미구현)

| 글로벌 메뉴 | URL | 상태 |
|-------------|-----|------|
| 리드관리 | /sales-dept/sales-leads | React 미구현 |
| 매출처관리 | /sales-dept/customer-account-management | React 미구현 |
| 영업실적 | /sales-dept/sales-performance | React 미구현 |
| 수주관리 | /sales/order-management-sales | React 미구현 |
| 현장관리 | /sales/site-management | React 미구현 |
| 구매관리 전체 | /purchase/* | React 미구현 |
| 품질관리 전체 | /quality/* | React 미구현 |
| 자재관리 전체 | /material/* | React 미구현 |
| 장비관리 전체 | /equipment/* | React 미구현 |
| 차량관리 전체 | /vehicle/* | React 미구현 |

### 3.3 URL 불일치 (수정 필요)

| React 라우트 | GlobalMenu URL | 제안 |
|--------------|----------------|------|
| /accounting/vendors | /accounting/client-management | React 기준 사용 |
| /accounting/sales | /accounting/sales-accounting | React 기준 사용 |
| /accounting/purchase | /accounting/purchase-accounting | React 기준 사용 |
| /hr/employee-management | /master-data/employee-management | React 기준 사용 |
| /hr/department-management | /master-data/department-management | React 기준 사용 |

---

## 4. 메뉴 재구조화 제안

### 4.1 신규 대메뉴 구조

```
1. 대시보드 (dashboard)
2. 결재관리 (approval) - 신규
3. 게시판 (board) - 신규
4. 품목관리 (items) - 기존 master-data에서 분리
5. 판매관리 (sales)
6. 생산관리 (production)
7. 회계관리 (accounting)
8. 인사관리 (hr) - 신규
9. 리포트 (reports) - 신규
10. 고객센터 (customer-center) - 신규
11. 설정 (settings) - 신규
```

### 4.2 아이콘 매핑

| 메뉴 | Lucide 아이콘 |
|------|---------------|
| 결재관리 | file-check |
| 게시판 | layout-list |
| 인사관리 | users |
| 리포트 | bar-chart-3 |
| 고객센터 | headphones |
| 설정 | settings |

---

## 5. 다음 단계

1. **menu-list.md 작성**: 최종 메뉴 리스트 정리
2. **mng 등록**: GlobalMenu seeder 업데이트
3. **권한 매핑**: 각 메뉴별 필요 권한 정의

---

*이 문서는 Phase 2 분석 결과입니다.*
