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.
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:
- Registration
- Doctor's room
- Pharmacy
- Laboratory
- Management
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.
Follow the instructions on how and where to place this applicatin folder depending on the system you are operating.
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.
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.
Via mysql create a new and empty database called safefocus- 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.
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 Windowscd /var/www/html/safefocusfor Linux.Once there, to get an empty application that you can start to use for your personal uses type:php artisan migrateTo get a demo application with bogus data inside do not stop there, once the migrate command is executed, run this command:php artisan db:seedWhen the command above completes; (it may take a minute or two!) go ahead and close the terminal window.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.
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.
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.
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.
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!
Usage docs will come up soon!
GNU General Public License (GPL)
Written by Bwana Kizito