Dashboard

Ana sayfa (/), organizasyonunuzun “tek bakışta sağlığı”nı gösterir: kaç proje, ajan, bilgi tabanı ve entegrasyon var; abonelik limitlerine ne kadar yakınsınız; son günlerde hangi işlemler yapıldı.

Veriler backend DashboardModule üzerinden gelir ve çoğu kurulumda JwtAuthGuard + OrgScopedGuard ile korunur — yani Dashboard da aktif organizasyon bağlamına bağlıdır.

İstatistik kartları

Tipik kartlar (stat-card bileşenleri):

• Toplam proje — org içindeki proje sayısı; plandaki projects kotasına göre bağlamlandırılabilir.
• Toplam ajan — tüm projelerdeki ajanların listesi; limit agents alanına bağlı olabilir.
• Bilgi tabanı sayısı — knowledgeBases kotası.
• Entegrasyon sayısı — harici API entegrasyonları.

Kaynak kullanımı ve limit çubukları

subscription-bar veya grafikler:

• Kullanım / limit oranı (ör. dosya depolama MB, bilgi tabanı dosya adedi).
• Limit aşımında backend 402 Payment Required veya guard mesajı dönebilir; UI’da banner görebilirsiniz.

Her limit kodda farklı isimlense de Prisma şeması ve SubscriptionLimitGuard genelde şu tür alanları kontrol eder: projects, agents, knowledgeBases, storage_mb, knowledge_files, workflows vb.

Aktivite trendi ve günlük

• Aktivite trendi: Zaman serisi — oluşturma/güncelleme hacmi (ör. son 30 gün).
• Aktivite günlüğü: Örneğin PROJECT_CREATED, KNOWLEDGE_BASE_UPLOAD gibi eylemlerin kronolojik listesi; operasyonel denetim için kullanılır.

Log satırında aktör (hangi kullanıcı) ve varlık adı gösteriliyorsa ekip içi iletişim kolaylaşır.

Son projeler / hızlı erişim

• Yakın zamanda kullanılan veya güncellenen projelere tek tık.
• Bu liste boşsa henüz proje oluşturulmamış veya filtreniz hariç tutuyor olabilir.

Abonelik özeti

Dashboard’da kısa plan adı, yenileme tarihi veya durum (ACTIVE vb.) gösterilebilir. Plan yükseltme iş akışı kurumsal süreçlerinize bağlıdır — self-serve değilse Abonelik sayfası yönlendirme içerir.

Grafikler ve performans

Çubuk grafikler Recharts tabanlı olabilir; büyük veri setlerinde API agregasyonu backend’de yapılır — tarayıcıya ham konuşma dökümü indirilmez.

Dashboard’ı kim kullanmalı?

Rol	Ne arar?
Org yöneticisi	Limit dolmadan mı? Son 24 saatte hata var mı?
Operasyon	Hangi proje yoğun? Yeni KB eklendi mi?
Geliştirici	Entegrasyon sayısı beklenenle uyumlu mu?

API

• Dashboard uç noktaları — özet, aktivite, grafik parametreleri

Sonraki adımlar

• Hızlı başlangıç
• Abonelik
• Raporlar — operasyonel KPI’lar