# maheshvaviya/nutri-veda architecture

> Architecture diagram of the GitHub repository maheshvaviya/nutri-veda, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maheshvaviya/nutri-veda
- Repository: https://github.com/maheshvaviya/nutri-veda

## Overview

##### Project type and purpose
- This is a full-stack web application (“NutriVeda”) for personalized Ayurvedic diet planning.
- Frontend: React + Tailwind, running on port 3000.
- Backend: Node.js/Express REST API, running on port 5000.
- Integrations: OpenAI for AI diet generation, Firebase for auth/DB, PDFKit for PDF output.

##### File structure
- Top-level: two folders, `nutriveda-frontend/` and `nutriveda-backend/`.
- Frontend: `src/pages/`, `src/components/` ⇒ React pages & UI components + routing in `App.jsx`.
- Backend: MVC pattern under `src/`:
- `routes/` defines REST endpoints (`/api/v1/patients`, `/ai-diet`, `/pdf`, etc.)
- `controllers/` orchestrate request handling (e.g., `aiDietController.js`, `patientController.js`)
- `services/` encapsulate business logic (e.g., `csvService`, `pdfService`)
- `models/` define data schemas (`Patient.js`, `DietChart.js`, `Food.js`…)
- `config/` holds `database.js`, `firebase.js`
- `middleware/` holds JWT auth checks
- Deployment scripts: `.env` for secrets, `scripts/loadPatientSamples.js` for CSV data import.

##### README for additional insights
- Describes each major feature: multi-step registration, AI diet generation, interactive editor, PDF download.
- Lists tech stack: React, Tailwind, Node.js/Express, OpenAI API, PDFKit, Firebase Admin.
- Provides API endpoints, environment variables, and architecture outline.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Browser["Web Browser"]:::frontend

    %% Frontend Layer
    subgraph "Frontend Application" 
        direction TB
        App["App.jsx"]:::frontend
        Routing["Routing (React Router)"]:::frontend
        subgraph "Pages" 
            direction TB
            Dashboard["Dashboard.jsx"]:::frontend
            DietGen["DietPlanGenerator.jsx"]:::frontend
            Login["Login.jsx"]:::frontend
            PatientForm["PatientForm.jsx"]:::frontend
            PatientMgmt["PatientManagement.jsx"]:::frontend
            Recipes["Recipes.jsx"]:::frontend
            Settings["Settings.jsx"]:::frontend
        end
        subgraph "UI Components"
            direction TB
            MealPlanCard["MealPlanCard.jsx"]:::frontend
            Navbar["Navbar.jsx"]:::frontend
            Sidebar["Sidebar.jsx"]:::frontend
        end
    end

    %% Backend Layer
    subgraph "Backend API Server" 
        direction TB
        Server["server.js"]:::backend
        Env[".env"]:::backend
        subgraph "Configuration"
            direction TB
            DBConfig["database.js"]:::backend
            FirebaseConfig["firebase.js"]:::backend
        end
        subgraph "Middleware"
            direction TB
            AuthMiddleware["auth.js"]:::backend
        end
        subgraph "Routes"
            direction TB
            AuthRoute["auth.js"]:::backend
            PatientRegRoute["patientRegistration.js"]:::backend
            PatientRoute["patient.js"]:::backend
            DietChartRoute["dietChart.js"]:::backend
            FoodRoute["food.js"]:::backend
            RecipeRoute["recipe.js"]:::backend
            AIDietRoute["aiDiet.js"]:::backend
            PDFRoute["pdf.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            AuthCtrl["authController.js"]:::backend
            PatientRegCtrl["patientRegistrationController.js"]:::backend
            PatientRegCtrlBk["patientRegistrationController_backup.js"]:::backend
            PatientCtrl["patientController.js"]:::backend
            DietChartCtrl["dietChartController.js"]:::backend
            FoodCtrl["foodController.js"]:::backend
            RecipeCtrl["recipeController.js"]:::backend
            AIDietCtrl["aiDietController.js"]:::backend
            PDFCtrl["pdfController.js"]:::backend
        end
        subgraph "Services"
            direction TB
            FoodService["foodService.js"]:::backend
            PDFService["pdfService.js"]:::backend
        end
        subgraph "Models"
            direction TB
            PatientModel["Patient.js"]:::backend
            DietChartModel["DietChart.js"]:::backend
            FoodModel["Food.js"]:::backend
            RecipeModel["Recipe.js"]:::backend
            PDFModel["pdf.js"]:::backend
        end
    end

    %% External & Data Layer
    subgraph "External Services & Data Stores"
        direction TB
        Firestore["Firebase Firestore"]:::db
        FirebaseAuth["Firebase Auth"]:::external
        OpenAI["OpenAI API"]:::external
        PDFKit["PDFKit Library"]:::external
        CSVScript["loadPatientSamples.js"]:::external
    end

    %% Interactions
    Browser -->|loads| App
    App -->|uses| Routing
    Routing --> Dashboard
    Routing --> DietGen
    Routing --> Login
    Routing --> PatientForm
    Routing --> PatientMgmt
    Routing --> Recipes
    Routing --> Settings

    DietGen -->|POST /api/v1/ai-diet/generate/:patientId| AIDietRoute
    PatientForm -->|POST /api/v1/patients| PatientRegRoute
    PatientMgmt -->|GET/PUT/DELETE /api/v1/patients| PatientRoute
    Recipes -->|GET/POST /api/v1/recipes| RecipeRoute

    AuthMiddleware --> AuthCtrl
    AuthRoute --> AuthCtrl
    PatientRegRoute --> PatientRegCtrl
    PatientRegCtrl --> FirebaseAuth
    PatientRegCtrl --> PatientModel
    PatientRegCtrlBk --> PatientRegCtrl

    PatientRoute --> PatientCtrl
    PatientCtrl --> PatientModel

    DietChartRoute --> DietChartCtrl
    DietChartCtrl --> DietChartModel

    FoodRoute --> FoodCtrl
    FoodCtrl --> FoodService
    FoodService --> FoodModel

    RecipeRoute --> RecipeCtrl
    RecipeCtrl --> RecipeModel

    AIDietRoute --> AIDietCtrl
    AIDietCtrl --> OpenAI
    AIDietCtrl --> DietChartModel

    PDFRoute --> PDFCtrl
    PDFCtrl --> PDFService
    PDFService --> PDFKit

    Server --> DBConfig
    Server --> FirebaseConfig
    Server --> AuthMiddleware
    Server --> Routes

    CSVScript -->|imports data| Firestore

    %% Data persistence
    PatientModel --> Firestore
    DietChartModel --> Firestore
    FoodModel --> Firestore
    RecipeModel --> Firestore

    %% Click Events
    click App "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/App.jsx"
    click Routing "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/App.jsx"
    click Dashboard "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/Dashboard.jsx"
    click DietGen "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/DietPlanGenerator.jsx"
    click Login "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/Login.jsx"
    click PatientForm "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/PatientForm.jsx"
    click PatientMgmt "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/PatientManagement.jsx"
    click Recipes "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/Recipes.jsx"
    click Settings "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/pages/Settings.jsx"
    click MealPlanCard "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/components/MealPlanCard.jsx"
    click Navbar "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/components/Navbar.jsx"
    click Sidebar "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-frontend/src/components/Sidebar.jsx"
    click Server "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/server.js"
    click Env "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/.env"
    click DBConfig "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/config/database.js"
    click FirebaseConfig "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/config/firebase.js"
    click AuthCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/authController.js"
    click AuthRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/auth.js"
    click AuthMiddleware "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/middleware/auth.js"
    click PatientRegCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/patientRegistrationController.js"
    click PatientRegCtrlBk "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/patientRegistrationController_backup.js"
    click PatientRegRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/patientRegistration.js"
    click PatientCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/patientController.js"
    click PatientRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/patient.js"
    click PatientModel "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/models/Patient.js"
    click DietChartCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/dietChartController.js"
    click DietChartRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/dietChart.js"
    click DietChartModel "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/models/DietChart.js"
    click FoodCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/foodController.js"
    click FoodRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/food.js"
    click FoodModel "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/models/Food.js"
    click FoodService "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/services/foodService.js"
    click RecipeCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/recipeController.js"
    click RecipeRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/recipe.js"
    click RecipeModel "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/models/Recipe.js"
    click AIDietCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/aiDietController.js"
    click AIDietRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/aiDiet.js"
    click PDFCtrl "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/controllers/pdfController.js"
    click PDFRoute "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/routes/pdf.js"
    click PDFService "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/services/pdfService.js"
    click PDFModel "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/src/models/pdf.js"
    click CSVScript "https://github.com/maheshvaviya/nutri-veda/blob/main/nutriveda-backend/scripts/loadPatientSamples.js"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#005B96,color:#000
    classDef backend fill:#DFF2BF,stroke:#4F8A10,color:#000
    classDef external fill:#FFE8CC,stroke:#C65D00,color:#000
    classDef db fill:#E0E0E0,stroke:#888,color:#000
```
