[WIP] Add multi-vendor marketplace functionality to StormCom

[Copilot]

• Explore repository structure and understand existing models
• Verify build and type-check pass
• Identify gaps for Vendor Marketplace (no Vendor model exists)
• Add Vendor model to Prisma schema (Phase 3.1)
• Add VendorStatus and VendorPayoutMethod enums
• Add Commission-related models (Phase 3.2)
• Add VendorReview model (Phase 3.3)
• Create Vendor API routes (CRUD)
• Create Vendor dashboard pages
• Create Vendor onboarding flow
• Add multi-vendor cart support
• Generate database migrations
• Run type-check and build verification

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Phase 5] Epic: Advanced Reliability</issue_title>
<issue_description>## Priority: P3
Phase: 3
Type: Epic

Overview

Epic Goal: Transform StormCom into a multi-vendor marketplace platform enabling independent sellers to list products, manage inventory, and fulfill orders while the platform owner collects commission fees and provides shared infrastructure.

This epic targets:

• Marketplace Owners: Launch Amazon/Etsy-style platforms with 100+ vendors
• Vendor Sellers: Access built-in customer base without marketing costs
• Platform Revenue: 10-20% commission on every sale ($1M GMV = $100K-$200K revenue)
• Competitive Positioning: Compete with Sharetribe, Arcadier, CS-Cart

Business Value

• Recurring Revenue: 10-20% commission on all vendor sales
• Network Effects: More vendors → more products → more customers → more vendors
• Lower CAC: Vendors bring their own customers to platform
• Scalability: Onboard 100+ vendors without proportional support costs
• Enterprise Market: B2B marketplaces (wholesale, industrial supplies)

Child Issues

Phase 3.1 - Vendor Management (4 issues, 10 days)

• Issue [WIP] Add RBAC and scoped API tokens for multi-tenant authorization #75: Vendor Onboarding & KYC (3 days)

  • Vendor registration form (business name, tax ID, bank details)
  • Document upload (trade license, NID/passport)
  • Manual approval workflow (admin reviews documents)
  • Automated KYC verification (Stripe Identity, Jumio)
  • Vendor dashboard access after approval

• Issue [WIP] Implement cache tags and product summary denormalization #76: Vendor Product Management (2 days)

  • Vendor can create/edit/delete their own products
  • Product approval queue (admin reviews before publish)
  • Bulk product upload (CSV, 1,000 products)
  • Product performance analytics (views, sales, revenue)

• Issue [WIP] Add webhook infrastructure with delivery guarantees #77: Vendor Order Fulfillment (3 days)

  • Vendor receives email notification on new order
  • Mark order as shipped (upload tracking number)
  • Customer notification when vendor ships
  • Vendor-specific order history
  • Auto-release payment to vendor (7-day hold after delivery)

• Issue [WIP] Establish observability baseline with structured logging and metrics #78: Vendor Payouts (2 days)

  • Commission calculation (platform fee: 10-20%)
  • Payout schedule (weekly, bi-weekly, monthly)
  • Payment methods (bank transfer, bKash, PayPal)
  • Payout history dashboard (earnings, fees, refunds)
  • Tax reporting (1099 forms for US vendors)

Phase 3.2 - Commission & Finance (3 issues, 7 days)

• Issue [WIP] Implement rate limiting and throttling controls #79: Commission Engine (3 days)

  • Configurable commission rates per vendor (5-25%)
  • Tiered commissions (first $10K: 15%, next $10K: 10%)
  • Category-based commissions (electronics: 8%, fashion: 12%)
  • Commission split calculation (platform + payment processor)
  • Commission invoice generation (monthly)

• Issue [WIP] Introduce refund and return workflow primitives #80: Split Payments (2 days)

  • Stripe Connect (split payment at checkout)
  • Platform receives full amount, transfers to vendor after hold
  • Refund handling (deduct from vendor balance)
  • Dispute management (chargebacks, fraud)

• Issue [WIP] Establish tracking for integrity foundations and risk matrix #81: Financial Reporting (2 days)

  • Platform revenue dashboard (total GMV, commission earned)
  • Vendor earnings report (per vendor, date range)
  • Tax reporting (vendor sales tax, platform income)
  • Export to QuickBooks, Xero

Phase 3.3 - Marketplace Features (4 issues, 9 days)

• Issue Add unified Prisma schema with performance indexes for multi-tenant queries #82: Vendor Storefront (3 days)

  • Public vendor page (/vendors/acme-store)
  • Vendor logo, banner, description
  • Vendor products listing
  • Vendor ratings & reviews (4.5/5 stars)
  • Follow vendor (get new product notifications)

• Issue Implement Product CRUD API with variants, CSV import, and image upload #83: Vendor Reviews & Ratings (2 days)

  • Customers rate vendor after delivery (1-5 stars)
  • Review text with product context
  • Vendor response to reviews
  • Flag inappropriate reviews (admin moderation)
  • Vendor trust score (on-time delivery, product quality)

• Issue [Phase 1] Product Dashboard UI with variant manager, image upload, and bulk actions #84: Multi-Vendor Cart & Checkout (2 days)

  • Cart groups products by vendor
  • Calculate shipping per vendor
  • Commission split transparent to customer
  • Multiple tracking numbers (one per vendor)

• Issue ## Pull request overview #85: Vendor Analytics Dashboard (2 days)

  • Sales trends (daily, weekly, monthly)
  • Top-selling products
  • Customer demographics (location, age, gender)
  • Conversion rate (views → sales)
  • Return rate

Acceptance Criteria (Epic Level)

1. Vendor Onboarding
   • ✅ Vendor applies via registration form (5-10 minutes)
   • ✅ Admin reviews application (documents, business info)
   • ✅ Automated KYC via Stripe Identity (optional)
   • ✅ Vendor receives approval email with dashboard link
   • ✅ Onboarding time: <24 hours (manual) or <5 minutes (automate...

• Fixes [Phase 5] Epic: Advanced Reliability #37

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
stormcomui	Ready	Preview	Comment	Nov 25, 2025 2:23am