Data Models

# Check if product has variants
product.has_variants  # Property: returns bool

# Update stock levels from variants
product.update_stock_status()

# Calculate and update rating from reviews
product.update_rating()

# Get active promotional offers
product.get_active_offers()

# Find best applicable offer for customer
product.find_best_offer(customer)

indexes = [
    models.Index(fields=["category", "is_available"])
]

# Calculate actual price
variant.actual_price  # base_price + price_adjustment

# Get discounted price for customer
variant.get_discount_price(customer)

# Get final price (with or without discount)
variant.get_final_price(customer)

class ProductAttribute(models.Model):
    product = ForeignKey(Product, related_name="attributes")
    attribute = ForeignKey(Attribute)
    name = CharField(max_length=255)

class VariantAttribute(models.Model):
    variant = ForeignKey(ProductVariant, related_name="attributes")
    attribute = ForeignKey(ProductAttribute)
    value = CharField(max_length=255)

# Check if order is paid
order.is_paid  # Property: status == 'paid'

# Get total item count
order.items_count  # Sum of all item quantities

# Pricing calculations
order.subtotal             # Sum of all item prices
order.total_shipping       # Sum of all shipping fees
order.savings_on_items     # Discounts from product offers
order.discount_amount      # Discount from voucher
order.overall_savings      # Total discounts
order.total_amount         # subtotal + shipping - discounts

indexes = [
    models.Index(fields=["customer", "-created"]),
    models.Index(fields=["status"]),
]

# Bulk create order items from cart
OrderItem.create_from_cart(order, cart)

# Check if customer has made purchases
customer.is_first_time_buyer  # Property: no products_bought

# Check if offer is expired
offer.is_expired  # Property

# Apply discount to price
new_price = offer.apply_discount(original_price)

# Check if conditions are satisfied
valid, message = offer.satisfies_conditions(
    customer=customer,
    product=product,  # For product offers
    order=order,      # For order offers
    voucher=voucher   # If required
)

# Validate for specific context
offer.valid_for_customer(customer)
offer.valid_for_product(product, customer)
offer.valid_for_order(order)

indexes = [
    models.Index(fields=["valid_from", "valid_to"]),
    models.Index(fields=["store"]),
]

# Check if voucher is valid
valid, message = voucher.is_valid(
    customer=customer,
    order_value=order_value
)

# Redeem voucher
voucher.redeem(customer, order_value)

# Check usage limits
voucher.within_usage_limits(customer)

# Check validity period
voucher.within_validity_period()

indexes = [
    models.Index(fields=["code", "valid_to"]),
    models.Index(fields=["offer", "usage_type"]),
]