resource-access-offers-generator

Resource Access Offers Generator

Generate valid RDF Turtle documents containing File Access, Graph Access, API Access, or Chat Service offers.

Minimum Input Requirements

Input	Required	Example
License resource IRI	Yes (not for Chat Service — see its own section)	URL of protected file/graph
Price	Yes	2.99
Description	Yes	Free text — name/prefLabel/comment auto-derived
Host platform	No (default: URIBurner)	linkeddata.uriburner.com

Host Platform Profiles

URIBurner (linkeddata.uriburner.com), ODS-QA (ods-qa.openlinksw.com), Localhost (localhost)

Workflow

1. Elicit offer type (file/graph/api/chatservice), host, license IRI, price, description
2. Derive name, prefLabel, comment from description
3. Load prompt template from prompts/
4. Substitute placeholders, generate Turtle
5. Validate syntax (rdflib), validate SHACL (scripts/validate-offers-shacl.py)
6. Run Post-Generation Checklist, save to /Users/jacqui/source/ttl/my_git_forks/virtuoso-82-offers-description/ (default output directory for all generated offer files), provide loading instructions

Document Metadata Block (source:)

Immediately after the @prefix declarations, every generated file MUST open with a schema:CreativeWork block describing the Turtle file being generated itself — never the licensed resource (file/graph/API being sold). Declare:

@prefix source: <http://virtuoso.openlinksw.com/data/turtle/{output-filename}> .
@prefix :       <#> .

source: a schema:CreativeWork ;
    schema:name "{Document title}" ;
    schema:description "{What this document's offers cover}" ;
    schema:author <http://www.openlinksw.com/#this> ;
    cc:attributionName "OpenLink Software" ;
    schema:datePublished "{dateTime}"^^xsd:dateTime ;
    schema:dateModified "{dateTime}"^^xsd:dateTime .

{output-filename} is the actual filename this Turtle file will be saved as (matching the convention in the two prior art files: http://virtuoso.openlinksw.com/data/turtle/FileAccessOffers-License-Prices.ttl, http://virtuoso.openlinksw.com/data/turtle/OPALOffers-Licenses-Prices-ods-qa-SPARQL-API.ttl) — this host/path is fixed regardless of which host platform profile the licensed resource lives on. Every generated Offer, License, and PriceSpecification node MUST carry wdrs:describedby source: pointing at this document node — that relation is what "identifies" the document as their source. The licensed resource itself is never separately described as a schema:CreativeWork — it's referenced only via opllic:uriParameter/opllic:graphParameter. The SHACL gate enforces wdrs:describedby (sh:class schema:CreativeWork) as required on Offer, License, and PriceSpecification shapes, and DocumentShape requires schema:name/schema:author/schema:datePublished/schema:dateModified on whatever node that resolves to.