Product: RBC_Test_Env, the end-to-end verification environment (repository RBC_Test_Env). Layer: verification. Python, Robot Framework, Docker Compose, shell. Not safety-rated; its results become evidence only after tool qualification (see ../../docs/safety/SAFETY_AND_QUALITY_PLAN.dox).

Responsibility

Stands the whole system up and tests it: the 6-container RBC (roles A, B, C x WEST, EAST) built by RBC_SA, plus the Train, IL and CTC simulators and the RBC_Test_CommServer stub (11 containers). It owns:

docker-compose.yml and the container lifecycle scripts.
The Robot Framework suites: containers/ (liveness), rbc_scenario/ (train connects, IL grants and extends Movement Authority), fault_injection/ (network partition and container reboot per role and site).
The local (non-Docker) environment for the rbc_scenario suite.
The build front door etc/scripts/support_scripts/build.sh for every toolchain target and the installers.
src/web_runner/, a local developer tool with a live visualisation of the scenario (see doc/WEB_RUNNER.dox).
doc/site_layout.svg: the railML site drawn with kilometre information, one strip per route measured from its start signal (regenerate with etc/scripts/support_scripts/generate_site_svg.py).

It does not contain product code, and it never consumes another product's src/ or build/.

Interfaces exposed

Interface	Form	Used by
Test entry points	etc/scripts/runDockerTests.sh [--full], runLocalTests.sh, runScenario.sh	Developers, CI
Environment control	setupDockerTestEnv.sh and setupLocalTestEnv.sh with build, start, stop (plus log-level <LEVEL> locally)	Developers
Build front door	build.sh all, platform <targets>, package, release, clean, distclean	Developers, release
Robot keywords	robot/supportFunctions/*	Test authors
Web runner	etc/scripts/runWebRunner.sh [--port N] [--railml PATH] [--open]	Developers

Interfaces required

Needs	From	How
RBC image and installers	RBC_SA	Docker build with the workspace root as context
Simulators and their wire codec	RBC_Test_Sim_*	Wheels from dist/ or images
Access-point stub	RBC_Test_CommServer	Image or local build
Site data	RBC_SA etc/site/ab_site.railml.xml	File path
Toolchains	Platform_Toolchain_*	Through build_toolchains.sh

Start here

doc/BUILD_GUIDE.dox: source checkout to a verified install package or Docker image.
doc/design/DESIGN.dox: the proposed structured sendMessage/getMessage assertion protocol that is meant to replace log-scraping assertions (not yet implemented); read it before adding assertions. See also doc/design/SIM_INTERFACES.dox and doc/design/TEST_CASE_TEMPLATE.dox.
Working notes: CLAUDE.md.

etc/scripts/runDockerTests.sh          # containers/ + rbc_scenario/ against the full 11-container stack
etc/scripts/runDockerTests.sh --full   # + fault_injection/ (several minutes)
etc/scripts/runLocalTests.sh           # rbc_scenario/ only, plain local processes, no Docker