Hangsha Android

교내의 다양한 행사 일정을 한곳에서 확인하고, 관심 있는 행사를 자신의 일정과 함께 관리할 수 있는 Hangsha의 Android 애플리케이션입니다.

월별 캘린더에서 행사를 탐색하는 것부터 관심 행사 저장, 행사별 메모 작성, 시간표와 행사 일정 확인까지 하나의 앱에서 제공합니다. 로그인하지 않아도 행사 정보를 둘러볼 수 있으며, 로그인하면 개인화 기능을 사용할 수 있습니다.

주요 기능

• 행사 캘린더: 월별 캘린더와 날짜별 목록으로 행사 일정을 확인할 수 있습니다.
• 검색과 필터: 행사명으로 검색하고 행사 종류, 주최 기관, 모집 현황 및 제외 키워드로 원하는 행사만 골라볼 수 있습니다.
• 행사 상세 정보: 행사의 일정과 세부 내용을 확인하고, 잘못된 행사 정보는 앱에서 바로 제보할 수 있습니다.
• 관심 행사 관리: 관심 있는 행사를 찜하고 마이페이지에서 다시 확인할 수 있습니다.
• 행사 후기와 메모: 행사별 메모와 태그를 작성하고, 작성한 내용을 한곳에서 조회·수정·삭제할 수 있습니다.
• 관심사 우선순위: 선호하는 행사 카테고리와 주최 기관을 설정해 먼저 보고 싶은 행사를 개인화할 수 있습니다.
• 시간표 관리: 시간표를 만들고 수업을 직접 추가하거나 SNUTT 시간표를 가져올 수 있습니다. 주간 시간표 위에서 행사 일정도 함께 확인할 수 있습니다.
• 다양한 로그인 방식: 이메일과 Google, Kakao, Naver 로그인을 지원하며 게스트로도 시작할 수 있습니다.

기술 구성

• Kotlin
• Jetpack Compose
• Hilt
• Retrofit
• Material 3

개발 환경

• Android Studio
• JDK 11
• Android SDK (compile SDK 36)
• 최소 지원 Android SDK 24

로컬 실행

1. Android Studio에서 이 프로젝트를 엽니다.
2. 프로젝트 루트에 local.properties 파일을 만들고, 필요한 로컬 설정값을 추가합니다. 이 파일은 민감한 값이 포함될 수 있으므로 Git으로 관리하지 않습니다.
3. Android Studio에서 app의 debug 변형을 선택해 실행하거나, 아래 명령을 실행합니다.

./gradlew.bat assembleDebug

브랜치 규칙

브랜치는 아래의 순서와 목적에 따라 관리합니다.

브랜치	목적	병합 대상
dgddgd	주 작업 브랜치입니다. 기능 개발과 일상적인 작업은 이 브랜치에서 진행합니다.	develop
develop	새 기능 개발이 완료된 상태를 모아 두는 통합 브랜치입니다.	deploy
deploy	기존 master 브랜치에 해당합니다. 실제 앱스토어에 배포된 코드를 보관하는 배포 브랜치입니다.	앱스토어 배포

기본 작업 흐름은 다음과 같습니다.

1. dgddgd에서 기능을 개발하고 검증합니다.
2. 기능 개발이 완료되면 develop으로 병합합니다.
3. 배포할 변경사항이 준비되면 develop의 내용을 deploy로 병합한 뒤 앱스토어에 배포합니다.

배포 안정성을 위해 deploy에는 긴급 수정이나 검증된 배포 변경사항만 직접 반영합니다.