👋 Welcome to Bike Share

🛠️ 사용 도구 및 기술 스택

• UML 모델링: [Umbrello UML Modeller]

🧭 개요

Bike Share는 사용자가 자전거를 쉽게 대여하고 반납할 수 있도록 지원하는 공유 자전거 시뮬레이션 시스템입니다. 본 프로젝트는 2025년도 소프트웨어공학 과목의 팀 프로젝트로 진행됩니다.

사용자는 일반 자전거 또는 전기 자전거를 선택해 대여할 수 있으며 대여소 검색, 실시간 자전거 현황 조회, 예약 대기, 반납 후 결제 및 외부 서비스 연계(식당 예약 추천) 등 다양한 기능을 이용할 수 있습니다. 관리자는 대여소 및 자전거의 등록/관리와 더불어 통계 기능을 통해 지역별/기간별 사용 현황을 확인할 수 있습니다.

시스템은 다음과 같은 주요 기능을 포함합니다:

• 회원 가입, 탈퇴, 로그인/로그아웃
• 대여소 등록/조회/삭제 및 자전거 등록/조회/삭제
• 대여소 검색, 자전거 즉시 대여 및 예약대기
• 자전거 반납 및 근처 식당 예약 연계
• 요금 자동 결제 및 대여 이력 조회
• 관리자 통계 조회 (최근 사용, 지역별, 기간별 분석)

---

📝 커밋 컨벤션

모든 커밋 메시지는 다음과 같은 형식으로 작성합니다:

Type: 작성 내용

예시:

Feat: 사용자 이용내역 조회 기능 추가

Type	설명
Feat	새로운 기능 추가 시
Fix	버그 수정 시
Docs	문서화 작업 (README, 주석 등)
Style	코드 포맷, 들여쓰기 수정 등 로직 변경 없는 작업
Refactor	코드 리팩터링 (기능 변경 없이 구조 개선)
Chore	빌드 설정, 패키지 매니저 변경 등 기타 작업
Rename	파일 또는 폴더 이름 변경
Remove	파일/코드 제거
Environment	개발 환경 설정 (e.g. ESLint, Prettier, requirements.txt)
!HOTFIX	긴급한 치명적 버그 수정 시 사용 (주의: 신중하게 사용)

⚠️ !HOTFIX는 꼭 필요한 경우에만 사용하며, 변경 내용을 최대한 상세히 남깁니다.

---

✅ PR 규칙

1. main 브랜치에서 개인 작업 브랜치(feature/기능명 또는 fix/이슈명)로 분기하여 작업합니다.

2. 기능 구현 완료 후 main 브랜치로 Pull Request(PR)를 생성합니다.

3. PR 제목은 다음 형식을 따릅니다. [] 안의 키워드는 커밋 컨벤션과 동일합니다.

   예시:

   [Feat] 자전거 반납 기능 추가
   

4. 반드시 Reviewers에 팀원 1명 이상을 추가합니다.

5. Assignees에는 본인을 지정합니다.

6. PR 본문에 다음 항목들을 포함합니다:

   • 변경 요약
   • 관련 기능/화면
   • 테스트 방법 (가능 시)
   • 기타 참고사항 (e.g. 관련 이슈 번호)