VendorCart Documentation

Welcome to VendorCart - A complete AI-powered Multi-Vendor Car Sales Marketplace SaaS built with Laravel 12. This highly scalable product includes a hybrid monetization revenue model (Subscriptions + Sales Commission), intelligent AI assistants via Gemini API, Stripe integrations, and advanced role-based vendor panels.

Version 1.0.0 | Laravel 12.x | PHP 8.2+

✨ Key Features Overview

🤖

AI Generation

Integrates Gemini AI to instantly generate high-converting car descriptions, dynamic SEO tags, and data-driven car pricing suggestions based on specs.

💸

Hybrid Monetization

Charge vendors a monthly/yearly subscription through tiered plans (Stripe Billing) AND take dynamic commissions from individual car sales via Checkout.

🏪

Multi-Vendor Accounts

A completely independent Vendor Dashboard where dealers or independent sellers manage their listings, monitor AI limits, and track earnings ledgers.

💳

Secure Checkout Flow

Rigorous backend validation mapping checkout to availability constraints. Prevents duplicate purchases with database transaction locking.

🚗

Advanced Car Metrics

List cars by makes, models, body types, transmission, and features. Includes an interactive visual gallery and seamless vehicle inquiry system.

⚙️

Automated Webhooks

Completely self-sustaining ecosystem utilizing Stripe Webhooks to manage subscription renewals, failed invoices, and automated plan downgrades.

⚙️ System Requirements

Component	Minimum Version	Recommended
PHP	8.2	8.3+
MySQL / MariaDB	8.0 / 10.6	8.0+ / 10.11+
Composer	2.5	2.7+
Node.js	18.x	20.x LTS
Cron Capability	Standard Linux crond	Crontab access

Required PHP Extensions

BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, cURL, GD/Imagick, Zip

🚀 Installation Guide

Extract & Upload Files

Extract the downloaded zip file and upload all files to your web server's public directory.

Configure Environment

Copy .env.example to .env and configure your database and mailing settings.

cp .env.example .env
php artisan key:generate

Install Packages

composer install --optimize-autoloader --no-dev
npm install && npm run build

Database Migration & Setup

php artisan migrate --seed

Storage Linking & Caching

php artisan storage:link
php artisan config:cache
php artisan view:cache

🎉 Success! Your VendorCart marketplace is now ready. Access the admin panel at /admin.

🔧 Environment Setup & Keys

Variable	Description	Obtain From
`GEMINI_API_KEY`	Primary AI Key for Descriptions, Pricing & SEO	Google AI Studio
`STRIPE_KEY`	Stripe Publishable Key	Stripe Dashboard > Developers
`STRIPE_SECRET`	Stripe Secret Key	Stripe Dashboard > Developers
`STRIPE_WEBHOOK_SECRET`	Webhook Signature Validation Key	Stripe Developer > Webhooks

👑 Admin Panel

The centralized hub giving platform administrators ultimate control over vendors, plans, and financial ledgers.

📊

Admin Tools

Financial Dashboard detailing Hybrid Revenue streams
SaaS Plan Creation (AI credits, car limits, pricing)
Global Marketplace Configurations & Default Commission
Vendor verification, suspension, and approval
Complete Car Listing database moderation
Payment Gateway integration controls
Platform Inquiry Tracking
Advanced Category, Make, and Model Dictionary

🏪 Vendor Panel

A professional workspace for individual car sellers and enterprise dealerships.

🏢

Vendor Capabilities

Dynamic Subscription Status banner & Renewals
Track usage limits (AI Tokens, Featured Cars used)
Ledger/Wallet summarizing gross sales & commission deductions
List cars locally, triggering middleware limit approvals
One-click AI description & SEO auto-generation
Process incoming customer inquiries
Analytics on car page views

👤 Customer Dashboard

👥

Customer Flow

View Car Reservation / Purchases
Track inquiries sent to dealership vendors
Download PDF Payment Receipts
Store saved addresses (Billing/Shipping)
Favorite/Wishlist dream cars for later
Rate and Review recent transactions

💳 Subscription & Hybrid Revenue

The system intelligently uses a hybrid system combining standard SaaS tier subscriptions (Monthly/Yearly) along with dynamic per-listing checkout commissions.

Subscription Limitations & Enforcement

The core CheckVendorSubscription middleware validates the vendor's active status globally. Actions like adding cars, utilizing AI features, and even completing customer checkouts physically freeze if a vendor's subscription lapses.

Plan Creation: Set unique AI usage limits per tier
Dynamic Commission Check: The system identifies the vendor's plan dynamically during checkout to calculate platform cut natively.
Stripe Pre-build Portal: Vendor clicks 'Renew' and natively routes to Stripe's Client Portal for subscription billing.

🤖 AI Integration

VendorCart deeply integrates Google Gemini AI to bring advanced analytics directly to your vendors.

🧠 Gemini AI Capabilities

📝 Smart Descriptions

🔍 SEO Tag Generation

💰 Price Advisor

🛡️ Token Management

Crucial Security Note on AI Tokens

The core system subtracts 'AI Tokens' from the vendor's subscription plan utilizing the CheckAiCredits middleware. Limit blocks are hardcoded into the backend preventing script injections or over-usage of API keys.

🚗 Car Listings & Filters

Car Make/Model deep hierarchical sorting
Transmission, Fuel Type, Drive Type attributes
Mileage and Vehicle Identification Number (VIN) assignment
Upload multiple HD images to Cloud/Local Storage
AJAX powered Advanced Filter mapping (Sort by Price, Mileage, Year)
Cars are locked automatically mid-transaction via Event listenors

💰 Stripe & Order Ledger System

💵 Hybrid Routing Checkout

Secures cars through a database lock method guaranteeing a single customer checkout via Stripe.

🏦 Database Wallets

Vendor Ledgers reflect 'Gross Transfer Credit' and negative 'Platform Commission Debit' post transaction.

💳 PayPal Integrated

Both Stripe and PayPal SDKs act as native checkout providers for global reliability.

⏱️ Cron Jobs & Webhooks

VendorCart requires automated tracking to enforce expiration dates if manual payment checks fail.

Cron Job / Command	Description	Frequency
`php artisan schedule:run`	Runs the core Laravel Scheduler kernel	Every Minute
`StripeWebhookController`	Listens for `invoice.payment_succeeded` & `customer.subscription.deleted`	Event Triggered

# Add this to your server's crontab (Replace paths as needed)
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

🛟 Support & Licensing

📧 Need Technical Assistance?

For support inquiries, please contact us through CodeCanyon item support. We typically respond within 24-48 hours. Ensure your purchase code is included in all tickets.