sam-docs/projects/api-integration/phase-2-menu-extraction/react-routes-analysis.md

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 분석 결과입니다.