# devyanshu-kataria/careconnect architecture

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

- Interactive diagram: https://gitdiagram.com/devyanshu-kataria/careconnect
- Repository: https://github.com/devyanshu-kataria/careconnect

## Overview

##### Project type and purpose
- From the file tree, this is a full-stack medical appointment and records management application.
- Frontend: A React/Vite single-page application (SPA) under `frontend/src`.
- Backend: An Express.js API with Mongoose models for bookings, doctors, users, reviews, reports, prescriptions, authentication, and file uploads.

##### File structure
- Top-level directories: `frontend/` and `backend/`.
- Frontend:
- `src/pages`, `src/components`, `src/routes`, `src/context`, `src/hooks`, `src/utils` – typical React architecture.
- ProtectedRoute → route guarding using JWT in context.
- Backend:
- `Controllers/` → business logic for each resource (auth, booking, doctor, document, review, user).
- `Routes/` → Express routers mounting controllers at `/auth`, `/booking`, `/doctor`, `/documents`, `/review`, `/user`, `/upload`.
- `models/` → Mongoose schemas for each domain object.
- `auth/verifyToken.js` → JWT validation middleware.
- `index.js` → entrypoint that sets up Express, middleware, and route mounting.
- `vercel.json` → deployment config for Vercel (likely serverless functions).

##### README for additional insights
- README is empty; infer architecture details from file names: uses JWT authentication, file uploads (documents), React Context for auth state, Axios-style fetch hooks.

##### Elements
- Clear component labels (e.g., “React SPA”, “Express API”, “MongoDB”).
- UI → Router → API → Controllers → Models → Database
- Models → Database
- File upload route → File Storage
- Blue for frontend/UI
- Green for backend/API
- Orange for database/storage

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend (React SPA)"
        direction TB
        MainFE["main.jsx & App.jsx"]:::frontend
        Routes["Routers.jsx & ProtectedRoute.jsx"]:::frontend
        Context["AuthContext.jsx"]:::frontend
        Hooks["useFetchData.jsx"]:::frontend
        Utils["convertTime.js"]:::frontend
        Pages["src/pages"]:::frontend
        Components["src/components"]:::frontend
    end

    subgraph "Backend (Express API)"
        direction TB
        Entry["index.js"]:::backend
        Verify["verifyToken.js"]:::backend
        subgraph "Routes"
            direction TB
            AuthRoute["auth.js"]:::backend
            BookingRoute["booking.js"]:::backend
            DoctorRoute["doctor.js"]:::backend
            UploadRoute["upload.js & documents.js"]:::backend
            ReviewRoute["review.js"]:::backend
            UserRoute["user.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            AuthCtrl["authController.js"]:::backend
            BookingCtrl["bookingController.js"]:::backend
            DoctorCtrl["doctorController.js"]:::backend
            DocumentCtrl["documentController.js"]:::backend
            ReviewCtrl["reviewController.js"]:::backend
            UserCtrl["userController.js"]:::backend
        end
        subgraph "Models"
            direction TB
            BookingModel["BookingSchema.js"]:::backend
            DoctorModel["DoctorSchema.js"]:::backend
            PrescriptionModel["PrescriptionSchema.js"]:::backend
            ReportModel["ReportSchema.js"]:::backend
            ReviewModel["ReviewSchema.js"]:::backend
            UserModel["UserSchema.js"]:::backend
        end
    end

    Database["MongoDB"]:::database
    Storage["File Storage"]:::database
    ExternalEmail["Email Service"]:::external

    MainFE -->|renders| Routes
    Routes -->|protects| Pages
    Routes -->|renders| Components
    Routes -->|uses| Context
    Context -->|provides token & state| Hooks
    Hooks -->|HTTP requests| Entry
    Utils -->|formatting| Pages

    Entry -->|uses| Verify
    Entry -->|mounts| AuthRoute
    Entry -->|mounts| BookingRoute
    Entry -->|mounts| DoctorRoute
    Entry -->|mounts| UploadRoute
    Entry -->|mounts| ReviewRoute
    Entry -->|mounts| UserRoute

    AuthRoute -->|calls| AuthCtrl
    BookingRoute -->|calls| BookingCtrl
    DoctorRoute -->|calls| DoctorCtrl
    UploadRoute -->|calls| DocumentCtrl
    ReviewRoute -->|calls| ReviewCtrl
    UserRoute -->|calls| UserCtrl

    AuthCtrl -->|reads/writes| UserModel
    BookingCtrl -->|reads/writes| BookingModel
    DoctorCtrl -->|reads/writes| DoctorModel
    DocumentCtrl -->|writes metadata| ReportModel
    DocumentCtrl -->|uploads files| Storage
    ReviewCtrl -->|reads/writes| ReviewModel
    UserCtrl -->|reads/writes| UserModel

    BookingModel -->|persist| Database
    DoctorModel -->|persist| Database
    PrescriptionModel -->|persist| Database
    ReportModel -->|persist metadata| Database
    ReviewModel -->|persist| Database
    UserModel -->|persist| Database

    DocumentCtrl -->|send notification| ExternalEmail

    click MainFE "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/main.jsx"
    click MainFE "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/App.jsx"
    click Routes "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/routes/Routers.jsx"
    click Routes "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/routes/ProtectedRoute.jsx"
    click Context "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/context/AuthContext.jsx"
    click Hooks "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/hooks/useFetchData.jsx"
    click Utils "https://github.com/devyanshu-kataria/careconnect/blob/main/frontend/src/utils/convertTime.js"
    click Pages "https://github.com/devyanshu-kataria/careconnect/tree/main/frontend/src/pages"
    click Components "https://github.com/devyanshu-kataria/careconnect/tree/main/frontend/src/components"
    click Entry "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/index.js"
    click Verify "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/auth/verifyToken.js"
    click AuthRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/auth.js"
    click BookingRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/booking.js"
    click DoctorRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/doctor.js"
    click UploadRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/upload.js"
    click UploadRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/documents.js"
    click ReviewRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/review.js"
    click UserRoute "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Routes/user.js"
    click AuthCtrl "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Controllers/authController.js"
    click BookingCtrl "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Controllers/bookingController.js"
    click DoctorCtrl "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Controllers/doctorController.js"
    click DocumentCtrl "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Controllers/documentController.js"
    click ReviewCtrl "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Controllers/reviewController.js"
    click UserCtrl "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/Controllers/userController.js"
    click BookingModel "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/models/BookingSchema.js"
    click DoctorModel "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/models/DoctorSchema.js"
    click PrescriptionModel "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/models/PrescriptionSchema.js"
    click ReportModel "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/models/ReportSchema.js"
    click ReviewModel "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/models/ReviewSchema.js"
    click UserModel "https://github.com/devyanshu-kataria/careconnect/blob/main/backend/models/UserSchema.js"

    classDef frontend fill:#E0F7FA,stroke:#00796B,color:#004D40
    classDef backend fill:#E8F5E9,stroke:#388E3C,color:#1B5E20
    classDef database fill:#FFF3E0,stroke:#F57C00,color:#E65100
    classDef external stroke-dasharray: 5 5,fill:#F3E5F5,stroke:#8E24AA,color:#4A148C
```
