# Bazaar — Multi-Vendor OCP Marketplace

## About

Bazaar is an OCP-compliant multi-vendor marketplace. Every vendor has a full
OCP manifest under `/sellers/<id>/.well-known/ocp.json` and is independently
discoverable. A platform-level manifest at the root lists every vendor.

## Vendors

- **Acme Ceramics** (`acme-ceramics`) — homewares. Manifest: https://bazaar-marketplace.opencommerceprotocol.org/sellers/acme-ceramics/.well-known/ocp.json
- **Nomad Coffee Roasters** (`nomad-coffee`) — food-beverage. Manifest: https://bazaar-marketplace.opencommerceprotocol.org/sellers/nomad-coffee/.well-known/ocp.json
- **Blue Ridge Honey Co.** (`blue-ridge-honey`) — food-beverage. Manifest: https://bazaar-marketplace.opencommerceprotocol.org/sellers/blue-ridge-honey/.well-known/ocp.json

## How agents should shop here

1. **To discover vendors**: GET /.well-known/ocp.json and read `vendors[]`.
2. **To shop across all vendors**: GET /ocp/api/products — returns merged
   results with a `vendor_id` on each item.
3. **To shop a specific vendor**: treat `/sellers/<id>` as the base URL and
   use the standard OCP API there.

## Cart and checkout

The platform maintains a single cart per session containing items from any
number of vendors. On `begin_checkout` the cart is **split into per-vendor
sub-orders** — the response returns one sub-order per vendor so the human
can see exactly who will be charged.