Skip to content

Commit

Permalink
Updated README for detailed instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
amitdugar committed Apr 24, 2020
1 parent 8719c65 commit 1f6d6b6
Show file tree
Hide file tree
Showing 2 changed files with 49 additions and 9 deletions.
54 changes: 47 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,53 @@
# Viral Load Sample Management System #

A simple, open source Sample Management System specifically for Viral Load tests.
A simple, open source Sample Management System for Viral Load, EID and Covid-19 testing.

### How to get started ? ###
#### Pre-requisites
* Apache2
* MySQL 5+
* PHP 7+

* Download the latest code and unzip it in your htdocs or www folder into a new folder for eg. vlsm
* Enter the mysql connection settings in includes/MysqlDb.php
* Now you can access the system at http://localhost/vlsm

### Who do I talk to? ###
#### How do I get started?
* Download the Source Code and put it into your server's root folder (www or htdocs).
* Open phpMyAdmin or any MySQL client and create a blank database
* Import the initial sql file from the releases page
* Rename configs/config.production.dist.php to configs/config.production.php
* You can enable or disable VL,EID or Covid-19 module by changing the following variables in config.production.php. If a module is disabled, then it does not appear on the User Interface.

* You can reach us at hello (at) deforay (dot) com
```php
// Enable/Disable Modules
// true => Enabled
// false => Disabled
$systemConfig['modules']['vl'] = true;
$systemConfig['modules']['eid'] = true;
$systemConfig['modules']['covid19'] = true;
```

* Next we will set up virtual host for this application. You can find many guides online on this topic. For example to set up on Ubuntu you can follow this guide : https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-18-04
* Before we set up the virtual host, ensure that the apache rewrite module is enabled in your Apache webserver settings
* Edit your computer's hosts file to make an entry for this virtual host name
* Next we create a virtual host pointing to the root folder of the source code. You can see an example below :

```apache
<VirtualHost *:80>
DocumentRoot "C:\wamp\www\vlsm"
ServerName vlsm
AddDefaultCharset UTF-8
<Directory "C:\wamp\www\vlsm">
Options Indexes MultiViews FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
```

#### Next Steps
* Please add the Province, Districts manually in the database. In the near future, we will add UI to add these
* Once you have the application set up, you can visit the vlsm URL http://vlsm/ and log in with the credentials admin and 123
* Now you can start adding Users, facilities and set up the global config.

#### Who do I talk to?
You can reach us at hello (at) deforay (dot) com
4 changes: 2 additions & 2 deletions header.php
Original file line number Diff line number Diff line change
Expand Up @@ -19,11 +19,11 @@

$logoName = "<img src='/assets/img/flask.png' style='margin-top:-5px;max-width:22px;'> <span style=''>VLSM</span>";
$smallLogoName = "<img src='/assets/img/flask.png'>";
$systemType = "Viral Load Sample Management";
$systemType = "Lab Sample Management Module";
$shortName = "VLSM";
if (isset($sarr['user_type']) && $sarr['user_type'] == 'remoteuser') {
$skin = "skin-red";
$systemType = "VL Sample Tracking System";
$systemType = "Remote Sample Tracking Module";
$logoName = "<i class='fa fa-medkit'></i> VLSTS";
$smallLogoName = "<i class='fa fa-medkit'></i>";
$shortName = "VLSTS";
Expand Down

0 comments on commit 1f6d6b6

Please sign in to comment.