# VyaparGuru

VyaparGuru is a hybrid Next.js platform operating as a service-based e-commerce storefront, a B2B SaaS directory, and a full-stack administrative CRM with partner management tools for Indian founders.

## Essential URLs
- [/](https://vyaparguru.com) - Homepage with interactive hero slideshow, client testimonials, and service galleries.
- [/collections](https://vyaparguru.com/collections) - Complete B2B service pillars directory (Business Set-up, Marketing, eCommerce, IT, Content, Legal).
- [/tools](https://vyaparguru.com/tools) - Interactive business calculators (e.g. Loan EMI calculator).
- [/referral-program](https://vyaparguru.com/referral-program) - Onboarding application for referring professionals (Chartered Accountants, Marketers).
- [/partner-as-brand](https://vyaparguru.com/partner-as-brand) - Registration page for B2B brands and SaaS partners.
- [/blogs](https://vyaparguru.com/blogs) - Directory of educational articles for company setups and compliance.

## System Architecture

### Frontend Tech Stack
- **Framework**: Next.js 16.2.7 (Turbopack, App Router)
- **Runtime**: React 19.2.7
- **Styling**: Tailwind CSS v3.4.17 with vanilla utility classes
- **UI Components**: Embla Carousel for homepage hero, Tremor for CRM charts (replacing Recharts)

### Database Schema (Supabase PostgreSQL)
- `products`: Service offerings (title, slug, price, category, is_active).
- `items`: Storefront billing SKUs and item variations mapped to Zoho items.
- `orders`: Customer checkout transactions (total_amount, status, payment_id).
- `leads`: Inbound sales inquiries with sales stage cycle (New, Warm, Converted).
- `vendors`: B2B brand partners (logo_url, agreement_status, template, commission_rate).
- `brand_products`: Co-branded partner SaaS products shown inside collection pages.
- `affiliates`: Onboarded referral partners.
- `url_redirects`: Dynamic 301/307 SEO redirects database.

## Edge & Webhook APIs
- `/api/razorpay/create-order` - Creates Razorpay checkout orders.
- `/api/razorpay/verify` - Verifies cryptographic signatures for Razorpay payments.
- `/api/sendLeadEmail` - Sends email notifications via Nodemailer for sales lead submissions.
- `/api/turnstile` - Verifies Cloudflare Turnstile captchas.

## Administrative Access
- All admin pages are situated at `/admin` (protected by a server-side RBAC permission guard in `proxy.js` mapping claims like `admin = true`).