07374c826c
- 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>
91 lines
3.4 KiB
Markdown
91 lines
3.4 KiB
Markdown
# 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
|
|
```
|