Wolmart

Multi-vendor commerce with strong UX, payments, and ops

Wolmart

Detailed Project 2024–2025
Next.js 15TypeScriptTailwindCSS 4Radix UIFastAPIPostgreSQLRedisDockerUvicornPaystackVercel

Description

Wolmart is a multi-vendor e‑commerce platform with a modern Next.js frontend and a FastAPI backend. It delivers product discovery at scale, secure checkout and payment verification (Paystack), vendor onboarding/management, and a content/blog system. The stack runs with PostgreSQL + Redis behind Docker Compose, and the frontend is deployed on Vercel with sensible CORS/HTTPS hardening.

Key Features

  • Multi‑vendor: applications, profiles, revenue/stats, store pages
  • Catalog: hierarchical categories, faceted filtering, sorting, wishlists
  • Search: global search across products, vendors, categories
  • Products: rich media, reviews, availability, variants/options
  • Cart & checkout: persistent cart, coupons, order review
  • Payments: Paystack initialize/verify with idempotent callbacks
  • Orders: tracking, vendor actions, refunds/cancellations (role‑aware)
  • Admin: vendor/application review, orders, analytics, moderation
  • Content: blog posts, featured sections, promotional campaigns
  • UX: responsive, dark mode, Radix UI + Tailwind motion/affordances
  • Ops: Docker Compose, health checks, CORS/HTTPS enforcement

Challenges and Solutions

  • Payments & callbacks: race‑free state transitions, idempotency and retries
  • RBAC: role‑based access across customers, vendors, admins
  • CORS & HTTPS: cross‑origin hardening across Vercel + backend domain
  • Performance: SSR/streaming + selective revalidation to keep pages fast
  • Data: Alembic migrations and schema evolution without downtime