브랜치/커밋 컨벤션

브랜치 전략

main        ← 배포용 (직접 푸시 금지)
dev         ← 통합 브랜치 (PR로만 머지)
  │
  ├── backend/BRAIN4-XX-기능명
  ├── frontend/BRAIN4-XX-기능명
  └── llm/BRAIN4-XX-기능명

브랜치 이름 규칙

{담당}/{티켓번호}-{영문-작업명}

담당 접두어
백엔드 backend/
프론트엔드 frontend/
LLM llm/

예: backend/BRAIN4-7-django-docker-setup, frontend/BRAIN4-12-chat-ui, llm/BRAIN4-15-prompt-tuning

커밋 메시지 규칙

형식

타입: 제목 (50자 이내)

본문 (선택, 뭘 왜 했는지)

타입 종류

타입 언제 쓰나 예시
feat 새 기능 feat: Policy 모델 추가
fix 버그 수정 fix: 나이 필터링 오류 수정
docs 문서 수정 docs: README 설치방법 추가
style 포맷팅 style: 들여쓰기 정리
refactor 리팩토링 refactor: API 호출 로직 분리
test 테스트 test: 모델 유닛테스트 추가
chore 설정, 빌드 chore: docker-compose 추가
init 초기 생성 init: Django 프로젝트 생성
rename 이름 변경 rename: utils.py → helpers.py
remove 파일 삭제 remove: 사용 안 하는 파일 삭제

좋은 예시

feat: Policy, Category 모델 추가

- M:N 관계로 PolicyCategory 중간 테이블 구성
- district 필드 추가 (자치구 필터링용)

나쁜 예시

수정함
ㅇㅇ
feat: 여러가지 수정