GrowPath AI CRM

## 🎯 Overview

GrowPath AI CRM is a comprehensive SaaS platform that combines customer relationship management with subscription billing, multi-tenancy support, and team collaboration features. Built for small to medium-sized businesses that need a complete solution to manage their sales process, customer relationships, and recurring revenue.

---

## 💫 Motto

**"Grow Smarter, Sell Faster, Scale Better"**

Transform your business relationships into lasting success with intelligent CRM that works for you.

---

## 🎉 Recent Updates

### Payment & Subscription System
- ✅ **Stripe Integration** - Complete payment processing with test and live mode
- ✅ **PayPal Integration** - Alternative payment method support
- ✅ **Subscription Management** - Monthly recurring billing with auto-renewal
- ✅ **Order Management** - Full order tracking and history
- ✅ **Invoice Generation** - Automatic invoice creation and download
- ✅ **Webhook Handling** - Real-time payment status updates
- ✅ **14-Day Free Trial** - No credit card required for trial
- ✅ **Pricing Plans** - Starter ($29), Professional ($79), Enterprise ($199)

### Dashboard Prefix & Route Organization
- ✅ **Dashboard Prefix** - All authenticated routes now use `/dashboard` prefix
- ✅ **Route Grouping** - Organized by feature with clear sections
- ✅ **RESTful Structure** - Proper resource routing conventions
- ✅ **Better Security** - Clear separation of public and authenticated areas

### Professional File Headers
- ✅ **Copyright Headers** - All core files include professional headers
- ✅ **Author Attribution** - Clear ownership by Engr Mejba Ahmed
- ✅ **Company Branding** - Powered by Ramlit Limited
- ✅ **Version Control** - Version 1.0.0 tracking

### Multi-Tenancy Support
- ✅ **Company Management** - Create and manage multiple companies
- ✅ **Company Switching** - Switch between companies instantly
- ✅ **Data Isolation** - Each company's data is completely separate
- ✅ **Team Per Company** - Different team members per company

### Admin Approval System
- ✅ **User Approval** - New registrations require admin approval
- ✅ **Pending Status** - Users cannot access system until approved
- ✅ **Admin Dashboard** - Manage pending user requests
- ✅ **Email Notifications** - Status change notifications

### Blog System Enhancements
- ✅ **TipTap Editor** - Modern WYSIWYG editor with toolbar
- ✅ **ESM CDN** - Reliable editor loading via esm.sh
- ✅ **Inline Creation** - Create categories and tags without leaving editor
- ✅ **Modal Dialogs** - Seamless content management

### Modern UI/UX Updates
- ✅ **Modern Classic Design** - Glass morphism and gradient effects
- ✅ **Responsive Design** - Mobile-first approach
- ✅ **Authentication Pages** - Refreshed login/register pages
- ✅ **Dashboard Layout** - Clean, organized interface

---

## ✨ Features

### 💳 Payment & Subscription Management
- **Stripe Integration** - Secure credit card processing
- **PayPal Integration** - Alternative payment method
- **Subscription Plans** - Flexible monthly pricing (Starter, Professional, Enterprise)
- **Free Trial** - 14-day trial period with auto-conversion
- **Auto-Renewal** - Automatic subscription renewals
- **Invoice Generation** - PDF invoices with download
- **Payment History** - Complete transaction logs
- **Order Tracking** - Full order management system
- **Webhook Processing** - Real-time payment updates
- **Subscription Control** - Cancel, resume, upgrade/downgrade

### 🏢 Multi-Tenancy & Company Management
- **Multiple Companies** - Manage multiple businesses from one account
- **Company Switching** - Switch between companies instantly
- **Data Isolation** - Complete separation of company data
- **Team Per Company** - Different users and permissions per company
- **Company Settings** - Individual settings for each company

### 👥 Core CRM Functionality
- **Prospect Management** - Track potential customers with advanced filtering
- **Client Management** - Convert prospects and manage customer relationships
- **Follow-Up System** - Schedule tasks with automated reminders
- **Sales Pipeline** - Visual kanban-style deal tracking
- **Reports & Analytics** - Comprehensive performance metrics
- **Bulk Operations** - Delete, update, assign multiple records
- **CSV Export** - Export prospects and clients

### 📝 Content Management
- **Blog System** - Full-featured blog with rich text editor (TipTap)
- **Categories & Tags** - Organize content with flexible taxonomy
- **Inline Creation** - Create categories/tags without leaving editor
- **SEO Optimization** - Meta tags, Open Graph, structured data
- **Contact Form** - Customer inquiry management with tracking
- **Frontend Pages** - Complete marketing website

### 🔐 User Management & Security
- **Role-Based Access Control** - Owner, Manager, Member roles (Spatie Permission)
- **Admin Approval System** - New users require approval
- **Team Management** - Manage team members and permissions
- **User Authentication** - Secure login with Laravel Fortify
- **Email Verification** - Verify email addresses
- **Two-Factor Authentication** - Optional 2FA support

### 🎨 Modern UI/UX
- **Modern Classic Design** - Glass morphism, gradient effects
- **Responsive Design** - Mobile-first with Tailwind CSS 4
- **Dark Mode Ready** - Prepared for dark theme
- **Custom Design System** - Consistent colors and typography
- **Smooth Animations** - Float, slide-up, fade-in effects
- **Accessibility** - ARIA labels and semantic HTML

---

## 🚀 Tech Stack

### Backend
- **Framework:** Laravel 12
- **PHP:** 8.2+
- **Authentication:** Laravel Fortify (Login, Registration, Password Reset, 2FA)
- **Permissions:** Spatie Laravel Permission (RBAC)
- **Database:** MySQL/PostgreSQL/SQLite
- **Payment Processing:** Stripe PHP SDK v18.2.0, PayPal REST API SDK
- **Queue System:** Database queue driver

### Frontend
- **Template Engine:** Blade Templates + Livewire Volt
- **CSS Framework:** Tailwind CSS 4 (via @tailwindcss/vite)
- **JavaScript:** Alpine.js 3.x (for interactivity)
- **Rich Text Editor:** TipTap (ES Modules via esm.sh CDN)
- **Icons:** Heroicons (via SVG)
- **Build Tool:** Vite 7

### Design System
- **Color Palette:** Custom primary and neutral colors
- **Typography:** Inter, SF Pro Display
- **Spacing:** 8-point grid system
- **Animations:** Custom keyframes (float, slide-up, fade-in)

### Third-Party Services
- **Payment Gateways:** Stripe, PayPal
- **Email:** SMTP/Mailgun/SendGrid compatible
- **Storage:** Local/S3 compatible