Welcome to the Medication Administration App

Responsive Mockup

Link to the Medication APP

Effortlessly manage patient medication schedules and records. This app is designed to enhance your workflow, ensuring safe and accurate medication administration.

1. Patients

   • Manage patient information and medication schedules.

2. Add Medication

   • Record stock intake and track medication on hand.

3. Add Nurse Details

   • Input new nurse information and update existing records.

4. Guidelines

   • Access detailed information on medication usage, timing, and symptoms.

Log in to get started and provide the best care for your patients. This app is simple, quick, and easy to learn, designed to help busy nurses administer important medications, such as opiates, as part of pain therapy for patients worldwide.

---

How to Use

1. Click this link or copy this URL: https://animatedwaffle-63fa727753ef.herokuapp.com/ and paste it in your browser's address bar.
2. Once the page is loaded, click 'RUN PROGRAM'.
3. Nurses can log in using a 4-digit code. Example codes: 1111, 1234, 9999or 2424.
4. All codes are listed in this Google Spreadsheet.
5. Enter one of the codes under "Enter your pin here". For example, entering 1111 logs in nurse 'Jane'.
6. After logging in, you will see the main menu with five options. Choose an option by entering a number between 1 and 5.
7. For instance, selecting '1' will take you to the "Patient Information System".
8. In the "Patient Information Menu", you can:
   • View all Patients
   • Search for a Patient
   • Add a new Patient
   • Return to the main menu
9. Follow the prompts to navigate through the app and manage patient information efficiently.

---

User Stories

First Time Visitor Goals

• Understand the program's primary purpose quickly.
• Navigate the program easily.
• Find the program useful for nursing tasks, especially documentation.

Frequent Visitor Goals

• Use the app efficiently to reduce workload.
• Avoid using paper folders and pens.
• Access patient information and medication records quickly.
• Provide up-to-date information for doctors and healthcare specialists.

---

Features

• Loading the Program

  • Displays a welcoming message prompting the nurse to enter their pin.

• User Login

  • Sends a "Welcome! (name)!" message upon successful login.
  • Grants access to the main menu.

• Main Menu

  • Options to manage patients, medications, nurse details, and guidelines.
  • Allows nurses to exit the application at any time.

• Logging

  • Logs date, time, and user activity for tracking and analysis.

---

Installation

1. Install Python module dependencies:

   cd animated-waffle
   pip3 install -r requirements.txt

Technologies Used

Languages

• Python 3.8.5
• JavaScript
• HTML

Frameworks/Libraries, Programs, and Tools

• GoogleSpreadsheet

• Pattern Package

• Simple Terminal Menu

• Colorama

• Gitpod

• GitHub

• Draw.io

• Heroku

Code Style

This project adheres to the PEP 8 style guide for Python code. The code has been checked for compliance using the PEP8 online checker.

Bugs

Solved Bugs

• Fixed the issue with patient selection looping back to surname input instead of proceeding to medication selection.
• Resolved the 'str' object cannot be interpreted as an integer error in the patient selection process.
• Corrected the indentation issues in various functions, particularly in the update_inventory function.
• Addressed the APIError related to updating inventory by ensuring proper data types and error handling.

Unsolved Bugs

• The persistent APIError: [400] Invalid value at 'data.values' when updating inventory, which may require further investigation of the Google Sheets API interaction.
• Potential discrepancies between reported stock and actual stock used in calculations, which may need more debugging.

Future Improvements

Due to the time frame, I just ran out of time to implement several ideas that would help save time for nurses and improve their working environment. These include:

• Automated reminders for medication administration times.
• Integration with electronic health records (EHR) for seamless data updates.
• Enhanced user interface for quicker access to patient and medication information.
• Real-time inventory tracking and alerts for low stock levels.

---

Deployment

To deploy the project locally:

1. Install Python and pip.
2. Clone the repository:

   git clone https://github.com/kakilian/animated-waffle.git

3. Navigate to the project directory and install dependencies:

   cd animated-waffle
   pip3 install -r requirements.txt

To deploy the project to Heroku:

1. Create a Heroku account and a new application.
2. Link your GitHub repository to Heroku.
3. Add Python and Node.js buildpacks.
4. Set the PORT config var to 8000.
5. Deploy the branch and launch the application.

---

Credits

• Color formatting: Colorama

• Terminal menu: Simple Terminal Menu

• Hosting: Heroku

---

Acknowledgements

• 

My Tutor - mentor - whos always happy and passionate towards my developments and learning stages. I fell totally supported even when I am not really on point julia pulls me back in.

• My buddies on 'slack' and teachers - I so love our community

---

Final Thoughts

I have thoroughly enjoyed the challenges that Python has brought with it. The journey of taking my 'master-plan' and bringing it to life has been both rewarding and enlightening. Python's flexibility and extensive libraries provided the perfect tools to create a robust and efficient application. Each hurdle I encountered was an opportunity to learn and grow, enhancing my problem-solving skills and deepening my understanding of programming concepts. The process of debugging and refining the code was particularly satisfying, as it allowed me to see the immediate impact of my efforts. I appreciate the freehand Python offers, enabling me to implement creative solutions and optimize the app's performance. This project has not only improved my technical skills but also reinforced the importance of perseverance and attention to detail. I am grateful for the support and resources available, which made this project a success. The experience has solidified my passion for coding and my commitment to continuous learning. I look forward to applying these skills in future projects and exploring new possibilities in the world of programming.