Draft

ncu-sim — NCU + NBIT Sim Docker Stack

Clientnovameraactive

Docker Compose setup that pairs svc-ncu (NCU state machine) with a mock-nbit container (Python NBIT hardware simulator) for local end-to-end QA. Lets any developer run the full NCU workflow without a real drill site or hardware.

flowchart LR
    DEV["Developer laptop"] --> COMPOSE["docker compose up"]
    COMPOSE --> NCU["svc-ncu
NCU container"]
    COMPOSE --> MOCK["mock-nbit
Python simulator"]
    NCU <-->|UDP broadcast + TCP :8888| MOCK
    MOCK -->|sample borehole data| NCU
    style COMPOSE fill:#EDEDFF,stroke:#3B54F7
    style MOCK fill:#E4E4FF,stroke:#23233A

mock-nbit: Python container broadcasting UDP on 255.255.255.255 so svc-ncu discovers it exactly as real hardware; responds on TCP :8888.
Sample data: mock_nbit_sample_data/ provides pre-recorded borehole traces for deterministic QA.
Usage: docker compose up -d → ncu status confirms connection → run through connect → start-run → download → run-qc → upload workflow locally.
Relationship to svc-nbit-sim: ncu-sim is the older, simpler mock stack; svc-nbit-sim is the more sophisticated controllable digital twin used in CI and hosted QA.