# senthilcaesar/diabetes-nutrition-app architecture

> Architecture diagram of the GitHub repository senthilcaesar/diabetes-nutrition-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/senthilcaesar/diabetes-nutrition-app
- Repository: https://github.com/senthilcaesar/diabetes-nutrition-app

## Overview

##### Project type and purpose
- This is a Python-based, full-stack, AI-driven web application built with Streamlit.
- It collects user health metrics, socioeconomic data, optional genetic profiles, and uses OpenAI’s GPT-4 (and a RAG pipeline with Pinecone) to generate personalized nutrition plans for diabetes management.
- Key use cases: data collection pages, health & genetic analysis, AI content generation, retrieval-augmented Q&A from PDF resources.

##### File structure
- Root
- app.py: Streamlit entry point, page router
- Dockerfile / .devcontainer: containerization for consistent dev/test
- .streamlit/config.toml: Streamlit configuration
- apprunner.yaml: AWS App Runner deployment manifest
- app_pages/: UI pages (input_page, health_assessment_page, nutrition_plan_page, educational_resources_page, rag_qa_page)
- utils/: business logic & service layer (data_processing, llm_integration, genetic_processing, genetic_llm_integration, rag_system, pinecone_utils, UI components, visualizations)
- rag/: ingestion pipeline for PDF documents, Pinecone utility wrappers
- example_data/: sample genetic data to demo processing
- requirements.txt, README.md: dependencies & documentation

##### README for additional insights
- Describes modular separation: app.py (UI router), utils/ (services), app_pages/ (view layer), example_data/
- Lists core technologies: Streamlit UI, OpenAI GPT-4, Pinecone embeddings (via LangChain splitters), Matplotlib/Plotting, Pandas/Numpy, PyMuPDF for PDF extraction
- Mentions RAG Q&A system as an embedded feature leveraging retrieved PDF content

##### Final recommendations
- Every module in utils and app_pages as distinct nodes

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        App["Streamlit Entry Point & Router\n(app.py)"]:::frontend
        Config["Streamlit Configuration\n(.streamlit/config.toml)"]:::frontend
        InputPage["Input Data Collection Page\n(app_pages/input_page.py)"]:::frontend
        HealthPage["Health Assessment Page\n(app_pages/health_assessment_page.py)"]:::frontend
        NutritionPage["Nutrition Plan Display Page\n(app_pages/nutrition_plan_page.py)"]:::frontend
        EduPage["Educational Resources Page\n(app_pages/educational_resources_page.py)"]:::frontend
        RAGPage["RAG Q&A Page\n(app_pages/rag_qa_page.py)"]:::frontend
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        DataProc["Data Processing Service\n(utils/data_processing.py)"]:::service
        GeneticProc["Genetic Processing Pipeline\n(utils/genetic_processing.py)"]:::service
        GeneticLLM["Genetic LLM Enrichment\n(utils/genetic_llm_integration.py)"]:::service
        GeneticUI["Genetic UI Components\n(utils/genetic_ui_components.py)"]:::service
        LLM["LLM Orchestration Service\n(utils/llm_integration.py)"]:::service
        RAGSys["RAG Query Orchestration\n(utils/rag_system.py)"]:::service
        UIComp["Shared UI Components\n(utils/ui_components.py)"]:::service
        Viz["Visualization Service\n(utils/visualization.py)"]:::service
    end

    %% RAG Ingestion Layer
    subgraph "RAG Ingestion Layer"
        direction TB
        Ingest["Document Ingestion & Chunking\n(rag/ingest_documents.py)"]:::service
        PineUtils["Pinecone Utility Wrappers\n(rag/pinecone_utils.py)"]:::service
    end

    %% Data Stores
    subgraph "Data Stores"
        direction TB
        ExampleData["Example Genetic Data\n(example_data/sample_23andme.txt)"]:::data
        PDFStore["Static PDF Data Store\n(rag/data/*.pdf)"]:::data
        SessionState["Session State\n(in-memory)"]:::data
        PineconeDB["Pinecone Vector DB"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        OpenAI["OpenAI API\n(GPT-4, Embeddings)"]:::external
    end

    %% Containerization & Deployment
    subgraph "Containerization & Deployment"
        direction TB
        Docker["Dockerfile"]:::service
        DevContainer[".devcontainer/devcontainer.json"]:::service
        AppRunner["apprunner.yaml"]:::service
    end

    %% Connections: UI to Services
    App -->|routes to| InputPage
    App -->|routes to| HealthPage
    App -->|routes to| NutritionPage
    App -->|routes to| EduPage
    App -->|routes to| RAGPage
    InputPage -->|uses| DataProc
    HealthPage -->|uses| DataProc
    NutritionPage -->|displays| Viz
    RAGPage -->|submits queries to| RAGSys
    RAGPage -->|uses| UIComp
    HealthPage -->|uses| GeneticUI
    HealthPage -->|sends data to| GeneticProc

    %% Genetic Flow
    GeneticUI -->|collects genetic data| GeneticProc
    GeneticProc -->|enrich via LLM| GeneticLLM
    GeneticLLM -->|provides prompts to| LLM

    %% Nutrition Plan Flow
    NutritionPage -->|triggers| LLM
    LLM -->|requests| OpenAI
    OpenAI -->|returns plan| LLM
    LLM -->|responds to| NutritionPage

    %% RAG Pipeline Flow
    Ingest -->|reads| PDFStore
    Ingest -->|chunks & embeds| PineconeDB
    PineUtils -->|manages| PineconeDB
    RAGSys -->|queries| PineconeDB
    RAGSys -->|retrieves chunks| PineUtils
    RAGSys -->|forwards to| LLM
    LLM -->|answers| RAGSys
    RAGSys -->|displays answer| RAGPage

    %% Visualization Flow
    HealthPage -->|requests charts| Viz
    DataProc -->|provides processed data| Viz
    Viz -->|renders charts| HealthPage

    %% Data Assets
    GeneticProc -->|example input| ExampleData
    Ingest -->|source files| PDFStore

    %% Containerization
    App --> Docker
    App --> DevContainer
    App --> AppRunner

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef service fill:#D0FFD8,stroke:#28a745,color:#28a745;
    classDef data fill:#FFF4D0,stroke:#d73a49,color:#d73a49;
    classDef external fill:#FFD8A8,stroke:#dbab09,color:#dbab09;

    %% Click Events
    click App "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/app.py"
    click Config "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/.streamlit/config.toml"
    click InputPage "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/app_pages/input_page.py"
    click HealthPage "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/app_pages/health_assessment_page.py"
    click NutritionPage "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/app_pages/nutrition_plan_page.py"
    click EduPage "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/app_pages/educational_resources_page.py"
    click RAGPage "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/app_pages/rag_qa_page.py"
    click DataProc "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/data_processing.py"
    click GeneticProc "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/genetic_processing.py"
    click GeneticLLM "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/genetic_llm_integration.py"
    click GeneticUI "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/genetic_ui_components.py"
    click LLM "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/llm_integration.py"
    click RAGSys "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/rag_system.py"
    click DataProc "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/data_processing.py"
    click UIComp "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/ui_components.py"
    click Viz "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/utils/visualization.py"
    click Ingest "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/rag/ingest_documents.py"
    click PineUtils "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/rag/pinecone_utils.py"
    click ExampleData "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/example_data/sample_23andme.txt"
    click Docker "https://github.com/senthilcaesar/diabetes-nutrition-app/tree/main/Dockerfile"
    click DevContainer "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/.devcontainer/devcontainer.json"
    click AppRunner "https://github.com/senthilcaesar/diabetes-nutrition-app/blob/main/apprunner.yaml"
```
