SSU 학생동아리 홈페이지 프론트엔드

📖 프로젝트 소개

숭실대학교 동아리 연합회 홈페이지의 프론트엔드 프로젝트입니다. 최신 React/Vite/TypeScript 기반으로 개발되며, RESTful API와 연동합니다.

---

👥 팀 멤버

이름	GitHub	역할
김경주	StarvingOrange	Frontend
이태건	taegeon2	Frontend
홍준우	AndyH0ng	Frontend

---

🛠 기술 스택

• Language: TypeScript
• Framework: React 19, Vite
• State: Zustand, React Query
• Form: React Hook Form, Zod
• Style: Tailwind CSS
• API: Axios
• Lint/Format: Biome, ESLint
• Build Tool: Vite

---

📋 Git Convention

브랜치 전략

브랜치	역할
main	실제 배포 가능한 안정 브랜치
develop	다음 배포를 위한 통합 브랜치

브랜치 네이밍

{type}/{issue-number}-{short-description}

type

type	설명
feat	신규 기능 개발
fix	버그 수정
refactor	리팩토링 (기능 변경 없음)
chore	설정, 빌드, 문서 등

커밋 메시지 규칙

형식

type: subject

type

type	설명
feat	새로운 기능 추가
fix	버그 수정
refactor	리팩터링
docs	문서 추가/수정
chore	빌드, 설정, 기타 작업
test	테스트 코드

subject 규칙

• 현재형, 명령문
• 50자 이내
• 마침표 사용 금지

Pull Request 규칙

PR 제목

[type] 이슈 제목

규칙

• 프론트엔드 리뷰어 지정
• approve 1개 이상 시 merge

---

📂 프로젝트 구조

src/
├── App.tsx
├── assets/
├── const/
├── features/         # 백엔드 도메인 기준 분류
│   └── Main/
│       ├── apis/
│       ├── hooks/
│       └── types/
├── index.css
├── layout/
│   └── Layout.tsx
├── main.tsx
└── ui/               # 프론트 도메인 (UI) 기준 분류
    └── Main/
        ├── MainPage.tsx
        └── components/

---

📝 환경설정

• 커밋 컨벤션: commitlint + conventional commits
• 코드 스타일: biome, eslint, tailwind
• 자동 포맷/수정: lint-staged, biome
• 빌드/실행: pnpm run dev, pnpm run build

---

💡 기타

문의 및 제안은 Issue 또는 PR로 남겨주세요.