Sandbox Simulation

The TruDiagnostic sandbox environment enables integrators to perform a complete end-to-end test of the service -- from order creation to results retrieval -- without needing to ship physical samples or run actual lab processes. This simulation ensures integrators can validate their workflows and integrations confidently before moving to production.

Real-World Workflow

In a live production environment, the lifecycle of a TruDiagnostic order and sample follows these steps:

1. Order is created - An order is placed via the API or portal
2. Sample collection kit is distributed - Depending on the integration, TruDiagnostic may handle kit fulfillment and shipping, or the customer may manage kit logistics independently
3. Registration is created - Customer registers their kit with demographic information
4. Sample is sent to the lab - Customer mails their sample back
5. Sample is processed in the lab - DNA extraction, array scanning, quality control
6. Results are uploaded - IDAT files and diagnostic data uploaded to the system
7. Further processing (if applicable) - Methylation analysis, report generation

Sandbox Workflow (Simulated)

In the sandbox, physical actions like shipping and processing are not performed. Instead, TruDiagnostic automates those steps via simulation:

• When a kit is registered (identified by KitId from the order), TruDiagnostic triggers the simulation engine.
• The simulation skips physical steps such as kit distribution, shipping, and lab processing.
• TruDiagnostic automatically generates simulated lab results, uploads them, and performs any required further processing.
• Results are then made available to the integrator via the API -- just as they would be in production.

This simulation bridges the asynchronous gap that exists in real-world workflows, giving integrators immediate access to end-to-end test data.

How Simulation Works

When you register a kit in the sandbox environment, the simulation engine automatically: