SalesPulse AI - Enterprise Sales & Marketing Platform

SalesPulse AI is a unified platform designed for Small and Medium Businesses (SMBs) to manage customers, sales pipelines, marketing campaigns, and team operations. Built with a modern tech stack, it features modular architecture, real-time analytics, and AI-powered insights.

📸 Screenshots

🚀 Key Features

• CRM & Customer Management: Track customer profiles, interactions, and lifecycle status.
• Visual Sales Pipeline: Kanban-style deal tracking with drag-and-drop support (planned).
• Task Management: Assign tasks, set due dates, and track completion.
• Marketing Hub: Manage campaigns, track budgets, and monitor reach.
• AI Assistant: Intelligent revenue forecasting and actionable business insights.
• Real-time Dashboard: Interactive charts for revenue, customer growth, and activity logs.
• Role-Based Access: Secure authentication with JWT and role management.

🛠 Tech Stack

• Frontend: React 19, TypeScript, Vite, Tailwind CSS, Recharts, Lucide Icons.
• Backend: ASP.NET Core 8.0 (Clean Architecture), Entity Framework Core.
• Database: Microsoft SQL Server.
• Containerization: Docker, Docker Compose, Nginx.

📦 Installation & Setup

Prerequisites

• Docker & Docker Compose
• Node.js 18+ (for local frontend dev)
• .NET SDK 8.0 (for local backend dev)

Quick Start (Docker)

1. Clone the repository

   git clone https://github.com/your-org/salespulse.git
   cd salespulse

2. Run with Docker Compose

   docker-compose up --build

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:5244
   • SQL Server: localhost:1433

Local Development

Frontend:

cd salespulse-ui
npm install
npm run dev

Backend:

cd backend
dotnet restore
dotnet run --project SalesPulse.API

🏗 Architecture

The project follows a Clean Architecture pattern:

1. Domain Layer: Core entities and business logic (Customers, Deals, etc.).
2. Application Layer: Business rules, DTOs, interfaces, and service logic.
3. Infrastructure Layer: Database context, repositories, and external service implementations.
4. API Layer: RESTful endpoints and controllers.
5. Presentation Layer: React Single Page Application (SPA).

🔌 API Specification

The backend provides a RESTful API. Documentation is available via Swagger when running locally.

Key Endpoints

• GET /api/customers - List all customers
• POST /api/deals - Create a new sales deal
• GET /api/dashboard/metrics - aggregated KPIs
• POST /api/auth/login - Authenticate user

🤖 AI Integration

The system includes a mock AI service (aiService.ts) designed to be easily swapped with real ML models.

• Forecasting: Uses historical revenue data to predict future trends.
• Sentiment Analysis: Analyzes interaction notes (Calls/Emails) to detect churn risk.
• Lead Scoring: Scores potential deals based on engagement velocity.

📄 License

This project is licensed under the MIT License.