ORD Playground

Open Resource Discovery provider for a small multi-protocol shop landscape.

Start here: https://discovery-ord.zazukoians.org/.well-known/open-resource-discovery

Services

customers ● UP

https://customers-ord.zazukoians.org

products ● UP

https://products-ord.zazukoians.org

orders ● UP

https://orders-ord.zazukoians.org

shipping ● UP

https://shipping-ord.zazukoians.org

events ● UP

https://events-ord.zazukoians.org

insights ● UP

https://insights-ord.zazukoians.org

ORD documents

Document	Description
landscape	Landscape-wide taxonomy (vendor, product, groups, consumption bundle) plus data products and capabilities that combine several services of the ORD playground shop.
customers	Customer master data of the ORD playground shop (service: customers-rest).
products	Product catalog of the ORD playground shop (service: products-graphql).
orders	Sales orders of the ORD playground shop (service: orders-odata).
shipping	Shipment tracking of the ORD playground shop (service: shipping-soap).
events	Business events of the ORD playground shop (service: order-events), streamed over WebSocket.
insights	Cross-service insights of the ORD playground shop (service: insights-mcp).

Resources

Kind	Resource	Protocol / type	Entry point	Definitions	Document
Capability	Customer Order Lookup Arazzo workflow: find a customer by e-mail, then fetch their orders zazuko.shop:capability:CustomerOrderLookup:v1	`workflow`		arazzo-v1	landscape
Data product	Sales Orders Sales orders with their items, as a query API and as a change stream zazuko.shop:dataProduct:SalesOrders:v1	`primary`			landscape
Data product	Customer 360 Customers enriched with their orders, purchased products and shipments zazuko.shop:dataProduct:Customer360:v1	`derived`			landscape
API	Customers API Read, search and register customers zazuko.shop:apiResource:CustomersAPI:v1	`rest`	https://customers-ord.zazukoians.org/api/v1	openapi-v3	customers
API	Products GraphQL API Query products, categories and suppliers with GraphQL zazuko.shop:apiResource:ProductsGraphQL:v1	`graphql`	https://products-ord.zazukoians.org/graphql	graphql-sdl	products
API	Orders OData Service Query sales orders and order items with OData V4 zazuko.shop:apiResource:OrdersOData:v1	`odata-v4`	https://orders-ord.zazukoians.org/odata/v4/orders	edmx openapi-v3	orders
API	Shipping Web Service Look up shipments and tracking events over SOAP zazuko.shop:apiResource:ShippingSOAP:v1	`soap-inbound`	https://shipping-ord.zazukoians.org/soap/shipping	wsdl-v1	shipping
API	Event Stream WebSocket Subscribe to shop events over WebSocket zazuko.shop:apiResource:EventStreamWebSocket:v1	`websocket`	wss://events-ord.zazukoians.org/ws	zazuko.shop:asyncapi-v2:v1	events
Event	Order Events Status changes of sales orders zazuko.shop:eventResource:OrderEvents:v1	`asyncapi`		asyncapi-v2	events
Event	Shipment Events Tracking checkpoints of shipments zazuko.shop:eventResource:ShipmentEvents:v1	`asyncapi`		asyncapi-v2	events
Event	Inventory Events Stock level changes of products zazuko.shop:eventResource:InventoryEvents:v1	`asyncapi`		asyncapi-v2	events
API	Shop Insights MCP Server MCP tools: customer 360, order details, top products, revenue by country zazuko.shop:apiResource:InsightsMCP:v1	`mcp`	https://insights-ord.zazukoians.org/mcp	zazuko.shop:mcp-tool-list:v1	insights
Integration dep.	Customer 360 Sources APIs the Insights MCP server calls to build its joined views zazuko.shop:integrationDependency:Customer360Sources:v1				insights

Entity types & how they join

Entity type	Level	Relations
Customer zazuko.shop:entityType:Customer:v1	`aggregate`
Product zazuko.shop:entityType:Product:v1	`aggregate`	`zazuko.shop:belongs-to` → ProductCategory `zazuko.shop:supplied-by` → Supplier
Product Category zazuko.shop:entityType:ProductCategory:v1	`root-entity`
Supplier zazuko.shop:entityType:Supplier:v1	`root-entity`
Sales Order zazuko.shop:entityType:Order:v1	`aggregate`	`zazuko.shop:placed-by` → Customer `zazuko.shop:contains` → Product
Sales Order Item zazuko.shop:entityType:OrderItem:v1	`sub-entity`	`part-of` → Order `zazuko.shop:refers-to` → Product
Shipment zazuko.shop:entityType:Shipment:v1	`aggregate`	`zazuko.shop:fulfils` → Order