영양제 복용을 손쉽게 관리하고, 섭취 습관을 개선할 수 있도록 캘린더, 차트, 알림, 검색 기능 등을 제공하는 스마트 헬스케어 앱입니다.
1. 영양제 등록 및 수정
- 등록: 사용자가 섭취 중인 영양제를 간편하게 등록할 수 있습니다.
- 수정: 등록된 영양제의 이름, 복용 요일, 시간 등을 언제든지 수정할 수 있습니다.
2. 캘린더로 영양제 섭취 스케줄 확인
- 요일별 캘린더 뷰: 영양제 섭취 요일과 시간을 캘린더에서 한눈에 확인할 수 있습니다.
- 주간 및 월간 뷰 지원: 일주일 또는 한 달 단위로 섭취 스케줄을 효율적으로 관리할 수 있습니다.
3. 차트로 보는 영양제 섭취율
- 섭취율 차트 제공: 사용자가 얼마나 규칙적으로 영양제를 섭취했는지, 섭취율을 시각적으로 볼 수 있습니다.
- 분석 데이터 제공: 요일별, 시간별 섭취 패턴을 확인하여 복용 습관을 개선할 수 있도록 도움을 줍니다.
4. 로컬 알림 기능
- 복용 시간 알림: 사용자가 설정한 요일과 시간에 맞춰 영양제 복용 알림을 받을 수 있습니다.
- 반복 알림 지원: 주기적으로 알림을 받을 수 있어 복용을 놓치지 않도록 관리합니다.
- 맞춤 알림 메시지: 각 영양제에 대한 개별 알림 메시지를 전송합니다.
5. 네트워크 기반 영양제 검색 기능
- 영양제 데이터베이스 검색: 네트워크를 통해 원하는 영양제를 검색할 수 있습니다.
- 자동 완성 지원: 검색어 입력 시 유사한 영양제 목록을 자동으로 추천합니다.
- 추가 정보 확인: 검색한 영양제의 상세 정보(성분, 효능 등)를 확인 후 등록 가능합니다.
| 영양제 등록 | 총 보유량 | 복용 요일 | 복용 시간 | 복용 시간 디테일 |
|---|---|---|---|---|
 |
 |
 |
 |
 |
| 영양제 검색 | 영양제 관리 | 내 영양제 | 섭취 알림 | 보유량 알림 |
|---|---|---|---|---|
 |
 |
 |
 |
 |
- 앱 지원 iOS SDK: iOS 16.0 이상
- Xcode: 15.0 이상
- Swift 버전: 5.8 이상
- Input-Output Custom Reactive MVVM: UI와 비즈니스 로직 분리
- 싱글턴 패턴: 전역적으로 관리가 필요한 객체를 재사용하기 위해 사용
UI와 비즈니스 로직의 명확한 분리를 위해 Custom Observable 기반의 Input-Output Reactive MVVM을 적용하였습니다. 외부 라이브러리를 따로 사용하지 않고, 직접 프로젝트 요구사항에 맞춘 경량화된 데이터 바인딩 구조를 구현했습니다.
- UI와 로직의 분리: View는 UI 렌더링과 사용자 이벤트를 전달하는 역할만 담당하며, 비즈니스 로직은 ViewModel에 집중합니다.
- 경량화된 데이터 바인딩: 외부 라이브러리(RxSwift, Combine)를 사용하지 않고, Custom Observable을 구현하여 데이터 바인딩과 상태 관리를 효율적으로 처리했습니다.
- 명확한 데이터 흐름: Input-Output 구조를 통해 View와 ViewModel 간의 데이터 흐름을 명확히 정의하고, 유지보수성을 높였습니다.
- 유연성과 확장성: Custom Observable을 통해 경량화된 반응형 프로그래밍이 가능하며, 프로젝트의 특성에 맞는 유연한 확장을 지원합니다.
-
Custom Observable 정의
- 데이터 변경을 감지하고 이를 구독자(뷰)에게 전달하는
Observable클래스를 직접 구현
final class Observable<T> { private var closure: ((T) -> Void)? var value: T { didSet { closure?(value) } } init(_ value: T) { self.value = value } func bind(_ closure: @escaping (T) -> Void) { closure(value) self.closure = closure } }
- 데이터 변경을 감지하고 이를 구독자(뷰)에게 전달하는
-
ViewModel의 Input-Output 구조
- Input: View에서 발생하는 사용자 이벤트를 ViewModel로 전달
- Output: ViewModel에서 처리된 데이터를 View에 전달
final class CalendarViewModel { // Input let inputSelectedDate: Observable<Date> = Observable(FSCalendar().today!) let inputCheck: Observable<(Date?, ObjectId?)> = Observable((nil, nil)) let inputCombinedCheck: Observable<(Date, Date?, ObjectId?)> = Observable((FSCalendar().today!, nil, nil)) // Output let outputData: Observable<[(key: Date, value: [MySupplement])]> = Observable([]) let outputCheckData: Observable<[CheckSupplement]> = Observable([]) let outputCheckStatus: Observable<(CheckStatus, CheckSupplement?, MySupplement?)> = Observable((.unchecked, nil, nil)) init() { bindInputs() } private func bindInputs() { inputSelectedDate.bind { [weak self] date in // 날짜 선택에 따른 데이터 업데이트 } inputCheck.bind { [weak self] (time, pk) in // 체크 액션 처리 } inputCombinedCheck.bind { [weak self] (date, time, pk) in // Combined 체크 상태 관리 } } }
-
View에서의 데이터 바인딩
- View는
bind메서드를 통해 ViewModel의 Output을 구독하고, 상태 변화에 따라 UI를 업데이트
private func bindData() { viewModel.outputData.bind { [weak self] value in self?.tableView.reloadData() } viewModel.outputCheckStatus.bind { [weak self] (status, checkData, data) in guard let self = self else { return } self.handleCheckStatus(status, checkData, data) } } private func handleCheckStatus(_ status: CheckStatus, _ checkData: CheckSupplement?, _ data: MySupplement?) { switch status { case .checked: viewModel.repository.deleteCheckItem(checkData!) case .uncheckedAndNotDue: present(AlertManager.shared.showAlert(...)) case .unchecked: viewModel.repository.createCheckItem(checkData!) } tableView.reloadData() }
- View는
- 테스트 강화: ViewModel에서 정의된 Output을 기반으로 단위 테스트 작성
- DI(Dependency Injection) 적용: ViewModel과 Repository 간의 의존성을 명확히 관리
- Combine 도입 검토: Swift에서 기본으로 제공하는 Combine 프레임워크를 활용하여 더 효율적인 Reactive 프로그래밍 구현 가능성 탐색
전역적으로 관리가 필요한 객체들에 대해 싱글턴 패턴을 적용하여 일관성과 성능 최적화를 도모했습니다.
- 일관된 전역 관리: 동일한 인스턴스를 재사용하여 코드 일관성 유지
- 성능 최적화:
DateFormatter와 같은 비용이 큰 객체의 재사용을 통해 성능 향상 - 중복 방지: 반복적인 리소스 초기화 방지 및 전역 접근 보장
- UIKit: iOS 사용자 인터페이스 구현
- SnapKit: 간결한 Auto Layout 코드 작성
- Codebase UI: 코드 기반으로 UI를 설계하여 Storyboard 의존성 제거
- DiffableDataSource: 리스트 및 컬렉션 뷰의 데이터 소스 관리
- Pagination: 효율적인 데이터 로드 및 무한 스크롤 구현
- Codable: 네트워크 응답 데이터의 디코딩 및 인코딩을 통해 JSON 데이터 처리
- Alamofire: 네트워크 요청 및 응답 관리
- Firebase: 백엔드 통합 (Crashlytics, Analytics 등)
- Realm: 경량 데이터베이스로 로컬 데이터 관리
- LocalNotification: 로컬 알림을 통한 사용자 리마인더 및 알림
- Kingfisher: 네트워크 이미지를 간편하게 로드 및 캐싱
- Toast-Swift: 사용자 알림 메시지 표시
- FSCalendar: 커스터마이징 가능한 캘린더 UI
- DGCharts: 데이터 시각화를 위한 다양한 차트 지원
- Lottie: JSON 기반 애니메이션을 통해 사용자 경험 강화
- iOS의 로컬 알림은 최대 64개로 제한되어 있음
- 영양제 등록 및 수정 시, 알림을 요일별로 지정된 시간에 맞춰 등록하기 때문에 알림 개수가 64개를 초과할 가능성이 존재
- 이 경우 정상적으로 알림이 등록되지 않을 수 있으며, 사용자는 알림이 등록되지 않는 원인을 파악하기 어려움
- 영양제 등록 및 수정 시 알림 개수를 미리 시뮬레이션하여 초과 가능성을 사전에 감지
- 등록 예정인 알림이 64개를 초과할 경우, 사용자에게 경고 메시지 및 해결 방법을 안내하는 알럿 제공
- iOS의 플랫폼 제약을 고려해 사전에 위험 요소를 감지하고 대응할 수 있는 구조로 설계
- 64개 초과로 인한 알림 누락 문제를 사전 예방하여 앱의 신뢰성과 사용성 향상
- 사용자에게 문제 발생 가능성과 해결 방법을 명확히 안내, 사용자의 혼란 최소화
- 플랫폼 제약을 고려한 설계를 통해 안정적인 알림 관리 구조 구현 및 유지보수 용이성 확보
- 사용자가 영양제의 복용 요일이나 시간을 수정하면, 수정된 정보가 과거 기록에도 일괄적으로 반영되는 문제가 발생
- 예를 들어, 원래 월/수/금에 복용하던 영양제를 화/목/토로 수정하면, 과거의 월/수/금 기록까지 모두 화/목/토로 변경
- 이는 Realm 모델에서 복용 주기(cycle)와 시간(time)을 단일 리스트로 관리하면서, 수정 시 해당 값이 덮어쓰게 되기 때문
- 이에 따라 과거 날짜를 조회할 때도 최신 복용 정보 기준으로 표시되면서, 복용 체크 이력이 실제와 다르게 왜곡
- 복용 정보를 수정하는 순간 과거의 체크 기록과의 정합성이 깨져 사용자 신뢰도에 영향
- 복용 정보 변경 이력을 저장하기 위해 HistorySupplement라는 EmbeddedObject 모델을 도입
- 해당 객체는 변경된 복용 요일과 시간, 그리고 변경된 날짜(updateDay)를 함께 저장
- 캘린더 뷰에서는 날짜별로 유효한 복용 정보를 계산하기 위해, updateDay 기준으로 복용 시점을 구분하여 cycle과 time을 다르게 적용하도록 구현
- 과거 이력은 해당 시점의 정보를 그대로 유지하고, 이후 변경분은 분리된 이력으로 관리
- 과거의 복용 기록이 실제 복용 당시 기준으로 정확히 표시되어 데이터 왜곡 문제 해결
- 사용자는 "이 시기엔 월/수/금, 지금은 화/목/토"처럼 이력 흐름을 직관적으로 이해 가능
- 데이터 정합성과 사용자 신뢰도 모두 확보, 장기적인 이력 기반 기능 확장의 기반 마련
- 영양제 등록 및 수정 화면에서 이미지, 이름, 복용 요일 등 다양한 입력 항목의 효율적인 관리가 필요
- 기존 방식은 데이터를 변경한 후 reloadData() 또는 performBatchUpdates()를 호출해야 했으며, 이에 따라 전체 View 리로드가 불필요하게 발생
- 결과적으로 UI와 데이터 간의 불일치 가능성이 생기고, 화면 전환도 매끄럽지 못한 UX로 이어졌음
- DiffableDataSource를 활용하여 데이터를 섹션별로 그룹화
- 스냅샷 기반의 중앙화된 데이터 관리를 적용하여 변경되는 부분만 애니메이션이 적용되어 자연스럽게 업데이트
- reloadData() 없이 보다 효율적이고 dynamic하게 View를 업데이트할 수 있도록 개선
- 전체 View 리로드 없이 필요한 부분만 업데이트됨으로써 렌더링 성능 및 사용자 반응 속도 향상
- 변경 사항이 즉시 UI에 반영되어 데이터 불일치 문제 예방
- 자연스럽고 부드러운 화면 전환으로 사용자 경험(UX) 개선
Yakssok
┣ Add
┃ ┣ Cycle
┃ ┃ ┣ .DS_Store
┃ ┃ ┣ CycleCollectionViewCell.swift
┃ ┃ ┣ CycleViewController.swift
┃ ┃ ┗ CycleViewModel.swift
┃ ┣ Image
┃ ┃ ┣ ImageCollectionViewCell.swift
┃ ┃ ┣ ImageTypeSelectTableViewCell.swift
┃ ┃ ┣ ImageTypeSelectViewController.swift
┃ ┃ ┗ ImageTypeSelectViewModel.swift
┃ ┣ Period
┃ ┃ ┣ PeriodViewController.swift
┃ ┃ ┗ PeriodViewModel.swift
┃ ┣ StartDay
┃ ┃ ┣ StartDayViewController.swift
┃ ┃ ┗ StartDayViewModel.swift
┃ ┣ Stock
┃ ┃ ┣ StockViewController.swift
┃ ┃ ┗ StockViewModel.swift
┃ ┣ Time
┃ ┃ ┣ TimePickerViewController.swift
┃ ┃ ┣ TimePickerViewModel.swift
┃ ┃ ┣ TimeTableViewCell.swift
┃ ┃ ┣ TimeViewController.swift
┃ ┃ ┗ TimeViewModel.swift
┃ ┣ .DS_Store
┃ ┣ AddViewController.swift
┃ ┣ AddViewModel.swift
┃ ┣ AmountCollectionViewCell.swift
┃ ┣ CommonCollectionViewCell.swift
┃ ┗ NameCollectionViewCell.swift
┣ Assets.xcassets
┃ ┣ AccentColor.colorset
┃ ┃ ┗ Contents.json
┃ ┣ AppIcon.appiconset
┃ ┃ ┣ Contents.json
┃ ┃ ┗ 제목을 입력해주세요_-001 (3).jpg
┃ ┣ logo.imageset
┃ ┃ ┣ Contents.json
┃ ┃ ┣ 제목을_입력해주세요__복사본-001-removebg-preview.png
┃ ┃ ┣ 제목을_입력해주세요__복사본[email protected]
┃ ┃ ┗ 제목을_입력해주세요__복사본[email protected]
┃ ┣ pill.imageset
┃ ┃ ┣ Contents.json
┃ ┃ ┣ icons8-medicine-100 (1).png
┃ ┃ ┣ icons8-medicine-100 (1)@2x.png
┃ ┃ ┗ icons8-medicine-100 (1)@3x.png
┃ ┗ Contents.json
┣ Base
┃ ┣ BaseCollectionReusableView.swift
┃ ┣ BaseCollectionViewCell.swift
┃ ┣ BaseTableViewCell.swift
┃ ┣ BaseView.swift
┃ ┗ BaseViewController.swift
┣ Base.lproj
┃ ┣ LaunchScreen.storyboard
┃ ┗ Main.storyboard
┣ Calendar
┃ ┣ Cell
┃ ┃ ┣ CalendarTableViewCell.swift
┃ ┃ ┣ ChartTableViewCell.swift
┃ ┃ ┣ EmptyTableViewCell.swift
┃ ┃ ┗ ScheduleTableViewCell.swift
┃ ┣ CalendarViewController.swift
┃ ┣ CalendarViewModel.swift
┃ ┗ ScheduleHeaderView.swift
┣ Custom
┃ ┣ CustomCalendar.swift
┃ ┣ CustomChartView.swift
┃ ┣ CustomImageView.swift
┃ ┣ CustomLabel.swift
┃ ┣ CustomTextField.swift
┃ ┣ LogoView.swift
┃ ┗ SplashView.swift
┣ DesignSystem
┃ ┣ ColorStyle.swift
┃ ┣ FontStyle.swift
┃ ┗ ImageStyle.swift
┣ Extension
┃ ┣ Dictionary+Extension.swift
┃ ┣ Notification.Name+Extension.swift
┃ ┣ UIButton.Configuration+Extension.swift
┃ ┣ UIColor+Extension.swift
┃ ┣ UISheetPresentationController.Detent+Extension.swift
┃ ┣ UITextField+Extension.swift
┃ ┗ UIView+Extension.swift
┣ Lottie
┃ ┣ congratulation.json
┃ ┗ splash.json
┣ Manager
┃ ┣ AlertManager.swift
┃ ┣ DateFormatterManager.swift
┃ ┣ ImageDocumentManager.swift
┃ ┣ NotificationManager.swift
┃ ┣ NumberFormatterManager.swift
┃ ┣ SearchManger.swift
┃ ┗ ToastManager.swift
┣ My
┃ ┣ Cell
┃ ┃ ┗ MyCollectionViewCell.swift
┃ ┣ .DS_Store
┃ ┣ MyViewController.swift
┃ ┗ MyViewModel.swift
┣ Network
┃ ┣ APIKey.swift
┃ ┣ APIService.swift
┃ ┣ Supplement.swift
┃ ┗ SupplementAPI.swift
┣ Realm
┃ ┣ MySupplement.swift
┃ ┣ MySupplements.swift
┃ ┗ SupplementRepository.swift
┣ Search
┃ ┣ SearchResultTableViewCell.swift
┃ ┣ SearchViewController.swift
┃ ┗ SearchViewModel.swift
┣ .DS_Store
┣ AppDelegate.swift
┣ Info.plist
┣ Observable.swift
┣ SceneDelegate.swift
┗ ViewController.swift
- 한 달 영양제 섭취 완료율 차트 제공