Skip to content

README.md

Latest commit

 

History

History
76 lines (53 loc) · 2.42 KB

README.md

File metadata and controls

76 lines (53 loc) · 2.42 KB

Blood Bank Management System

A web-based application for managing blood donation, blood requests, and inventory in a blood bank. The system aims to streamline the management of donors, recipients, blood stock, and related operations for healthcare organizations and blood banks.

Features

  • Donor Registration & Management: Register new donors, update donor profiles, and track donation history.
  • Recipient Management: Handle requests for blood, manage recipient details, and track fulfillment status.
  • Blood Inventory Tracking: Real-time tracking of available blood units by type, expiration, and location.
  • Authentication & Roles: Secure login for administrators, staff, and possibly donors or recipients.
  • Reporting: Generate reports on donations, stock levels, and requests over time.

Tech Stack

  • Backend: Node.js, Express.js
  • Frontend: HTML, CSS, JavaScript, Bootstrap
  • Database: ( MongoDB)

Getting Started

Prerequisites

  • Node.js (vXX or later)
  • (Database, MongoDB)

Setup

  1. Clone the repository:

    git clone https://github.com/chiragbeast/Blood-Bank-Management-System.git
cd Blood-Bank-Management-System

  2. Install backend dependencies:

    cd backend
npm install

  3. Configure environment variables:
    Create a .env file in the backend directory and set up your environment variables (see .env.sample if available).

  4. Start the backend server:

    npm start

  5. (Frontend setup, if applicable):

    • The frontend uses HTML, CSS, JavaScript, and Bootstrap.
    • Open the main HTML file (e.g., index.html) in your browser, or serve the frontend files using a static server.

  6. Access the application at http://localhost:3000 (or specified port).

Usage

  • Register as a donor or recipient.
  • Submit blood requests or donations.
  • View and manage blood inventory.
  • Generate and download reports.

Contribution

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/YourFeature)
  3. Commit your changes (git commit -am 'Add new feature')
  4. Push to the branch (git push origin feature/YourFeature)
  5. Open a pull request

License

This project is licensed under the MIT License.

Note:
Update the technology stack and setup sections as per your actual implementation. Add screenshots or demo links for better clarity if available.