📢 팀 프로젝트 커밋 컨벤션(Commit Convention) 표준 적용 안내

[frydaynar]

✅ Commit Convention (커밋 규칙)

1. 도입 배경 및 목적

• 공통 가이드 준수
  공통 플랫폼에서 정의된 GitHub Ground Rule 및 워크플로우(v1.3)를 팀 프로젝트에 동일하게 적용하여 협업의 일관성을 유지합니다.
• 이력 추적성 확보
  모든 코드 변경 사항을 관련 이슈(Issue)와 연결하여, '누가, 왜, 무엇을' 수정했는지 명확히 파악할 수 있도록 합니다.
• 관리 효율화
  Frontend, Backend, DB, AI Agent 파트의 병렬 개발 시 코드 리뷰 및 통합 과정을 원활하게 합니다.

2. 커밋 메시지 규칙 (Commit Message Rule)

모든 커밋은 작업 내용을 한눈에 파악할 수 있도록 아래 형식을 반드시 준수해야 합니다.

📌 메시지 형식

작업 내용 (#Issue번호)

✅ 작성 예시

• [FE] 파트너 사 디렉토리 및 대시보드 UI 구현 (#18)
• [DB] 공급망 협력사 데이터 스키마 설계 (#12)
• [BE] 실시간 리스크 평가 API 로직 구현 (#25)
• [AI] 에이전트 프롬프트 최적화 및 테스트 (#30)
• [DB] DB 커넥션 풀 설정 오류 수정 (#42)

3. 커밋 원칙 (Commit Principles)

커밋 시 아래의 3대 원칙을 반드시 지켜주시기 바랍니다.

1. 기능 단위 커밋
   하나의 커밋은 논리적으로 독립된 하나의 기능(또는 수정) 단위를 담아야 합니다.
2. 혼합 커밋 지양
   서로 다른 이슈에 해당하는 작업 내용을 하나의 커밋에 섞어서 작성하지 마십시오.
3. 의미 있는 커밋 관리
   '수정', '백업' 등 작업 내용을 알 수 없는 커밋이나 의미 없는 대량 커밋은 지양하며, 기록되지 않은 작업은 관리되지 않는 작업임을 명심해야 합니다.

4. 적용 대상 및 시점

• 대상 : dev_triplevalues 레포지토리에서 진행되는 모든 개발 파트 (Frontend, Backend, DB, AI Agent)
• 시점 : 공지 즉시 (M3 서비스 개발 및 통합 단계 전체 적용)

---

📎 관련 근거

• [공지] 프로젝트 협업을 위한 GitHub Ground Rule 및 워크플로우 (v1.3)
• [Engineering Standards] 통합 개발 표준 및 보안 가이드라인

위 결정 사항은 우리 팀이 '실무형 Product Team' 으로서 협업하기 위한 최소한의 약속입니다.
팀원분들의 적극적인 준수 부탁드립니다.

[mpsddd-commits]

확인했습니다