Files
sam-react-prod/claudedocs/guides/migration/[IMPL-2026-01-23] button-navigation-checklist.md
유병철 07374c826c refactor(WEB): claudedocs 재정리 및 AuthContext/Zustand/유틸 코드 개선
- claudedocs 폴더 구조 재정리: archive/sessions, guides/migration·mobile·universal-list, refactoring 분류
- 오래된 세션 컨텍스트/체크리스트 문서 정리 (아카이브 이동 또는 삭제)
- AuthContext → authStore(Zustand) 전환 시작, RootProvider 간소화
- GenericCRUDDialog 공통 다이얼로그 컴포넌트 추가
- PermissionDialog 삭제 → GenericCRUDDialog로 대체
- RankDialog/TitleDialog GenericCRUDDialog 기반으로 리팩토링
- toast-utils.ts 삭제 (미사용)
- fileDownload.ts 개선, excel-download.ts 정리
- menuStore/themeStore Zustand 셀렉터 최적화
- useColumnSettings/useTableColumnStore 기능 보강
- 세금계산서/견적/작업자화면/결재 등 소규모 개선

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 17:17:13 +09:00

6.0 KiB

버튼 네비게이션 검수 체크리스트

등록/수정/상세 버튼 클릭 시 정상 이동 여부 검증 Last Updated: 2026-01-23

🔴 검수 기준 (필수 확인 사항)

URL 패턴 기준

기능 정상 URL 패턴 확인 포인트
등록 /ko/[path]?mode=new 1) ?mode=new 쿼리 파라미터 존재 2) locale /ko/ 포함
상세 /ko/[path]/[id]?mode=view 1) ?mode=view 쿼리 파라미터 존재 2) locale /ko/ 포함
수정 /ko/[path]/[id]?mode=edit 1) ?mode=edit 쿼리 파라미터 존재 2) locale /ko/ 포함

검수 체크포인트

  1. URL 쿼리 파라미터: ?mode=new, ?mode=view, ?mode=edit 확인
  2. locale 포함 여부: URL에 /ko/ 포함 확인
  3. 페이지 로딩: 해당 폼/상세 화면이 정상 표시되는지 확인
  4. 버튼 존재 여부: 등록/상세/수정 버튼이 UI에 있는지 확인

상태 표시

  • 미검수
  • 통과 (URL 패턴 + locale 모두 정상)
  • [!] 오류 발견 (상세 내용 기록)
  • N/A 해당 기능 없음

1. 생산관리 (Production)

페이지 URL 등록 상세 수정 비고
스크린생산 (품목관리) /ko/production/screen-production [!] [!] [x] 등록: mode=new 폼 미표시, 상세: 다른 URL패턴 사용
작업지시관리 /ko/production/work-orders [!] [x] [!] 등록: mode=new 폼 미표시, 상세: /[id] 패턴 정상, 수정: URL변경 없이 내부상태 처리

2. 인사관리 (HR)

페이지 URL 등록 상세 수정 비고
부서관리 /ko/hr/department-management [x] N/A [x] 모달 방식 (트리구조, URL패턴 불필요)
사원관리 /ko/hr/employee-management [x] [x] [x] 등록: ?mode=new, 상세: /[id], 수정: /[id]?mode=edit 정상
카드관리 /ko/hr/card-management [!] N/A N/A 등록: ?mode=new 동작하나 UI에 등록버튼 없음, 데이터 없어 상세/수정 미검증

3. 판매관리 (Sales)

페이지 URL 등록 상세 수정 비고
거래처관리 /ko/sales/client-management-sales-admin [!] [x] [x] 등록: ?mode=new React hooks 오류, 상세/수정 정상
견적관리 /ko/sales/quote-management [x] [!] [!] 등록: ?mode=new 정상, 상세: /[id] 빈 페이지(라우트 미구현?), 수정: 작업 버튼 URL변경 없음
단가관리 /ko/sales/pricing-management [!] N/A [!] 등록/수정: ?mode=new&itemId=XX 패턴이나 폼 미표시(버그), 상세: 별도 상세 페이지 없음(인라인)

4. 기준정보관리 (Master Data)

페이지 URL 등록 상세 수정 비고
품목기준관리 /ko/master-data/item-master-data-management [!] [!] [!] 페이지 로딩 안됨 (스켈레톤만 표시)
공정관리 /ko/master-data/process-management [x] N/A [x] 등록: ?mode=new, 수정: /[id]?mode=edit 정상, 상세 뷰 없음

5. 회계관리 (Accounting)

페이지 URL 등록 상세 수정 비고
거래처관리 /ko/accounting/vendors N/A [!] [!] 등록버튼 없음, 상세/수정: 인라인 버튼만(URL 변경 없음)
매입관리 /ko/accounting/purchase [ ] [ ] [ ]
매출관리 /ko/accounting/sales [!] [!] [!] 등록: ?mode=new ✓ but locale 누락, 상세: /[id]만 사용 ?mode=view 누락, 수정: ?mode=edit ✓ but locale 누락
입금관리 /ko/accounting/deposits [!] N/A N/A 등록: 인라인 폼(URL 변경 없음), 상세/수정 버튼 없음
출금관리 /ko/accounting/withdrawals [ ] [ ] [ ]
어음관리 /ko/accounting/bills [ ] [ ] [ ]
카드내역조회 /ko/accounting/card-transactions N/A N/A N/A 조회 전용 페이지

6. 설정 (Settings)

페이지 URL 등록 상세 수정 비고
계좌관리 /ko/settings/accounts [ ] [ ] [ ]
팝업관리 /ko/settings/popup-management [ ] [ ] [ ]
게시판관리 /ko/board/board-management [ ] [ ] [ ]
직급관리 /ko/settings/ranks [ ] [ ] [ ]
직책관리 /ko/settings/titles [ ] [ ] [ ]

7. 게시판 (Board)

페이지 URL 등록 상세 수정 비고
게시판 목록 /ko/board [ ] [ ] [ ]

8. 고객센터 (Customer Center)

페이지 URL 등록 상세 수정 비고
1:1 문의 /ko/customer-center/qna [ ] [ ] [ ]

9. 품질관리 (Quality)

페이지 URL 등록 상세 수정 비고
검사관리 /ko/quality/inspections [ ] [ ] [ ]

10. 출고관리 (Outbound)

페이지 URL 등록 상세 수정 비고
출하관리 /ko/outbound/shipments [ ] [ ] [ ]

오류 상세 기록

공통 버그: locale 누락

  • 증상: /ko/accounting/sales 접속 시 URL이 /accounting/sales로 변경됨
  • 영향: 모든 페이지에서 locale /ko/가 누락되는 현상

매출관리 (/ko/accounting/sales)

기능 실제 URL 예상 URL 상태
등록 /accounting/sales?mode=new /ko/accounting/sales?mode=new locale 누락
상세 /accounting/sales/83 /ko/accounting/sales/83?mode=view locale + ?mode=view 누락
수정 /accounting/sales/83?mode=edit /ko/accounting/sales/83?mode=edit locale 누락

검수 진행 현황

  • 시작: 2026-01-23
  • 완료: 진행 중
  • 검수자: Claude