Smart AI Ticket Assistant 🎟️🤖

A full-stack MERN application that automates ticket management using AI-powered workflows and Inngest event-driven functions. The project supports user authentication, ticket creation, AI-based ticket analysis, and automated email notifications.

🚀 Features

🔑 Authentication – Signup/Login using JWT

🎟️ Ticket Management – Create and track support tickets

🤖 AI-Powered Assistance – Classify, assign, and add notes to tickets using AI

📩 Email Notifications – Sends welcome emails and ticket updates

⚡ Event-Driven Workflows – Uses Inngest for reliable async event handling

🗺️ Full-Stack MERN – React + Node.js + Express + MongoDB

🛠️ Tech Stack

Frontend: React (Vite, Tailwind, DaisyUI)

Backend: Node.js, Express

Database: MongoDB

Event System: Inngest

AI Integration: Custom AI utility (via Gemini)

Auth: JWT-based

Deployment:

Frontend → Vercel

Backend → Render

📂 Project Structure

smart-ai-ticket-assistant/ │ ├── ai-ticket-assistant/ # Backend │ ├── controllers/ # Auth & ticket controllers │ ├── inngest/ # Inngest client & event functions │ ├── middlewares/ # Auth middleware │ ├── models/ # Mongoose models (User, Ticket) │ ├── routes/ # API routes │ ├── utils/ # Helpers (Mailer, AI) │ ├── index.js # Express server entry │ └── .env # Backend environment variables │ ├── ai-ticket-frontend/ # Frontend │ ├── src/ │ │ ├── components/ # Navbar, Auth check │ │ ├── pages/ # Login, Signup, Tickets, Admin │ │ ├── App.jsx # Routes │ │ └── main.jsx # React entry │ ├── public/ # Static assets │ ├── vite.config.js # Vite config │ └── .env # Frontend environment variables │ ├── .gitignore └── README.md

yaml Copy code

---

⚙️ Setup Instructions

1. Clone Repository

git clone https://github.com/ankitsharma101/smart-ai-ticket-assistant.git
cd smart-ai-ticket-assistant
2. Backend Setup
bash
Copy code
cd ai-ticket-assistant
npm install
Create a .env file inside ai-ticket-assistant/:

env
Copy code
PORT=5000
MONGO_URL=your_mongo_connection_string
JWT_SECRET=your_secret_key
INNGEST_EVENT_KEY=your_inngest_event_key
EMAIL_USER=your_email
EMAIL_PASS=your_email_password
Run backend:

bash
Copy code
npm start
Or with Inngest dev:

bash
Copy code
npx inngest dev --sdk-url=http://localhost:5000/api/inngest
vbnet
Copy code

✅ This will now render perfectly with **code blocks, tree structure, and .env example**.  

Do you want me to also **fix the frontend setup section** in the same way (with clean Markdown formatting)?

3. Frontend Setup
cd ai-ticket-frontend
npm install


Create .env:

VITE_SERVER_URL=http://localhost:5000

Run frontend:

npm run dev

🌍 Deployment

Frontend (Vercel): Connect ai-ticket-frontend/ to Vercel

Backend (Render): Deploy ai-ticket-assistant/ on Render

Ensure all .env variables are configured in deployment dashboards

🧪 Testing

Signup a new user → triggers onUserSignup event → sends welcome email

Create a new ticket → triggers onTicketCreated event → AI assigns ticket & adds notes

View tickets on frontend → should display assigned moderator & status

📌 Future Improvements

Google OAuth integration

Admin dashboard with analytics

Priority-based ticket routing

File upload support for tickets

👨‍💻 Author

Ankit Sharma
MERN Stack Developer | AI Enthusiast