🔹CBNU SW 포털 (충북대학교 소프트웨어학부 통합 웹 플랫폼)
🔹CBNU Software portal

📬 Contact

PM 이예솔 | yesol4138@chungbuk.ac.kr

👥 Team

이예솔 PM / FE

김다민 FE / FE

조재영 디자인 / FE

허채민 BE

📝 Purpose

충북대학교 소프트웨어학부 학생들이 흩어진 정보를 한곳에서 확인하고
소통 및 협업을 원활히 할 수 있도록 지원하는 통합 웹 플랫폼

🛠️ Tools

Notion 프로젝트 페이지 notionlink

🤝 GitHub 협업 전략

본 프로젝트는 팀원 간의 효율적인 협업과 충돌 최소화를 위해 아래와 같은 GitHub 전략을 따릅니다.

---

🔧 브랜치 전략

1. 모든 팀원은 자신의 이름을 기준으로 브랜치를 하나씩 생성하여 관리합니다.
2. main 브랜치는 최종 배포용 브랜치로, 직접 push하지 않고 Pull Request(PR)를 통해서만 병합됩니다.
3. 브랜치 구조
   
   
   📁 main ← 최종 결과물
   
   ├── 📁 yesol ← 예솔의 작업 브랜치
   
   ├── 📁 jaeyoung ← 재영의 작업 브랜치
   
   ├── 📁 chaemin ← 채민의 작업 브랜치
   
   └── 📁 damin ← 다민의 작업 브랜치
   
   
   

---

🚀 작업 방식

1. 모든 팀원은 각자 GitHub에서 초대받은 4WARD 팀의 local repository를 Fork합니다.
2. 자신의 Fork된 저장소를 local로 Clone합니다. git clone http://gitgub.com/팀원계정명/4WARD.git
3. 자신의 브랜치에서만 작업합니다.
4. 작업 내용을 Fork해간 자신의 repository로 Push합니다.
5. git pull origin main와 'Sync Fork'로 최신 상태를 자주 반영합니다.
6. 작업이 완료되면 **PR(Pull Request)**을 생성해 4WARD 팀의 local repository branch로 병합 요청합니다.
7. PR은 팀원 1인 이상의 확인(리뷰) 후 병합합니다.

---

🔒 브랜치 보호 규칙

• 브랜치는 다음과 같이 보호됩니다:
  • ✅ PR을 통해서만 병합 가능
  • ✅ 최소 1명 이상의 리뷰 필요
  • ✅ 직접 push 금지

👉 이로 인해 의도치 않은 충돌이나 오류 발생을 사전에 방지할 수 있습니다.

---

🛑 브랜치 접근 규칙

• 다른 팀원의 브랜치에는 push하지 않습니다.
• 필요한 경우 pull만 허용하여 참고할 수 있습니다.
• 개인 브랜치 내 작업은 자율적으로 관리하며, 팀 내 약속된 스타일과 구조를 따릅니다.

---

💻 커밋 & PR 규칙

• 의미 있는 커밋 메시지 작성을 권장합니다.
  • 예: (#이슈번호) [본인 이름]
• PR 제목은 명확하게 작성하며, 설명에는 변경 사항 요약을 포함합니다.
• PR 시 PM이 등록해 둔 PR 팀플릿을 반드시 작성해 작업 내용을 명확히 합니다.

---

🧭 예시 워크플로우

# 1. 브랜치 생성 (최초 1회) - PM이 담당
git checkout -b yesol

# 2. 내 레포지토리 git clone
cd /c/projects
git clone https://github.com/ieeyesoi/4WARD.git
cd 4WARD
git status

#3. 원본 저장소 연결
git remote add upstream https://github.com/ieeyesoi/4WARD.git
git remote -v
-> 출력 예시
	origin    https://github.com/본인계정명/4WARD.git (fetch)
	origin    https://github.com/본인계정명/4WARD.git (push)
	upstream  https://github.com/ieeyesoi/4WARD.git (fetch)
	upstream  https://github.com/ieeyesoi/4WARD.git (push)

# 4. 작업 브랜치 설정
git fetch upstream
git checkout yesol
git branch
	
# 5. 작업 & 커밋
git status
git add .
git commit -m "(#이슈번호) [본인 이름]"
git push origin 본인 이름

# 6. PR 생성 → main 브랜치로 병합 요청