[규칙] Issue & Label 규칙

[frankie516c]

📢 Issue & Label 운영 규칙 안내

1️⃣ 운영 목적

모든 작업 흐름을 GitHub Issue 기준으로 관리합니다.

Issue를 통해:

• 현재 시스템 상태 공유
• 기능 진행 흐름 추적
• 일정 및 리스크 관리
• 협업 가시성 확보

를 목표로 합니다.

---

2️⃣ Issue 운영 원칙

선(先) Issue - 후(後) 작업

모든 작업은 Issue 생성 후 진행합니다.

기능 흐름 중심 작성

영역(FE/BE/DB) 중심보다 기능 흐름 기준으로 작성합니다.

제목 형식

[유형] 작업 내용

예시

[기능] 배출량 자동 산정 기능 구현

[설계] AI 리포트 생성 구조 정의

[개선] 업로드 예외 처리 강화

[문서] README 구조 개선

---

3️⃣ 필수 지정 항목

• Label
• Milestone
• Assignee

---

4️⃣ Label 운영 체계

상태(Label)

Label	의미
⛔ 진행 불가	외부 의존성 또는 이슈로 작업 진행 불가
🚧 진행 중	현재 개발 진행 중
🎉 완료	작업 완료 및 반영됨

---

작업 유형(Label)

Label	의미
✨ 기능	신규 기능 개발
🐞 버그	오류 수정 및 버그 대응
♻️ 리팩토링	코드 구조 개선 및 리팩토링
📝 문서	문서 작성 및 수정
🧪 테스트	테스트 코드 및 검증 작업

---

영역 유형(Label)

Label	의미
🤖 AI	AI/모델/에이전트 관련 작업
⚙️ BE	백엔드 관련 작업
🗄️ DB	데이터베이스 및 데이터 처리 작업
🖥️ FE	프론트엔드 관련 작업
☁️ INFRA	배포 및 인프라 관련 작업

---

5️⃣ Milestone 연동

모든 이슈는 현재 진행 중인 Milestone과 연결합니다.

• [M1] 프로젝트 기반 구축
• [M2] 핵심 기능 구현
• [M3] 통합 및 안정화
• [M4] 최종 안정화 및 발표 준비

---

Issue는 작업 목록이 아니라,
현재 시스템 상태를 공유하는 단위입니다.