Files
sam-react-prod/claudedocs/_index.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

3.4 KiB

claudedocs 문서 맵

프로젝트 기술 문서 인덱스 (Last Updated: 2026-02-23)

빠른 참조

문서 설명
[REF] all-pages-test-urls.md 전체 페이지 테스트 URL 목록
[REF] technical-decisions.md 프로젝트 기술 결정 사항 (13개 항목)
[GUIDE] common-page-patterns.md 공통 페이지 패턴 가이드

폴더 구조

claudedocs/
├── _index.md              # 이 파일 - 문서 맵
├── auth/                  # 인증 & 토큰 관리
├── hr/                    # 인사관리 (부서/사원)
├── item-master/           # 품목기준관리
├── production/            # 생산관리 (생산현황판/작업자화면)
├── quality/               # 품질관리 (검사관리)
├── sales/                 # 판매관리 (견적/거래처/단가)
├── accounting/            # 회계관리 (매입/매출/출금)
├── construction/          # 주일 공사 MES
├── board/                 # 게시판 관리
├── settings/              # 설정 관리
├── dashboard/             # 대시보드 & 사이드바
├── security/              # 보안 & 권한
├── api/                   # API 통합
├── dev/                   # 개발도구 & 테스트
├── guides/                # 범용 가이드
│   ├── mobile/            # 모바일 반응형
│   ├── universal-list/    # UniversalListPage 관련
│   └── migration/         # 마이그레이션 체크리스트
├── architecture/          # 아키텍처 & 시스템 & 기술 결정
├── changes/               # 변경이력
├── refactoring/           # 리팩토링 체크리스트
├── vehicle/               # 차량관리
├── material/              # 자재관리
├── approval/              # 결재관리
├── customer-center/       # 고객센터
├── components/            # 컴포넌트 문서
├── vercel/                # Vercel 배포
└── archive/               # 레거시/완료된 문서
    └── sessions/          # 만료된 세션 체크포인트

문서 작성 규칙

파일명 컨벤션

[TYPE-YYYY-MM-DD] description.md

TYPE 종류:

  • IMPL - 구현 문서
  • API - API 명세/요청
  • GUIDE - 사용 가이드
  • REF - 참조 문서
  • ANALYSIS - 분석 노트
  • PLAN - 계획 문서
  • DESIGN - 설계 문서
  • TEST - 테스트 가이드
  • NEXT - 다음 작업 목록 (세션 체크포인트)
  • FIX - 버그 해결 문서
  • QA - 품질 검사 문서
  • HOTFIX - 긴급 수정 문서
  • REPORT - 보고서/전달 문서

폴더 배치 기준

  1. 기능/도메인 우선: 문서 주제에 맞는 폴더에 배치
  2. 범용 가이드: 여러 기능에 적용되면 guides/에 배치
  3. 시스템 전체: 아키텍처/리팩토링/기술결정은 architecture/에 배치
  4. 개발도구: 테스트 URL, 빌드, E2E, 설정은 dev/에 배치
  5. 완료된 작업: 더 이상 활성화되지 않으면 archive/로 이동
  6. 만료 세션: 2개월 이상 경과한 NEXT-* 파일은 archive/sessions/로 이동

파일 목록 확인

# 특정 도메인 파일 확인
ls claudedocs/<domain>/

# 전체 파일 검색
find claudedocs/ -name "*.md" | sort