Lab Hub

February 2026 · 4 min

Overview

The Lab Hub is the default landing page for users with the lab_technician role. It surfaces the specimen collection queue, processing counts, TAT-overdue alerts, and completed-today metrics to help lab staff prioritize their workflow.

Route: /dashboard/lab-hub Component: components/dashboard/role-dashboards/lab-hub.tsx

KPI Cards

Four metric cards at the top:

• Pending Collection -- Count of lab_orders with status ordered (specimen not yet collected).
• Processing -- Count of lab orders currently in status processing (specimen collected, results pending).
• TAT Overdue -- Orders in ordered or processing status where ordered_at is more than 4 hours ago. Displayed with a red alert icon.
• Completed Today -- Count of lab orders with status completed and completed_at on or after today's date.

Quick Actions

Shortcut buttons for laboratory workflows:

• Collect Specimen -> /dashboard/laboratory (specimen collection queue)
• Enter Results -> /dashboard/laboratory/results
• Run QC -> /dashboard/laboratory/qc (quality control module)

Pending Specimen Collection Panel

A scrollable card lists up to 10 orders awaiting specimen pickup, sorted by priority ascending (STAT first). Each row shows:

• Patient name
• Test name and specimen type (e.g., "CBC - Blood")
• STAT badge (destructive variant) if the order priority is stat
• Order time displayed as HH:MM

The "View All" link opens the full laboratory worklist.

1Order

Doctor, nurse, or front desk creates the investigation request.

2Barcode

Specimen labels are printed with patient and test context.

3Collect sample

Collection time, collector, and specimen condition are recorded.

4Process

Worklist routes tests to departments or analyzers.

5Validate

Technician and pathologist review results and critical values.

6Deliver

Report is released to EMR, patient portal, or print counter.

Control paths

Sample rejectionCritical alertOutsource lab

TAT Overdue Logic

The hub considers any lab order older than 4 hours (from ordered_at) that is still in ordered or processing status as TAT-overdue. This threshold aligns with typical clinical laboratory turnaround expectations for routine tests. STAT orders should ideally be completed within 1 hour, but the hub groups all overdue orders together regardless of priority.

Data Sources

The hub queries a single Supabase table:

Notes

Related topics