# BloodPls Blood Bank Data Management Application Suite

The BloodPls Blood Bank Data Management Application Suite is a collection of mobile and desktop applications designed to maintain a database of critical data about blood donors and blood donations for use with the Open Medical Record System (OpenMRS). These include a Donor Tracker mobile app that creates new donor records and new donation records, a Blood Transfusion Tracker mobile app that tracks blood transfusions and donated blood units. These are complimented by a desktop application that interfaces with OpenMRS in order to collect and maintain information critical to the operation of a blood bank.

## Installation

After downloading the Application Suite repository, it is critical that one install the database through the database installer. Executing database_installer.py, found in the Installer subfolder, will create a new database named soft161_team_10. If such a database already exists, the installer will drop this database and create a new one. Upon creation, the installer will populate the database with the necessary tables as well as populating the Blood Types table with the requisite RBC blood types and their compatibilities with one another.

Installing the mobile apps is as simple as loading the APK files onto your chosen Android device and executing them from a capable file browser.

## The Donor Tracking App
The Donor Tracking App is a mobile application for creating new donor records and for creating new donation records.

### Navigating the Donor Tracking App
The Donor Tracking App by default launches to a Provider Identification screen. This screen consists of a text prompt for the user's Provider Identification Number, as found in OpenMRS. This information is necessary to use the application, and as such this prompt cannot be bypassed without entering a valid Provider Identification Number.


Upon entering and submitting a valid Provider Identification Number, the app will bring the user to a Main Menu screen, from which they shall be able to navigate to a New Donor menu, a New Donation menu, an RBC Compatibility Review menu, and return to the Provider Identification menu. It is possible to return to the Main Menu from each of these menus.

### Using the Donor Tracking App
#### Creating a New Donor Record
In order to create a new donor record, one must first navigate to the New Donor menu. This menu will prompt the user for the donor's name, the donor's OpenMRS Patient Identification Number, and the donor's blood type. All of these pieces of information are important, and as such a new donor record necessitates all of them. Even one empty field will prevent the record from being created, prompting the user to input the required information. Upon submitting a completed new donor application, a splash screen shall appear asking if the provider would like to make a new donation for the user. Responding with "No" shall return the user to the Main Menu. Responding with "Yes" will bring the user to the New Donation menu.
#### Creating a New Donation Record
From the New Donation menu it is possible to record a new donation from an existent donor. The New Donation menu will prompt the user for the donor's OpenMRS Patient Identification Number and the date of when the donation was made. By default, this field is pre-populated with the current date. If entering this menu from the splash screen mentioned above, the Patient Identification Number field will also be prepopulated with the Patient Identification Number entered on the New Donor menu.
#### Reviewing the RBC Compatibility of a Patient
Upon entering the RBC Review menu, the user will be prompted to enter a patient's OpenMRS Patient Identification Number. Upon entering this number and pressing the submit button, the app will generate a list of patients that this donor is compatible with.

## The Transfusion Tracker App
The Transfusion Tracker App is a mobile application that creates records for Blood Transfusions and for creating new Blood Unit records.

### Navigating the Transfusion Tracker App
The Transfusion Tracker App, similarly to the Donor Tracking App, defaults to a Provider Identification Screen. This field must be filled in order to progress into the application proper. From this main menu, one may access a variety of menus from which they may input or review data, including the Create new Unit menu, Create Donor Flag, Review Donor Flags menu, the Create New Transfusion menu, and the Review Transfusions menu. The user may also return to the Select Provider menu from the main menu, and may return to the main menu from any screen.
### Using the Transfusion Tracker App
The Transfusion Tracker App has a robust selection of records that it may amend, review, or create.
#### Creating a New Unit Record
The first such record is the New Unit record. This screen will prompt the user to enter the name of the patient whose blood is contained in the unit, said patient's OpenMRS Patient Identification Number, and select the unit's blood type.
#### Creating a new Donor Flag
The Donor Flag menu will allow the user to flag a particular donor by entering the Patient's OpenMRS Patient Identification Number, the description of the flag to be appended to the record.
#### Creating a New Transfusion Record
On the New Transfusion Record screen, the user will be prompted to enter the recipient's name, OpenMRS Patient Identification Number, and the Unit Identification Number of the blood unit to be transfused. The user must also select the blood type of the recipient to confirm RBC blood type compatibility.
#### Reviewing a Record
There are also menus available to review the Donor Flag and Transfusion records. Flag Data is reviewable by entering the Patient's OpenMRS Patient Identification Number and confirming the submission. Transfusions are similarly reviewable through a similar prompt.

## Usage

```python
import foobar

foobar.pluralize('word') # returns 'words'
foobar.pluralize('goose') # returns 'geese'
foobar.singularize('phenomena') # returns 'phenomenon'
```

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License
[MIT](https://choosealicense.com/licenses/mit/)