# priyanshudas01/bloodnetwork architecture

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

- Interactive diagram: https://gitdiagram.com/priyanshudas01/bloodnetwork
- Repository: https://github.com/priyanshudas01/bloodnetwork

## Overview

##### Project Type and Purpose
- Full-stack blood donation platform
- React frontend (client) + Node/Express backend (server) + MongoDB database
- Integrates Mapbox for mapping, Google OAuth for authentication, real-time inventory & alerting

##### File Structure
- Top level: `/client` (React app), `/server` (Express API)
- Client: `public/`, `src/` (components grouped by feature: Auth, Bank, User, Main, Util, context)
- Server: `app.js`, `middleware/` (authentication), `models/` (Mongoose schemas), `routers/` (Express route modules)

##### Key Components to Illustrate
a. Frontend (React)
– Components (AuthContext, API wrapper)
– UI features: map (Mapbox GL), animations (Framer Motion), routing (React Router), HTTP client (Axios)
– Environment config (REACT_APP_API_URL, MAPBOX_TOKEN)
b. Backend (Node.js/Express)
– Express server entry (`app.js`)
– Middleware layer (`auth.js` JWT & Passport)
– Routers: `authRouter`, `bankRouter`, `campRouter`, `userRouter`
– Controllers (implicit in routers)
– Models (`models.js` defines User, Bank, Camp schemas via Mongoose)
c. Database
– MongoDB instance (hosted, connection via MONGODB_URI)
– Collections: users, banks, camps, inventory
d. External Services
– Google OAuth2 (GOOGLE_CLIENT_ID/SECRET)
– Mapbox API
– (Optional) Notification/push service for emergency alerts

##### Relationships and Data Flows
- Frontend → Backend API (HTTP/HTTPS, Axios)
- Auth requests: signup/login → receives JWT
- CRUD: banks, camps, user profiles
- Search/filter: real-time availability, location queries
- Backend → Database (Mongoose ORM)
- Backend → External APIs
- Google OAuth for social login
- Mapbox for map tiles/geocoding
- (Future) push notification service
- Frontend Context (AuthContext) stores JWT, provides to Axios via Authorization header

##### Architectural Patterns & Design Principles
- Frontend: component-driven UI, single-page app, separation of concerns by feature folder
- Backend: MVC-style separation (Routes → Controllers → Models), middleware for cross-cutting concerns (auth)
- API-first: RESTful routes mapped to resource endpoints
- JWT-based stateless authentication

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        ReactApp["React App\n(Axios, React Router, Mapbox, Framer Motion)\nEnv: REACT_APP_API_URL, MAPBOX_TOKEN"]:::frontend
        ApiWrapper["API Wrapper\n(Axios)"]:::frontend
        AuthCtx["AuthContext\n(JWT Storage)"]:::frontend
        Routing["Routing\n(React Router)"]:::frontend
        MapUI["Map UI\n(Mapbox Integration)"]:::frontend

        subgraph "Bank UI"
            direction TB
            BankDash["Bank Dashboard"]:::frontend
            RegisterBank["RegisterBank Form"]:::frontend
            Stock["Stock Management"]:::frontend
            CampsList["Camps Listing"]:::frontend
            CampsCheck["CampsCheck"]:::frontend
            CampEdit["CampEdit"]:::frontend
        end

        subgraph "User UI"
            direction TB
            UserNav["UserNav"]:::frontend
            UserProfile["User Profile"]:::frontend
            EditProfile["EditProfile Form"]:::frontend
            BanksSearch["BanksSearch"]:::frontend
            CampsSearch["CampsSearch"]:::frontend
        end

        subgraph "Main/Public Pages"
            direction TB
            Home["Home"]:::frontend
            About["About"]:::frontend
            BanksPub["Banks"]:::frontend
            CampsPub["Camps"]:::frontend
            Contact["Contact"]:::frontend
            Navbar["Navbar"]:::frontend
            AboutDonation["AboutDonation"]:::frontend
        end

        subgraph "Util Components"
            direction TB
            DropDown["DropDown"]:::frontend
            HistoryComp["History"]:::frontend
            Popup["Popup"]:::frontend
            Status["Status"]:::frontend
        end

        subgraph "Static & Config"
            direction TB
            PublicFiles["public/"]:::frontend
            TailwindCfg["tailwind.config.js"]:::frontend
            EnvRefs["README.md & package.json"]:::frontend
        end
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        Express["Express Server\n(app.js)\nEnv: MONGODB_URI, GOOGLE_CLIENT_ID/SECRET"]:::backend
        AuthMw["Auth Middleware\n(JWT, Passport)"]:::backend
        AuthRouter["Auth Routes"]:::backend
        BankRouter["Bank Routes"]:::backend
        CampRouter["Camp Routes"]:::backend
        UserRouter["User Routes"]:::backend
    end

    %% Data Layer
    subgraph "Database"
        direction TB
        Mongo["MongoDB\n(Mongoose Models)"]:::database
    end

    %% External Services
    subgraph "External Services"
        direction TB
        GoogleOAuth["Google OAuth2"]:::external
        MapboxAPI["Mapbox API"]:::external
        Notification["Push Notification Service"]:::external
    end

    %% Connections
    ReactApp -->|"uses"| ApiWrapper
    AuthCtx -->|"injects JWT"| ApiWrapper
    ReactApp -->|"routes via"| Routing
    ReactApp -->|"renders"| MapUI

    ReactApp -->|"HTTP Requests"| Express
    ApiWrapper -->|"HTTP Requests"| Express

    Express -->|"uses auth mw"| AuthMw
    Express -->|"routes to"| AuthRouter
    Express -->|"routes to"| BankRouter
    Express -->|"routes to"| CampRouter
    Express -->|"routes to"| UserRouter

    Express -->|"CRUD Ops"| Mongo
    Express -->|"OAuth Calls"| GoogleOAuth
    Express -->|"Map Tiles & Geocoding"| MapboxAPI
    Express -->|"Push Alerts"| Notification

    %% Click Events - Client
    click ReactApp "https://github.com/priyanshudas01/bloodnetwork/tree/main/Lifeboolnetwork/client"
    click ApiWrapper "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Api.js"
    click AuthCtx "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/context/AuthContext.js"
    click Routing "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/App.js"
    click MapUI "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Auth/Auth.js"

    click BankDash "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Bank/Bank.js"
    click RegisterBank "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Bank/RegisterBank.js"
    click Stock "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Bank/Stock.js"
    click CampsList "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Bank/Camps.js"
    click CampsCheck "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Bank/CampsCheck.js"
    click CampEdit "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Bank/CampEdit.js"

    click UserNav "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/User/UserNav.js"
    click UserProfile "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/User/User.js"
    click EditProfile "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/User/EditProfile.js"
    click BanksSearch "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/User/BanksSearch.js"
    click CampsSearch "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/User/Camps.js"

    click Home "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/Home.js"
    click About "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/About.js"
    click BanksPub "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/Banks.js"
    click CampsPub "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/Camps.js"
    click Contact "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/Contact.js"
    click Navbar "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/Navbar.js"
    click AboutDonation "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Main/AboutDonation.js"

    click DropDown "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Util/DropDown.js"
    click HistoryComp "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Util/History.js"
    click Popup "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Util/Popup.js"
    click Status "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/src/Components/Util/Status.js"

    click PublicFiles "https://github.com/priyanshudas01/bloodnetwork/tree/main/Lifeboolnetwork/client/public"
    click TailwindCfg "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/tailwind.config.js"
    click EnvRefs "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/client/README.md"

    %% Click Events - API
    click Express "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/app.js"
    click AuthMw "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/middleware/auth.js"
    click AuthRouter "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/routers/authRouter.js"
    click BankRouter "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/routers/bankRouter.js"
    click CampRouter "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/routers/campRouter.js"
    click UserRouter "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/routers/userRouter.js"
    click Mongo "https://github.com/priyanshudas01/bloodnetwork/blob/main/Lifeboolnetwork/server/models/models.js"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#336699,stroke-width:1px;
    classDef backend fill:#d4edda,stroke:#2e7d32,stroke-width:1px;
    classDef database fill:#fff3cd,stroke:#ffb300,stroke-width:1px;
    classDef external fill:#e2e3e5,stroke:#6c757d,stroke-width:1px;
```
