📢 팀 프로젝트 Issue / Label 운영 표준 적용 안내

[frydaynar]

✅ Issue / Label 운영

1. 도입 배경 및 목적

• 선(先) Issue 원칙 확립
  모든 작업은 이슈 생성에서 시작하며, 기록되지 않은 작업은 관리되지 않는 작업으로 간주합니다
• 가시성 확보
  이슈와 라벨을 통해 프로젝트의 현재 진행 상태와 파트별(Front/Back/DB/AI) 작업 현황을 한눈에 파악합니다
• 마일스톤 동기화
  모든 이슈를 전체 프로젝트 마일스톤과 연결하여 일정 지연 리스크를 사전에 관리합니다

2. 이슈(Issue) 관리 규칙

• 선(先) 이슈 - 후(後) 브랜치
  이슈 번호가 없는 브랜치 생성은 금지되며, 반드시 이슈를 먼저 생성한 후 해당 번호를 포함하여 작업합니다

• 제목 형식
  [파트] 작업 내용 형식을 반드시 준수합니다

  • 예시 : [FE] 파트너 사 디렉토리 및 대시보드 UI 구현 (#18)
  • 예시 : [BE] 공급망 리스크 평가 API 개발 (#12)
  • 예시 : [DB] 협력사 마스터 데이터 스키마 설계 (#15)
  • 예시 : [AI] 에이전트 프롬프트 전략 수립 (#20)

• 필수 포함 항목
  이슈 생성 시 아래 내용을 반드시 작성해야 합니다

  • 작업 목적 : 해당 작업을 수행하는 이유
  • 상세 작업 내용 : 체크리스트 형식의 세부 태스크
  • 완료 조건(DoD) : 작업이 완료되었다고 판단할 수 있는 기준
  • Assignee / Label / Milestone : 우측 설정창에서 반드시 지정

3. 라벨(Label) 운영 체계

프로젝트 상태와 작업 성격을 구분하기 위해 아래와 같은 이중 라벨 체계를 운영합니다.

① 상태 추적 라벨 (Status Labels)

Label	의미
🏗 building	기능 개발 및 작업 진행 중
👀 needs review	코드 리뷰 또는 결과물 검토 필요
✅ merge ready	리뷰 완료 및 병합 가능 상태
⛔ blocked	외부 요인 또는 의존성으로 인해 작업 중단
📚 archiving	문서 및 지식 자산 정리 중 (확정 공지 등)

② 작업 타입 라벨 (Type Labels)

Type	Label	상세 내용
Type A	Feature, Bug	신규 기능 개발, 오류 수정
Type B	Update, Refactoring	단순 갱신, 코드 구조 개선
Type C	Trouble Shooting	기술적 난제 해결 및 의사결정 기록
Type D	Release	산출물 배포 및 버전 관리

4. 마일스톤(Milestone) 연결

모든 이슈는 현재 진행 중인 마일스톤에 반드시 연결되어야 하며,
'공통' 마일스톤의 '[M3] 서비스 개발 및 통합 (Sprint)' 에 준수합니다.

• [M3-1] 공급망 매핑 및 원재료 추적 로직 구현 단계
• [M3-2] 탄소 배출량(CBAM/CSDDD) 계산 엔진 개발 단계
• [M3-3] UI/UX 컴포넌트 결합 및 데이터 시각화 단계
• [M3-4] 통합 테스트 및 트러블슈팅 기록 단계 (~6/5)

---

📎 관련 근거 및 문서

• [공지] 프로젝트 협업을 위한 GitHub Ground Rule 및 워크플로우 (v1.3)
• [WITH] 프로젝트 GitHub 협업 및 운영 가이드 (v1.3)

"기록되지 않은 작업은 관리되지 않은 작업이며, 검토되지 않은 변경은 팀 자산이 될 수 없습니다."
우리 팀은 실무형 Product Team으로서 이 원칙을 엄격히 준수하여 ESG 공급망 관리 시스템을 성공적으로 구축해 나갈 것입니다.