9cc8f6b66a
- CLAUDE.md: React/TypeScript/Vite 프로젝트 가이드 - .claude/settings.json: npm/Node.js 빌드 도구 권한 설정 - .claude/rules/: TypeScript/React 코드 스타일, 네이밍, 테스트 규칙 - .githooks/pre-commit: TypeScript 타입체크 + ESLint 검증 - .npmrc: Nexus npm 프록시 레지스트리 - .prettierrc: 코드 포맷팅 설정 - .node-version: Node.js 버전 고정
61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
# 프로젝트 개요
|
|
|
|
- **타입**: React + TypeScript + Vite
|
|
- **Node.js**: `.node-version` 참조
|
|
- **패키지 매니저**: npm
|
|
- **빌드 도구**: Vite
|
|
|
|
## 빌드 및 실행
|
|
|
|
```bash
|
|
# 의존성 설치
|
|
npm install
|
|
|
|
# 개발 서버
|
|
npm run dev
|
|
|
|
# 빌드
|
|
npm run build
|
|
|
|
# 테스트
|
|
npm run test
|
|
|
|
# 린트
|
|
npm run lint
|
|
|
|
# 포맷팅
|
|
npm run format
|
|
```
|
|
|
|
## 프로젝트 구조
|
|
|
|
```
|
|
src/
|
|
├── assets/ # 정적 리소스 (이미지, 폰트 등)
|
|
├── components/ # 공통 UI 컴포넌트
|
|
│ ├── common/ # 범용 컴포넌트 (Button, Input 등)
|
|
│ └── layout/ # 레이아웃 컴포넌트 (Header, Sidebar 등)
|
|
├── hooks/ # 커스텀 훅
|
|
├── pages/ # 페이지 컴포넌트 (라우팅 단위)
|
|
├── services/ # API 호출 로직
|
|
├── store/ # 상태 관리 (Context, Zustand 등)
|
|
├── types/ # TypeScript 타입 정의
|
|
├── utils/ # 유틸리티 함수
|
|
├── App.tsx
|
|
└── main.tsx
|
|
```
|
|
|
|
## 팀 규칙
|
|
|
|
- 코드 스타일: `.claude/rules/code-style.md` 참조
|
|
- 네이밍 규칙: `.claude/rules/naming.md` 참조
|
|
- 테스트 규칙: `.claude/rules/testing.md` 참조
|
|
- Git 워크플로우: `.claude/rules/git-workflow.md` 참조
|
|
- 팀 정책: `.claude/rules/team-policy.md` 참조
|
|
|
|
## 의존성 관리
|
|
|
|
- Nexus 프록시 레포지토리를 통해 npm 패키지 관리 (`.npmrc`)
|
|
- 새 의존성 추가: `npm install 패키지명`
|
|
- devDependency: `npm install -D 패키지명`
|