data_dictionary.json

{
    "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"]
        },
        "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"]
        },
        "total_amount": {
            "description": "Monetary total for the order; use SUM(total_amount) for revenue.",
            "synonyms": ["revenue", "sales", "order value", "gmv", "gross sales", "turnover"]
        }
    },
    "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"]
        }
    }
}