# nehardxb23/nutriguardianai architecture

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

- Interactive diagram: https://gitdiagram.com/nehardxb23/nutriguardianai
- Repository: https://github.com/nehardxb23/nutriguardianai

## Overview

NutriGuardian AI combines a protected health-tracking web app with nutrition assistance, meal planning, translation, and disease-risk prediction. The main user flow runs from the web app through FastAPI routes to tracking or AI services and persisted records; the separate disease-prediction frontend presents four risk forms. The backend entry point explicitly registers the sampled API routers. Some feature implementations are only identified in the source index, so edges to those modules cite that index evidence; disease prediction’s backend-to-frontend wiring is not established by the excerpts.

Main entry points: [`backend/main.py`](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/main.py) (API application), [`backend/database.py`](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/database.py) (MySQL database), [`backend/api/agent.py`](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/agent.py) (Agent endpoint), [`backend/frontend/src/App.jsx`](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/App.jsx) (App routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_main_web["App routes<br/>[App.jsx]"]
  node_tracking_pages["Tracking and history<br/>[AddTracking.jsx]"]
  node_ai_pages["AI feature pages<br/>[Agent.jsx]"]
end

subgraph group_api["API and accounts"]
  node_backend_app["API application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_ai_schema["AI request schemas<br/>[ai_schema.py]"]
end

subgraph group_records["Health records"]
  node_tracking_api["Tracking endpoints<br/>[tracking.py]"]
  node_chat_model["Chat model<br/>[chat_history.py]"]
  node_meal_model["Meal history model<br/>[meal_history.py]"]
  node_tracking_model["Tracking model<br/>[tracking.py]"]
  node_user_model["User model<br/>[user.py]"]
  node_database[("MySQL database<br/>[database.py]")]
end

subgraph group_ai["AI assistance"]
  node_chat_api["Chat endpoints<br/>[chatbot.py]"]
  node_diet_api["Diet endpoints<br/>[diet_planner.py]"]
  node_agent_api["Agent endpoint<br/>[agent.py]"]
  node_translation_api["Translation endpoint<br/>[translation.py]"]
  node_agent_logic["Contextual agent<br/>[agent.py]"]
end

subgraph group_disease["Disease prediction"]
  node_disease_web["Disease risk UI"]
  node_disease_forms["Risk forms<br/>[DiabetesForm.jsx]"]
  node_disease_cards["Risk results<br/>[DiseaseCard.jsx]"]
  node_disease_predictors["Risk predictors"]
end

node_user(("User"))
node_ai_provider["AI model service"]

node_user -->|"uses"| node_main_web
node_main_web -->|"routes to"| node_tracking_pages
node_main_web -->|"routes to"| node_ai_pages
node_user -->|"uses"| node_disease_web
node_disease_web -->|"renders"| node_disease_forms
node_disease_web -->|"renders"| node_disease_cards
node_main_web -.->|"requests API"| node_backend_app
node_disease_forms -.->|"requests prediction"| node_disease_predictors
node_backend_app -->|"registers"| node_auth
node_backend_app -->|"registers"| node_tracking_api
node_backend_app -->|"registers"| node_chat_api
node_backend_app -->|"registers"| node_diet_api
node_backend_app -->|"registers"| node_agent_api
node_backend_app -->|"registers"| node_translation_api
node_auth -->|"queries and saves"| node_user_model
node_auth -->|"gets sessions"| node_database
node_tracking_api -->|"reads and writes"| node_tracking_model
node_tracking_api -->|"gets sessions"| node_database
node_chat_api -->|"uses history"| node_chat_model
node_chat_api -->|"gets sessions"| node_database
node_diet_api -->|"persists plans"| node_meal_model
node_diet_api -->|"gets sessions"| node_database
node_agent_api -->|"loads history"| node_tracking_model
node_agent_api -->|"loads history"| node_meal_model
node_agent_api -->|"calls"| node_agent_logic
node_agent_api -->|"saves conversation"| node_chat_model
node_agent_api -->|"gets sessions"| node_database
node_agent_api -->|"validates request"| node_ai_schema
node_agent_logic -->|"asks AI"| node_ai_provider
node_agent_logic -.->|"notifies"| node_backend_app
node_chat_model -->|"uses base"| node_database
node_meal_model -->|"uses base"| node_database
node_tracking_model -->|"uses base"| node_database
node_user_model -->|"uses base"| node_database

click node_main_web "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/App.jsx"
click node_tracking_pages "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/pages/AddTracking.jsx"
click node_ai_pages "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/pages/Agent.jsx"
click node_disease_web "https://github.com/nehardxb23/nutriguardianai/blob/main/frontend/src/pages/DiseasePrediction.jsx"
click node_disease_forms "https://github.com/nehardxb23/nutriguardianai/blob/main/frontend/src/components/DiabetesForm.jsx"
click node_disease_cards "https://github.com/nehardxb23/nutriguardianai/blob/main/frontend/src/components/DiseaseCard.jsx"
click node_backend_app "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/main.py"
click node_auth "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/auth/auth.py"
click node_tracking_api "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/tracking/tracking.py"
click node_chat_api "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/chatbot.py"
click node_diet_api "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/diet_planner.py"
click node_agent_api "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/agent.py"
click node_translation_api "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/translation.py"
click node_agent_logic "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/ai/agent.py"
click node_chat_model "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/chat_history.py"
click node_meal_model "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/meal_history.py"
click node_tracking_model "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/tracking.py"
click node_user_model "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/user.py"
click node_database "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/database.py"
click node_ai_schema "https://github.com/nehardxb23/nutriguardianai/blob/main/backend/schemas/ai_schema.py"
click node_disease_predictors "https://github.com/nehardxb23/nutriguardianai/tree/main/backend/disease/train"

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_main_web,node_tracking_pages,node_ai_pages,node_user toneBlue
class node_backend_app,node_auth,node_ai_schema toneAmber
class node_tracking_api,node_chat_model,node_meal_model,node_tracking_model,node_user_model,node_database toneMint
class node_chat_api,node_diet_api,node_agent_api,node_translation_api,node_agent_logic toneRose
class node_disease_web,node_disease_forms,node_disease_cards,node_disease_predictors,node_ai_provider toneIndigo
```

## Components

### Web experience

- [App routes](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/App.jsx): `backend/frontend/src/App.jsx`
- [Tracking and history](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/pages/AddTracking.jsx): `backend/frontend/src/pages/AddTracking.jsx`
- [AI feature pages](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/frontend/src/pages/Agent.jsx): `backend/frontend/src/pages/Agent.jsx`

### API and accounts

- [API application](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/main.py): `backend/main.py`
- [Authentication](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/auth/auth.py): `backend/auth/auth.py`
- [AI request schemas](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/schemas/ai_schema.py): `backend/schemas/ai_schema.py`

### Health records

- [Tracking endpoints](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/tracking/tracking.py): `backend/tracking/tracking.py`
- [Chat model](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/chat_history.py): `backend/models/chat_history.py`
- [Meal history model](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/meal_history.py): `backend/models/meal_history.py`
- [Tracking model](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/tracking.py): `backend/models/tracking.py`
- [User model](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/models/user.py): `backend/models/user.py`
- [MySQL database](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/database.py): `backend/database.py`

### AI assistance

- [Chat endpoints](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/chatbot.py): `backend/api/chatbot.py`
- [Diet endpoints](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/diet_planner.py): `backend/api/diet_planner.py`
- [Agent endpoint](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/agent.py): `backend/api/agent.py`
- [Translation endpoint](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/api/translation.py): `backend/api/translation.py`
- [Contextual agent](https://github.com/nehardxb23/nutriguardianai/blob/main/backend/ai/agent.py): `backend/ai/agent.py`

### Disease prediction

- [Disease risk UI](https://github.com/nehardxb23/nutriguardianai/blob/main/frontend/src/pages/DiseasePrediction.jsx): `frontend/src/pages/DiseasePrediction.jsx`
- [Risk forms](https://github.com/nehardxb23/nutriguardianai/blob/main/frontend/src/components/DiabetesForm.jsx): `frontend/src/components/DiabetesForm.jsx`
- [Risk results](https://github.com/nehardxb23/nutriguardianai/blob/main/frontend/src/components/DiseaseCard.jsx): `frontend/src/components/DiseaseCard.jsx`
- [Risk predictors](https://github.com/nehardxb23/nutriguardianai/tree/main/backend/disease/train): `backend/disease/train`

### Other components

- **User**
- **AI model service**

## Connections

- User → App routes: uses (evidence: `backend/frontend/src/App.jsx`)
- App routes → Tracking and history: routes to (evidence: `backend/frontend/src/App.jsx`)
- App routes → AI feature pages: routes to (evidence: `backend/frontend/src/App.jsx`)
- User → Disease risk UI: uses
- Disease risk UI → Risk forms: renders (evidence: `frontend/src/pages/DiseasePrediction.jsx`)
- Disease risk UI → Risk results: renders (evidence: `frontend/src/pages/DiseasePrediction.jsx`)
- App routes → API application: requests API
- Risk forms → Risk predictors: requests prediction
- API application → Authentication: registers (evidence: `backend/main.py`)
- API application → Tracking endpoints: registers (evidence: `backend/main.py`)
- API application → Chat endpoints: registers (evidence: `backend/main.py`)
- API application → Diet endpoints: registers (evidence: `backend/main.py`)
- API application → Agent endpoint: registers (evidence: `backend/main.py`)
- API application → Translation endpoint: registers (evidence: `backend/main.py`)
- Authentication → User model: queries and saves (evidence: `backend/auth/auth.py`)
- Authentication → MySQL database: gets sessions (evidence: `backend/auth/auth.py`)
- Tracking endpoints → Tracking model: reads and writes (evidence: `backend/tracking/tracking.py`)
- Tracking endpoints → MySQL database: gets sessions (evidence: `backend/tracking/tracking.py`)
- Chat endpoints → Chat model: uses history (evidence: `backend/api/chatbot.py`)
- Chat endpoints → MySQL database: gets sessions (evidence: `backend/api/chatbot.py`)
- Diet endpoints → Meal history model: persists plans (evidence: `backend/api/diet_planner.py`)
- Diet endpoints → MySQL database: gets sessions (evidence: `backend/api/diet_planner.py`)
- Agent endpoint → Tracking model: loads history (evidence: `backend/api/agent.py`)
- Agent endpoint → Meal history model: loads history (evidence: `backend/api/agent.py`)
- Agent endpoint → Contextual agent: calls (evidence: `backend/api/agent.py`)
- Agent endpoint → Chat model: saves conversation (evidence: `backend/api/agent.py`)
- Agent endpoint → MySQL database: gets sessions (evidence: `backend/api/agent.py`)
- Agent endpoint → AI request schemas: validates request (evidence: `backend/api/agent.py`)
- Contextual agent → AI model service: asks AI (evidence: `backend/ai/agent.py`)
- Contextual agent → API application: notifies
- Chat model → MySQL database: uses base (evidence: `backend/models/chat_history.py`)
- Meal history model → MySQL database: uses base (evidence: `backend/models/meal_history.py`)
- Tracking model → MySQL database: uses base (evidence: `backend/models/tracking.py`)
- User model → MySQL database: uses base (evidence: `backend/models/user.py`)
