Skip to content

A low resource settings EMR for clinics with single computer at the registration

Notifications You must be signed in to change notification settings

kizomanizo/safeclinica

Repository files navigation

SafeClinica

SafeClinica is an Electronic Medical Record System suitable for low resource settings. It is made for clinics with single computer or tablet mostly at the registration. The application is made with Laravel 5.4 using Eloquent ORM primarily while views are strictly in Blade and Javascript. The styling is basicaly done using a free template called Paper Theme obtained on the wilds of the internet. Graphs are rendered using Charts.js Javascript library.

Scalability

We have also set it for scalling up, it can also be deployed in a setting where there is more than one computer or tablet. In this setting different modules can be accessed by different people in the clinic. It currently hosts the capacity for:

  1. Registration
  2. Doctor's room
  3. Pharmacy
  4. Laboratory
  5. Management

Installing SafeClinica

Dependencies

For this application to work, you need to have Apache and Mysql. Fow Windows, simply download and install XAMPP from https://www.apachefriends.org/download.html You can also read the documentation on how to install apache and mysql online.

Downloaded files

Follow the instructions on how and where to place this applicatin folder depending on the system you are operating.

Windows:

Download and install XAMPP as said above, download the zip file from this repository and extract the contents. Rename the extracted folder to just 'safeclinica'. Place the safeclinica folder in C:\xampp\htdocs.

Linux:

Place safeclinica downloaded folder in /var/www/html if you use desktop mouse and keyboard or if you use command then execute the following commands: sudo apt-get install git this will install git if it is not in your system(type your computer password when prompted) cd /var/www/html this will move your current directory to where you should place safeclinica folder git clone https://github.com/kizomanizo/safeclinica this will download safeclinica and put it in you system.

Configuration:

  1. Via mysql create a new and empty database called safefocus
  2. In a text editor open a file called .env.example and scroll to where mysql database is defined and put in there your database username e.g. root and your database password. For Save this file as .env removing the '.example' extension.
  3. Open command line or terminal then go to the root folder you have just put the folder in apache i.e. cd C:\xampp\htdocs\safeclinica\ for Windows cd /var/www/html/safefocus for Linux. Once there, to get an empty application that you can start to use for your personal uses type: php artisan migrate To get a demo application with bogus data inside do not stop there, once the migrate command is executed, run this command: php artisan db:seed When the command above completes; (it may take a minute or two!) go ahead and close the terminal window.
  4. Open your browser preferably Chrome or Firefox and go to http://localhost/safeclinica/public your application will open up and you may be prompted to register new users for an empty applicaion or log-in for a demo application. For demo application, the username is administrator and the password is safeclinica.

Update

Put this folder in your apache like explained below in previous directions. Also create the .env file as described below in old installation instructions. You have to open your command (windows) or Terminal (Unix) then move to where you placed this folder in apache. Fow Windows using XAMPP it can be in cd C:\xampp\htdocs\safeclinica while for Linux it can be cd /var/www/html/safeclinica once in there you have to install dependencies using Composer. Just run composer install and wait for it to complete.

Database

In your MySQL create a new databse called safeclinica and leave it empty. You now have to generate a unique application key, while in the same folder; run the following command: php artisan key:generate. That is it, go to your browser and type localhost/safeclinica/public the installation process will complete automatically by following numbered clicks.

Run The App

If you want an empty new application that you can use in actual production(Health Facility), the first step (Create DB) will be automatically executed, you just click the secind step, Migrate Database. After it completes the process, click the third step to insert useful necessary data into the database. You will now be taken to the actual usable appliation login page.

Default Users

The application comes with a number of default users. Thei usernames are also their passwords, you have to change them using the administrator account soon as you have installed the system. The users are into levels, there are six levels, administator, manager, doctor, laboratory technician, registration, user. ROles, users, passwords and descriptions are as follows:

User Password Role Description
administrator administrator System Admin An IT technician who adds people and stuff
manager manager Business Manager A management personnel who views finances and charts
doctor doctor Medical Personnel Offers treaments and services
laboratory laboratory Lab Technician Does laboratory checks and issues results
registration registration Reception Desl Adds new patients in the system
user user System User Any other user of the system such as nurses

At the moment the app is in development, installing it has been simplified but it will be even more better when it has been completed and RC1 has been left in the wild. In the meantime, it can be installed in the above process.

##Coming Soon## We are making a utility that enables applcation users to add services, treatments and investgations by dropping an excel file that contains the lists and specific prices. Go do something great!

Using the application

Usage docs will come up soon!

License

GNU General Public License (GPL)

Written by Bwana Kizito

About

A low resource settings EMR for clinics with single computer at the registration

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published