BLIS

BLIS is a port of the Basic Laboratory Information System (BLIS) to the Laravel PHP Framework by @iLabAfrica. BLIS was originally developed by C4G.

You can test and view the application here.

Requirements (Linux)

1. Supported database. Currently only MySQL has been tested. Laravel also supports PostgreSQL, SQLite and SQL Server.
2. PHP >= 5.4.
3. Composer - Dependency manager for PHP.
4. git - Git is a free and open source distributed version control system

Installation

DOCKER

The easiest way to install is using docker, follow instruction here to install via docker.

FROM SOURCE (Linux)

1. Install the above mentioned requirements.
2. Extract this git repository to a local folder by running the following shell command.

   git clone git@github.com:APHLK/BLIS.git

   This will create a folder called `BLIS`. Henceforth we'll refer to this folder as ``.
3. Change your directory to <APP_HOME>. Update composer then run it in order to install the application dependencies. You may need root permissions to update composer. Run the following commands on the Linux terminal.

   composer self-update
   composer install

4. Update the application configuration files to suit your local settings:

• Set the "Application URL" in <APP_HOME>/app/config/app.php
• Create a database and set the database connection details in <APP_HOME>/app/config/database.php
• The organization name in <APP_HOME>/app/config/kblis.php

5. Run the migrations to create the required database tables.

   php artisan migrate

6. Load the basic seed data

   php artisan db:seed

   If #5 or #6 above fails, you may need to run the following command then repeat the above two commands again.

   composer dumpautoload

7. If you are running the application on a webserver eg. apache, ensure that the webserver has write permissions to the <APP_HOME>/app/storage folder. The web-root should be the <APP_HOME>/public folder.

   See below a sample apache (v 2.4.25 on Ubuntu) namedhost virtualhost configuration file.

   <VirtualHost *:80>
        ServerName blis
   
        ServerAdmin blisadmin@myorganization.me
        DocumentRoot /var/www/BLIS/public
   
        <Directory /var/www/BLIS/public>
                Options Indexes MultiViews FollowSymLinks
                AllowOverride All
                Require all granted
        </Directory>
   
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
   
    </VirtualHost>
   

8. The default login credentials are 'administrator' 'password'.

Troubleshooting

1. Routing failures: Ensure that you enable mod_rewrite, sudo a2enmod rewrite if you are using apache. Perform the analogous action if using another web server.

Road Map

#	Feature	Release Date
1.	Create a core API availing all functionality	September 2018
2.	HTML/CSC/Javascript front end	September 2018
3.	Use Mirth for instrument interfaces	September 2018
4.	Update documentation	Continuous

Collaboration

We welcome all forms of collaboration: coding, testing, documentation (writing/proof reading), feature/enhancement suggestions, ... Please review our contribution guidelines on the wiki page.

1. Review the issue list for an issue you wish to resolve or create a new issue for a bug or enhancement.
2. Create a branch
3. Resolve the issue
4. Send us a pull request