# himanshuiiitbhopal/careayourhealth architecture

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

- Interactive diagram: https://gitdiagram.com/himanshuiiitbhopal/careayourhealth
- Repository: https://github.com/himanshuiiitbhopal/careayourhealth

## Overview

##### Project Type and Purpose
- Prescripto is a full-stack MERN web application for booking doctor appointments, comprising three user roles (Patient, Doctor, Admin).
- It consists of two React-based frontends (“frontend” for patients, “admin” for doctors & admins) and a Node/Express backend serving REST APIs, persisting data in MongoDB, and integrating with Stripe, Razorpay, and Cloudinary.

##### High-Level Architecture Components
a. Client Layer
- Patient Portal (frontend/src): React SPA hosted on Vercel, pages for Home, Doctors, Appointment booking, Profile, MyAppointments, Verify, etc.
- Admin/Doctor Portal (admin/src): React SPA with separate routes/pages for Admin (Dashboard, DoctorsList, AddDoctor, AllAppointments) and Doctor (DoctorDashboard, DoctorAppointments, DoctorProfile).
b. API Layer
- Backend Server (backend/server.js): Express.js application exposing REST endpoints under /api/user, /api/doctor, /api/admin.
- Middleware: JWT auth (authUser, authDoctor, authAdmin), file upload via Multer, Cloudinary config for image hosting.
c. Data Layer
- MongoDB (via mongoose in backend/config/mongodb.js) storing User, Doctor, Appointment schemas.
d. External Services
- Stripe & Razorpay for payment processing (configured in controllers).
- Cloudinary for doctor profile image uploads.
- Vercel for frontend & admin deployments (vercel.json configs).

##### Component Relationships & Data Flows
- Frontends ←–(HTTPS/REST + JWT)–→ Backend API
- Backend API ←–(Mongoose ORM)–→ MongoDB
- Backend API ←–→ Stripe & Razorpay (payment charge creation, webhooks)
- Backend API ←–→ Cloudinary (image upload/download)

##### Architectural Patterns & Design Principles
- MVC in the backend: Models (in models/), Controllers (in controllers/), Routes (in routes/).
- Context API in frontends for state management (AdminContext, DoctorContext, AppContext, UserContext).
- Separation of concerns: two distinct React apps sharing common patterns (Tailwind CSS, Vite bundler).
- Environment-based configuration (dotenv for API keys, Vercel env).

##### Technology & Deployment Notes
- Frontends: React, Vite, Tailwind CSS; specify “deployed on Vercel”.
- External payment services: Stripe, Razorpay; Cloudinary.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        PatientSPA["Patient React SPA<br/>(React, Vite, Tailwind)"]:::client
        AdminSPA["Admin React SPA<br/>(React, Vite, Tailwind)"]:::client
        DoctorSPA["Doctor React SPA<br/>(React, Vite, Tailwind)"]:::client
    end

    %% API Gateway
    subgraph "API Layer"
        direction TB
        APIGateway(["REST API Gateway<br/>(Node.js, Express.js, JWT auth, Multer, Mongoose)"]):::backend
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MongoDB[(MongoDB Atlas)]:::db
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Stripe["Stripe"]:::external
        Razorpay["Razorpay"]:::external
        Cloudinary["Cloudinary"]:::external
    end

    %% Connections
    PatientSPA -->|1. HTTPS/JSON+JWT| APIGateway
    AdminSPA   -->|1. HTTPS/JSON+JWT| APIGateway
    DoctorSPA  -->|1. HTTPS/JSON+JWT| APIGateway

    APIGateway -->|2. Mongoose ORM CRUD| MongoDB

    APIGateway -->|3. HTTPS Payments| Stripe
    APIGateway -->|3. HTTPS Payments| Razorpay
    APIGateway -->|4. HTTPS Image Upload| Cloudinary

    Stripe   -->|5. Webhooks| APIGateway
    Razorpay -->|5. Webhooks| APIGateway

    %% Click Events - Client
    click PatientSPA "https://github.com/himanshuiiitbhopal/careayourhealth/tree/main/frontend/src"
    click AdminSPA "https://github.com/himanshuiiitbhopal/careayourhealth/tree/main/admin/src"
    click DoctorSPA "https://github.com/himanshuiiitbhopal/careayourhealth/tree/main/admin/src/pages/Doctor"

    %% Click Events - API Layer
    click APIGateway "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/server.js"
    click MongoDB "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/config/mongodb.js"
    click Cloudinary "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/config/cloudinary.js"

    %% Backend MVC Components
    subgraph "Backend Modules"
        direction TB
        Controllers["Controllers"]:::backend
        Routes["Routes"]:::backend
        Models["Models"]:::backend
        Middleware["Middleware"]:::backend
    end

    APIGateway --> Controllers
    APIGateway --> Routes
    APIGateway --> Models
    APIGateway --> Middleware

    %% Controllers
    Controllers --> UserController["User Controller"] 
    Controllers --> DoctorController["Doctor Controller"]
    Controllers --> AdminController["Admin Controller"]
    click UserController "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/controllers/userController.js"
    click DoctorController "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/controllers/doctorController.js"
    click AdminController "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/controllers/adminController.js"

    %% Routes
    Routes --> UserRoute["/api/user"]
    Routes --> DoctorRoute["/api/doctor"]
    Routes --> AdminRoute["/api/admin"]
    click UserRoute "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/routes/userRoute.js"
    click DoctorRoute "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/routes/doctorRoute.js"
    click AdminRoute "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/routes/adminRoute.js"

    %% Models
    Models --> AppointmentModel["Appointment Model"]
    Models --> DoctorModel["Doctor Model"]
    Models --> UserModel["User Model"]
    click AppointmentModel "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/models/appointmentModel.js"
    click DoctorModel "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/models/doctorModel.js"
    click UserModel "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/models/userModel.js"

    %% Middleware
    Middleware --> AuthUser["authUser"]
    Middleware --> AuthDoctor["authDoctor"]
    Middleware --> AuthAdmin["authAdmin"]
    Middleware --> Multer["File Upload (Multer)"]
    click AuthUser "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/middleware/authUser.js"
    click AuthDoctor "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/middleware/authDoctor.js"
    click AuthAdmin "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/middleware/authAdmin.js"
    click Multer "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/backend/middleware/multer.js"

    %% Frontend Context Providers
    subgraph "Frontend Context Providers"
        direction TB
        AppContextFE["AppContext (Patient)"]
        AppContextAdmin["AppContext (Admin)"]
        AdminContext["AdminContext"]
        DoctorContext["DoctorContext"]
    end

    PatientSPA --> AppContextFE
    AdminSPA   --> AppContextAdmin
    AdminSPA   --> AdminContext
    DoctorSPA  --> DoctorContext

    click AppContextFE "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/frontend/src/context/AppContext.jsx"
    click AppContextAdmin "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/admin/src/context/AppContext.jsx"
    click AdminContext "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/admin/src/context/AdminContext.jsx"
    click DoctorContext "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/admin/src/context/DoctorContext.jsx"

    %% Deployment Configs
    subgraph "Deployment & Config"
        direction TB
        FEConfig["frontend/vite.config.js<br/>frontend/vercel.json"]
        AdminConfig["admin/vite.config.js<br/>admin/vercel.json"]
        FE_Tailwind["frontend/tailwind.config.js"]
        Admin_Tailwind["admin/tailwind.config.js"]
    end

    click FEConfig "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/frontend/vite.config.js"
    click FEConfig "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/frontend/vercel.json"
    click AdminConfig "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/admin/vite.config.js"
    click AdminConfig "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/admin/vercel.json"
    click FE_Tailwind "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/frontend/tailwind.config.js"
    click Admin_Tailwind "https://github.com/himanshuiiitbhopal/careayourhealth/blob/main/admin/tailwind.config.js"

    %% Styling
    classDef client fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#DFFFD0,stroke:#228B22,color:#228B22
    classDef db fill:#FFE0B2,stroke:#E65100,color:#E65100
    classDef external fill:#F0F0F0,stroke:#666,color:#333
```
