참고용 레포: https://github.com/aws-cloud-clubs/2026-ACC-EWHA-PAYLINKER-BE

[RULE] Code & Naming Convention

<aside>

</aside>

0. 문서 목적

본 문서는 Frontend 팀에서 사용하는 Git convention 및 GitHub 기반 워크플로우를 정의하기 위해 작성되었습니다. 작업 흐름을 표준화하여 협업 시 혼선을 줄이고, 코드 리뷰·테스트·배포 과정을 일관되게 유지하는 것을 목표로 합니다.

1번 섹션은 전반적인 워크플로우 이해를 위해 사용하시고 (세부적인 내용을 바로 숙지할 필요는 없습니다), 2번 섹션은 실제 작업 시 컨벤션 확인용으로 사용하시면 됩니다.

1. Workflow 개요

본 프로젝트는 GitHub Flow를 기본으로 하되, GitFlow의 dev / main 분리 개념을 부분 적용합니다.

1.1 고정 브랜치

• main
  • 프로덕션 및 릴리즈 브랜치
  • 직접 커밋 금지
  • 정기 배포 (milestone)
• dev
  • 통합 및 테스트 브랜치, 개발 중 확인용 브랜치
  • 모든 기능은 dev를 거쳐 main로 반영
  • 무중단 배포

1.2 작업 흐름

모든 작업은 아래 순서를 반드시 따릅니다.

1.2.1 Issue 생성

작업 단위를 Issue 단위로 관리합니다. 모든 작업은 Issue 생성으로 시작합니다.

• 이슈 템플릿 선택: 기능 / 버그 / 태스크로 분리.

• 이슈 제목 규칙: prefix: 작업과 관련된 한국어 설명

  • 예시

    feat: 회원가입 API 추가
    docs: swagger 설명 보완
    

• 이슈 라벨 설정

  • prefix / status / priority 라벨 각각 한 개씩 설정하는 것을 필수로 합니다.