Walkee

Walkee는 HealthKit과 연동된 걷기 데이터를 기반으로
Alan AI가 개인 맞춤형 활동 및 걷기 코스를 추천하는 헬스케어 앱입니다.
개인의 건강 상태와 체력 수준을 고려한 맞춤형 걷기 솔루션을 제공하여
기존 만보기 앱과 달리 AI가 사용자별 최적화된 활동을 제안합니다.

📌 프로젝트 개요

🎯 프로젝트 목적

현대인들의 운동 부족과 건강 관리에 대한 어려움을 해결하기 위해 개발되었습니다.
기존의 획일적인 건강 앱들과 달리, 개인의 신체 조건과 건강 상태를 고려한 맞춤형 추천을 제공합니다.

💡 핵심 가치

• 개인화: 사용자의 성별, 나이, 키, 몸무게, 질병 여부를 종합 분석
• 지능화: Alan AI를 통한 실시간 건강 상담 및 코스 추천
• 보안성: Face ID/Touch ID 기반 민감정보 보호
• 편의성: 실시간 위젯 동기화로 앱 실행 없이도 데이터 확인

🔥 차별점

• AI 기반 맞춤 분석: 단순 통계가 아닌 개인별 건강 상태 분석
• 지역 기반 코스 추천: 공공데이터와 실시간 위치 정보를 활용한 실제 걷기 코스 제안
• 대화형 건강 상담: 걷기 전문 챗봇을 통한 실시간 건강 조언
• 유연한 목표 관리: 날짜별로 다른 목표 걸음 수 설정 가능

📸 주요 화면

👋 온보딩	📊 대시보드 탭	📅 캘린더 탭	💡 맞춤케어 탭	🤖 Alan AI 챗봇	👤 프로필 탭

✨ 주요 기능

기능	설명
📊 스마트 차트	주간·월간 분석 + 나이대별 정상범위 비교
📅 유연한 목표 관리	날짜별 다른 목표 설정 + 무한 스크롤 캘린더
🗺 위치 기반 코스	추천현재 위치 거리 계산 + Apple 지도 연동
🤖 AI 전문 상담	신체 조건 기반 맞춤 분석 + 걷기 전용 챗봇
🔒 생체 인증 보안	Face ID/Touch ID 기반 민감정보 보호
📱 실시간 위젯	앱 미실행시에도 실시간 걸음 수 동기화

🎯 세부 기능 특징

📱 사용자 경험

• 단계별 가이드: 온보딩 페이지 완독 후 다음 단계 진행
• 입력 검증: 허용 범위 초과시 친절한 안내 메시지
• 햅틱 피드백: 버튼 길게 누르기로 빠른 수치 조정
• 즉시 반영: 설정 변경사항의 실시간 화면 업데이트

🔐 보안 및 프라이버시

• 생체 인증: 민감한 신체정보 수정시 Face ID/Touch ID 요구
• 자동 마스킹: 챗봇 사용시 개인정보 자동 비식별화 처리
• 권한 관리: 데이터별 세분화된 접근 권한 + 시각적 표시

🤖 Alan AI 역할

Alan AI는 Walkee의 핵심 지능화 엔진으로 다음과 같은 역할을 담당합니다.

📋 맞춤형 분석 리포트

• 월간 활동 요약: 걸음 수, 이동 거리 기반 종합 분석 (하루 1회 갱신)
• 개인별 건강 상담: 성별, 나이, 체형, 질병 여부 고려한 맞춤 조언
• 나이대별 비교: 동연령대 정상 범위와 사용자 데이터 비교 분석

🗺 스마트 코스 추천

• 난이도별 분류: 사용자 체력에 맞는 어려움·보통·쉬움 코스 제안
• 거리 기반 정렬: 현재 위치에서 가까운 순 또는 코스 길이순 정렬
• 상세 정보 제공: 예상 소요시간, 코스 특징, 주의사항 안내

💬 걷기 전문 챗봇

• 실시간 상담: 걷기, 러닝, 트레킹 관련 전문 조언
• 개인정보 보호: 민감정보 자동 마스킹 처리
• 외부 링크 연동: 관련 건강 정보 사이트로 Safari 연결

🛠 기술 스택

📱 플랫폼 & 언어

• Target: iOS 15.0+
• Language: Swift 5.9+
• IDE: Xcode 14.0+

🏗 아키텍처 & 패턴

• Architecture: MVVM + Clean Architecture
• Dependency Injection: DIContainer 기반 의존성 관리
• Concurrency: Swift Concurrency (async/await) 기반 비동기 처리

💾 데이터 & 저장소

• Health Data: HealthKit Framework
• Local Storage: Core Data
• Widget Sync: UserDefaults (App Group)
• Security: Keychain Services + Biometric Authentication

🤖 AI & 외부 서비스

• AI Engine: Alan AI
• Location: Core Location + Apple Maps Integration
• Public Data: 공공데이터 포털 API

🎨 UI & 사용자 경험

• UI Framework: UIKit
• Widget: WidgetKit (실시간 동기화)
• Charts: Custom Chart Implementation
• Calendar: Custom Infinite Scroll Calendar UI

🏛 프로젝트 계층 구조

계층	주요 역할	예시 파일
Application	앱 실행/환경설정	AppDelegate, SceneDelegate, AppConfiguration
Core	공통 유틸/보안/DI	DIContainer, CoreDataStack, KeychainWrapper
Model	데이터 모델	UserInfoEntity, DailyStepEntity, AlanStreamingResponse, WalkingCourse
Presentation	UI 화면/컴포넌트	Calendar, Dashboard, Chatbot, Onboarding, Profile
Services	데이터 서비스 계층	HealthService, CalendarStepService, WalkingCourseService, StepSyncService
ViewModels	UI와 서비스 계층을 연결, 데이터 상태 관리	CalendarViewModel, DashboardViewModel, UserInfoViewModel, AlanViewModel

📊 주요 데이터 모델

모델	설명
UserInfoEntity	사용자 프로필 (성별, 나이, 키, 몸무게, 질병)
DailyStepEntity	날짜별 걸음 수 기록
GoalStepCountEntity	목표 걸음 수 기록 (날짜별 다른 목표 지원)
HealthDashboardSnapshot	위젯/대시보드용 통합 데이터
WalkingCourse	공공데이터 기반 걷기 코스 + 거리 계산

🗂 데이터 플로우

1. HealthKit ➡️ DefaultHealthService ➡️ CoreData
2. CoreDataStack ➡️ CalendarStepService / DashboardSnapshotStore
3. Alan AI SSE ➡️ AlanStreamingResponse 파싱 ➡️ UI 반영
4. LocationPermissionService ➡️ WalkingCourseService ➡️ 지도 썸네일 생성
5. SharedStore(AppGroup) ➡️ WidgetKit ➡️ 홈화면 위젯 갱신

🧪 테스트

테스트 대상	방식
CoreDataUserService	더미 데이터 기반 단위 테스트
DIContainer	의존성 주입 검증
HealthService	MockHealthService 활용
ViewModels	CalendarViewModelTests (캘린더 데이터 검증), LLMRecommendationViewModelTests (AI 추천 로직 검증) 등

👨‍💻 팀원

팀장	부팀장	팀원	팀원	팀원	팀원
김건우 rlarjsdn3	김서현 cestbonciel	권도현 kwondohyun12	김종성 jseongee	노기승 giseungNoh	하재준 haejaejoon
대시보드 탭	Alan AI 챗봇	온보딩	캘린더 탭	맞춤케어 탭	프로필 탭