From d20e106964669b22ec2214a19b476a1e00237806 Mon Sep 17 00:00:00 2001
From: pro <lightone2017@codebridge-x.com>
Date: Wed, 21 Jan 2026 19:11:25 +0900
Subject: [PATCH] =?UTF-8?q?chore:CLAUDE.md=20=ED=94=84=EB=A1=9C=EC=A0=9D?=
 =?UTF-8?q?=ED=8A=B8=20=EC=84=A4=EC=A0=95=20=ED=8C=8C=EC=9D=BC=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CLAUDE.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..63e6268d
--- /dev/null
+++ b/CLAUDE.md
@@ -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