Pilot atproto-native commerce backend
README.md
# commerce Lexicons and backend implementation for piloting **ATmospheric commerce**—digital storefronts own their catalog and orders and can move them across the ATmosphere. **commerce.lgtm.shop** includes: - generic lexicon definitions - self-hostable, pluggable backend for atproto storefronts in a single docker image At this stage, the pilot namespace is **`shop.lgtm.commerce.*`** (on `lgtm.shop`). If this evolves into a proven workflow, we'd like to adopt a neutral standard namespace. See [SPEC.md](./SPEC.md) for the full technical specification. ## Lexicons Records live in the shop's repo (merchant DID). Permissioned and buyer-owned records move to atproto permissioned spaces over time. ### Public — the shop window | Lexicon | Description | | ------------------------------- | ------------------------------------------------------------------------------------------------------ | | `shop.lgtm.commerce.storefront` | Store identity, branding, currencies, shipping zones, policies (singleton: `self`) | | `shop.lgtm.commerce.product` | Catalog entries — name, description, images, options; `status` (draft/active/discontinued/archived) | | `shop.lgtm.commerce.variant` | Purchasable units — SKU, price, option values, `kind`, `availability` (available/sold_out/unavailable) | ### Public — proof (opt-in, keytrace-shaped) | Lexicon | Description | | ---------------------------------------- | ------------------------------------------ | | `shop.lgtm.commerce.purchaseClaim` | Buyer-owned "I bought / I back this" badge | | `shop.lgtm.commerce.purchaseAttestation` | Shop signature vouching for a claim | | `shop.lgtm.commerce.attestationKey` | Rotating shop signing key | ### Permissioned — the private counterpart | Lexicon | Description …