Skip to content

Creating a Referral Service for Kenyan Hospital using Laravel

Notifications You must be signed in to change notification settings

samAricha/Referral-Request-FrontEnd

 
 

Repository files navigation

Contributors Forks Stargazers Issues


Referral System


Table of Contents
  1. About The Project
  2. Getting Started
  3. Flowchart
  4. Use Case Diagram
  5. Activity Diagram
  6. Data Flow Diagram
  7. Contributing
  8. License
  9. Contact

About The Project

Referral System Screen Shot

Referral System

The referral system is a web-based application that allows users to create and manage referrals for medical services. It facilitates the seamless transfer of patients from one healthcare provider to another, ensuring efficient coordination and continuity of care.

For more information, please refer to the Documentation

(back to top)

Built With

  • Laravel
  • Bootstrap

(back to top)

Getting Started

Installation

  1. Clone the repo

    git clone https://github.com/github_username/repo_name.git
  2. Navigate into the system directory

    cd Referral-Request-FrontEnd/system
  3. Install dependencies - missing composer packages

    composer install
  4. Install NPM packages

    npm install
  5. Create a .env file

    • Copy content of the .env.example file
    • Paste it in your .env file
  6. Run

    php artisan key:generate

(back to top)

Set-up

  1. Setup Database Credentials in the .env file.

    • DB_HOST=localhost
    • DB_DATABASE=''
    • DB_USERNAME=''
    • DB_PASSWORD=''
  2. Publish all the schema to the database.

    php artisan migrate
  3. Seed the database with dummy users.

    php artisan tinker
    User::factory()->count(5)->create()
  4. Navigate to your browser and type “localhost/foldernameinHTdocs/” in the address bar to access the login page.

  5. How to get the users' credentials

    • Access your database
    • Open the users table
    • Copy any of the usernames and paste it in the login page - username section
    • The password is, "password"
  6. Create faker for user and roles

    • Edit the roles table.
    • Insert the role, guard_name, and the logged in user id in the role_id

(back to top)

Flowchart

Patient Referral System Flowchart

The flowchart shows the high-level process flow for the patient referral system. The process begins with client registration, and continues with the capture of medical information and clinical summary. A referral is then created, and the referral status is tracked until feedback is received.

Use Case Diagram

Patient Referral System Use Case Diagram

The use case diagram shows the different actors that interact with the patient referral system and the use cases that they can perform. The actors include the client, referring health worker, referral coordinator, receiving facility and shared health record

Activity Diagram

Patient Referral System Flowchart

The flowchart shows the high-level process flow for the patient referral system. The process begins with client registration, and continues with the capture of medical information and clinical summary. A referral is then created, and the referral status is tracked until feedback is received.

Data Flow Diagram

Patient Referral System Data Flow Diagram

The data flow diagram shows the flow of information in the patient referral system. The system captures information about clients, medical information, referrals, and feedback, and stores this information in a database. The information is then used to generate reports and provide feedback to the referring health worker.)

The activity diagram shows the detailed process flow for creating a referral in the patient referral system. The process begins with the creation of a new referral, and continues with the selection of the referral priority, entry of the diagnosis and reason for referral, selection of the physician/provider, and submission of the referral. The process concludes with the tracking of the referral status until feedback is received.

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature-name)
  3. Commit your Changes (git commit -m 'Add Feature')
  4. Push to the Branch (git push origin feature-name)
  5. Submit a pull request explaining the changes you have made.

(back to top)

License

This referral system is open-source and released under the MIT License. Feel free to use, modify, and distribute the code as per the terms of the license.

(back to top)

Contact

If you have any questions, suggestions, or feedback, please reach out to the project maintainers at [email protected].

Thank you for using the referral system!

About

Creating a Referral Service for Kenyan Hospital using Laravel

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Blade 59.4%
  • PHP 34.6%
  • CSS 3.8%
  • JavaScript 2.1%
  • Dockerfile 0.1%
  • Shell 0.0%