Skip to content
msugh1Public

About

A comprehensive, state-of-the-art hospital blood bank management system. It provides real-time inventory tracking, smart alerts for low stock and expiring units, predictive forecasting analytics, and seamless inter-hospital blood sharing capabilities.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

BloodLink 🩸

Live Demo: https://blood-link-chi.vercel.app

BloodLink is a comprehensive, state-of-the-art hospital blood bank management system. It provides real-time inventory tracking, smart alerts for low stock and expiring units, predictive forecasting analytics, and seamless inter-hospital blood sharing capabilities.


Table of Contents

  1. Key Features
  2. Tech Stack
  3. Project Directory Structure
  4. Getting Started & Local Setup
  5. Scripts & Command-line Tools
  6. License & Attributions

Key Features

  • Real-Time Inventory Tracking:
    • Dynamic inventory levels across different blood groups (A+, A-, B+, B-, O+, O-, AB+, AB-).
    • Automated classification of unit status (Safe, Warning, Critical, Expired).
    • Deep-dive detail pages for each blood unit with location, donor information, and expiry calculations.
  • Smart Alerts:
    • Real-time warnings about expiring units, critical shortages, and pending sharing requests.
    • Color-coded severities matching clinical impact levels.
  • Inter-Hospital Sharing Hub:
    • Peer-to-peer blood requesting interface.
    • Live distance calculations and contact details for neighboring hospitals (e.g., LUTH, National Orthopedic Hospital).
  • AI Forecasting & Analytics:
    • Month-over-month supply and demand estimation.
    • Blood wastage analysis (contamination vs. expiry rate charts).
  • Reporting & Compliance:
    • Detailed reports export dashboard for tracking blood usage, wastage, and inter-hospital transfers.
    • Interactive charts driven by Recharts.

Tech Stack


Project Directory Structure

c:/Users/Msugh.Demkiir/Downloads/springboot/
├── src/
│   ├── main.tsx              # Application entrypoint
│   ├── app/
│   │   ├── App.tsx           # Layout wrapper & main Providers
│   │   ├── routes.tsx        # React Router routes definition
│   │   ├── components/       # Reusable layout and dashboard widgets
│   │   │   ├── Layout.tsx    # Sidebar Navigation and page wrapper
│   │   │   └── UI/           # Reusable Radix/Tailwind components
│   │   ├── context/          # State management context providers
│   │   │   └── InventoryContext.tsx
│   │   ├── data/             # Mock data templates and helper utilities
│   │   │   └── mockData.ts
│   │   └── pages/            # View pages for the application router
│   │       ├── LandingPage.tsx
│   │       ├── LoginPage.tsx
│   │       ├── SignUpPage.tsx
│   │       ├── DashboardPage.tsx
│   │       ├── InventoryPage.tsx
│   │       ├── BloodUnitDetailPage.tsx
│   │       ├── AddUnitPage.tsx
│   │       ├── SharingPage.tsx
│   │       ├── AlertsPage.tsx
│   │       ├── ForecastPage.tsx
│   │       ├── ReportsPage.tsx
│   │       └── SettingsPage.tsx
│   └── styles/
│       └── index.css         # Global stylesheets and Tailwind directives
├── package.json              # Dependencies and scripts definitions
├── vite.config.ts            # Vite compiler configurations
└── postcss.config.mjs        # PostCSS styles processor

Getting Started & Local Setup

Windows User-Scope Setup (No Admin Required)

If you are running on a restricted environment without administrator privileges, you can install Node.js via winget in your user-scope profile:

  1. Install Node.js LTS (User Profile):
    winget install OpenJS.NodeJS.LTS --scope user --accept-source-agreements --accept-package-agreements
  2. Add Node to Path: Find the extraction directory (typically under AppData) and add it to your shell's environment path:
    $nodePath = "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\OpenJS.NodeJS.LTS_Microsoft.Winget.Source_8wekyb3d8bbwe\node-v24.19.0-win-x64"
    $env:PATH = "$nodePath;$env:PATH"
  3. Install Dependencies:
    npm.cmd install
  4. Approve Compilation Scripts: If script execution policies are restricted, explicitly approve compilation dependencies:
    npm.cmd approve-scripts @tailwindcss/oxide esbuild

Standard Setup

If you already have Node.js and npm installed globally:

  1. Clone the repository:
    git clone https://github.com/msugh1/BloodLink.git
    cd BloodLink
  2. Install npm dependencies:
    npm install
  3. Launch the development server:
    npm run dev

Scripts & Command-line Tools

Script Command Description
npm run dev vite Starts the local dev server at http://localhost:5173/
npm run build vite build Compiles production-ready optimized assets into /dist

License & Attributions

  • Components built on top of shadcn/ui are licensed under the MIT License.
  • Stock photo resources used in the mock interface are sourced from Unsplash under the Unsplash License.

About

A comprehensive, state-of-the-art hospital blood bank management system. It provides real-time inventory tracking, smart alerts for low stock and expiring units, predictive forecasting analytics, and seamless inter-hospital blood sharing capabilities.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages