# TicketHub

Enterprise-grade open-source ticket and issue tracking system.

## Features

### Work Management
- 📊 **Dashboard** - Overview with KPIs and recent activity
- 🎫 **Tickets** - Full CRUD with filters, search, and bulk actions
- 📋 **Kanban Board** - Drag-and-drop ticket management
- 📁 **Projects** - Organize tickets by project with unique keys

### Team Collaboration
- 👥 **Team Management** - Invite members with role-based access
- 💬 **Comments** - Discussion threads on tickets
- 🔔 **Notifications** - Email and Slack alerts

### Enterprise Features
- 📈 **Reports & Analytics** - Performance metrics and insights
- 🔌 **Integrations** - GitHub, GitLab, Jira, ServiceNow, Slack
- ⚡ **Automation** - Rules engine for repetitive tasks
- 🔐 **Security** - SSO, 2FA, IP restrictions

### API & Webhooks
- RESTful API with full documentation
- Incoming/outgoing webhooks
- API key management

## Tech Stack

### Backend
- Python 3.11 + FastAPI
- SQLite (development) / PostgreSQL (production)
- Async/await architecture

### Frontend
- React 18 + TypeScript
- TailwindCSS
- React Query
- React Router

## Quick Start

```bash
# Backend
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

# Frontend
cd frontend
npm install
npm run dev
```

## API Endpoints

```
GET    /api/projects
POST   /api/projects
GET    /api/projects/:id
PATCH  /api/projects/:id
DELETE /api/projects/:id

GET    /api/tickets
POST   /api/tickets
GET    /api/tickets/:id
PATCH  /api/tickets/:id
DELETE /api/tickets/:id

GET    /api/tickets/:id/comments
POST   /api/tickets/:id/comments

POST   /api/webhooks/incoming
```

## License

MIT

## Credits

Created by StartData