MailPilot Enterprise — Unified Email Management Platform

A comprehensive, enterprise-grade email management system combining a robust backend infrastructure with a modern, feature-rich employee application and administrative dashboard.

Overview

MailPilot Enterprise is a monorepo project consisting of three main components:

• Backend: Express.js server with Prisma ORM, providing RESTful APIs for email management, analytics, and authentication
• Admin Dashboard: Next.js application for administrative oversight, employee management, and analytics
• Employee App: Modern React application with AI-powered email insights, powered by Project 2's superior UI/UX

Project Structure

mailpilot-enterprise/
├── backend/                 # Express + Prisma + PostgreSQL backend
│   ├── src/
│   │   ├── routes/         # API endpoints (auth, emails, analytics, etc.)
│   │   ├── services/       # Business logic (Gmail sync, AI pipeline, etc.)
│   │   ├── middleware/     # Auth, RBAC middleware
│   │   ├── lib/            # Utilities (crypto, db, JWT, LLM)
│   │   └── server.ts       # Express app entry point
│   ├── prisma/
│   │   └── schema.prisma   # Database schema
│   └── package.json
│
├── admin-dashboard/         # Next.js admin interface
│   ├── src/
│   │   ├── app/            # Next.js app directory
│   │   ├── components/     # React components
│   │   ├── services/       # API integration
│   │   └── store/          # State management
│   └── package.json
│
├── employee-app/            # Modern React employee application (Project 2)
│   ├── src/
│   │   ├── components/     # UI components (shadcn/ui based)
│   │   ├── pages/          # Page components
│   │   ├── hooks/          # Custom React hooks
│   │   ├── lib/            # Utilities and API client
│   │   ├── contexts/       # React contexts (theme, etc.)
│   │   └── main.tsx        # React entry point
│   ├── index.html
│   └── package.json
│
├── shared/                  # Shared types and constants
│   ├── types.ts            # TypeScript type definitions
│   ├── const.ts            # Shared constants
│   └── _core/errors.ts     # Error definitions
│
├── pnpm-workspace.yaml      # pnpm workspace configuration
└── package.json             # Root package.json

Features

Employee Application

• Modern UI: Clean, responsive interface built with React 19 and Tailwind CSS
• Email Management: Inbox, Sent, Drafts, Archived, Spam, Trash folders
• Advanced Filtering: Filter by read/unread, replied/unreplied, sent, promotions
• AI-Powered Insights:
  • Email summaries
  • Priority scoring (1-10)
  • Suggested replies
  • Draft generation
• Gmail Integration: Connect Gmail accounts for seamless email sync
• IMAP Support: Connect any email provider via IMAP
• Rich Email Viewer: Display emails with attachments, threading, and formatting
• Reply Composer: Compose and send replies with attachment support
• Settings: Configure Gmail/IMAP credentials and AI settings
• Theme Support: Light/dark mode toggle
• Responsive Design: Works on desktop and mobile devices

Admin Dashboard

• Employee Management: View and manage employees
• Department Management: Organize employees by departments
• Analytics: Track email activity, response times, and engagement
• Reports: Generate detailed reports on employee activity
• Leaderboards: Performance metrics and rankings
• Settings: Configure system-wide settings
• Live Updates: Real-time dashboard updates via WebSocket

Backend

• Authentication: JWT-based authentication with refresh tokens
• RBAC: Role-based access control (CEO, Manager, Employee)
• Gmail Sync: Automatic Gmail account connection and email synchronization
• AI Pipeline: Email analysis with summary, priority, and reply suggestions
• Analytics Engine: Real-time and scheduled analytics computation
• Email Management: Full email lifecycle management (read, star, trash, etc.)
• Notification System: Real-time notifications for important events
• Report Generation: Scheduled and on-demand report generation
• WebSocket Support: Live updates for admin dashboard

Tech Stack

Frontend (Employee App)

• Framework: React 19
• Language: TypeScript
• Styling: Tailwind CSS 4
• UI Components: shadcn/ui
• State Management: React Hooks, React Query
• Routing: Wouter
• Forms: React Hook Form
• Notifications: Sonner
• Icons: Lucide React

Frontend (Admin Dashboard)

• Framework: Next.js
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: Custom components
• State Management: Zustand (store)

Backend

• Runtime: Node.js 20+
• Framework: Express.js
• Language: TypeScript
• Database: PostgreSQL with Prisma ORM
• Real-time: Socket.IO
• Authentication: JWT with bcrypt
• Email: Nodemailer
• Scheduling: node-cron
• Rate Limiting: express-rate-limit
• Security: Helmet

Installation

Prerequisites

• Node.js 20.0.0 or higher
• pnpm 10.0.0 or higher
• A PostgreSQL database — this project is set up to use Neon (serverless Postgres); any Postgres 12+ connection string works the same way

Setup

1. Clone and Install Dependencies

   cd mailpilot-enterprise
   pnpm install
   

2. Configure Environment Variables

   # Backend
   cp backend/.env.example backend/.env
   
   # Admin Dashboard
   cp admin-dashboard/.env.example admin-dashboard/.env
   
   # Employee App
   cp employee-app/.env.example employee-app/.env
   

3. Set Up Database

   # Generate and apply migrations
   pnpm db:push
   
   # Seed with demo data (optional)
   pnpm db:seed
   

4. Start Development Servers

   # Start all services
   pnpm dev
   
   # Or start individual services
   pnpm -C backend dev
   pnpm -C admin-dashboard dev
   pnpm -C employee-app dev
   

This is the beginning of the README. Read the rest at the original. Read the full README ↗