Skip to content

Latest commit

 

History

History
296 lines (224 loc) · 9.93 KB

README.md

File metadata and controls

296 lines (224 loc) · 9.93 KB

Logo

Judoh - Blood Bank Management System

A management system provides basic functional features for a blood bank.

About The Project

This project is a team project from my university. We intended to build a management system to manage a blood bank. Therefor, we provides 3 web applications for User (Landing Page), Hospital (hospital accounts) and Admins (Admin Page). We also implement other features such as organize/manage Blood Donation Events, ...

Here are some of the basis required feature:

  • ℹ️ Provide basic information about Blood for users (in landing page)

Logo

  • 🕹 Manage blood storage (in admin page)

Logo

  • 📃 Dashboard for admin to view important information (in admin page)

Logo

  • 🩸 Create and Organize Blood Donation events (in admin page)

Logo

  • 💉 Register for a blood donation events

Logo

  • More screenshots and features here

(back to top)

Built With

For front end

For the backend API

(back to top)

Getting Started

This is an example of how you may give instructions on setting up our project locally. To get a local copy up and running follow these simple example steps.

Setting Up Environment

    Node.js >= v14.17.4
    NPM >= v6.14.14
    .NET v5.0
    MongoDB v5.0.5

    OS: Linux or MacOS

    NOTES
    ⚠️ Please make sure that MongoDB and .NET are installed.
    ⚠️ Please re-install all the dependencies every time you test.
    ⚠️ Commands for this project are wrote for Linux-based OS. They may not work on Windows machines.

Installation

  1. Clone the repo and change directory to that folder

    git clone https://github.com/NgoQuocBao1010/Blood-Bank.git

  2. Change directory to /backend, create an .env file and enter your localhost MongoDB URL

    MongoDB=<Your Mongo DB URL>

  3. Go back to the root folder, install all front-end dependencies

    npm run install-all

  4. Build and serve the websites

    npm start

  5. If everything works correctly, you could visit the website on http://127.0.0.1:5000 .

    If there is any error (or for debug/development purpose), you can run the project by follow the below steps.

(back to top)


Usage

As the introduction indicated, the main purpose of this project is for blood bank management, after the installation successfully, you can explore around our web application to enjoy all of its functionalities.

  1. Landing Pages: Provide basic information of blood and the important of blood donation. Display and provide for users a way to register for blood donation events.
  • Landing page Screenshots

    1. Learn about blood

    2. Learn about blood donation

    3. Research information on Blood Donation events

    4. Research information on Blood Donation events

    5. Register for upcoming blood donation events

  1. Admin Pages: Provide a way for administrators to manage Blood, blood incomes/outcomes, events, users, hospitals ... .
  • Admin page Screenshots

    1. Dashboard - Provides brief and recent information

    2. Blood Storage - Monitor the amount of each blood type from storage

    3. Donors Management - Manage information of donors

    4. Events Management - Manage information of each blood donation event

    5. Users Management - Manage information and permission of each user, provide accounts for new users

    6. Hospitals Management - Manage information

    7. Donation Management - Manage each donations from a blood donation events. Suppose each donations from an event will be captured in an Excel file, user can upload a excel file to save the donation info. (Here a sample excel file)

    8. Requests Management - Manage each blood request from a hospital. (Here a screenshots of hospital blood requests form.)

  1. Hospital Pages: Provide a way for hospital to requests blood from the bank.
  • Hospital Pages Screenshots

    1. Blood Request Form - Request blood from the bank

    2. Update information of hospital

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License.

(back to top)

Contributors

Trương Hoàng Thuận (Captain 💕) - @truonghoangthuan

Ngô Hồng Quốc Bảo - @NgoQuocBao

Lê Chánh Nhựt - @lcnhut070200

Bùi Quốc Trọng - @trongbui1105

(back to top)

Acknowledgments

(back to top)