kent
2d9b02f74e
- INDEX.md: TODO.md 링크 추가 - TODO.md: 프로젝트 할일 목록 신규 생성 - plans/flow-tests/: Flow Tester 테스트 시나리오 JSON 추가 - auth-api-flow.json: 인증 API 플로우 테스트 - pricing-validation-test.json: 가격 검증 테스트 - projects/api-integration/: 마이그레이션 계획 문서 - MASTER_PLAN.md: 전체 마이그레이션 전략 - PROGRESS.md: 진행 상황 추적 - WORKFLOW.md: 작업 워크플로우 - phase-1 ~ phase-4: 단계별 상세 계획 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
301 lines
12 KiB
Markdown
301 lines
12 KiB
Markdown
# 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 분석 결과입니다.*
|