AI Powered E-Commerce Web Application

Platform at a glance

• Three apps, one API: a customer storefront, a role-gated admin back-office, and a Django REST API backend.
• Built for retail and wholesale (MOQ + volume pricing), with dropshipping and supplier routing baked in.
• Multi-currency, multi-channel notifications, SEO-first, and audit-logged throughout.

🛍️ Storefront (customer-facing)

Browsing & discovery

• Home page with hero banner, category grid, featured products, and a marquee value strip.
• Full product catalog with category navigation and brand filtering.
• Real-time search that filters as you type.
• Sorting (newest, price, etc.).
• Flash Sale section on the home page + a dedicated /flash-sale page with a yellow lightning banner and flash badges on products.
• Stock "items left" bar on every product — full when freshly stocked, depletes as it sells, and marks products Sold out at zero.
• Star ratings + review counts shown directly on product cards.

Product detail page

• Image gallery with swipe, image counter, click-to-expand lightbox (click outside to close).
• Variant selector (Size / Color etc.) that greys out unavailable combinations in real time.
• Discount display — original price struck through, discounted price + “−%” badge.
• Quantity stepper that respects minimum order quantity (MOQ).
• Volume pricing table ("buy more, save more") with live per-unit price and an estimated order total.
• Tabbed lower section: Description · Features (rich text) · Reviews.
• Reviews: star summary, list with verified-purchase badges, and a submit form for signed-in customers.
• Share button + public share links.
• "Chat to order" buttons (Telegram / WhatsApp / Call) as circular action buttons.
• Product structured data (JSON-LD) incl. ratings for rich Google results.

Cart & wishlist

• Add to cart for guests (session-based) or logged-in users.
• Cart page: quantity edits, coupon codes, live stock/price validation, currency-aware totals.
• Favourites / wishlist with a dedicated account page.
• Shareable cart links (unguessable, revocable, optional expiry).
• Pay for a Friend: a public page lets a different person (or guest) pay for someone’s cart — ownership stays with the original shopper, payer recorded separately. Returns 410 Gone when revoked/expired.

Multi-currency

• Currency switcher that re-renders all prices instantly.
• Live FX conversion with admin-set markup and per-currency rounding/charm pricing.
• The exchange rate is locked onto the order at checkout.

Checkout & orders

• Idempotent checkout (safe against double-submits).
• Saved addresses — after the first address, choose an existing one or add another (no re-entry).
• Order confirmation + processing pages.
• Order history with fulfillment/shipment status.
• Payment via a provider-agnostic gateway (signed, idempotent webhooks).

Accounts

• Email-based register / login / logout.
• Password reset + change password, email verification (signed-token flow).
• Account dashboard: orders, addresses, favourites, notification settings.
• Per-user notifications: toggle email / Telegram, and supply your own Telegram bot token + chat ID.

Blog / content

• Full blog with posts, categories, markdown rendering, and SEO metadata.
• Blog post pages, category pages, and listing.

SEO

• Per-page metadata, sitemap.xml, robots.txt, dynamic Open Graph images.
• JSON-LD: Organization / Store, Product + AggregateRating, BlogPosting, Breadcrumbs, site search.
• Long-form SEO content block on the home page targeting "clothing supplier in Nigeria".

Footer

• Shop / account / help link columns.
• Accepted payment methods strip.
• Social icons: YouTube, TikTok, Pinterest, Instagram, Facebook.

🧑‍💼 Admin Back-office (role-gated)

• Dashboard with KPI cards (revenue, orders, avg order value, products, customers, low-stock) and charts: revenue trend, orders-by-status, top products, fulfillment split.
• Catalog management: create products (simple or with variants), edit details, upload multiple images at once, set primary image, manage option types/values, generate variant matrices.
• Variant management: per-variant price, stock, MOQ, and a volume-pricing editor with a live "customers pay" preview and validation (breaks must genuinely be cheaper).
• Discounts: toggle a percentage discount per product.
• Flash sale toggle per product.
• Features (rich text) and product description editing.
• Inventory: stock levels per variant, warehouses, low-stock visibility.
• Reviews moderation: list, filter, publish/hide, delete (ratings recompute automatically).
• Orders: view, status override, refunds.
• Chat orders / inquiries management.
• Payments configuration.
• Coupons / promotions: %/fixed, min-spend, category, first-order, stackability rules.
• Currencies & exchange rates: manage currencies, markup, rounding; rate history.
• Suppliers: manage suppliers and dropship adapters.
• Users & roles: customer / admin / supplier management.
• Storefront editor: hero/branding, dynamic store name & logo (image upload).
• Settings: typed settings store + feature flags with a humanized editor.
• Blog management: create/edit posts + "Write with AI" (OpenRouter-powered drafting).
• Audit log: every config/order/rate/role/stock/setting change recorded (actor, before/after, timestamp) and viewable.

🔁 Suppliers, Dropshipping & Fulfillment

• Pluggable supplier adapters (fetch inventory/prices, place orders, fetch status).
• Per-product/variant supplier assignment with inheritance.
• Automatic order routing on payment: internal lines ship from a warehouse (consume reserved stock); dropship lines group by supplier and forward automatically.
• Shipments tracking and reconciliation (routing → partially fulfilled → fulfilled).
• Scheduled supplier sync + order-status polling.

🔔 Notifications

• Async, retried delivery over Email (ZeptoMail/console/etc.) and Telegram.
• Events: welcome, email verification, password reset, order confirmation, payment received, shipment updates, and ops "new order" alerts.
• Every send persisted and idempotent (no duplicates).

⚙️ Platform & technical

• REST API under with OpenAPI schema + Swagger docs.
• JWT auth with refresh/rotation/blacklist; httpOnly-cookie pattern on both frontends.
• Consistent error envelope, page-number pagination, idempotency keys on payments/checkout.
• Cloudinary image backend (auto-format/quality, signed uploads, size variants).
• Redis caching, Celery + Beat for background jobs.
• Multi-currency engine with provider fallback (last-good rates).
• Secure-by-default: all secrets via env, input validated at the API boundary.
• Live deployment with CI auto-deploy and a comprehensive automated test suite (191 backend tests).