2025 HSU Festival

2025 한성대 대동제 웹사이트 프론트엔드 레포지토리

🎉 서비스 소개

2025 HSU Festival은 컴퓨터공학부 4명, 미디어디자인트랙 1명이 함께 진로탐색학점제 프로젝트로 제작된 웹사이트입니다.
대동제 정보가 여러 SNS(에브리타임, 인스타그램)에 흩어져있는 불편함을 해소하고자 제작되었습니다.

✨ 주요 기능

• 메인 홈(타임테이블)
• 공지사항, 사이트 정보
• 챗봇
• 커뮤니티
• 부스정보(부스, 푸드트럭, 프로모션)

🧑‍💻 팀원 소개

임혜정	김혜진	김건우	정예빈
@frombunny	@khyaejin	@kmgnw.png	@benniejung
BE 개발(부스정보, 커뮤니티)	BE 개발(공지사항, 챗봇)	FE 개발(커뮤니티, 챗봇)	FE 개발(메인화면, 공지사항, 부스 정보)

📁 프로젝트 폴더 구조

HSU-Festival-FE/
├── public/
├── src/
│   ├── api/             # 백엔드 API 요청 함수 정리
│   ├── assets/          # 이미지 및 기타 리소스
│   ├── components/      # 공통 컴포넌트
│   ├── hooks/           # 커스텀 훅
│   ├── layouts/         # 페이지 공통 레이아웃 컴포넌트 (예: Header, Footer 포함 레이아웃)
│   ├── pages/           # 페이지 단위 컴포넌트
│   ├── shared/          # 공용 타입, 상수, 유틸 함수 등
│   ├── stores/          # 전역 상태 관리 (Zustand)
│   ├── styles/          # 스타일링
│   └── App.jsx
├── .gitignore
├── package.json
└── README.md

🛠 기술 스택

역할	종류
Library
Language
Styling
Data Fetching
Formatting
Package Manager
Version Control
Deploy

📏 컨벤션

Git Convention

🌐 Git Flow

• main: 프로젝트가 최종적으로 배포되는 브랜치
• develop: 다음 출시 버전을 개발하는 브랜치
• feature: 기능을 개발하는 브랜치

📌 Git branch 규칙

1. 개인 작업은 꼭 feature 브랜치에서 하기
2. 모든 작업 시작 전 develop에서 pull을 받은 후, feature 브랜치에서 작업 시작
3. 개인 작업 마치면 feature 브랜치로 pull request를 통해 develop에 merge하기
4. 프로젝트 완료 후 main으로 merge

📝 Feature branch

1. 브랜치명은 아래의 형식으로 작성합니다. (feature/이름-기능제목#이슈번호)

   • 팀원 sheepyis의 브랜치명: feature/sheepyis-login#1

2. Feature branch -> develop branch로 merge하기 전 PR에서 reviewers 설정하여 팀원 1명 이상에게 approve 받기

3. PR 후 팀원들에게 공지하기

🎯 Commit Convention

1. 커밋 메시지의 형식은 아래처럼 통일해 주세요.

   • ✨feat: 로그인 페이지 UI 개발

2. 깃모지를 사용해 주세요.

🎉 Start: Start New Project [:tada]

✨ Feat: 새로운 기능을 추가 [:sparkles]

🐛 Fix: 버그 수정 [:bug]

🎨 Design: CSS 등 사용자 UI 디자인 변경 [:art]

♻️ Refactor: 코드 리팩토링 [:recycle]

🔧 Settings: Changing configuration files [:wrench]

🗃️ Comment: 필요한 주석 추가 및 변경 [:card_file_box]

➕ Dependency/Plugin: Add a dependency/plugin [:heavy_plus_sign]

📝 Docs: 문서 수정 [:memo]

🔀 Merge: Merge branches [:twisted_rightwards_arrows:]

🚀 Deploy: Deploying stuff [:rocket]

🚚 Rename: 파일 혹은 폴더명을 수정하거나 옮기는 작업만인 경우 [:truck]

🔥 Remove: 파일을 삭제하는 작업만 수행한 경우 [:fire]

⏪️ Revert: 전 버전으로 롤백 [:rewind]