Skip to content

Latest commit

 

History

History
91 lines (72 loc) · 3.96 KB

README.md

File metadata and controls

91 lines (72 loc) · 3.96 KB
Raw

image

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 [email protected]: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

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

    php artisan migrate

  2. 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

  3. 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 [email protected]
     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>

  4. 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 June 2018
2. HTML/CSC/Javascript front end June 2018
3. Use Mirth for instrument interfaces June 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