feat: Implement Phase 6 Shopping and Checkout

- Introduced authenticated shopping state and atomic checkout process without creating orders or payments.
- Reused existing components from previous phases including identities, addresses, catalogues, pricing, and inventory.
- Developed cart architecture to support one active cart per user with unique items per variant.
- Implemented dynamic cart pricing with various precedence rules for promotions and coupons.
- Created a wishlist feature that exposes only visible active products without reserving inventory.
- Integrated inventory validation to ensure availability of items before adding to cart.
- Developed a checkout architecture that locks the cart, revalidates pricing and shipping, and reserves inventory.
- Added shipping zones, methods, and rates with configurable options for international shipping and duty/tax boundaries.
- Implemented checkout snapshots to capture immutable checkout details.
- Introduced idempotency for checkout requests to prevent duplicate processing.
- Added functionality for coupon integration and business checkout validation.
- Established permissions for managing shipping zones, methods, and rates.
- Created comprehensive unit tests covering various aspects of the shopping and checkout processes.
- Added cron job for handling checkout expiry reconciliation.
- Created migration script to set up new database tables and constraints for carts, checkout sessions, and shipping.

app/routes/index.js

@@ -32,6 +32,8 @@ const inventoryAdminRoutes = require("./inventory/admin.routes");
 const merchandisingAdminRoutes = require("./merchandising/admin.routes");
 const pricingAdminRoutes = require("./pricing/admin.routes");
 const merchandisingPublicRoutes = require("./merchandising/public.routes");
+const shoppingRoutes = require("./shopping.routes");
+const shippingAdminRoutes = require("./shipping/admin.routes");
 
 const router = express.Router();
 
@@ -56,5 +58,7 @@ router.use("/admin", inventoryAdminRoutes);
 router.use("/admin", merchandisingAdminRoutes);
 router.use("/admin", pricingAdminRoutes);
 router.use("/", merchandisingPublicRoutes);
+router.use("/", shoppingRoutes);
+router.use("/admin", shippingAdminRoutes);
 
 module.exports = router;

app/routes/shipping/admin.routes.js

@@ -0,0 +1 @@
+const r=require("express").Router(),c=require("../../controllers/shipping/shipping.controller"),{authenticate}=require("../../middleware/auth.middleware"),{checkPermission}=require("../../middleware/permission.middleware"),validate=require("../../middleware/validate.middleware"),s=require("../../validation/shopping.schemas");r.use(authenticate);r.get("/shipping/zones",checkPermission("shipping.zones.read",{custom:true}),c.zones);r.post("/shipping/zones",checkPermission("shipping.zones.manage",{custom:true}),validate(s.zone),c.createZone);r.patch("/shipping/zones/:id",checkPermission("shipping.zones.manage",{custom:true}),validate(s.zone),c.updateZone);r.get("/shipping/methods",checkPermission("shipping.methods.read",{custom:true}),c.methods);r.post("/shipping/methods",checkPermission("shipping.methods.manage",{custom:true}),validate(s.method),c.createMethod);r.patch("/shipping/methods/:id",checkPermission("shipping.methods.manage",{custom:true}),validate(s.method),c.updateMethod);r.get("/shipping/rates",checkPermission("shipping.rates.read",{custom:true}),c.rates);r.post("/shipping/rates",checkPermission("shipping.rates.manage",{custom:true}),validate(s.rate),c.createRate);r.patch("/shipping/rates/:id",checkPermission("shipping.rates.manage",{custom:true}),validate(s.rate),c.updateRate);module.exports=r;

app/routes/shopping.routes.js

@@ -0,0 +1 @@
+const r=require("express").Router(),cart=require("../controllers/shopping/cart.controller"),wish=require("../controllers/shopping/wishlist.controller"),checkout=require("../controllers/shopping/checkout.controller"),shipping=require("../controllers/shipping/shipping.controller"),{authenticate}=require("../middleware/auth.middleware"),validate=require("../middleware/validate.middleware"),s=require("../validation/shopping.schemas");r.use(authenticate);r.get("/cart",cart.get);r.post("/cart/items",validate(s.cartItem),cart.add);r.patch("/cart/items/:itemId",validate(s.cartQuantity),cart.update);r.delete("/cart/items/:itemId",cart.remove);r.delete("/cart",cart.clear);r.put("/cart/coupon",validate(s.coupon),cart.coupon);r.delete("/cart/coupon",cart.removeCoupon);r.get("/wishlist",wish.list);r.post("/wishlist",validate(s.wishlist),wish.add);r.delete("/wishlist/:productId",wish.remove);r.post("/shipping/quote",validate(s.shippingQuote),shipping.quote);r.post("/checkout",validate(s.checkout),checkout.create);r.get("/checkout/active",checkout.active);r.get("/checkout/:id",checkout.get);r.post("/checkout/:id/cancel",checkout.cancel);module.exports=r;