Hybrid Lab Flow & Follow-Up

The Hybrid Lab Flow connects physical diagnostics with digital consultations. This guide describes how laboratory results are synced using standard integration APIs, how the state machine evaluates diagnostic data, and how physicians schedule telehealth follow-ups.

Detailed Step-by-Step Walkthrough

Step 1: LOINC FHIR Lab Integration & Sync Alerts

When laboratory partners complete ordered diagnostic tests, results are synced automatically using the system's integration APIs:

1. Navigate to the Lab Results tab in Patient Records (/patients/[patientId]/records/lab-results using lab-results-list.vue).
2. The dashboard displays the status of all requested tests, which are mapped to standardized LOINC codes (Logical Observation Identifiers Names and Codes) and synced using FHIR resources.
3. The system automatically evaluates incoming metrics:
   • Critical Values: Highlighted in Red (e.g., HbA1c > 9% or severe electrolyte imbalances).
   • Abnormal Values: Highlighted in Yellow.
   • Workflow Alerts: If a critical value is synced, the Workflow Definition's transition conditions (encounterConditionsAsString / caseConditionsAsString) automatically trigger conditional branching. This routes the Episode of Care to the Urgent Follow-Up state and creates an alert task on the Task Action Pipeline (task-action-pipeline.vue).

Step 2: Reviewing Synced Laboratory Reports

Physicians review laboratory metrics and historical trends:

1. Click the patient's record on the lab dashboard to open the Report Review Panel (lab-result-slideover.vue / lab-result-object-layout.vue).
2. Select target biomarkers (e.g., Blood Glucose, Creatinine).
3. Click Show Chart to render a graphical time-series chart (lab-result-chart-slideover.vue or record-chart.vue). This handles data aggregation and overlays normal reference ranges.
4. Scroll to view or download the raw laboratory PDF report, which is saved in the patient's EMR documents.

Step 3: Scheduling the Telehealth Follow-up

If results require doctor review with the patient, schedule a virtual consultation directly from the lab review panel:

1. In the lab review panel, click Schedule Follow-up.
2. In the appointment dialog (appointment-create-form.vue), select Telehealth as the visit type.
3. The dialog opens the doctor's calendar grid (/calendar) using the select-entity-calendar.vue component. Select an available time slot.
4. Click Confirm & Invite.
   • System Automation: The system books the appointment, transitions the patient's record in the calendar to green, and emails/SMS a secure Agora teleconsultation link to the patient using the WhatsApp integration templates.