sam-react-prod/claudedocs/_index.md

# claudedocs 문서 맵

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

## 빠른 참조

| 문서 | 설명 |
|------|------|
| **[`[REF] all-pages-test-urls.md`](./dev/[REF]%20all-pages-test-urls.md)** | 전체 페이지 테스트 URL 목록 |
| **[`[REF] technical-decisions.md`](./architecture/[REF]%20technical-decisions.md)** | 프로젝트 기술 결정 사항 (13개 항목) |
| **[`[GUIDE] common-page-patterns.md`](./guides/[GUIDE]%20common-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/`로 이동

### 파일 목록 확인
```bash
# 특정 도메인 파일 확인
ls claudedocs/<domain>/

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