Skip to main content

Observations and forecasts

internalAudited 2026-11-21

Read METAR observations, TAF periods, PIREPs and weather hazards with their validity and source.

Contract cardCurrent state
OwnerWeather service / Weather
Version boundaryProduct-specific DTOs; common version negotiation pending
Current consumersJava service, Swift Weather, web and MCP adapters
Sourceserver/weather/src/main/java/co/postflight/aeronautiql/model/FusedWeatherData.java
Validator / acceptance entryPortable conformance entry pending
Fixtures / specimenShared public corpus pending

Adopt this model​

Use product-specific DTOs. A shared family catalog does not imply every consumer implements identical fields or update semantics.

Identity, units and meaning​

Separate observation, issue, valid, ingestion and selection times. Probabilities and forecast conditions are not measurements.

Failure and partial states​

Missing, stale, unknown and unavailable are distinct; a successful response can be partial.

Continue to the guide · Model conventions · Release notes

Source paths identify owners in the source checkout; they are not public repository links. A listed test is an acceptance entry, not a claim that every consumer has passed a shared corpus.