innovationacademy-kr/24hane-ios

🕓 24HANE (42Checkin_v2-iOS)

💬 프로젝트 소개

24 hours are not enough! 24시간이 부족해!

안녕하세요:) 42서울 공식 체크인 서비스 24HANE입니다💌

"24 Hane" (24 hours are not enough) 은 Cadet 여러분의 클러스터 출입 여부와 출입 누적 시간을 직접 확인할 수 있도록 개발된 서비스 입니다.

원활하게 서비스를 이용할 수 있도록 기본 기능을 소개합니다. 👋

카뎃 여러분이 직접 클러스터 출입 누적 시간을 확인할 수 있는 24 HANE 서비스를 소개합니다.
 - 클러스터 출입태깅이 잘 됐는지 궁금한가요?
 - 클러스터 출입 누적 시간이 궁금한가요?

24HANE 서비스를 이용한다면?
 - 클러스터 출입 누적 시간을 오늘 / 월 기준으로 한 눈에 볼 수 있습니다.
 - 지원금 산정의 기준이 되는 인정 시간을 확인할 수 있습니다.
 - 목표 시간을 설정하여 오늘의 학습 시간 진척도를 그래프로 볼 수 있습니다.
 - 최근 6주간 / 6달간의 학습 시간 진척도를 그래프로 볼 수 있습니다.
 - 클러스터에서 학습중인 실시간 인원을 확인할 수 있습니다.
 - 자신의 상세한 클러스터 출입 기록을 일별로 확인할 수 있습니다.(누락된 기록까지!)
 - 자정 전후로 별도 태깅 없이 학습에만 몰입 할 수 있습니다.
 - 카드를 분실한 경우 카드 재발급을 앱에서 신청할 수 있습니다.

앱스토어 링크

• https://apps.apple.com/kr/app/24hane/id1659801775

웹사이트

• https://24hoursarenotenough.42seoul.kr/

🛠 기술 스택

분야	기술스택	선정이유
iOS	Swift	이미 각 플랫폼별로 팀이 나뉘어 있기 때문에 ReactNative나 Flutter등의 크로스플랫폼 보다 Swift를 기반으로 하는 네이티브가 개발중 발생할 수 있는 문제 해결에 유리할 것으로 판단
	SwiftUI	팀원이 모두 앱 개발이 처음이었기 때문에 UIkit의 StoryBoard와 협업을 위해 익숙하지 않은 코드베이스의 작업방식을 배우기 보다는 상대적으로 러닝커브가 낮은 SwiftUI를 선택
Architecture	✨ MVVM	24HANE.ver1 개발 당시 뚜렷한 형식이 없는 소스코드로 인해 코드 수정이나 리팩토링을 시도할 때 예상비용이 굉장히 컸던 이유로 ver2 에서 새로운 디자인에 맞춰 새로운 아키텍쳐를 적용해 보고자 선택

🗓️ 개발 기간

버전	기간	비고
Ver. 1	2022.10 - 2022.12	-
Ver. 2	2023.02 - 2023.03	지원금 정책 변경에 따른 리빌딩, 디자인 개편
Ver. 3	2023.12 - 2023.01	지원금 정책 변경에 따른 업데이트, 리팩토링

🧑‍💻 멤버

멤버	역할
👩🏻‍💻 장희주 (hejang)	기획, 개발
🐾 황윤기 (yuhwang)	개발
🎨 신인호 (inshin)	기획, 디자인

💻 기능 소개

• 로그인

  • Intra 로그인을 통해 서비스 로그인이 가능합니다.

• 홈

  • 로그인 후 바로 보이는 페이지로 본인의 정보와 출입 누적 시간(오늘, 이번 달) 현황을 한 눈에 볼 수 있습니다.
  • 개인 정보
    • 본인의 인트라 사진과 ID를 통해 본인의 정보를 확인합니다.
  • 출입 여부
    • 입실 시 홈 화면의 전체 배경이 바뀝니다. 또한 인트라ID의 우측 상단에 있는 작은 원으로 출입 여부가 표시됩니다.
    • (초록색🟢) 정상적으로 입실(check-in) 되었음을 의미합니다.
  • 이용시간
    • 오늘의 클러스터 누적 시간을 표시합니다.
    • 단, 개인별 사진 출입 카드의 ‘입실’ 과 ‘퇴실’ 태깅 짝이 일치하는 경우에만 ‘오늘 누적 시간’으로 기록됩니다.
    • 따라서, 입실(check-in) 중일 경우 오늘 누적 시간은 기록되지 않으며 퇴실(check-out) 태깅이 확인 된 후 누적 시간이 기록됩니다.
    • 목표시간을 설정할 수 있습니다. 기본 값으로 4시간이 적용되어 있으며, 목표시간을 1시간 단위로 24시간까지 변경하실 수 있습니다.
  • 월 누적시간
    • 이번 달 클러스터 누적 시간을 표시합니다.
    • 패널을 펼쳐서 지원금 산정 기준이 되는 '인정시간'을 확인할 수 있습니다.
  • 6주 / 6개월 체류시간 그래프
    • 6주, 6개월 체류 시간을 표시하는 바형 그래프가 추가되었습니다.
    • 각 바를 탭하면 누적 시간과 일 평균 시간을 확인할 수 있습니다.
  • 실시간 현황
    • 42서울 클러스터의 현재 체류 인원이 표시됩니다.

• 캘린더

  • 2022. 8(24HANE 서비스 시작 월)부터 현재까지의 기록을 확인 할 수 있습니다.
  • 월별로 총 누적시간을 확인할 수 있습니다.
  • 총 누적시간 패널을 탭하면 해당 월의 인정시간을 확인할 수 있습니다.
  • 일별 진척도를 색상을 통해 확인할 수 있습니다. (4시간 단위)
  • Pagination과 타이틀을 탭해서 월을 변경할 수 있습니다.
  • 일별로 태깅기록을 확일 할 수 있으며, 누락된 기록도 표시됩니다.

• 더보기

  • 앱을 통해 카드 재발급 신청을 진행하실 수 있습니다.
  • 지원금 지침 안내페이지(링크)
  • 출입기록 문의(링크)
  • 이용 가이드(링크)
  • 앱 피드백(링크)
  • 로그아웃

24hane-ios's Issues

[Docs] READ.ME 수정

변경점

• 활동 인원 추가
• 기술 스택 추가
• 자잘한 변경점 추가

[Public] Tuist 적용해보기

기존 파일의 형태를 Tuist를 적용한 형태로 변경하는 작업

[Reissue] 재발급 ViewModel과 재발급 절차에 대한 테스트 작성

구현 사항

• 카드 재발급 신청에 대한 유닛 테스트 작성
• 카드 재발급 상태에 대한 테스트
• 카드 재발급 완료에 대한 테스트

특이사항

• 실제 서버를 사용하는 게 아닌 가짜 네트워크를 이용할 예정

[FEAT] Auth ViewModel 추가

구현사항

• 유저의 로그인 상태를 관리할 클래스
  • 로그인/로그아웃
  • 토큰에 대한 관리 및 갱신
  • 워치에 대한 토큰 공유

(추후)

• 리프레시 토큰에 대한 관리 및 갱신

참고사항

[PUBLIC] 애플워치 관련

기술 스택

• watchOS: watchKit
• combine
• swiftData
• UserNotification: push-alert

구현 기능

목표 시간 달성 시 알림

1. 하루 12시간 달성 시 축하 알림
2. 한달 160시간 달성 시 축하 알림
3. 한달 42시간 달성 시

실시간 갱신 시간 체크

월 누적 시간 체크

캘린더 색상으로 체크

확인해야 할 부분

• 애플워치 배포 과정 알아보기

[Calendar] 캘린더 viewmodel 리팩토링

개선해야할 점들

• Hane ViewModel에서 Calendar 부분을 분리
• 분리된 Network 쪽 연결
• convert 함수의 분리
• SOLID 원칙 준수

[FEAT] 에러 핸들링

• 각 상황에 맞는 에러 핸들링을 진행합니다