# jand19081/cse499-meal-planner architecture

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

- Interactive diagram: https://gitdiagram.com/jand19081/cse499-meal-planner
- Repository: https://github.com/jand19081/cse499-meal-planner

## Overview

1. **Overall shape**
   - This is a **Kotlin Multiplatform** meal-planning app with a thin Android app shell and a shared `composeApp` module that holds almost all business logic, UI, and persistence.
   - The architecture is strongly **local-first**: the app runs against a local Room database and does not appear to depend on any remote backend.

2. **Application entry points**
   - `androidApp` contains the Android-specific launcher (`MainActivity`) and manifest.
   - `composeApp` provides the shared app entry (`App.kt`) plus a JVM desktop entry (`main.kt`) under `jvmMain`.
   - Both targets reuse the same shared feature, domain, and data layers, with platform-specific implementations injected where needed.

3. **Presentation layer**
   - The `feature/` package is the main UI layer and is split by product area: dashboard, calendar, meals, pantry, ingredients, recipes, shopping list, analytics, settings, kitchen, and inventory.
   - Each feature typically has a `View`, `ViewModel`, and feature-specific model/state files.
   - UI is built with **Compose Multiplatform**, and shared reusable widgets live under `ui/components`.

4. **Navigation, theming, and app composition**
   - `core/navigation/AppNavigation.kt` defines the app’s screen flow and is the main boundary between feature screens.
   - `core/theme/Theme.kt` centralizes styling.
   - `core/di/DependencyInjectionContainer.kt` and `ViewModelFactory.kt` indicate a lightweight shared dependency injection layer used to wire repositories, use cases, and view models.

5. **Domain layer**
   - The `domain/` package isolates business rules from storage and UI.
   - `domain/model/` holds the core business entities such as `FoodItem` and `MealSource`.
   - `domain/logic/` contains the main use cases and calculators, including pantry consumption, recipe execution, cooking time, and price calculation.
   - `domain/repository/` defines repository interfaces, keeping the rest of the app independent from Room details.

6. **Data layer and persistence**
   - `data/db/` is the persistence core and uses **Room + SQLite**.
   - The database is modeled in an ECS-like style: a base identity entity plus component-like tables and `@Relation`-based reconstruction.
   - `data/db/entity`, `relation`, `dao`, and `converters` split the persistence concerns cleanly.
   - `composeApp/schemas/...json` stores Room schema history, showing database versioning and migrations as a first-class architectural concern.

7. **Repository boundary**
   - Concrete repositories under `data/repository/` implement the domain repository interfaces using Room-backed data access.
   - These repositories are the main bridge from business logic to storage and are likely the primary source of state for most view models.
   - This keeps feature code from talking directly to DAOs or entities.

8. **Meal-planning and kitchen workflows**
   - The app’s main business flow revolves around meal planning, recipe execution, pantry inventory, and shopping list generation.
   - The `kitchen/` and `recipes/` features show a distinct “cook and consume” workflow, with models like `KitchenTransaction`, `ConsumptionResult`, and recipe execution state.
   - The `calendar/` and `meals/` features likely schedule meals, while the `shoppinglist/` feature aggregates required ingredients from scheduled meals and pantry availability.

9. **Data transformation and utilities**
   - `core/util/` contains important shared helpers: unit conversion, validation, mapping, enum definitions, and mock data.
   - The README’s graph-based unit conversion suggests a central utility service used by recipe, pantry, and shopping features to normalize quantities.
   - `DataQualityValidator` and related validators imply that user-entered item data is checked before it reaches domain logic or persistence.

10. **Backup, export, and file transfer**
   - `data/export/` implements structured backup/restore using `BackupPayloadV1` and mapping helpers.
   - `core/util/FileTransferButtons.*` has platform-specific implementations for Android and JVM, indicating file I/O and sharing are abstracted per target.
   - This backup subsystem is a separate architectural boundary from the core runtime data path.

11. **Notifications and platform-specific behavior**
   - `notification/` is split into shared scheduling contracts and platform-specific workers/schedulers.
   - Android has a `MealNotificationWorker` and Android scheduler implementation; JVM has its own scheduler implementation.
   - Notifications are therefore treated as an optional platform service layered on top of the shared meal/calendar domain.

12. **Testing and schema evolution**
   - `composeApp/src/commonTest` suggests shared tests for platform-independent logic.
   - The preserved Room schema snapshots and design artifacts under `Design/` indicate the project emphasizes data model evolution and documentation.
   - For an architecture diagram, the key takeaway is a layered KMP app with a shared core, a Room persistence backend, feature-specific Compose screens, and small platform-specific adapters for notifications and file handling.

Main entry points: [`MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/navigation/AppNavigation.kt`](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/navigation/AppNavigation.kt) (Navigation), [`MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/App.kt`](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/App.kt) (App), [`MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/repository/RoomFoodItemRepository.kt`](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/repository/RoomFoodItemRepository.kt) (Room repos), [`MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/MealPlannerDatabase.kt`](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/MealPlannerDatabase.kt) (Room database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_android["Android app"]
  node_node_android_main["MainActivity<br/>android launcher<br/>[MainActivity.kt]"]
end

subgraph group_group_shared["Shared app"]
  node_node_shared_app["App<br/>compose entry<br/>[App.kt]"]
  node_node_desktop_main["Desktop main<br/>jvm entry<br/>[main.kt]"]
  node_node_nav["Navigation<br/>screen flow<br/>[AppNavigation.kt]"]
  node_node_theme["Theme<br/>styling<br/>[Theme.kt]"]
  node_node_di["DI container<br/>composition root"]
  node_node_vm_factory["ViewModel factory"]
end

subgraph group_group_domain["Domain layer"]
  node_node_domain_models["Domain models<br/>entities<br/>[FoodItem.kt]"]
  node_node_domain_logic["Business logic<br/>use cases"]
  node_node_domain_repo["Repo contracts<br/>interfaces<br/>[Repository.kt]"]
end

subgraph group_group_data["Data layer"]
  node_node_db[("Room database<br/>sqlite store")]
  node_node_db_entities["Entities<br/>persistence model"]
  node_node_db_daos["DAOs<br/>data access<br/>[MealPlannerDaos.kt]"]
  node_node_repos["Room repos<br/>adapters"]
  node_node_export["Backup export<br/>transfer"]
end

subgraph group_group_features["Feature UI"]
  node_node_main_feature["Main screen<br/>home ui<br/>[MainView.kt]"]
  node_node_dashboard["Dashboard<br/>feature screen<br/>[DashboardView.kt]"]
  node_node_calendar["Calendar<br/>feature screen<br/>[CalendarView.kt]"]
  node_node_meals["Meals<br/>feature screen<br/>[MealsView.kt]"]
  node_node_pantry["Pantry<br/>feature screen<br/>[PantryView.kt]"]
  node_node_ingredients["Ingredients<br/>feature screen<br/>[IngredientsView.kt]"]
  node_node_recipes["Recipes<br/>feature screen<br/>[RecipesView.kt]"]
  node_node_shopping["Shopping list<br/>feature screen"]
  node_node_analytics["Analytics<br/>feature screen<br/>[AnalyticsView.kt]"]
  node_node_settings["Settings<br/>feature screen<br/>[SettingsView.kt]"]
  node_node_kitchen["Kitchen<br/>workflow ui<br/>[KitchenView.kt]"]
end

subgraph group_group_platform["Platform services"]
  node_node_notification["Notifications<br/>scheduler"]
  node_node_file_transfer["File transfer<br/>platform adapter"]
end

node_node_android_main -->|"launches"| node_node_shared_app
node_node_desktop_main -->|"launches"| node_node_shared_app
node_node_shared_app -->|"uses"| node_node_nav
node_node_shared_app -->|"uses"| node_node_theme
node_node_shared_app -->|"wires"| node_node_di
node_node_di -->|"creates"| node_node_vm_factory
node_node_nav -->|"routes to"| node_node_main_feature
node_node_nav -->|"routes to"| node_node_dashboard
node_node_nav -->|"routes to"| node_node_calendar
node_node_nav -->|"routes to"| node_node_meals
node_node_nav -->|"routes to"| node_node_pantry
node_node_nav -->|"routes to"| node_node_recipes
node_node_nav -->|"routes to"| node_node_shopping
node_node_nav -->|"routes to"| node_node_settings
node_node_nav -->|"routes to"| node_node_kitchen
node_node_dashboard -->|"uses"| node_node_domain_logic
node_node_meals -->|"uses"| node_node_domain_repo
node_node_kitchen -->|"uses"| node_node_domain_logic
node_node_domain_logic -->|"operates on"| node_node_domain_models
node_node_repos -->|"queries"| node_node_db_daos
node_node_repos -->|"persists in"| node_node_db
node_node_db -->|"stores"| node_node_db_entities
node_node_db -->|"exposes"| node_node_db_daos
node_node_repos -->|"implements"| node_node_domain_repo
node_node_export -->|"reads from"| node_node_repos
node_node_export -->|"maps"| node_node_db_entities
node_node_notification -.->|"supports"| node_node_calendar
node_node_file_transfer -.->|"supports"| node_node_export

click node_node_android_main "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/androidApp/src/main/kotlin/io/github/and19081/mealplanner/android/MainActivity.kt"
click node_node_shared_app "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/App.kt"
click node_node_desktop_main "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/jvmMain/kotlin/io/github/and19081/mealplanner/main.kt"
click node_node_nav "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/navigation/AppNavigation.kt"
click node_node_theme "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/theme/Theme.kt"
click node_node_di "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/di/DependencyInjectionContainer.kt"
click node_node_vm_factory "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/di/ViewModelFactory.kt"
click node_node_main_feature "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/main/MainView.kt"
click node_node_dashboard "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/dashboard/DashboardView.kt"
click node_node_calendar "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/calendar/CalendarView.kt"
click node_node_meals "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/meals/MealsView.kt"
click node_node_pantry "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/pantry/PantryView.kt"
click node_node_ingredients "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/ingredients/IngredientsView.kt"
click node_node_recipes "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/recipes/RecipesView.kt"
click node_node_shopping "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/shoppinglist/ShoppingListView.kt"
click node_node_analytics "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/analytics/AnalyticsView.kt"
click node_node_settings "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/settings/SettingsView.kt"
click node_node_kitchen "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/kitchen/KitchenView.kt"
click node_node_domain_models "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/model/FoodItem.kt"
click node_node_domain_logic "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/logic/CommitConsumptionUseCase.kt"
click node_node_domain_repo "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/repository/Repository.kt"
click node_node_db "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/MealPlannerDatabase.kt"
click node_node_db_entities "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/entity/MealPlannerEntities.kt"
click node_node_db_daos "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/dao/MealPlannerDaos.kt"
click node_node_repos "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/repository/RoomFoodItemRepository.kt"
click node_node_export "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/export/DataTransferService.kt"
click node_node_notification "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/notification/MealNotificationScheduler.kt"
click node_node_file_transfer "https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/util/FileTransferButtons.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_node_android_main toneBlue
class node_node_shared_app,node_node_desktop_main,node_node_nav,node_node_theme,node_node_di,node_node_vm_factory toneAmber
class node_node_domain_models,node_node_domain_logic,node_node_domain_repo toneMint
class node_node_db,node_node_db_entities,node_node_db_daos,node_node_repos,node_node_export toneRose
class node_node_main_feature,node_node_dashboard,node_node_calendar,node_node_meals,node_node_pantry,node_node_ingredients,node_node_recipes,node_node_shopping,node_node_analytics,node_node_settings,node_node_kitchen toneIndigo
class node_node_notification,node_node_file_transfer toneTeal
```

## Components

### Android app

Android-specific launcher shell and resources.

- [MainActivity](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/androidApp/src/main/kotlin/io/github/and19081/mealplanner/android/MainActivity.kt): android launcher · Android entry activity and manifest-backed app shell. · `MealPlanner/androidApp/src/main/kotlin/io/github/and19081/mealplanner/android/MainActivity.kt`

### Shared app

Common Compose Multiplatform application code reused across targets.

- [App](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/App.kt): compose entry · Shared application root for Compose Multiplatform. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/App.kt`
- [Desktop main](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/jvmMain/kotlin/io/github/and19081/mealplanner/main.kt): jvm entry · JVM desktop launcher for the shared app. · `MealPlanner/composeApp/src/jvmMain/kotlin/io/github/and19081/mealplanner/main.kt`
- [Navigation](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/navigation/AppNavigation.kt): screen flow · Shared screen routing and app-level flow control. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/navigation/AppNavigation.kt`
- [Theme](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/theme/Theme.kt): styling · Centralized shared styling and theme definition. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/theme/Theme.kt`
- [DI container](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/di/DependencyInjectionContainer.kt): composition root · Lightweight dependency wiring for repositories and view models. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/di/DependencyInjectionContainer.kt`
- [ViewModel factory](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/di/ViewModelFactory.kt): factory · Shared view model construction support. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/di/ViewModelFactory.kt`

### Domain layer

Business rules, entities, and repository contracts.

- [Domain models](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/model/FoodItem.kt): entities · Core business entities such as food items and meal sources. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/model/FoodItem.kt`
- [Business logic](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/logic/CommitConsumptionUseCase.kt): use cases · Pantry consumption, recipe execution, cooking time, and price calculation. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/logic/CommitConsumptionUseCase.kt`
- [Repo contracts](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/repository/Repository.kt): interfaces · Repository abstractions that decouple the app from storage details. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/domain/repository/Repository.kt`

### Data layer

Room persistence, repository implementations, and export/backup.

- [Room database](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/MealPlannerDatabase.kt): sqlite store · Shared Room database and schema root. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/MealPlannerDatabase.kt`
- [Entities](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/entity/MealPlannerEntities.kt): persistence model · Room entity definitions for the local-first data model. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/entity/MealPlannerEntities.kt`
- [DAOs](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/dao/MealPlannerDaos.kt): data access · Room access layer for queries and mutations. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/db/dao/MealPlannerDaos.kt`
- [Room repos](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/repository/RoomFoodItemRepository.kt): adapters · Concrete repository implementations backed by Room. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/repository/RoomFoodItemRepository.kt`
- [Backup export](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/export/DataTransferService.kt): transfer · Structured backup and restore payload mapping. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/data/export/DataTransferService.kt`

### Feature UI

Compose screens and view models organized by product area.

- [Main screen](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/main/MainView.kt): home ui · Primary shared landing screen and its state model. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/main/MainView.kt`
- [Dashboard](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/dashboard/DashboardView.kt): feature screen · Overview screen for the app's main meal-planning state. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/dashboard/DashboardView.kt`
- [Calendar](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/calendar/CalendarView.kt): feature screen · Meal scheduling and day-based planning interface. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/calendar/CalendarView.kt`
- [Meals](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/meals/MealsView.kt): feature screen · Meal plan management and meal scheduling workflows. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/meals/MealsView.kt`
- [Pantry](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/pantry/PantryView.kt): feature screen · Inventory and pantry management UI. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/pantry/PantryView.kt`
- [Ingredients](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/ingredients/IngredientsView.kt): feature screen · Ingredient browsing and editing interface. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/ingredients/IngredientsView.kt`
- [Recipes](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/recipes/RecipesView.kt): feature screen · Recipe management and recipe execution flow. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/recipes/RecipesView.kt`
- [Shopping list](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/shoppinglist/ShoppingListView.kt): feature screen · Shopping aggregation and receipt drafting workflow. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/shoppinglist/ShoppingListView.kt`
- [Analytics](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/analytics/AnalyticsView.kt): feature screen · Reporting and summary views over meal-planning data. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/analytics/AnalyticsView.kt`
- [Settings](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/settings/SettingsView.kt): feature screen · User preferences and app configuration screens. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/settings/SettingsView.kt`
- [Kitchen](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/kitchen/KitchenView.kt): workflow ui · Consumption and recipe execution workflow interface. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/feature/kitchen/KitchenView.kt`

### Platform services

Target-specific adapters for notifications and file transfer.

- [Notifications](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/notification/MealNotificationScheduler.kt): scheduler · Shared notification scheduling contract with platform adapters. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/notification/MealNotificationScheduler.kt`
- [File transfer](https://github.com/jand19081/cse499-meal-planner/blob/main/MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/util/FileTransferButtons.kt): platform adapter · Platform-specific file I/O and sharing helper implementations. · `MealPlanner/composeApp/src/commonMain/kotlin/io/github/and19081/mealplanner/core/util/FileTransferButtons.kt`

## Connections

- MainActivity → App: launches · Android shell starts the shared Compose app.
- Desktop main → App: launches · JVM desktop entry starts the same shared app.
- App → Navigation: uses · App root delegates screen flow to navigation.
- App → Theme: uses · App root applies shared theme.
- App → DI container: wires · App root initializes dependencies.
- DI container → ViewModel factory: creates · Dependency container relies on the view model factory.
- Navigation → Main screen: routes to · Navigation connects the primary home surface.
- Navigation → Dashboard: routes to · Navigation connects dashboard screens.
- Navigation → Calendar: routes to · Navigation connects calendar screens.
- Navigation → Meals: routes to · Navigation connects meal plan screens.
- Navigation → Pantry: routes to · Navigation connects pantry screens.
- Navigation → Recipes: routes to · Navigation connects recipe workflows.
- Navigation → Shopping list: routes to · Navigation connects shopping list screens.
- Navigation → Settings: routes to · Navigation connects settings screens.
- Navigation → Kitchen: routes to · Navigation connects kitchen workflow screens.
- Dashboard → Business logic: uses · Dashboard reads derived business calculations.
- Meals → Repo contracts: uses · Meal planning screen works through repository contracts.
- Kitchen → Business logic: uses · Kitchen workflow executes consumption and recipe use cases.
- Business logic → Domain models: operates on · Use cases are built on shared business entities.
- Room repos → DAOs: queries · Room repositories access DAOs for persistence.
- Room repos → Room database: persists in · Repositories are backed by the shared Room database.
- Room database → Entities: stores · Database is defined by entity tables.
- Room database → DAOs: exposes · Database provides DAO entry points.
- Room repos → Repo contracts: implements · Concrete repositories satisfy domain contracts.
- Backup export → Room repos: reads from · Backup and restore layers serialize repository data.
- Backup export → Entities: maps · Transfer payloads are mapped from persistence models.
- Notifications → Calendar: supports · Scheduling is layered on top of meal/calendar data.
- File transfer → Backup export: supports · Platform file helpers enable backup and restore flows.
