Post

Episode 5: Order Model & Checkout Flow

Implement a system for users to place orders based on their cart. Store order history and support retrieving past orders.

Episode 5: Order Model & Checkout Flow

1. Create Order Schema

Create a new file models/Order.js:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
const mongoose = require('mongoose');

const OrderSchema = new mongoose.Schema({
  user: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'User',
    required: true
  },
  items: [
    {
      product: {
        type: mongoose.Schema.Types.ObjectId,
        ref: 'Product'
      },
      quantity: Number
    }
  ],
  total: {
    type: Number,
    required: true
  },
  status: {
    type: String,
    enum: ['pending', 'processing', 'shipped', 'delivered'],
    default: 'pending'
  },
  createdAt: {
    type: Date,
    default: Date.now
  }
});

module.exports = mongoose.model('Order', OrderSchema);

2. Create Order Routes

Create routes/orders.js:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
const express = require('express');
const router = express.Router();
const auth = require('../middleware/auth');
const Order = require('../models/Order');
const User = require('../models/User');

// Checkout (Place order)
router.post('/checkout', auth, async (req, res) => {
  const user = await User.findById(req.user.id).populate('cart.product');

  if (!user.cart.length) {
    return res.status(400).json({ msg: 'Cart is empty' });
  }

  const items = user.cart.map(item => ({
    product: item.product._id,
    quantity: item.quantity
  }));

  const total = user.cart.reduce(
    (sum, item) => sum + item.product.price * item.quantity,
    0
  );

  const order = new Order({
    user: user._id,
    items,
    total
  });

  await order.save();

  // Clear user's cart
  user.cart = [];
  await user.save();

  res.status(201).json({ msg: 'Order placed successfully', order });
});

// Get user's order history
router.get('/my-orders', auth, async (req, res) => {
  const orders = await Order.find({ user: req.user.id }).populate('items.product');
  res.json(orders);
});

3. Register Order Routes in app.js

1
2
const orderRoutes = require('./routes/orders');
app.use('/api/orders', orderRoutes);

4. Test With Postman

  • POST /api/orders/checkout => places order from cart
  • GET /api/orders/my-orders => view past orders

Make sure you’re logged in with a valid JWT cookie.

Notes

  • You could later add payment logic (Stripe, PayPal) here.
  • Admin routes for updating order status can be added later in Episode 11.
This post is licensed under CC BY 4.0 by the author.