🎫 TicketFlow

AI-Powered IT Service Desk & Incident Management Platform

Modern AI-Powered Ticket Management System built with Next.js, FastAPI, PostgreSQL, Docker, Groq & ChromaDB.

---

🎥 Project Demo

▶ Click the thumbnail above to watch the full demo.

---

🚀 Features

🎫 Smart Ticket Management

• Create and manage support tickets
• Ticket lifecycle tracking
• Priority & category management
• SLA monitoring
• Status-based workflows

🤖 AI-Powered Features

• Automatic ticket classification
• AI ticket summarization
• Risk analysis and scoring
• Suggested ticket responses
• Intelligent routing recommendations

📚 Knowledge Base

• Semantic search using embeddings
• ChromaDB vector storage
• AI-assisted document retrieval
• Internal support documentation

👥 User & Role Management

• Admin dashboard
• Support agents
• Employees
• Department-based ticket routing

📊 Analytics Dashboard

• Ticket trends
• Resolution metrics
• SLA performance
• Department statistics

---

🏗️ Architecture

Frontend (Next.js)
        │
        ▼
Backend API (FastAPI)
        │
 ┌──────┼──────┐
 ▼      ▼      ▼
Postgres Redis ChromaDB
                │
                ▼
          Groq API

---

🛠️ Tech Stack

🖥️ Frontend

• Next.js 16
• React
• TypeScript
• Tailwind CSS

⚙️ Backend

• FastAPI
• SQLAlchemy
• Alembic
• PostgreSQL

🧠 AI Layer

• Groq API
• ChromaDB
• Sentence Transformers

🐳 Infrastructure

• Docker
• Docker Compose
• Redis

---

🐳 Docker Deployment

Clone Repository

git clone https://github.com/Janviswa/TicketFlow.git
cd TicketFlow

Build Containers

docker compose build

Start Application

docker compose up

Run In Background

docker compose up -d

Stop Containers

docker compose down

---

📦 Docker Services

Service	Port
Frontend	3000
Backend	8000
PostgreSQL	5432
Redis	6379
Groq API	-

---

🌐 Access URLs

Frontend

http://localhost:3000

Backend API

http://localhost:8000

Swagger Documentation

http://localhost:8000/docs

---

📁 Project Structure

TicketFlow
│
├── app/
├── components/
├── public/
├── backend/
│   ├── api/
│   ├── models/
│   ├── services/
│   ├── vector_store/
│   └── main.py
│
├── database/
├── docker-compose.yml
├── Dockerfile.frontend
├── README.md
└── .env.example

---

📚 Knowledge Base

The system includes a vector-powered knowledge base containing:

• Password Reset Guides
• VPN Setup Documentation
• Email Troubleshooting
• Security Policies
• Incident Response Procedures
• AWS & Azure Documentation
• Change Management Guides
• Employee Onboarding Documentation

All documents are embedded and stored in ChromaDB for semantic search and AI retrieval.

---

🔒 Environment Variables

POSTGRES_PASSWORD=your_password
REDIS_PASSWORD=your_password
SECRET_KEY=your_secret_key
GROQ_API_KEY=your_api_key

---

✨ Future Enhancements

• Email-to-Ticket Integration
• Slack Integration
• Microsoft Teams Integration
• Single Sign-On (SSO)
• Real-Time Notifications
• Multi-Tenant Support
• Advanced AI Workflows

---

👩‍💻 Author

Janani V

B.Tech Artificial Intelligence & Data Science

---

⭐ If you found this project useful, consider giving it a star.