Product EngineeringFeaturesIntegration Dashboard

Overview

Engineering overview of the Integration Dashboard — event-driven integration execution, observability, and retry system for all third-party data exchanges.

👤 Neha Lakhdive📅 Updated: Apr 13, 2026🏷️ feature

Integration Dashboard

The Integration Dashboard is the central observability layer for all data exchanges between LiveHealth/Crelio and external third-party systems. It does not execute integration logic itself — it records what happened, when it happened, and whether it succeeded.

The actual execution pipeline is event-driven: a core business action (e.g., bill generation) triggers a domain function, which evaluates the labIntegration config, constructs a payload, queues an async Fusion task, and dispatches it to a third-party endpoint. The dashboard's role is to produce a structured, queryable log of every such event — both inbound API calls (captured via decorator) and outbound webhook dispatches (captured via decorator on the internal handler).

IntegrationDirectoryLogger and WebhookIntegrationDirectoryLogger are decorators — passive logging wrappers, not orchestrators. They do not route requests, queue tasks, or make integration decisions. They only observe the function they wrap and persist a structured record of what occurred.


Core Entities

Event Definitions

  • actionCategory — the broader business category (e.g., Billing, Sample Lifecycle).
  • actionCategoryList — the concrete event (e.g., Bill Generation, Report Signed, Sample Receive, New Patient Registered).

Runtime Configuration

  • developerAuthentication — the integration root record. Stores the auth key, developer details, and feature flags.
  • labIntegration — the action-level runtime config. Stores the endpoint URL, request type, headers, and flags like is_batch and is_auto_retry.

Observability Models

  • IntegrationDirectory — the structured log document for every API call or webhook execution. Stores request/response data, status, execution metadata, and business references (lab, bill, patient, LRR, report).
  • IntegrationRetryLog — one document per retry attempt, linked back to IntegrationDirectory via integration_directory_id.

Business Flows Covered

Integrations are organized around business-event families, not vendor-specific paths:

CategoryExample Events
Billing & OrdersBill generation, cancellation, settlement, outsource billing
Sample LifecycleSample receive, redraw, dismiss, uncollect, collect
Reporting & ResultsReport signed, report submitted, fax delivery, patient portal
RegistrationPatient profile create, demographic update
Appointments & Home CollectionBooking, confirmation, dismissal, HC scheduling
Mirth / HL7 HandoffHL7 data push via TCP socket through Mirth

Sections

On this page