# chey004/health-readmit-predictor architecture

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

- Interactive diagram: https://gitdiagram.com/chey004/health-readmit-predictor
- Repository: https://github.com/chey004/health-readmit-predictor

## Overview

##### Project type and purpose
- This is a single-page web application built with Vite, React, and TypeScript.
- It uses a component-driven UI library (shadcn-ui + Tailwind CSS) and integrates with Supabase for data storage/auth.
- The app focuses on patient risk visualization & simulation, exposing forms, charts, and calculators.

##### File structure
- Top level: config (`tsconfig.*`, `vite.config.ts`), package manifests, public assets.
- `src/main.tsx` → application entrypoint bootstraps React.
- `src/pages` → route components (Index, NotFound).
- `src/components` → UI building blocks and feature components (DataTable, RiskDisplay, etc.).
- `src/components/ui` → generic UI primitives (buttons, dialogs, forms).
- `src/hooks` → custom React hooks (e.g. `use‐mobile`).
- `src/utils` & `src/lib` → pure logic and helpers (e.g. `riskCalculator`, `utils.ts`).
- `src/integrations/supabase` → the Supabase client and type definitions.
- `supabase/config.toml` → Supabase project configuration.

##### README
- Lists core tech: Vite, React, TypeScript, shadcn-ui, Tailwind CSS.
- Deployment hints: static deploy (Netlify etc.).
- No custom backend code – uses Supabase as BaaS.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    User["User"]:::external --> Browser["Browser"]:::external
    Browser --> Main["src/main.tsx"]:::ui
    Main --> App["src/App.tsx"]:::ui
    App --> Index["src/pages/Index.tsx"]:::ui
    App --> NotFound["src/pages/NotFound.tsx"]:::ui

    subgraph "Core UI Components"
        Header["Header"]:::ui
        InfoCard["InfoCard"]:::ui
        DataTable["DataTable"]:::ui
        ModelBadge["ModelBadge"]:::ui
        ModelMetricsCard["ModelMetricsCard"]:::ui
        FeatureImportance["FeatureImportance"]:::ui
        FeatureImportanceChart["FeatureImportanceChart"]:::ui
        PatientForm["PatientForm"]:::ui
    end

    subgraph "Risk Visualization & Simulation Components"
        RiskDisplay["RiskDisplay"]:::ui
        InteractiveRiskDisplay["InteractiveRiskDisplay"]:::ui
        RiskGauge["RiskGauge"]:::ui
        RiskComparisonChart["RiskComparisonChart"]:::ui
        RiskCategory["RiskCategory"]:::ui
        RiskRecommendations["RiskRecommendations"]:::ui
        RiskBackdrop["RiskBackdrop"]:::ui
        RiskScenarioSimulator["RiskScenarioSimulator"]:::ui
    end

    subgraph "UI Library (shadcn-ui + Tailwind CSS)"
        UILib["src/components/ui/"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        UseMobile["use-mobile.tsx"]:::logic
        UseToast["use-toast.ts"]:::logic
        RiskCalculator["riskCalculator.ts"]:::logic
        Utils["utils.ts"]:::logic
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        SupabaseClient["client.ts"]:::data
        SupabaseTypes["types.ts"]:::data
    end

    %% External Services
    subgraph "External Services"
        SupabaseAuth["Supabase Auth"]:::external
        SupabaseDB["Supabase Postgres DB"]:::external
        SupabaseConfig["supabase/config.toml"]:::config
    end

    %% Build & Deployment
    subgraph "Build & Deployment"
        ViteConfig["vite.config.ts"]:::config
        TSConfig["tsconfig.json"]:::config
        TailwindConfig["tailwind.config.ts"]:::config
        PostCSS["postcss.config.js"]:::config
        IndexHTML["index.html"]:::config
        PackageJSON["package.json"]:::config
        CI["GitHub/Lovable CI"]:::external
        Hosting["Netlify (or similar)"]:::external
    end

    %% Relationships
    Index --> Header
    Index --> InfoCard
    Index --> DataTable
    Index --> ModelBadge
    Index --> ModelMetricsCard
    Index --> FeatureImportance
    Index --> FeatureImportanceChart
    Index --> PatientForm

    PatientForm --> RiskCalculator
    RiskCalculator --> RiskDisplay
    RiskCalculator --> InteractiveRiskDisplay
    RiskCalculator --> RiskScenarioSimulator

    InteractiveRiskDisplay --> RiskGauge
    InteractiveRiskDisplay --> RiskComparisonChart
    RiskComparisonChart --> RiskCategory
    RiskComparisonChart --> RiskRecommendations
    RiskBackdrop --> InteractiveRiskDisplay

    Header --> UILib
    InfoCard --> UILib
    DataTable --> UILib
    ModelBadge --> UILib
    ModelMetricsCard --> UILib
    FeatureImportance --> UILib
    FeatureImportanceChart --> UILib
    PatientForm --> UILib
    RiskDisplay --> UILib
    InteractiveRiskDisplay --> UILib
    RiskGauge --> UILib
    RiskComparisonChart --> UILib
    RiskCategory --> UILib
    RiskRecommendations --> UILib
    RiskBackdrop --> UILib
    RiskScenarioSimulator --> UILib

    UseMobile --> Utils
    UseToast --> Utils

    RiskCalculator --> Utils
    PatientForm --> UseMobile
    PatientForm --> UseToast

    RiskCalculator --> SupabaseClient
    SupabaseClient --> SupabaseAuth
    SupabaseClient --> SupabaseDB

    ViteConfig --> Main
    TSConfig --> Main
    TailwindConfig --> UILib
    PostCSS --> UILib
    IndexHTML --> Main
    PackageJSON --> ViteConfig

    CI --> ViteConfig
    CI --> Hosting
    ViteConfig --> Hosting

    %% Click events
    click Main "https://github.com/chey004/health-readmit-predictor/blob/main/src/main.tsx"
    click App "https://github.com/chey004/health-readmit-predictor/blob/main/src/App.tsx"
    click Index "https://github.com/chey004/health-readmit-predictor/blob/main/src/pages/Index.tsx"
    click NotFound "https://github.com/chey004/health-readmit-predictor/blob/main/src/pages/NotFound.tsx"
    click Header "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/Header.tsx"
    click InfoCard "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/InfoCard.tsx"
    click DataTable "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/DataTable.tsx"
    click ModelBadge "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/ModelBadge.tsx"
    click ModelMetricsCard "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/ModelMetricsCard.tsx"
    click FeatureImportance "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/FeatureImportance.tsx"
    click FeatureImportanceChart "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/FeatureImportanceChart.tsx"
    click PatientForm "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/PatientForm.tsx"
    click RiskDisplay "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskDisplay.tsx"
    click InteractiveRiskDisplay "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/InteractiveRiskDisplay.tsx"
    click RiskGauge "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskGauge.tsx"
    click RiskComparisonChart "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskComparisonChart.tsx"
    click RiskCategory "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskCategory.tsx"
    click RiskRecommendations "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskRecommendations.tsx"
    click RiskBackdrop "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskBackdrop.tsx"
    click RiskScenarioSimulator "https://github.com/chey004/health-readmit-predictor/blob/main/src/components/risk/RiskScenarioSimulator.tsx"
    click UILib "https://github.com/chey004/health-readmit-predictor/tree/main/src/components/ui/"
    click UseMobile "https://github.com/chey004/health-readmit-predictor/blob/main/src/hooks/use-mobile.tsx"
    click UseToast "https://github.com/chey004/health-readmit-predictor/blob/main/src/hooks/use-toast.ts"
    click RiskCalculator "https://github.com/chey004/health-readmit-predictor/blob/main/src/utils/riskCalculator.ts"
    click Utils "https://github.com/chey004/health-readmit-predictor/blob/main/src/lib/utils.ts"
    click SupabaseClient "https://github.com/chey004/health-readmit-predictor/blob/main/src/integrations/supabase/client.ts"
    click SupabaseTypes "https://github.com/chey004/health-readmit-predictor/blob/main/src/integrations/supabase/types.ts"
    click SupabaseConfig "https://github.com/chey004/health-readmit-predictor/blob/main/supabase/config.toml"
    click ViteConfig "https://github.com/chey004/health-readmit-predictor/blob/main/vite.config.ts"
    click TSConfig "https://github.com/chey004/health-readmit-predictor/blob/main/tsconfig.json"
    click TailwindConfig "https://github.com/chey004/health-readmit-predictor/blob/main/tailwind.config.ts"
    click PostCSS "https://github.com/chey004/health-readmit-predictor/blob/main/postcss.config.js"
    click IndexHTML "https://github.com/chey004/health-readmit-predictor/blob/main/index.html"
    click PackageJSON "https://github.com/chey004/health-readmit-predictor/blob/main/package.json"

    %% Styles
    classDef ui fill:#e0f7fa,stroke:#006064,color:#000
    classDef logic fill:#e8f5e9,stroke:#2e7d32,color:#000
    classDef data fill:#fff3e0,stroke:#ef6c00,color:#000
    classDef external fill:#eceff1,stroke:#546e7a,color:#000
    classDef config fill:#f3e5f5,stroke:#6a1b9a,color:#000
```
