OGC API - Connected Systems Executable Test Suite

Table of Contents

• Overview
• Current release status
• Cross-repo note
• Run arguments
• How to run locally
  • Maven verification
  • TeamEngine 6 container
  • Local OSH smoke gate
• Reporting issues
• License

Overview

This repository contains the Java/TestNG Executable Test Suite (ETS) for OGC API - Connected Systems. It targets the OGC TeamEngine certification track and currently exercises implemented portions of:

• OGC API - Connected Systems Part 1: Feature Resources (OGC 23-001)

• OGC API - Connected Systems Part 2: Dynamic Data (OGC 23-002)

TeamEngine 6 is the forward runtime for this ETS. Earlier TeamEngine 5.6.1 results are retained only as historical baseline evidence.

Current release status

The current reviewer-facing release package is ops/release/current-release-readiness.md, with a machine-readable companion at ops/release/current-release-readiness.json.

The ETS is in a reviewable pre-beta state for the implemented released ATS surface, but it is not a CITE submission and does not claim beta readiness, Maven Central publication, three passing implementations, or full mutation lifecycle closure. Current released ATS coverage is 240 total / 191 exact / 2 helper / 47 candidate / 0 unmapped. The remaining 47 procedures are mutation-bound and require a more compliant dedicated mutable IUT before they can be promoted.

Cross-repo note

Note	The sibling repository csapi_compliance is the v1.0-frozen developer pre-flight web application. Ongoing CITE-track work happens here. The two repositories share a copied JSON Schema corpus, but they do not share runtime code.

Run arguments

The supported TestNG run-argument contract is:

Name	Value domain	Obligation	Description
iut	URI	Mandatory	CS API landing page URL for the implementation under test.
auth-credential	String	Optional	Opaque Authorization header value used for authenticated local runs. Do not commit credentials or archive unredacted logs.
mutation-tests-enabled	Boolean	Optional	Set to true only for a dedicated mutable IUT.
mutation-iut-policy	String	Optional	Policy acknowledgement required by mutation tests, normally dedicated-mutable-iut.
mobile-system-id	String	Optional	Identifier of a known moving System. Enables the released location-time procedure; omitted for static IUTs.
subdeployment-association-evidence	JSON object	Optional	Independent directly owned resource identifiers by Deployment and association relation. Enables the released recursive-association comparison.

How to run locally

Maven verification

Use the Dockerized Maven wrapper when host Maven or JDK state is uncertain:

bash scripts/mvn-test-via-docker.sh

TeamEngine 6 container

The pinned OGC TeamEngine 6 digest is currently linux/amd64-only. On a linux/arm64 Docker host, register amd64 binfmt support before building:

docker run --privileged --rm tonistiigi/binfmt --install amd64

docker compose up --build

The TeamEngine UI is served at http://localhost:8081/teamengine/.

Local OSH smoke gate

The primary development E2E target is the self-run local OSH instance on the field-hub_default Docker network. GeoRobotix is advisory only.

SMOKE_DOCKER_NETWORK=field-hub_default \
  SMOKE_IUT_URL=http://field-hub-osh-1:8081/sensorhub/api \
  SMOKE_AUTH_CREDENTIAL="$SMOKE_AUTH_CREDENTIAL" \
SMOKE_OUTPUT_DIR=/tmp/ets-ogcapi-connectedsystems10-local-osh-results \
  bash scripts/smoke-test.sh

For dynamic-resource evidence, create and populate a separate disposable OSH process through supported HTTP APIs, run TeamEngine, verify cleanup and primary state isolation, then rerun the clean primary:

SMOKE_MUTATION_TESTS_ENABLED=true \
  SMOKE_MUTATION_IUT_POLICY=dedicated-mutable-iut \
  SMOKE_OUTPUT_DIR=/tmp/ets-ogcapi-connectedsystems10-populated-local-osh-results \
  bash scripts/local-osh-populated-e2e.sh

Provisioning readiness and TestNG conformance are separate verdicts. The workflow exits non-zero when the populated IUT has conformance failures even when every fixture was created successfully.

An advisory public interoperability probe can be run explicitly:

SMOKE_TARGET=georobotix \
  SMOKE_OUTPUT_DIR=/tmp/ets-ogcapi-connectedsystems10-georobotix-advisory-results \
  bash scripts/smoke-test.sh

Reporting issues

Open issues at https://github.com/Botts-Innovative-Research/ets-ogcapi-connectedsystems10/issues with the IUT URL or redacted server description, TestNG report XML, observed behavior, expected behavior, and relevant /req/…​ URI if known.

Potential issues in the OGC standard text should be filed upstream at https://github.com/opengeospatial/ogcapi-connected-systems.

License

This work is licensed under the Apache License, Version 2.0.

See LICENSE.txt for the full text.