tickethub/README.md

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

# 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