# banerjeesoumya/equihealth architecture

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

- Interactive diagram: https://gitdiagram.com/banerjeesoumya/equihealth
- Repository: https://github.com/banerjeesoumya/equihealth

## Overview

##### Project Type & Purpose
- EquiHealth is a full-stack, role-based healthcare platform.
- It consists of:
- A React + TypeScript single-page application (frontend/).
- A Hono.js + Prisma REST API server (backend/).
- A Python Flask microservice for ML-based disease prediction (Prediction/DiseasePrediction/).
- A PostgreSQL database behind Prisma.

##### File Structure
- Top-level:
- frontend/ – UI code, Vite build, Tailwind, React Router, Context.
- backend/ – Hono.js server, TS code in src/, Prisma schema & migrations.
- Prediction/ – Jupyter notebook, Flask app.py, pickled models.
- Config/build files: package.json, tsconfig.json, prisma/, requirements.txt, Docker or CI workflows (.github/).
- Role-specific routes in backend/src/routes (user, doctor, admin).

##### README Insights
- Key technologies: React/TypeScript, Vite, Tailwind, Hono.js, Prisma ORM, JWT auth, Flask/Python for ML.

##### Main Components & Interactions
a. Components:
1. Client Browser (React SPA).
2. Frontend App (served statically or via Vercel).
3. API Gateway / Authentication layer (Hono.js).
4. Business-logic modules: user, doctor, admin routes.
5. PostgreSQL Database (Prisma ORM).
6. ML Microservice (Flask Flask app.py + pickled models).
7. External services: JWT Auth provider, Email/SMS service (if any), Scheduling service.

b. Relationships / Data Flow:
- User’s browser ↔ Frontend SPA: HTTP(S) / WebSocket for chat.
- Frontend ↔ Backend REST API: Axios calls to /api/v1/* endpoints.
- Backend ↔ Database: Prisma client issues SQL queries to PostgreSQL.
- Backend ↔ ML Service: HTTP call to Flask endpoint (e.g., POST /predict).
- ML Service ↔ Pickled models: loads .pkl for inference.
- Backend ↔ External Auth/JWT: issues and validates tokens.

c. Architectural Patterns / Principles:
- Layered architecture: Presentation (React), API (Hono), Data access (Prisma + DB), ML service.
- Microservice for ML keeps Python dependencies isolated.
- Role-based access control via middleware (JWT).
- Separation of concerns: frontend UI vs. backend domain vs. ML inference.

d. Key Technologies to label:
- React, Vite, Tailwind CSS, React Router, Context API.
- Hono.js (lightweight), Prisma ORM, TypeScript.
- Flask (Python), scikit-learn (likely), vectorizer_symptom.pkl, disease_prediction_model.pkl.
- PostgreSQL.

##### Elements
- Browser → React SPA
- React SPA → API endpoints (/auth, /user, /doctor, /admin, /predict)
- API → DB
- API → ML Service
- ML Service → model files
- Blue for frontend/UI components
- Green for backend/API services
- Orange for external/infra (DB, ML models)
- Protocols (HTTP/HTTPS, WebSocket for chat).

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Client Tier
  subgraph "Client Tier"
    Browser["User Browser"]:::external
  end

  %% Frontend Layer
  subgraph "Frontend Layer"
    ReactSPA["React SPA"]:::frontend
    Entry["Entry: main.tsx"]:::frontend
    App["App.tsx & Routing"]:::frontend
    AuthContext["AuthContext"]:::frontend
    ThemeProvider["ThemeProvider"]:::frontend
    ProtectedRoute["ProtectedRoute"]:::frontend
    DashboardComp["Dashboard Components"]:::frontend
  end

  %% Backend Layer
  subgraph "Backend Layer"
    APIGateway["Hono.js API Gateway"]:::backend
    UserRoutes["user.ts (User Routes)"]:::backend
    DoctorRoutes["doctor.ts (Doctor Routes)"]:::backend
    AdminRoutes["admin.ts (Admin Routes)"]:::backend
    APIUtils["API Helpers & Types"]:::backend
    PrismaClient["Prisma Client"]:::backend
  end

  %% ML Prediction Service
  subgraph "ML Prediction Service"
    FlaskApp["Flask app"]:::ml
    Inference["Inference Engine"]:::ml
  end

  %% Data Tier
  subgraph "Data Tier"
    Postgres["PostgreSQL DB"]:::db
    PrismaSchema["Prisma Schema"]:::db
    Migrations["Migrations"]:::db
    Model1["disease_prediction_model.pkl"]:::db
    Model2["trained_model_symptom.pkl"]:::db
    Model3["vectorizer_symptom.pkl"]:::db
  end

  %% External Services
  JWT["JWT Auth Provider"]:::external
  Email["Email/SMS Service"]:::external
  Scheduling["Scheduling Service"]:::external

  %% Connections
  Browser --> ReactSPA
  ReactSPA -->|"HTTP/HTTPS"| APIGateway
  ReactSPA --> Entry
  Entry --> App
  App --> AuthContext
  App --> ThemeProvider
  App --> ProtectedRoute
  App --> DashboardComp

  APIGateway --> UserRoutes
  APIGateway --> DoctorRoutes
  APIGateway --> AdminRoutes
  APIGateway --> APIUtils
  APIGateway --> PrismaClient
  APIGateway -->|"POST /predict"| FlaskApp

  FlaskApp --> Inference
  Inference --> Model1
  Inference --> Model2
  Inference --> Model3

  PrismaClient --> Postgres
  PrismaSchema --> Postgres
  Migrations --> Postgres

  APIGateway -.-> JWT
  APIGateway -.-> Email
  APIGateway -.-> Scheduling

  %% Click Events
  click ReactSPA "https://github.com/banerjeesoumya/equihealth/tree/main/frontend/"
  click Entry "https://github.com/banerjeesoumya/equihealth/blob/main/frontend/src/main.tsx"
  click App "https://github.com/banerjeesoumya/equihealth/blob/main/frontend/src/App.tsx"
  click AuthContext "https://github.com/banerjeesoumya/equihealth/blob/main/frontend/src/contexts/AuthContext.tsx"
  click ThemeProvider "https://github.com/banerjeesoumya/equihealth/blob/main/frontend/src/components/ThemeProvider.tsx"
  click ProtectedRoute "https://github.com/banerjeesoumya/equihealth/blob/main/frontend/src/components/ProtectedRoute.tsx"
  click DashboardComp "https://github.com/banerjeesoumya/equihealth/tree/main/frontend/src/components/dashboard/"
  click APIGateway "https://github.com/banerjeesoumya/equihealth/blob/main/backend/src/index.ts"
  click UserRoutes "https://github.com/banerjeesoumya/equihealth/blob/main/backend/src/routes/user.ts"
  click DoctorRoutes "https://github.com/banerjeesoumya/equihealth/blob/main/backend/src/routes/doctor.ts"
  click AdminRoutes "https://github.com/banerjeesoumya/equihealth/blob/main/backend/src/routes/admin.ts"
  click APIUtils "https://github.com/banerjeesoumya/equihealth/blob/main/backend/src/utils/api.ts"
  click PrismaSchema "https://github.com/banerjeesoumya/equihealth/blob/main/backend/prisma/schema.prisma"
  click Migrations "https://github.com/banerjeesoumya/equihealth/tree/main/backend/prisma/migrations/"
  click FlaskApp "https://github.com/banerjeesoumya/equihealth/blob/main/Prediction/DiseasePrediction/app.py"
  click Model1 "https://github.com/banerjeesoumya/equihealth/blob/main/Prediction/DiseasePrediction/disease_prediction_model.pkl"
  click Model2 "https://github.com/banerjeesoumya/equihealth/blob/main/Prediction/DiseasePrediction/trained_model_symptom.pkl"
  click Model3 "https://github.com/banerjeesoumya/equihealth/blob/main/Prediction/DiseasePrediction/vectorizer_symptom.pkl"

  %% Styles
  classDef frontend fill:#aedcff,stroke:#0288d1,stroke-width:1px
  classDef backend fill:#b8e6b8,stroke:#2e7d32,stroke-width:1px
  classDef ml fill:#ffe0b2,stroke:#ef6c00,stroke-width:1px
  classDef db fill:#ffcc80,stroke:#e65100,stroke-width:1px
  classDef external fill:#f0f0f0,stroke:#888,stroke-dasharray: 5 5,stroke-width:1px
```
