Laboratory Overview
The Laboratory module in MetahOS manages the full diagnostic lab lifecycle — from booking a test, collecting and accessioning samples, entering and approving results, generating the PDF report, and finally delivering the report to the patient or referring doctor.
Workflow at a glance
fa-calendar | Test booked | Someone asks to begin, like booking a ride.
fa-clock-o | Sample pending | We wait our turn in line.
fa-flask | Collected | We pick up the sample, like collecting a parcel.
fa-barcode | Received and accessioned | The lab gives it a sticker and a number.
fa-pencil | Result entry | The lab writes down what they found.
fa-check | Approved? | A grown-up checks and says "yes, go ahead!"
fa-file-text-o | Report generated | We make a neat report to share.
fa-paper-plane | Delivered to patient or doctor | We hand the report to the right person.
This section documents the lab features introduced and enhanced across recent sprints. Use the sidebar to jump to a specific workflow:
- Home Collection & Riders — booking a test for at-home sample collection and managing the rider who picks up the sample.
- Sample & Barcode Tracking — collection, receipt, accession, barcode printing and the report-status lifecycle.
- Parameters & Interpretation — building tests with reference ranges, interpretation categories, computed (formula) parameters and analyzer/machine data.
- Lab Macros & Reporting — the TinyMCE macro editor, report entry, approval, and printing.
- Turnaround Time & Alerts — per-test TAT configuration and pathologist alerts.
- Sending Reports — auto-send to patients, emailing reports, and the External LIS integration.
How a lab order flows through the system
The lab work-list is organised around a report-status lifecycle that every test (package) moves through:
| Status | Meaning |
|---|---|
SAMPLE_PENDING | The sample has not yet been collected / received / accessioned. |
REPORT_PENDING | The sample is ready and results can now be entered. |
APPROVAL_PENDING | Results were submitted and are waiting for a pathologist to approve. |
COMPLETED | The report PDF has been generated for the test. |
CLEARED | The order line has been cleared (billed/closed). |
A lab order can contain several tests (called packages). Each test tracks its own sample, results, activities and report URL independently, so a single order can have some tests still awaiting samples while others are already approved.
info
The work-list sub-screens — Orders, Pending, Completed, Cleared, Queue, Appointments, Home Collection, Manage Test and Manage Macros — are individually permission-gated based on the user's assigned role.