sam-react-prod/claudedocs/_index.md

claudedocs 문서 맵

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

빠른 참조

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

주간 구현내역

기간	문서
2026-03-02 ~ 03-08	[IMPL-2026-03-08] frontend-weekly-0302-0308.md
(백엔드 일별)	backend/2026-03-02_구현내역.md ~ 2026-03-08_구현내역.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/           # 리팩토링 체크리스트
├── outbound/              # 출하/배차관리
├── vehicle/               # 차량관리
├── material/              # 자재관리
├── approval/              # 결재관리
├── backend/               # 백엔드 일별 구현내역
├── 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