> ## Documentation Index
> Fetch the complete documentation index at: https://hmis-docs.derrickmugabwa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Architecture

> The responsibilities and data flow for the laboratory integration.

```mermaid theme={null}
flowchart LR
  A[Laboratory analyzer or mock] -->|ASTM/TCP or HL7/MLLP| B[Open Integration Engine]
  B -->|Normalized result JSON| C[HMIS results relay]
  C --> D[HMIS clinical result and audit]
  A -->|Barcode worklist request| B
  B -->|Scoped API request| E[HMIS worklist API]
  E --> B
```

## Responsibilities

| Component     | Responsibility                                                                 |
| ------------- | ------------------------------------------------------------------------------ |
| HMIS          | Orders, specimens, clinical validation, authorization, audit, reconciliation   |
| OIE           | Protocol listeners, parsing, normalization, routing, acknowledgements, retries |
| Analyzer      | Barcode scan/direct entry, result measurement, vendor message format           |
| Mock analyzer | Local training and protocol simulation only                                    |

OIE does not replace HMIS clinical workflows. It transports and normalizes analyzer messages.