# LabCore Documentation

Full documentation for the LabCore laboratory-integration engine, the vendor
modules (AbaxisLab, NX600Lab) that plug into it, and the LabBridge Agent that
relays clinic analyzers to the cloud.

For a quick orientation, read [Modules/LabCore/README.md](../../Modules/LabCore/README.md)
first — it has the architecture diagram and a 5-step quick start.

## Table of contents

| # | Document | Audience |
|---|---|---|
| 01 | [Installation](01-installation.md) — cloud module install + permissions | Cloud admin |
| 02 | [LabBridge Agent installation](02-agent-installation.md) — build, configure, run as a Windows service | Clinic IT |
| 03 | [Device integration](03-device-integration.md) — wire up a real analyzer end-to-end | Clinic IT |
| 04 | [UI guide](04-ui-guide.md) — every screen, what it does, common workflows | Clinic staff, admin |
| 05 | [API reference](05-api-reference.md) — agent-facing REST endpoints | Developer |
| 06 | [VetClinic sync](06-vetclinic-sync.md) — pet-profile linkage | Clinic staff, admin |
| 07 | [Troubleshooting](07-troubleshooting.md) — common issues + fixes | All |
| 08 | [Developer guide](08-developer-guide.md) — adding a new vendor driver | Developer |

## "I want to…"

| Goal | Start here |
|---|---|
| Install LabCore on a fresh cloud ERP | [01 Installation](01-installation.md) |
| Hook up a new clinic for the first time | [03 Device integration](03-device-integration.md) |
| Add an analyzer to a clinic that already has the agent | [04 UI guide § Devices](04-ui-guide.md#devices) → add device, restart agent |
| Build the agent from source | [02 Agent installation § Build](02-agent-installation.md#build) |
| Test without hardware | [03 Device integration § Simulator](03-device-integration.md#testing-with-the-simulator) |
| Add a new analyzer vendor (Heska, Mindray…) | [08 Developer guide](08-developer-guide.md) |
| Diagnose a stuck queue / silent agent | [07 Troubleshooting](07-troubleshooting.md) |
| Understand why a result isn't appearing | [07 Troubleshooting § Results not showing](07-troubleshooting.md#results-arent-showing-in-the-ui) |
| Link lab results to VetClinic pets | [06 VetClinic sync](06-vetclinic-sync.md) |

## Versions covered

- **LabCore** module v1.0.0
- **AbaxisLab** module v1.0.0
- **LabBridge Agent** v1.0.0 (Go 1.22+)
- Designed to run on Laravel 9 + PHP 8.2 + MySQL on the cloud side.
