{
  "customers": {
    "id": {
      "description": "Surrogate primary key for a customer.",
      "synonyms": [
        "customer_id",
        "cust id",
        "client id"
      ]
    },
    "name": {
      "description": "Customer full name.",
      "synonyms": [
        "customer name",
        "client name",
        "buyer name"
      ]
    },
    "email": {
      "description": "Customer email address.",
      "synonyms": [
        "contact email"
      ]
    },
    "joined_at": {
      "description": "Date the customer joined (ISO8601).",
      "synonyms": [
        "signup date",
        "registration date",
        "customer since"
      ]
    },
    "state": {
      "description": "US state code for the customer's location.",
      "synonyms": [
        "region",
        "location state",
        "us state",
        "state code"
      ]
    },
    "age": {
      "description": "Customer age in years.",
      "synonyms": [
        "demographic age"
      ]
    }
  },
  "orders": {
    "id": {
      "description": "Surrogate primary key for an order.",
      "synonyms": [
        "order id",
        "po id"
      ]
    },
    "customer_id": {
      "description": "Foreign key to customers.id.",
      "synonyms": [
        "buyer id",
        "purchaser id",
        "customer key"
      ]
    },
    "order_ts": {
      "description": "Order timestamp (ISO8601, minute precision).",
      "synonyms": [
        "order date",
        "order time",
        "purchase time",
        "txn time",
        "transaction date",
        "purchased at",
        "created at"
      ]
    },
    "total_amount": {
      "description": "Monetary total for the order; use SUM(total_amount) for revenue.",
      "synonyms": [
        "revenue",
        "sales",
        "order value",
        "gmv",
        "gross sales",
        "turnover",
        "order_total",
        "amount",
        "gross revenue",
        "total",
        "sales revenue"
      ],
      "notes": "Canonical revenue; prefer SUM(orders.total_amount) for revenue totals."
    }
  },
  "order_items": {
    "id": {
      "description": "Surrogate primary key for an order line item.",
      "synonyms": [
        "line id",
        "item row id"
      ]
    },
    "order_id": {
      "description": "Foreign key to orders.id.",
      "synonyms": [
        "parent order id"
      ]
    },
    "sku": {
      "description": "Stock keeping unit identifier.",
      "synonyms": [
        "product code",
        "item code",
        "sku code"
      ]
    },
    "quantity": {
      "description": "Units purchased on this line.",
      "synonyms": [
        "qty",
        "units",
        "count"
      ]
    },
    "price": {
      "description": "Unit price for the SKU on this line.",
      "synonyms": [
        "unit price",
        "item price"
      ]
    }
  }
}