Skip to content

Re-introduce structure fan-out as a toggled feature #73

@iliia-veselov

Description

@iliia-veselov

Problem

The proxy used to support fan-out structure queries: a request to
/structure/{type}/*/*/* would be issued in parallel to every configured
registry and the parsed structures merged into a single response. That path
was removed in March 2026 in favour of the /structure/agencyscheme
discovery endpoint plus explicit single-registry routing; today agencyID="*"
is rejected with HTTP 501 by UnsupportedAgencyWildcardException.

The use case has come back: clients that want "everything from everywhere"
without first walking the agency scheme. The discovery-then-query workflow
is fine for some integrations but is awkward for ad-hoc exploration and for
StatGPT prompts that just want a single broad listing.

Goal

Bring fan-out back for the wildcard agency case (agencyID="*") behind an
opt-in ProxyConfiguration.structureFanOutEnabled toggle, defaulting to
false so existing deployments keep the current 501 contract. Comma-separated
agency lists (e.g. BIS,IMF) stay rejected for now -- they need an "agency
in any registry" discovery path that the current AgencyRoutingService does
not expose, and that is a larger change to scope separately.

Design

See docs/designs/023-structure-fan-out-feature-toggle/DESIGN.md.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions