# 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