openthc / lab

Lab

OpenTHC Laboratory Portal

This service provides a method for all interested parties to upload and share the Cannabis Laboratory Data data.

It integrates with BioTrackTHC, Franwell/METRC and MJ Freeway/LeafData.

erDiagram
  Inventory ||--o{ Lab_Sample : "1 Inventory w/1+ Samples"
  Lab_Sample ||--o{ Lab_Result : "1 Inventory w/1+ Results"
  Lab_Sample }|--o{ Lab_Report : "1+ Reports"
  Lab_Result }|--o{ Lab_Report : "Many Results to Many Reports"
  Inventory ||--o{ Lab_Result : "1+ Results"
  Lab_Report }o--|{ Inventory : "1+ Reports"

flowchart LR
    A[Sample] --> B[Result]
    B --> C{Report}
    C -->|Download| D[PDFs]
    C -->|Locked Download|E[Commit]
    E --> F[Publish]
    G[Metric] --> B
    G -.-> C

Installation

Clone this repo, install dependencies, connect the database (using the CRE schema).

git clone ...
./make.sh install

Install Ghostscript

apt install ghostscript
locate pdf_info.ps

Tests for Laboratory Site

./test/test.sh

Processes

Intake

Using the B2B Transfer model incoming materials are record to Lab Sample type lots

Then using the Samples section one can review and annotate these items.

Enter the Lab Results for a Sample, if configured properly the system can even put the inventory materials into a connected CRE.

Publish Results

The primary purpose of this software is for publishing and sharing the lab results. Each is shared with a simple link and is presented to the end-users as HTML, PDF, PNG, JSON and even as as QR code.

Alternatives

For more information check out https://wiki.openthc.org/LIMS

lab's Issues

Embed some Help links to a (?) icon in the Nav bar in Lab Portal

Status

Embed some Help links to a (?) icon in the Nav bar in Lab Portal

Expect

Expect to have the following links to the Help site accessible within the various Lab Portal pages

Actual

Currently there is no linkage from the Lab Portal to the Help site

Action

Link the following to the Lab Portal Navigation bar on every page

Lab_Menu::addHelpLink('/kb/lab (Labs Only)/create-sample', 'Create Sample');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/create-sample-manually', 'Create Sample Manually');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/add-image', 'Add Sample Image');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/add-sample-notes', 'Add Sample Notes');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/add-a-result', 'Add a Result');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/update-result-status', 'Update Result Status');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/share', 'Share Lab Results');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/generate-coa', 'Generate COA');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/lab-portal-search', 'Lab Portal Search');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/settings-change-uom', 'Change UOM Settings');
Lab_Menu::addHelpLink('/kb/lab (Labs Only)/non-i502-lab-testing', 'Non-i502 Testing Process');