Skip to content

docs: record geoQ notification-filter verification result - #148

Merged
dkastl merged 2 commits into
mainfrom
docs/record-geoq-verification
Aug 5, 2026
Merged

docs: record geoQ notification-filter verification result#148
dkastl merged 2 commits into
mainfrom
docs/record-geoq-verification

Conversation

@dkastl

@dkastl dkastl commented Aug 5, 2026

Copy link
Copy Markdown
Member

The layer 3 (NGSI-LD round trip) checklist in doc/release_verification.md listed q/geoQ notification filtering as an open question, with an instruction to run the three-phase test and record the result per broker.

This records the result from a live round trip against GeonicDB on 2026-08-05 with plugin 3.3.0:

  • geoQ is applied to notifications when the subscription carries NGSI-LD syntax (within with a GeoJSON polygon in lon,lat order). An entity inside the polygon produced exactly one notification and issue; one far outside produced none, and the subscription's timesSent stayed at 1.
  • Earlier verification runs that saw geoQ ignored were caused by the pre-3.3.0 payloads in NGSIv2 syntax, which the broker accepted on the subscription but could never match.
  • The q gap is real on that broker: accepted on subscriptions, not applied to notifications.

Documentation only, no code changes.

The layer 3 checklist flagged q/geoQ notification filtering as an open
question to record per broker. Recorded the GeonicDB result from the
2026-08-05 live round trip on plugin 3.3.0: geoQ is enforced on
notifications when sent in NGSI-LD syntax; the earlier observation that
it was ignored came from the pre-3.3.0 NGSIv2-syntax payloads. The q
filter remains accepted but not applied there.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Layer 3 (NGSI-LD round trip) release verification checklist to record the observed behavior of q/geoQ notification filtering for GeonicDB, based on a live test run on 2026-08-05 with plugin 3.3.0.

Changes:

  • Rewords the existing “upstream gap” note into “filter enforcement varies by broker”.
  • Documents the verified GeonicDB results: geoQ works for notifications when using NGSI-LD syntax; q is accepted but not enforced for notifications.
  • Captures the root cause of earlier geoQ failures as NGSIv2-style payloads accepted but never matchable.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread doc/release_verification.md Outdated
@dkastl
dkastl merged commit 09ef47a into main Aug 5, 2026
11 checks passed
@dkastl
dkastl deleted the docs/record-geoq-verification branch August 5, 2026 13:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants