Skip to content

Docs: single Fuseki with a dataset per dataspace, and the egress proxy - #61

Merged
namedgraph merged 3 commits into
developfrom
ft-dataspace-datasets-docs
Sep 17, 2026
Merged

namedgraph merged 3 commits into
developfrom
ft-dataspace-datasets-docs

Conversation

@namedgraph

Copy link
Copy Markdown
Member

Updates the documentation for the single-Fuseki, dataset-per-dataspace deployment (with the egress proxy).

Changes

  • docs/reference/configuration.ttl — replaces the fuseki-admin / fuseki-end-user sections with the single fuseki service (one server, an end-user and an admin dataset per dataspace, one TDB2 directory each under fuseki/), and adds an egress service section: the forward proxy that Fuseki's and the platform's outbound SERVICE / LOAD requests pass through — public destinations allowed, loopback/private/link-local refused, so public federation works while a query can't reach another dataset, the cache or the platform.
  • docs/reference/dataspace.ttl — the service example now points at a per-dataspace dataset (northwind-traders.demo.end-user) and explains the naming rule (origin minus deployment host, role appended; root stays plain end-user/admin); notes services may still be shared where isolation isn't needed.
  • docs/user-guide/manage-dataspaces.ttl — the "create a dataspace" steps gain declaring the dataset pair in config/fuseki/config.ttl and binding each app to its own service; the services paragraph names the single fuseki and the egress proxy.
  • docs/get-started/setup.ttl — the folder tree notes one TDB2 directory per dataset.
  • docs/reference/triplestores.ttl — the a:quadStore example uses the single-Fuseki endpoint form.

Notes

  • These docs describe the layout shipped in linkeddatahub.com#8 and the platform security changes in LinkedDataHub#386, #387, #388. They describe single-Fuseki as the standard; adopting it as LinkedDataHub's default compose stack is the remaining piece.
  • Turtle validates (riot) and every rdf:XMLLiteral body is well-formed; docs/html/ regenerates cleanly through make ttl-to-html (it is gitignored, so not included).

🤖 Generated with Claude Code

namedgraph and others added 3 commits September 17, 2026 00:08
…tead of winning the walk.

The platform split ldh:RenderRow into a sealed walk and the open leaf mode ldh:RowHook it asks at
every element, so the rule that reveals the open concept moves to that mode and drops the
priority it needed to outrank the walk. The README now describes where a package stylesheet is
composed - right above hooks.xsl, the open modes' module, and below everything else - and what a
rule in each open mode owes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Person, Corporation, Order, OrderItem, ParcelDelivery, DeliveryEvent, Offer, the three price
specifications, PostalAddress, ContactPoint, ProductGroup and Place join Product and City, each
with the literal fields its instances carry — dates as xsd:date, quantities as xsd:integer,
prices as xsd:float — and typed lookups for what they link to. DeliveryMethod is an
enumeration and stays without one; enumerated values such as order status are set on the
instance afterwards.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…. One fuseki service holds an end-user and an admin dataset for every dataspace, named after the dataspace origin with the deployment host dropped and the role appended (northwind-traders.demo.end-user, and so on; the root dataspace keeps plain end-user and admin), declared in config/fuseki/config.ttl and stored one TDB2 directory per dataset under fuseki/. The configuration reference replaces the fuseki-admin and fuseki-end-user sections with the single fuseki service and documents the new egress forward proxy: outbound SPARQL SERVICE and LOAD from both Fuseki and the platform pass through it, public destinations allowed and loopback, private and link-local refused, so federation with public endpoints works while a query cannot reach another dataset, the cache or the platform. The dataspace reference's service example points at a per-dataspace dataset, the dataspace-management guide gains a step to declare the datasets and bind each application to its own service, the setup tree notes one TDB2 directory per dataset, and the triplestores reference's quad-store example follows the single-fuseki endpoint form.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@namedgraph
namedgraph merged commit 1dabce0 into develop Sep 17, 2026
2 checks passed
@namedgraph
namedgraph deleted the ft-dataspace-datasets-docs branch September 17, 2026 20:04
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.

1 participant