# ducanh271/healthtracker architecture

> Architecture diagram of the GitHub repository ducanh271/healthtracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ducanh271/healthtracker
- Repository: https://github.com/ducanh271/healthtracker

## Overview

HealthTracker is an Android calorie and wellness tracker. The main workflow is to set up a personal profile and goal, log meals and physical activity, then review intake, expenditure, BMI, advice, and trends on the dashboard. Settings, scheduled reminders, and a home-screen calorie widget extend that workflow. The README documents the UI–domain–data architecture and storage technologies; source excerpts were not provided, so feature-level implementation links and reminder/widget wiring are not asserted.

Main entry points: [`app/src/main/java/com/example/healthtracker/domain/repository`](https://github.com/ducanh271/healthtracker/tree/main/app/src/main/java/com/example/healthtracker/domain/repository) (Repository contracts), [`app/src/main/java/com/example/healthtracker/ui/navigation/AppNavGraph.kt`](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/navigation/AppNavGraph.kt) (Navigation), [`app/src/main/java/com/example/healthtracker/domain/usecase/settings/UpdateAppThemeUseCase.kt`](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/settings/UpdateAppThemeUseCase.kt) (Settings logic), [`app/src/main/java/com/example/healthtracker/domain/usecase/SaveOnboardingProfileUseCase.kt`](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/SaveOnboardingProfileUseCase.kt) (Profile and TDEE)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["Android app"]
  node_navigation["Navigation<br/>[AppNavGraph.kt]"]
  node_onboarding["Profile setup"]
  node_dashboard["Dashboard"]
  node_meal_diary["Meal diary"]
  node_activity_diary["Activity diary"]
  node_profile_settings["Profile editor"]
  node_settings["Preferences"]
end

subgraph group_domain["Health domain"]
  node_profile_domain["Profile and TDEE"]
  node_meal_domain["Meal logging"]
  node_activity_domain["Activity logging"]
  node_dashboard_domain["Metrics and trends"]
  node_settings_domain["Settings logic"]
  node_repositories["Repository contracts"]
end

subgraph group_data["Persistence"]
  node_room[("Room database<br/>[HealthDatabase.kt]")]
  node_meal_repository["Meal repository"]
  node_activity_repository["Activity repository"]
  node_user_repository["User repository"]
  node_settings_store[("Preferences store")]
end

subgraph group_extensions["App extensions"]
  node_reminders["Meal reminders"]
  node_widget["Calorie widget<br/>[CalorieWidget.kt]"]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"presents"| node_navigation
node_navigation -->|"routes to"| node_onboarding
node_navigation -->|"routes to"| node_dashboard
node_navigation -->|"routes to"| node_meal_diary
node_navigation -->|"routes to"| node_activity_diary
node_navigation -->|"routes to"| node_profile_settings
node_navigation -->|"routes to"| node_settings
node_onboarding -->|"uses"| node_profile_domain
node_dashboard -->|"uses"| node_dashboard_domain
node_meal_diary -->|"uses"| node_meal_domain
node_activity_diary -->|"uses"| node_activity_domain
node_profile_settings -->|"uses"| node_profile_domain
node_settings -->|"uses"| node_settings_domain
node_profile_domain -->|"depends on"| node_repositories
node_meal_domain -->|"depends on"| node_repositories
node_activity_domain -->|"depends on"| node_repositories
node_dashboard_domain -->|"depends on"| node_repositories
node_settings_domain -->|"depends on"| node_repositories
node_repositories -->|"implemented by"| node_meal_repository
node_repositories -->|"implemented by"| node_activity_repository
node_repositories -->|"implemented by"| node_user_repository
node_meal_repository -->|"persists logs"| node_room
node_activity_repository -->|"persists logs"| node_room
node_user_repository -->|"stores profile"| node_settings_store
node_settings_domain -.->|"persists preferences"| node_settings_store
node_user -.->|"receives"| node_reminders
node_user -.->|"views progress"| node_widget

click node_app "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/HealthTrackerApp.kt"
click node_navigation "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/navigation/AppNavGraph.kt"
click node_onboarding "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/onboarding/OnboardingViewModel.kt"
click node_dashboard "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/dashboard/DashboardViewModel.kt"
click node_meal_diary "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/diary/meal/MealDiaryViewModel.kt"
click node_activity_diary "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/diary/activity/ActivityDiaryViewModel.kt"
click node_profile_settings "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/profile/EditProfileViewModel.kt"
click node_settings "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/settings/SettingsViewModel.kt"
click node_profile_domain "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/SaveOnboardingProfileUseCase.kt"
click node_meal_domain "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/meal/AddMealLogUseCase.kt"
click node_activity_domain "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/activity/AddActivityLogUseCase.kt"
click node_dashboard_domain "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/dashboard/GetDashboardMetricsUseCase.kt"
click node_settings_domain "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/settings/UpdateAppThemeUseCase.kt"
click node_repositories "https://github.com/ducanh271/healthtracker/tree/main/app/src/main/java/com/example/healthtracker/domain/repository"
click node_room "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/local/room/HealthDatabase.kt"
click node_meal_repository "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/repository/MealRepositoryImpl.kt"
click node_activity_repository "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/repository/ActivityRepositoryImpl.kt"
click node_user_repository "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/repository/UserRepositoryImpl.kt"
click node_settings_store "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/local/datastore/SettingsDataStore.kt"
click node_reminders "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/notification/ReminderScheduler.kt"
click node_widget "https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/widget/CalorieWidget.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_navigation,node_onboarding,node_dashboard,node_meal_diary,node_activity_diary,node_profile_settings,node_settings,node_user toneBlue
class node_profile_domain,node_meal_domain,node_activity_domain,node_dashboard_domain,node_settings_domain,node_repositories toneAmber
class node_room,node_meal_repository,node_activity_repository,node_user_repository,node_settings_store toneMint
class node_reminders,node_widget toneRose
```

## Components

### App experience

- [Android app](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/HealthTrackerApp.kt): `app/src/main/java/com/example/healthtracker/HealthTrackerApp.kt`
- [Navigation](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/navigation/AppNavGraph.kt): `app/src/main/java/com/example/healthtracker/ui/navigation/AppNavGraph.kt`
- [Profile setup](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/onboarding/OnboardingViewModel.kt): `app/src/main/java/com/example/healthtracker/ui/features/onboarding/OnboardingViewModel.kt`
- [Dashboard](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/dashboard/DashboardViewModel.kt): `app/src/main/java/com/example/healthtracker/ui/features/dashboard/DashboardViewModel.kt`
- [Meal diary](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/diary/meal/MealDiaryViewModel.kt): `app/src/main/java/com/example/healthtracker/ui/features/diary/meal/MealDiaryViewModel.kt`
- [Activity diary](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/diary/activity/ActivityDiaryViewModel.kt): `app/src/main/java/com/example/healthtracker/ui/features/diary/activity/ActivityDiaryViewModel.kt`
- [Profile editor](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/profile/EditProfileViewModel.kt): `app/src/main/java/com/example/healthtracker/ui/features/profile/EditProfileViewModel.kt`
- [Preferences](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/ui/features/settings/SettingsViewModel.kt): `app/src/main/java/com/example/healthtracker/ui/features/settings/SettingsViewModel.kt`

### Health domain

- [Profile and TDEE](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/SaveOnboardingProfileUseCase.kt): `app/src/main/java/com/example/healthtracker/domain/usecase/SaveOnboardingProfileUseCase.kt`
- [Meal logging](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/meal/AddMealLogUseCase.kt): `app/src/main/java/com/example/healthtracker/domain/usecase/meal/AddMealLogUseCase.kt`
- [Activity logging](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/activity/AddActivityLogUseCase.kt): `app/src/main/java/com/example/healthtracker/domain/usecase/activity/AddActivityLogUseCase.kt`
- [Metrics and trends](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/dashboard/GetDashboardMetricsUseCase.kt): `app/src/main/java/com/example/healthtracker/domain/usecase/dashboard/GetDashboardMetricsUseCase.kt`
- [Settings logic](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/domain/usecase/settings/UpdateAppThemeUseCase.kt): `app/src/main/java/com/example/healthtracker/domain/usecase/settings/UpdateAppThemeUseCase.kt`
- [Repository contracts](https://github.com/ducanh271/healthtracker/tree/main/app/src/main/java/com/example/healthtracker/domain/repository): `app/src/main/java/com/example/healthtracker/domain/repository`

### Persistence

- [Room database](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/local/room/HealthDatabase.kt): `app/src/main/java/com/example/healthtracker/data/local/room/HealthDatabase.kt`
- [Meal repository](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/repository/MealRepositoryImpl.kt): `app/src/main/java/com/example/healthtracker/data/repository/MealRepositoryImpl.kt`
- [Activity repository](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/repository/ActivityRepositoryImpl.kt): `app/src/main/java/com/example/healthtracker/data/repository/ActivityRepositoryImpl.kt`
- [User repository](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/repository/UserRepositoryImpl.kt): `app/src/main/java/com/example/healthtracker/data/repository/UserRepositoryImpl.kt`
- [Preferences store](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/data/local/datastore/SettingsDataStore.kt): `app/src/main/java/com/example/healthtracker/data/local/datastore/SettingsDataStore.kt`

### App extensions

- [Meal reminders](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/notification/ReminderScheduler.kt): `app/src/main/java/com/example/healthtracker/notification/ReminderScheduler.kt`
- [Calorie widget](https://github.com/ducanh271/healthtracker/blob/main/app/src/main/java/com/example/healthtracker/widget/CalorieWidget.kt): `app/src/main/java/com/example/healthtracker/widget/CalorieWidget.kt`

### Other components

- **User**

## Connections

- User → Android app: opens (evidence: `README.md`)
- Android app → Navigation: presents (evidence: `README.md`)
- Navigation → Profile setup: routes to (evidence: `README.md`)
- Navigation → Dashboard: routes to (evidence: `README.md`)
- Navigation → Meal diary: routes to (evidence: `README.md`)
- Navigation → Activity diary: routes to (evidence: `README.md`)
- Navigation → Profile editor: routes to (evidence: `README.md`)
- Navigation → Preferences: routes to (evidence: `README.md`)
- Profile setup → Profile and TDEE: uses (evidence: `README.md`)
- Dashboard → Metrics and trends: uses (evidence: `README.md`)
- Meal diary → Meal logging: uses (evidence: `README.md`)
- Activity diary → Activity logging: uses (evidence: `README.md`)
- Profile editor → Profile and TDEE: uses (evidence: `README.md`)
- Preferences → Settings logic: uses (evidence: `README.md`)
- Profile and TDEE → Repository contracts: depends on (evidence: `README.md`)
- Meal logging → Repository contracts: depends on (evidence: `README.md`)
- Activity logging → Repository contracts: depends on (evidence: `README.md`)
- Metrics and trends → Repository contracts: depends on (evidence: `README.md`)
- Settings logic → Repository contracts: depends on (evidence: `README.md`)
- Repository contracts → Meal repository: implemented by (evidence: `README.md`)
- Repository contracts → Activity repository: implemented by (evidence: `README.md`)
- Repository contracts → User repository: implemented by (evidence: `README.md`)
- Meal repository → Room database: persists logs (evidence: `README.md`)
- Activity repository → Room database: persists logs (evidence: `README.md`)
- User repository → Preferences store: stores profile (evidence: `README.md`)
- Settings logic → Preferences store: persists preferences
- User → Meal reminders: receives
- User → Calorie widget: views progress
