Genel Bakış

IT Ticket System, şirket içi IT destek süreçleri için tasarlanmış, Docker ile kurulan çok şirketli (multi-tenant), self-hosted bir ticket sistemidir. Talep edenler için şifresiz public portal, IT ekibi için rol bazlı yönetim paneli sunar ve baştan sona Türkçe / İngilizce çift dil çalışır.

Sistem on-prem (şirket içi) çalışmak üzere tasarlanmıştır: tek bir bileşen bile sunucunuzdan dışarı çıkmaz. Public portal bilinçli olarak kimlik doğrulaması yapmaz — erişim, tahmin edilemez bağlantı token'larına dayanır. Varsayılan olarak iç ağ / VPN arkasında çalışır; istenirse ters proxy + kimlik doğrulama ile dışarıdan da güvenli erişim sağlanabilir.

Kimler için?

Sistem üç ana persona etrafında kurgulanmıştır:

👤 Talep eden (public, giriş yok)

• Ticket oluşturur — şirket / lokasyon / kategori seçer, şirkete özel dinamik alanları doldurur, dosya ekler.
• Aldığı erişim linki ile durumu canlı izler, yanıt yazar, ek gönderir.
• Ticket numarası + e-posta ile geçmiş talebini sorgular.

🛠️ IT ekibi (yönetim paneli)

• Dashboard — açık/kapalı istatistikleri, SLA durumu, üzerine atanmış işler.
• Ticket yönetimi — liste/filtre/arama, detay, durum & atama, iç not (talep edene görünmez) + public yanıt, toplu işlem.
• Yerinde destek takvimi — randevu oluşturma, süre seçimi, takvim görünümü.
• Görevler — ticket'tan bağımsız işler, çoklu atama, yorumlar.
• Raporlar — dağılım, personel performansı, kategori kırılımı, SLA trendi, CSV export.

🔐 Yönetici (rol bazlı)

• admin + it_manager — şirket / lokasyon / kategori / özel alan, şirket bazlı SMTP, e-posta & SMS şablonları, hazır yanıtlar.
• admin — personel yönetimi ve şifre kasası (AES-256-GCM, her görüntüleme audit'lenir).

Öne çıkan özellikler

• Çok şirketli yapı — her şirket kendi lokasyonları, kategorileri, özel alanları ve SMTP ayarlarıyla yönetilir.
• Asenkron bildirimler — e-posta / SMS bildirimleri BullMQ ile arka planda (3 deneme, exponential backoff).
• SLA takibi — SLA kontrolü her 5 dakikada; kategori bazlı yanıt/çözüm süreleri.
• Canlı güncelleme — SSE ile panelde realtime güncelleme; domain'e göre şirket branding (logo + tema).
• Çift dil — arayüz tarayıcı diline göre açılır, düğmeyle anında geçilir; API mesajları Accept-Language'e, bildirimler alıcının diline göre.

Teknoloji

Katman	Teknoloji
Backend	Node.js 22 · Fastify 5 · TypeScript (ESM) · Prisma 6 · Zod
Frontend	React 18 · Vite 6 · TailwindCSS 3 · TanStack Query 5 · Zustand 5
Veritabanı	PostgreSQL 16
Kuyruk / Cache	Redis 7 + BullMQ
Realtime	SSE (Server-Sent Events)
Çok dillilik	react-i18next · Accept-Language bazlı API mesajları
Deploy	Docker Compose (Coolify + Nginx Proxy Manager uyumlu)

Sonraki adımlar

• Sistemi ayağa kaldırmak için Hızlı Başlangıç sayfasına geç.
• Mimari detaylar için Mimari sayfasına bak.