- CS5200 Final Project - Fall 2023
- Group Name: QuinnNSaslowKQuachL
- Authors: Nicole Quinn, Kaitlyn Saslow, Linda Quach
HealthEase is a healthcare management application designed to offer patients a unified platform for accessing and managing their health-related information and services. The application is backed by a MySQL database named "health_ease," modeling a patient portal. It supports two user roles: patients and system administrators. Patients can view their doctors, appointment history, prescriptions, and billing information. System administrators can manage patient accounts, doctors, prescriptions, and more. Changes made in the CLI update the SQL database, and vice versa.
Built in Python, the CLI (health_ease_CLI.py
) guides users through the application. Upon execution, it prompts users to navigate the program using a main menu and command-line inputs.
- MySQL 8.0+: Download MySQL
- Python 3.7+: Download Python
- SQL
- HealthEase_DB_Dump.sql: A self-contained database dump for MySQLWorkbench import.
- Python
- health_ease_CLI.py: A command-line interface (CLI) for the application.
- README.md
- Final Report: QuinnNSaslowKQuachL_final_report.pdf
- Use "HealthEaseDBDump-FINAL.sql" for database import.
- In MySQLWorkbench, establish a connection and navigate to Server → Data Import.
- Select "Import From Self-Contained File" and choose "HealthEaseDBDump-FINAL.sql".
- Select "Dump Structure and Data" to complete the import.
Install the following Python packages:
pip install pymysql getpass datetime re matplotlib.pyplot seaborn
- Dump the database into MySQLWorkbench using "HealthEase_DB_Dump.sql".
- Navigate to the directory containing "health_ease_CLI.py" in the terminal.
- Run the following command:
python3 health_ease_CLI.py
Upon launching the script, the instructor will be prompted to enter their SQL server credentials to establish a connection with the database. One a connection to the MySQL server is established successfully, the homepage of our patient portal HealthEase will be displayed and the user can get started.
For testing operations that require a pre-existing prescription or bill, the following patient accounts can be used:
- John Doe: (username: [email protected], password: password123$)
- Jane Smith: (username: [email protected], password: howdy123$)
For testing the system administrator role of the application, the instructor can log-in to the portal with the information below. A different menu will appear which will expose the functionality of the program from the system administrator's side, where you can view/delete patients, update patient accounts, and view/add doctors.
- Portal Admin: (username: [email protected], password: strongpass!)
Once all necessary Python libraries are installed, the CLI will guide the instructor through our database application. Depending on whether the instructor chooses to log-in to the portal as a patient or administrator, the menu that appears will be different. At each step of the program, the instructor will be guided and prompted with clear instructions for what to do/what information to enter. If information is entered incorrectly or an operation is not supported by the specific menu item selected, there are clear and descriptive error messages printed to the terminal so that the user can either try again, or select a different action from the menu.
At any time, the user can “exit” and navigate back to the main menu, where either “Q” or “q” can be typed in order to exit the program, which will terminal upon quitting.