FamFitAI is a mobile application that allows a caregiver (such as an adult child) to monitor the real-time health and wellness of multiple family members—like parents or grandparents—using Fitbit wearable data. Each person connects their Fitbit account through a secure OAuth 2.0 flow. Once connected, the app automatically syncs their activity, sleep, and heart-related metrics from Fitbit. The caregiver can then see detailed health dashboards, high-level summaries, alerts, and AI-generated insights for each monitored person. The system consists of: • iOS app (SwiftUI) • FastAPI backend (Python) • Database (SQLite or PostgreSQL) • Fitbit API integration • Domain: famfit.dev with HTTPS ✅ Core Features 1. Multi-Person Health Monitoring • The caregiver sees a dashboard of parents/loved ones. • Each person shows: • Fitbit connection status • Last sync time • Summary of daily metrics 2. Fitbit OAuth Integration • Secure OAuth 2.0 login for each family member • API token storage + refresh support • Server-side Fitbit synchronization 3. Real Data Sync via Fitbit Web APIs Pull metrics: • Steps • Distance • Calories burned • Active minutes • Resting heart rate • Average daily heart rate • Sleep stages (light, deep, REM, awake) • Sleep efficiency • Weekly stats (averages & goals) 4. Parent Detail Dashboard Visual presentation of: • Daily activity chart • Heart rate summary • Sleep breakdown • Weekly trend metrics 5. Status & Edge Case Handling • Connected / not connected • Connected but no data • Sync failed • Last synced timestamp • Proper empty-state UX 6. Backend System • Unified ParentSnapshot data model • FitbitConnection model (access_token, refresh_token) • Secure HTTPS via Nginx + Certbot • OAuth endpoints: • /auth/fitbit/login • /auth/fitbit/callback • API endpoints: • /api/parents • /api/parents/{id}/snapshot 7. (Optional Add-ons for phase 2) • AI-generated daily/weekly health summaries • Push notifications for: • low activity • poor sleep • unusual heart rate • Multi-user authentication • Admin dashboard (web) ✅ Deliverables Expected From Outsourced Team iOS • Fully working SwiftUI app • Screens: • Dashboard • Parent detail screen • Connect Fitbit flow • API integration • Error + empty-state handling • Clean architecture (MVVM preferred) Backend • Fully working FastAPI service • OAuth implementation • Fitbit sync logic • Database models • All endpoints functional QA • Token expiration scenarios tested • No crashes on empty or missing data • Graceful sync failure handling Deployment • Backend deployed on your server • HTTPS configured • Systemd service running uvicorn • Logs + health checks in place