chore:CLAUDE.md 프로젝트 설정 파일 추가

This commit is contained in:
pro
2026-01-21 19:11:25 +09:00
parent 79c60f074c
commit d20e106964

71
CLAUDE.md Normal file
View File

@@ -0,0 +1,71 @@
# Claude Code 프로젝트 설정
## Git 커밋 규칙 (필수)
**중요: 모든 코드 작업 완료 후 반드시 Git 커밋을 수행해야 합니다.**
### 커밋 절차
1. 작업 완료 후 `git add` 로 수정된 파일 스테이징
2. 적절한 커밋 메시지로 `git commit` 실행
### 커밋 메시지 형식
- `feat:` - 새로운 파일/기능 생성 시
- 예: `feat:재무 대시보드 페이지 추가`
- `fix:` - 기존 코드 수정/버그 수정 시
- 예: `fix:HTMX 리다이렉트 처리 개선`
- `refactor:` - 코드 리팩토링 시
- `docs:` - 문서 수정 시
- `chore:` - 설정 파일, 빌드 관련 수정 시
### 커밋 예시
```bash
git add app/Http/Controllers/Finance/FinanceDashboardController.php
git add resources/views/finance/dashboard.blade.php
git commit -m "feat:재무 대시보드 페이지 추가"
```
```bash
git add app/Http/Controllers/DailyLogController.php
git commit -m "fix:DailyLogController HTMX 리다이렉트 처리 추가"
```
### 주의사항
- 커밋 메시지는 한글로 작성
- 여러 파일 수정 시 관련 파일들을 함께 커밋
- 작업 단위별로 커밋 분리 (하나의 기능/수정 = 하나의 커밋)
---
## 프로젝트 기술 스택
- **Backend**: Laravel 11 (PHP 8.3)
- **Frontend**: Blade + HTMX + Tailwind CSS
- **React 페이지**: React 18 + Babel (브라우저 트랜스파일링)
- **Database**: MySQL 8
## HTMX 네비게이션 규칙
### HX-Redirect가 필요한 페이지
복잡한 JavaScript가 `@push('scripts')`에 있는 페이지는 HTMX 부분 로드 시 스크립트가 실행되지 않으므로 전체 페이지 리로드 필요:
```php
public function index(Request $request): View|Response
{
if ($request->header('HX-Request')) {
return response('', 200)->header('HX-Redirect', route('...'));
}
// ...
}
```
적용 대상:
- React 컴포넌트 사용 페이지 (VAT, 미수금, 미지급금 등)
- API Explorer, Flow Tester
- Daily Logs (toggleAttentionItem 등 함수 사용)
### HX-Redirect가 불필요한 페이지
단순 Blade 템플릿 (JavaScript 없음):
- 재무 대시보드
- 계좌관리 (accounts/*)
- FCM 관리
- API Logs