🎫 Tickly

Modern Help Desk & Ticket Management System

🚀 Kurumsal destek taleplerini yönetmek için tasarlanmış,
gerçek zamanlı ve modern bir help desk çözümü.

---

✨ Özellikler • 🛠️ Teknolojiler • 🚀 Kurulum • 📱 Mobil • 📖 Dokümantasyon

---

🎬 Demo Videoları

🖥️ Web Uygulaması Demo React & TypeScript ile geliştirilmiş web arayüzü

📱 Mobil Uygulama Demo Flutter ile geliştirilmiş mobil uygulama

---

�🌟 Proje Hakkında

Tickly, kurumsal ortamlarda destek taleplerinin etkin bir şekilde yönetilmesi için geliştirilmiş kapsamlı bir help desk sistemidir. Modern web teknolojileri ve mobil platform desteği ile kullanıcılara kesintisiz bir deneyim sunar.

🎯 Hedef Kitle 👨‍💼 IT Destek Ekipleri 🏢 Kurumsal Müşteri Hizmetleri 👥 Son Kullanıcılar 📊 Yöneticiler ve Analistler

💡 Temel Değerler ⚡ Hız - Gerçek zamanlı güncellemeler 🔒 Güvenlik - JWT tabanlı kimlik doğrulama 📈 Ölçeklenebilirlik - Modüler mimari 🎨 Kullanılabilirlik - Modern UI/UX

---

✨ Özellikler

🎫 Ticket Yönetimi Talep oluşturma, atama, önceliklendirme ve takip	⏱️ SLA Takibi Servis seviyesi anlaşmaları ve süre yönetimi	🤖 Otomasyon Kural tabanlı otomatik atama ve bildirimler
🔔 Gerçek Zamanlı SignalR ile anlık bildirimler ve güncellemeler	📧 Email Entegrasyonu Email'den ticket oluşturma ve bildirim gönderimi	📚 Bilgi Bankası Makaleler ve SSS yönetimi
👥 Rol Yönetimi Admin, Agent, EndUser RBAC yapısı	🏢 Departmanlar Organizasyonel yapı ve hiyerarşi	📊 Raporlama Dashboard ve analitik araçları

---

🛠️ Teknoloji Stack

🔧 Backend	🎨 Frontend	📱 Mobile
ASP.NET Core 8.0 C# 12 Entity Framework Core SQLite / PostgreSQL SignalR JWT Authentication Swagger/OpenAPI	React 18 TypeScript 5 Vite TailwindCSS React Router Axios React Query	Flutter 3.x Dart Provider (State) HTTP Package SignalR Client Shared Preferences

---

🚀 Hızlı Başlangıç

📋 Ön Gereksinimler

Araç	Versiyon
.NET SDK	8.0+
Node.js	18+
Flutter	3.x
Git	Latest

⚡ Kurulum

# 1️⃣ Projeyi klonlayın
git clone https://github.com/your-repo/tickly.git
cd tickly

# 2️⃣ Backend'i başlatın
cd backend
dotnet restore
dotnet run

# 3️⃣ Frontend'i başlatın (yeni terminal)
cd frontend
npm install
npm run dev

# 4️⃣ Mobil uygulamayı çalıştırın (opsiyonel)
cd mobile
flutter pub get
flutter run

🌐 Erişim Adresleri

Servis	URL
🖥️ Frontend	http://localhost:5173
⚙️ Backend API	http://localhost:5000
📚 Swagger UI	http://localhost:5000/swagger

---

📱 Mobil Uygulama

Flutter ile geliştirilmiş cross-platform mobil uygulama:

Özellikler:

• ✅ iOS ve Android desteği
• ✅ Gerçek zamanlı bildirimler
• ✅ Offline mod desteği
• ✅ Karanlık/Aydınlık tema
• ✅ Biyometrik kimlik doğrulama
• ✅ Push notifications

Proje Yapısı:

📂 mobile/
├── 📁 lib/
│   ├── 📁 models/
│   ├── 📁 providers/
│   ├── 📁 screens/
│   ├── 📁 services/
│   └── 📁 widgets/
├── 📁 test/
└── 📄 pubspec.yaml

📖 Detaylı kurulum için: mobile/SETUP.md

---

📁 Proje Yapısı

tickly/
├── 📂 backend/                 # ASP.NET Core API
│   ├── 📁 src/
│   │   ├── Controllers/        # API Controllers
│   │   ├── Models/             # Entity Models
│   │   ├── Services/           # Business Logic
│   │   ├── Data/               # DbContext & Repos
│   │   └── Hubs/               # SignalR Hubs
│   └── 📁 Migrations/          # EF Migrations
│
├── 📂 frontend/                # React SPA
│   ├── 📁 src/
│   │   ├── components/         # UI Components
│   │   ├── pages/              # Route Pages
│   │   ├── context/            # React Context
│   │   └── lib/                # Utilities
│   └── 📄 vite.config.ts
│
├── 📂 mobile/                  # Flutter App
│   └── 📁 lib/                 # Dart Source
│
└── 📂 docs/                    # Documentation
    ├── 📄 *.tex                # LaTeX Docs
    └── 📄 *.md                 # Markdown Docs

---

📖 Dokümantasyon

📄 Proje Dökümanları Dosya Açıklama Tickly_Proje_Dokumani.pdf Web uygulaması dokümantasyonu (PDF) Tickly_Mobile_Dokumani.pdf Mobil uygulama dokümantasyonu (PDF)

🔗 Faydalı Linkler 📚 ASP.NET Core Docs ⚛️ React Documentation 🦋 Flutter Docs 📡 SignalR Guide

---

🔐 Güvenlik

Özellik	Açıklama
🔑 JWT Authentication	Token tabanlı kimlik doğrulama
👥 RBAC	Rol tabanlı erişim kontrolü
🔒 Password Hashing	BCrypt ile şifreleme
🛡️ CORS	Cross-Origin güvenliği
📝 Input Validation	Model validation

---

🗺️ Yol Haritası

• ✅ Temel ticket yönetimi
• ✅ Kullanıcı kimlik doğrulama
• ✅ Gerçek zamanlı bildirimler
• ✅ Mobil uygulama (Flutter)
• 🔄 AI destekli ticket sınıflandırma
• 🔄 Gelişmiş raporlama ve analitik
• 🔄 Çoklu dil desteği (i18n)
• 🔄 Entegrasyon API'leri (Slack, Teams)

---

⭐ Beğendiyseniz yıldız vermeyi unutmayın!

Tickly ile destek taleplerinizi
profesyonelce yönetin 🎫✨

Son güncelleme: Ocak 2026

---

Made with ❤️ by Tickly Team