chore:CLAUDE.md 프로젝트 설정 파일 추가
This commit is contained in:
71
CLAUDE.md
Normal file
71
CLAUDE.md
Normal 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
|
||||
Reference in New Issue
Block a user