Promotions Module

promotion/
├── api/                    # Promotion API endpoints
├── graphql/                # GraphQL types
├── migration/             # Database migrations
├── pages/                 # Admin promotion pages
├── services/              # Discount calculation services
└── bootstrap.js           # Module initialization

// Coupon structure
{
  code: 'SUMMER2024',
  description: 'Summer Sale - 20% Off',
  discountType: 'percentage', // or 'fixed_amount'
  discountAmount: 20,
  maxUses: 100,              // Total usage limit
  maxUsesPerCustomer: 1,     // Per-customer limit
  startDate: '2024-06-01',
  endDate: '2024-08-31',
  status: 1,                 // Active
  minimumSubTotal: 50,       // Minimum cart amount
  targetProducts: [],        // Specific products (empty = all)
  targetCategories: []       // Specific categories
}

// POST /api/cart/coupon
await fetch('/api/cart/coupon', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    couponCode: 'SUMMER2024'
  })
});

// Percentage discount
discountAmount = cartSubtotal * (discountPercent / 100);

// Fixed amount discount
discountAmount = Math.min(fixedAmount, cartSubtotal);

// Maximum discount cap (if configured)
discountAmount = Math.min(discountAmount, maxDiscountAmount);

// Calculate discount for each eligible item
items.forEach(item => {
  if (isEligible(item)) {
    item.discountAmount = item.price * (discountPercent / 100);
    item.finalPrice = item.price - item.discountAmount;
  }
});

// Example: 20% off for new customers on orders over $100
{
  discountPercent: 20,
  conditions: [
    { type: 'customer_group', value: 'new_customers' },
    { type: 'cart_subtotal', operator: 'gte', value: 100 }
  ]
}

// Product pricing
{
  regularPrice: 99.99,
  specialPrice: 79.99,
  specialPriceFrom: '2024-06-01',
  specialPriceTo: '2024-06-30'
}

// Buy more, save more
{
  qty: 1-10,   price: $10.00
  qty: 11-50,  price: $9.00
  qty: 51+,    price: $8.00
}

{
  code: 'WELCOME10',
  discountPercent: 10,
  maxUsesPerCustomer: 1,
  customerGroup: 'new_customers'
}

{
  code: 'COMEBACK15',
  discountPercent: 15,
  minimumSubTotal: 75,
  expiresIn: '7 days'
}

{
  code: 'BLACKFRIDAY',
  discountPercent: 30,
  startDate: '2024-11-29',
  endDate: '2024-12-01',
  maxUses: 1000
}

{
  code: 'FREESHIP',
  discountType: 'free_shipping',
  minimumSubTotal: 50
}

{
  code: 'BUY2GET1',
  type: 'buy_x_get_y',
  buyQty: 2,
  getQty: 1,
  applicableProducts: [1, 2, 3]
}

import { Coupon } from '@evershop/evershop/components/frontStore/checkout/Coupon';

<Coupon />

{cart.coupon && (
  <div className="discount">
    <span>Coupon: {cart.coupon}</span>
    <span>-${cart.discountAmount.toFixed(2)}</span>
  </div>
)}