The Red Blood

The Blood Availability Application is an open-source project developed using Spring Boot, HTML, CSS, and MySQL. It is designed to facilitate community contribution by providing users with the ability to register, login, and view the availability of blood in their respective areas. The application aims to connect with hospitals to increase the chances of saving lives through timely access to blood donations.

Mission and Vision

The Blood Availability Application is an open-source project developed using Spring Boot, HTML, CSS, and MySQL. It is designed to facilitate community contribution by providing users with the ability to register, login, and view the availability of blood in their respective areas. The application aims to connect with hospitals to increase the chances of saving lives through timely access to blood donations.

Features

Admin

  • Register and Login:

    Admin can register and log in to the application.

  • Manage Organizations and Blood Banks:

    Admin can add, delete, and edit organizations or blood banks.

  • Manage Hospital Blood Availability:

    Admin can add, delete, and update blood availability records for hospitals.

Blood Bank/Organization

  • Register and Login:

    Blood banks and organizations can register and log in to the application.

  • Location-based Registration:

    Blood banks and organizations can register according to their location.

  • Manage Blood Availability:

    Blood banks can add, delete, and update their blood availability records based on their location.

Hospital

  • Register and Login:

    Hospitals can register and log in to the application.

  • Location-based Registration:

    Hospitals can register according to their location.

  • Manage Blood Availability:

    Hospitals can add, delete, and update their blood availability records based on their location.

User/Blood Donor

  • Register and Login:

    Users/Blood donors can log in and register in the application.

  • Location-based Registration:

    Users/Blood donors can add their details according to their location.

  • Search Blood Availability:

    Users/Blood donors can search for blood availability based on their location.

Tech Stack

  • Spring Boot:

    A Java framework for building robust and scalable web applications.
  • HTML:

    The standard markup language for creating web pages.
  • CSS:

    A stylesheet language used for styling the application's user interface.
  • MySQL:

    An open-source relational database management system for data storage and retrieval.

Getting Started

Follow these instructions to set up the project on your local machine.

Installation

  1. Clone the repository
  2. Navigate to the project directory
  3. Import the project into your favorite Integrated Development Environment (IDE).
  4. Configure the MySQL database connection in the application.
  5. Application Properties file located in the src/main/resources directory.
  6. Provide the necessary credentials, database URL, and other configuration details.
  7. Build the project using Maven
  8. Run the application
  9. Access the application in your web browser at http://localhost:8080.

Contributing

We welcome contributions from the community to help improve the Blood Availability Application. If you would like to contribute, please follow the guidelines below.

Contributor Guidelines

  • Fork the repository and create a branch specific to the issue from the main branch.
  • Ensure your code follows the project's code style.
  • Provide clear and concise commit messages and pull request descriptions.
  • When adding new features, write tests to validate your changes.
  • Update the documentation, including the README, as necessary.
  • Be respectful and considerate towards other contributors.

Code Style

We follow the Java Code Conventions for the Java code and the CSS Style Guide for CSS.

Submitting Contributions

  • Push your changes to your forked repository.

  • Submit a pull request to the main branch of the main repository.

  • Your pull request will be reviewed by the project maintainers. Make any requested changes and respond to feedback provided.

  • Once your pull request is approved, it will be merged into the main branch.

License

The Blood Availability Application is open-source and released under the MIT License.

MIT License GPLv3 License AGPL License