💊 Meditory

언제 어디서나 Alen AI와 함께 건강한 생활
Alan AI 기반 영양제 추천부터 복용 기록, 식단 관리까지 Meditory

🍎 Developers

윤혜주	김현식	김재훈	이동욱	이치훈	홍승아
팀장 👑	팀원 👨🏻‍💻	팀원 👨🏻‍💻	팀원 👨🏻‍💻	팀원 👨🏻‍💻	팀원 👨🏻‍💻
🏠 홈 화면 💊 영양제 상세 화면 ⏰ 알람 구현 🗓️ 달력 구현	🚀 초기 JIRA 설정 🚪 온보딩 화면 ✏️ PR리뷰 및 관리	💊 영양제 화면 🔍 검색 화면	⚙️ 설정 화면 🗂️ DBA	🍔 식단 화면 🍱 식단 추가 화면	📱 공통 컨포넌트 💊 영양제 추가 화면

📖 소개

Meditory(메디토리)는 사용자 건강 정보와 생활패턴을 반영해 맞춤형 영양제 복용 스케줄을 추천하는 개인화 헬스케어 앱입니다.

Alan AI 기반 큐레이션 기술을 활용하여, 영양제 추천부터 복용 기록 그리고 식단 관리까지 지원합니다.

“더 나은 건강한 생활”

🚀 주요 기능

🏠 홈 화면

• 주간 캘린더와 원형 진행률 그래프를 통해 복용 현황 한눈에 확인
• 섭취 완료 여부를 터치로 간단히 기록
• AI 기반 오늘의 건강 정보 카드 제공

---

🤖 AI 기반 맞춤 추천

• Alan AI 선호 학습 및 키워드 매칭으로 사용자 취향 분석
• 사용자 기상 시간, 수면 시간, 식사 시간을 반영한 개인화 복용 시간 추천
• 식단 입력 시 부족한 영양소를 분석하고 관련 영양제 추천
• (실험 기능) Apple HealthKit 활동량 데이터 기반 맞춤형 식단·영양 보완 제안

---

💊 영양제 관리

• 영양제 검색: Alan AI 연동을 통해 자동 검색
• 복용법, 주의사항, 메모까지 기록/확인 가능

📷 스크린샷

온보딩 화면	메인 화면	영양제 추가 화면	영양제 추천 화면	식단 관리 화면	설정 화면

🛠️ 기술 스택

항목	내용
💻 Framework
🗃 Database
🛠️ Tooling

🔗 API 출처

• 📌 EST Alen AI API

  → EST에서 자체적으로 제공하는 API

• 📍 Google Search API

  → 영양제 검색을 위해 사용

• 🔥 Firebase

  → 크래시 및 버그 추적을 위해 활용

🏆Prize

🧾 Git 커밋 컨벤션

타입	설명
feat	새로운 기능 추가
fix	버그 수정
docs	문서 수정
style	코드 스타일 변경 (세미콜론, 들여쓰기 등)
design	UI 디자인 변경 (색상, 레이아웃 등)
test	테스트 코드 추가 또는 테스트 리팩토링
refactor	리팩토링 (기능 변화 없는 코드 개선)
build	빌드 관련 파일 수정
ci	CI 설정 관련 변경
perf	성능 개선
chore	자잘한 수정이나 빌드/배포 작업
rename	파일명 또는 폴더명 변경
remove	파일 삭제

커밋 메시지 작성 시 위 컨벤션을 따라 일관성을 유지해 주세요.

🚨 Issue Convention

## 어떤 버그인가요?

> 어떤 버그인지 간결하게 설명해주세요

## 어떤 상황에서 발생한 버그인가요?

> (가능하면) Given-When-Then 형식으로 서술해주세요

## 예상 결과

> 예상했던 정상적인 결과가 어떤 것이었는지 설명해주세요

## 참고할만한 자료(선택)

🛰️ PR Convention

## 개요
<!---- 변경 사항 및 관련 이슈에 대해 간단하게 작성해주세요. 어떻게보다 무엇을 왜 수정했는지 설명해주세요. -->

<!---- Resolves: #(Isuue Number) -->

## PR 유형
어떤 변경 사항이 있나요?

- [ ] 새로운 기능 추가
- [ ] 버그 수정
- [ ] CSS 등 사용자 UI 디자인 변경
- [ ] 코드에 영향을 주지 않는 변경사항(오타 수정, 탭 사이즈 변경, 변수명 변경)
- [ ] 코드 리팩토링
- [ ] 주석 추가 및 수정
- [ ] 문서 수정
- [ ] 테스트 추가, 테스트 리팩토링
- [ ] 빌드 부분 혹은 패키지 매니저 수정
- [ ] 파일 혹은 폴더명 수정
- [ ] 파일 혹은 폴더 삭제

## PR Checklist
PR이 다음 요구 사항을 충족하는지 확인하세요.

- [ ] 커밋 메시지 컨벤션에 맞게 작성했습니다. Notion 팀 페이지 내 Commit Message Convention 참고
- [ ] 변경 사항에 대한 테스트를 했습니다.(버그 수정/기능에 대한 테스트).

📁 프로젝트 구조

Meditory/
├── Meditory/
│   ├── Extension/                # 공통 Extension 모음
│   ├── Features/                 # 주요 기능별 모듈
│   │   ├── AddIntake/            # 섭취 기록 추가
│   │   │   ├── Model/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── AddSupplement/        # 영양제 추가
│   │   │   ├── Components/
│   │   │   ├── Error/
│   │   │   ├── Model/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── CalendarBackground/   # 캘린더 뷰
│   │   │   ├── Components/
│   │   │   ├── Model/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── Common/               # 공용 컴포넌트 및 유틸
│   │   │   ├── NavigationBar/
│   │   │   ├── CardStyle.swift
│   │   │   ├── PrimaryButton.swift
│   │   │   └── ...
│   │   ├── DailyNutrition/       # 일일 영양 관리
│   │   │   ├── Component/
│   │   │   ├── Model/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── Home/                 # 홈 화면
│   │   │   ├── Components/
│   │   │   ├── Model/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── IntroduceOnboarding/  # 앱 소개 온보딩
│   │   ├── MainTab/              # 메인 탭바
│   │   │   ├── Components/
│   │   │   ├── Model/
│   │   │   ├── CustomTabView.swift
│   │   │   └── MainTabView.swift
│   │   ├── Notification/         # 알림 관련
│   │   │   ├── NotificationManager.swift
│   │   │   └── RoutineNotificationScheduler.swift
│   │   ├── Onboarding/           # 온보딩 화면
│   │   │   ├── Components/
│   │   │   ├── Model/
│   │   │   ├── Utility/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── Recommend/            # 영양제 추천
│   │   │   ├── Components/
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── Setting/              # 설정
│   │   │   ├── View/
│   │   │   └── ViewModel/
│   │   ├── Splash/               # 스플래시 화면
│   │   │   └── SplashView.swift
│   │   └── SupplementDetail/     # 영양제 상세
│   │       ├── Components/
│   │       ├── Helpers/
│   │       ├── Model/
│   │       ├── View/
│   │       └── ViewModel/
│   │
│   ├── Network/                  # 네트워크 레이어
│   │   ├── Client/
│   │   ├── Core/
│   │   ├── DTO/
│   │   ├── Endpoint/
│   │   ├── Extension/
│   │   └── Utilities/
│   │
│   ├── Persistence/              # 데이터 영속성 계층
│   │   ├── Models/
│   │   ├── Stores/
│   │   ├── DataController.swift
│   │   └── ExtraInfo.swift
│   │
│   ├── Resource/                 # 리소스 모음
│   │   ├── Font/
│   │   ├── Assets.xcassets
│   │   ├── GoogleService-Info.plist
│   │   ├── Info.plist
│   │   └── Secrets.xcconfig
│   │
│   ├── MeditoryApp.swift         # 앱 엔트리 포인트
│   └── ...
│
├── MeditoryTests/                # 단위 테스트
└── MeditoryUITests/              # UI 테스트

⚙️ 설치 및 실행 방법

⚡️ 1. 프로젝트 설치 방법

# 1. 레포지토리 클론
https://github.com/est-ios-3nd-team4/Meditory

🔐 2. API 키 설정

EST에서 발급받은 Alan API 키를 Info.plist 파일에 등록해주세요.

<!-- Secrets.plist -->
<dict>
    <key>AlanAPIKey</key>
	  <string>여기에_본인의_API_KEY_를_입력하세요</string>
</dict>

🏃‍➡️ 3. 프로젝트 실행

1. Xcode에서 Meditory.xcodeproj 파일을 엽니다.
2. 시뮬레이터 또는 실제 디바이스에서 실행합니다.

# 실행 단축키 (macOS 기준)
⌘ + R