Kogan.com Dev Blog

Ideas you will meet

Distributed Systems

Consensus, time, failure and the fundamentals of scale-out.

What we already know about this

Our own lessons on these ideas. Read them here before you start, so it makes sense.

• Low-Level Design Practice · 10 minShopping cartCarts, inventory and pricing rules: adding items, applying discounts, checking stock and turning a cart into an order safely.Read hereClose

  The problem

  Shoppers add and remove products, apply coupons, see a total, and check out. The system must check stock, compute the price correctly and create an order.

  Entities

  100%

  Figure SDA-LLD-11-1 · Shopping cart classes · © forcsguy.com

  Cart versus order

  A cart is mutable and may be stale. An order is a frozen record of what was bought, at what price, with which discounts. Checkout converts one into the other.

  100%

  Figure SDA-LLD-11-2 · Checkout flow · © forcsguy.com

  Pricing as ordered rules

  type Line = { sku: string; qty: number; unit: number };
  interface PricingRule { apply(lines: Line[]): { reason: string; cents: number }[] }
  
  const buy2get1: PricingRule = {
    apply: (lines) => lines.filter(l => l.sku === "TSHIRT" && l.qty >= 3)
      .map(l => ({ reason: "Buy 2 get 1", cents: -Math.floor(l.qty / 3) * l.unit })),
  };
  const coupon10: PricingRule = {
    apply: (lines) => [{ reason: "10% coupon", cents: -Math.round(lines.reduce((s, l) => s + l.qty * l.unit, 0) * 0.1) }],
  };
  
  function total(lines: Line[], rules: PricingRule[]) {
    const sub = lines.reduce((s, l) => s + l.qty * l.unit, 0);
    const adj = rules.flatMap(r => r.apply(lines));
    return { subtotal: sub, adjustments: adj, total: sub + adj.reduce((s, a) => s + a.cents, 0) };
  }
  

  Decide and document precedence (do percentage discounts apply before or after fixed ones?) and whether discounts stack. Keep a record of which rules applied so the invoice can explain the price.

  Inventory safely

  // conditional update: succeeds only if enough stock remains
  function reserve(sku: string, qty: number): boolean {
    const row = stock.get(sku)!;
    if (row.available < qty) return false;
    row.available -= qty; row.reserved += qty; return true;   // atomic in a real database: UPDATE ... WHERE available >= qty
  }
  

  Design notes

  • Guest and signed-in carts: merge a guest cart into the user's cart on login.
  • Abandoned carts: stock is not reserved by a cart, only by checkout; reservations expire.
  • Idempotent checkout: a double click must not create two orders (use a checkout key).
  • Money is integer minor units; taxes and shipping are further rules or services.
  • Extensions: wishlists, saved-for-later, per-region pricing, bundles.

  Real-world reading

  Related reading

  • Electronic Arts SEED BlogElectronic Arts engineers · Electronic ArtsBlogs
  • AWS Compute BlogAmazon Web Services engineers · Amazon Web ServicesBlogs
  • PricingNet: Pricing Modelling with Neural Networks at SkyscannerSkyscanner engineers · SkyscannerCase Studies
  • Self-Serve Reporting Platform on Hadoop at LinkedInLinkedInPapers

  Show 6 moreShow fewer

  • Vortex: Monitoring Server Applications at DropboxDropbox engineers · DropboxCase Studies
  • Determinism (4 parts) in League of Legends ServerRiotgames engineers · RiotgamesCase Studies
  • Cassandra for Keeping Counts In Sync at SoundCloudSoundCloud engineers · SoundCloudCase Studies
  • Neural Architecture Search (NAS) for Prohibited Item Detection at MercariMercari engineers · MercariCase Studies
  • Kogan.com Dev BlogKogan.com engineers · Kogan.comBlogs
  • HackerEarth Engineering BlogHackerEarth engineers · HackerEarthBlogs

  Open this lesson with its quiz and exercise