README.md

🐧 React:ON

목차

• 서비스 소개
  • 기획 배경
  • 주요 기능
  • 기대 효과
• 팀원별 역할
• 기술 스택
• 아키텍처
• 그라운드 룰
• 개발 룰

[1] 서비스 소개

🎯 React:ON이란?

React:ON은 교수와 학생 간의 실시간 상호작용을 촉진하는 웹 서비스입니다. 학생들은 보다 능동적으로 의견을 표현할 수 있으며, 교수는 즉각적인 피드백을 받을 수 있도록 돕습니다.

1-1 기획 배경

📌 문제점

🎓 대면 강의에서 학생들의 적극적인 참여 부족

✅ 해결책

💡 실시간 리액션과 익명 질문 기능 제공
🤝 학생들이 질문하기 어려운 환경에서도 쉽게 의견을 표현할 수 있도록 합니다.
📊 교수는 학생들의 반응을 실시간으로 확인하고, 수업 몰입도를 높이는 피드백을 제공합니다.
🔗 학생과 교수 간의 소통을 활성화하여 능동적인 수업 환경을 조성합니다.

1-2 주요 기능

1-3 기대 효과

✔ 기존 수업에서 질문하지 않던 학생들도 더 적극적으로 참여
✔ 교수는 학생들의 반응을 주기적으로 확인하여 강의 개선이 용이
✔ 교수와 학생 간의 소통이 증가하여 수업 만족도 상승

[2] 팀원별 역할

김선오	김유리	김동영	김민교
BE	BE	FE	FE
SSE 서버 구축 성능 테스트 DB 최적화 Oauth 로그인 구현 실시간 수업 API 조회 API	협업 관련 자동화 OAuth 로그인 구현 서버 인프라 구축 CI/CD 구축 DB 최적화 S3 파일 관련 API 회원, 수업 관련 API	학생 페이지 및 기능 구현 PDF 기능 구현	교수 페이지 및 기능 구현 PDF 기능 구현 프론트엔드 배포

[3] 기술 스택

프론트엔드

백엔드

협업

[4] 아키텍처 & CI/CD

🛠️ 백엔드 아키텍처

🚀 백엔드 CI/CD

프론트엔드 CI/CD

[5] 그라운드 룰

우리 팀의 원활한 협업을 위한 기본 규칙과 회의, 스프린트 기준, 소통 방식을 정리했습니다.

궁금하시다면 링크를 클릭해 주세요! 🚀

[6] 개발 룰

🌿 브랜치 전략

Git Flow 기반의 단순화된 전략

브랜치 구조

• main : 배포 브랜치
• dev : 개발 브랜치로 main에 병합되기 전 모든 개발 작업을 합치는 브랜치
• 기능별 브랜치 : dev 브랜치에서 파생되는 브랜치로 유형 뒤에 fe/be로 프론트엔드와 백엔드 구분
  • ex) feat/fe/기능명

📌 GitHub 활용

• Issue : 스프린트 단위로 이슈 생성 및 관리
• Milestone : 이슈와 연결하여 마감 기한 설정
• Discussions : 논의할 모든 사항을 기록
• Pull Request (PR)
  • 코드 변경 사항 반영 및 리뷰 진행
  • 최소 1인 이상의 Approve 필요
• Projects : 스프린트별 진행 상황 관리
• Wiki : 회의록, 데일리 스크럼, 개발 문서 보관

💬 커밋 컨벤션

유형: 커밋 메시지 #이슈번호

- 커밋 메시지 내용
- 커밋 메시지 내용
- 커밋 메시지 내용

유형	설명
✨ Feat	새로운 기능의 추가
🐞 Fix	버그 수정
📃 Docs	문서 수정
🔨 Refactor	코드 리팩토링
✅ Test	테스트 코드
🔧 Chore	기타