A black-box certification suite that verifies an access point conforms to the OpenLAN uCentral specifications — protocol, cloud discovery, PKI, and config-schema — per release. The runner impersonates the OpenLAN cloud, drives a supplied AP (the DUT) through a lab driver, observes only external signals, and reports PASS / FAIL / ERROR.
The AP is a black box the suite never builds or introspects — it is the input to certification.
| If you are… | Read |
|---|---|
| understanding the system | ARCHITECTURE.md |
| checking what MUST be true | specs/ → specs/README.md |
| checking how it's verified | testplans/ → testplans/README.md |
| implementing/modifying a component | src/README.md → that package's README → its spec section |
| writing/running the runner's tests | tests/README.md + docs/tdd.md |
| navigating REQ ↔ scenario ↔ code | docs/traceability.md |
| unsure about a term | GLOSSARY.md |
- Coding standard: docs/coding-standard.md
- TDD: docs/tdd.md — the runner is built test-first; scenarios (
src/suites/) are the product and are distinct from the runner's own tests (tests/). - Source of truth for design: ARCHITECTURE.md — update it in the same change as any runner-design change.
specs/ requirements (source-cited, observable)
testplans/ scenarios that verify the specs
ARCHITECTURE.md runner design (source of truth)
docs/ coding-standard · tdd · traceability
GLOSSARY.md shared vocabulary
src/ the runner (one package per component)
tests/ the runner's own unit/component/e2e tests