sam-manage/CLAUDE.md

Claude Code 프로젝트 설정

Git 커밋 규칙 (필수)

중요: 모든 코드 작업 완료 후 반드시 Git 커밋을 수행해야 합니다.

커밋 절차

1. 작업 완료 후 git add 로 수정된 파일 스테이징
2. 적절한 커밋 메시지로 git commit 실행

커밋 메시지 형식

• feat: - 새로운 파일/기능 생성 시
  • 예: feat:재무 대시보드 페이지 추가
• fix: - 기존 코드 수정/버그 수정 시
  • 예: fix:HTMX 리다이렉트 처리 개선
• refactor: - 코드 리팩토링 시
• docs: - 문서 수정 시
• chore: - 설정 파일, 빌드 관련 수정 시

커밋 예시

git add app/Http/Controllers/Finance/FinanceDashboardController.php
git add resources/views/finance/dashboard.blade.php
git commit -m "feat:재무 대시보드 페이지 추가"

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 부분 로드 시 스크립트가 실행되지 않으므로 전체 페이지 리로드 필요:

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