# patrick-codex/nutrifoodie_app architecture

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

- Interactive diagram: https://gitdiagram.com/patrick-codex/nutrifoodie_app
- Repository: https://github.com/patrick-codex/nutrifoodie_app

## Overview

NutriFoodie is a Flutter dining-menu tracker for GSU students. Its documented workflow fetches Nutrislice menu data, maps dishes into stations, and presents them with search, filters, and dietary badges. Students can star dishes; a weekly scanner checks meal schedules for those favorites and schedules local alerts. The README describes capabilities and dependencies, but no implementation files or source excerpts are available, so the graph shows only documented relationships and uses README.md as evidence.

Main entry points: [`README.md`](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md) (Menu dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_menus["Menu data"]
  node_menu_ingestion["Menu ingestion<br/>[README.md]"]
  node_station_mapping["Station mapping<br/>[README.md]"]
  node_menu_items["Menu items<br/>[README.md]"]
  node_campus_schedules["Campus schedules<br/>[README.md]"]
end

subgraph group_discovery["Menu discovery"]
  node_menu_dashboard["Menu dashboard<br/>[README.md]"]
  node_station_accordions["Station accordions<br/>[README.md]"]
  node_station_filters["Station filters<br/>[README.md]"]
  node_live_search["Live search<br/>[README.md]"]
  node_dietary_badges["Dietary badges<br/>[README.md]"]
end

subgraph group_alerts["Favorites and alerts"]
  node_watchlist["Food watchlist<br/>[README.md]"]
  node_weekly_scanner["Weekly scanner<br/>[README.md]"]
  node_local_notifications["Local notifications<br/>[README.md]"]
end

subgraph group_platform["App platform"]
  node_preferences_storage[("Preferences storage<br/>[README.md]")]
end

node_student(("GSU student"))
node_nutrislice{{"Nutrislice REST API"}}

node_menu_ingestion -->|"fetches menus"| node_nutrislice
node_menu_ingestion -->|"maps sections"| node_station_mapping
node_station_mapping -->|"groups dishes"| node_menu_items
node_menu_ingestion -->|"respects schedules"| node_campus_schedules
node_menu_dashboard -->|"presents dishes"| node_menu_items
node_menu_dashboard -->|"shows stations"| node_station_accordions
node_menu_dashboard -->|"offers filters"| node_station_filters
node_menu_dashboard -->|"offers search"| node_live_search
node_menu_dashboard -->|"shows badges"| node_dietary_badges
node_student -->|"browses menus"| node_menu_dashboard
node_student -->|"stars dishes"| node_watchlist
node_weekly_scanner -->|"checks favorites"| node_watchlist
node_weekly_scanner -->|"scans meal days"| node_campus_schedules
node_weekly_scanner -->|"schedules alerts"| node_local_notifications
node_watchlist -->|"persists favorites"| node_preferences_storage
node_student -->|"receives alerts"| node_local_notifications

click node_menu_ingestion "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_station_mapping "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_menu_items "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_campus_schedules "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_menu_dashboard "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_station_accordions "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_station_filters "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_live_search "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_dietary_badges "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_watchlist "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_weekly_scanner "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_local_notifications "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"
click node_preferences_storage "https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md"

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_menu_ingestion,node_station_mapping,node_menu_items,node_campus_schedules toneBlue
class node_menu_dashboard,node_station_accordions,node_station_filters,node_live_search,node_dietary_badges toneAmber
class node_watchlist,node_weekly_scanner,node_local_notifications,node_nutrislice toneMint
class node_preferences_storage toneRose
class node_student toneIndigo
```

## Components

### Menu data

- [Menu ingestion](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Station mapping](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Menu items](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Campus schedules](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`

### Menu discovery

- [Menu dashboard](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Station accordions](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Station filters](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Live search](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Dietary badges](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`

### Favorites and alerts

- [Food watchlist](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Weekly scanner](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`
- [Local notifications](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`

### App platform

- [Preferences storage](https://github.com/patrick-codex/nutrifoodie_app/blob/main/README.md): `README.md`

### Other components

- **GSU student**
- **Nutrislice REST API**

## Connections

- Menu ingestion → Nutrislice REST API: fetches menus (evidence: `README.md`)
- Menu ingestion → Station mapping: maps sections (evidence: `README.md`)
- Station mapping → Menu items: groups dishes (evidence: `README.md`)
- Menu ingestion → Campus schedules: respects schedules (evidence: `README.md`)
- Menu dashboard → Menu items: presents dishes (evidence: `README.md`)
- Menu dashboard → Station accordions: shows stations (evidence: `README.md`)
- Menu dashboard → Station filters: offers filters (evidence: `README.md`)
- Menu dashboard → Live search: offers search (evidence: `README.md`)
- Menu dashboard → Dietary badges: shows badges (evidence: `README.md`)
- GSU student → Menu dashboard: browses menus (evidence: `README.md`)
- GSU student → Food watchlist: stars dishes (evidence: `README.md`)
- Weekly scanner → Food watchlist: checks favorites (evidence: `README.md`)
- Weekly scanner → Campus schedules: scans meal days (evidence: `README.md`)
- Weekly scanner → Local notifications: schedules alerts (evidence: `README.md`)
- Food watchlist → Preferences storage: persists favorites (evidence: `README.md`)
- GSU student → Local notifications: receives alerts (evidence: `README.md`)
