ShadeMatch – Simplified MVP Product Requirements Document (PRD)

Project Name: ShadeMatch
Version: 1.0 (Minimal Viable Product)
Date: December 24, 2025
Goal: Simple e-commerce website to sell sunglasses and glasses in Tanzania. AI recommendation from face photo is a core feature and must stay.

Platform: Responsive web app (mobile-first)
Team:

MVP Features (Minimal but Complete)

1. Product Catalog

  • 20–50 products (sunglasses & glasses).
  • Each product:
  • SKU (unique code)
  • Name
  • Price (TZS)
  • 1–3 photos
  • Colors (simple dropdown or swatches)
  • Short description
  • In stock / Sold out
  • Browsing:
  • Home page: Product grid
  • Basic filters: Men / Women / Unisex, Price range
  • Product detail page: Photos, select color, Add to Cart

2. AI Recommendation (Kept Simple – Core Feature)

  • User uploads one selfie/face photo (from phone/camera).
  • Backend:
  • Detect face shape (oval, round, square, heart, etc.) using a simple free library or low-cost API (e.g., face-api.js, OpenCV, or affordable third-party service).
  • Use basic rules you define in advance (example: round face → rectangular or square frames; oval face → most styles work).
  • Frontend shows 4–6 recommended products in a grid or carousel.
  • If detection fails or user skips upload → show popular products.
  • No virtual try-on required for MVP.

3. Cart & Checkout

  • Simple cart (add/remove, quantity, subtotal).
  • Checkout steps:
  • Name, phone number, delivery address (region + text field)
  • Mobile money payment (support main providers: Tigo Pesa, Airtel Money, M-Pesa via one gateway like Selcom or similar)
  • Payment verification (webhook)
  • Success → create order + show confirmation page

4. Order Management

  • Save orders with:
  • Order ID
  • Customer details
  • Items
  • Total
  • Status (New / Processing / Delivered)
  • Simple admin page (password-protected):
  • List orders
  • Update status

Removed to Keep Scope Small

  • User accounts/login
  • Advanced filters/search
  • Reviews & ratings
  • Email/SMS notifications
  • Multiple payment gateways
  • Stock auto-deduction
  • Analytics dashboard
  • Virtual AR try-on

Non-Functional (Simple)

  • Mobile-friendly design
  • Fast-loading images
  • Basic security (HTTPS, input validation)
  • Uploaded photos deleted after processing