# Hermes Bilişim Raporlama Sistemi - Kullanım Kılavuzu

Bu kılavuz, **Hermes Bilişim Raporlama Sistemi**'nin temel işlevlerini ve modüllerini en verimli şekilde nasıl kullanacağınızı adım adım açıklamaktadır. 

---

## 1. Sisteme Giriş (Login)

1. Tarayıcınızdan uygulamanın kurulu olduğu adrese (örneğin: `http://localhost/`) gidin.
2. Karşınıza çıkan **Giriş Yap** ekranında, sistem yöneticiniz tarafından size verilmiş olan **Kullanıcı Adı** ve **Şifre** bilgilerinizi girin.
3. Giriş yaptıktan sonra sistemin ana ekranına (Dashboard) yönlendirileceksiniz.

---

## 2. Ana Ekran ve Dashboard Kullanımı

Sisteme giriş yaptığınızda sizi **Dashboard** karşılar. 
- **KPI (Önemli Performans Göstergeleri):** Ekranın en üst kısmında yer alan bilgi kartları, şirketinizin veya projenizin kritik özet verilerini anlık olarak gösterir.
- **Grafikler (Charts):** KPI kartlarının hemen altında pasta, sütun, çizgi vb. formatlarda görselleştirilmiş grafik analizleri bulunur.
- **Dinamik Yenileme:** Veriler otomatik olarak veya sayfayı yenilediğinizde güncel tablolardan beslenir.

---

## 3. Raporları Görüntüleme ve Analiz (Rapor İzleyici)

Sol menüde veya üst menüde yer alan **"Raporlar"** sekmesine tıkladığınızda erişim yetkiniz olan raporların listesini görürsünüz. İlgili rapora tıkladığınızda **Rapor Görüntüleme** ekranı açılır. Bu ekranda aşağıdaki özellikleri kullanabilirsiniz:

### a. Veri Listesi ve Özellikleri
- **Sayfalama:** Tablonun sağ üst köşesinden 1 sayfada listelenecek kayıt sayısını (100, 250, 500, 1000) seçebilirsiniz.
- **Sıralama:** Herhangi bir kolon başlığına tıklayarak o kolona göre verileri (A-Z veya Z-A, artan-azalan) sıralayabilirsiniz. Sayılar her zaman otomatik olarak sağa dayalı, metinler ise sola dayalıdır.
- **Tam Ekran Modu:** Rapor tablosunu genişletmek için sağ üstteki **"Tam Ekran"** ikonuna tıklayabilirsiniz. Bu mod, özellikle geniş veri setlerini (Pivot vb.) incelerken büyük kolaylık sağlar. Çıkmak için tekrar **"Tam Ekrandan Çık (Kapat)"** butonunu kullanabilirsiniz.
- **Renklendirme (Koşullu Biçimlendirme):** Rapora önceden tanımlanmış kurallar varsa; belirli hedeflerin altındaki veya üstündeki satırlar otomatik olarak kırmızı, yeşil gibi farklı renklere bürünür.

### b. Dinamik Filtreleme
- Rapor tablosunun hemen üzerinde yer alan **Filtreler** bölümünden Tarih Aralığı, Kategori, Kullanıcı, Cari vb. dinamik parametreleri girerek `Raporu Getir` butonuna basabilir ve sonuçları daraltabilirsiniz.

### c. Pivot (Özet Tablo) Özelliği
Eğer raporda aktif edildiyse, karmaşık verileri sürükle-bırak veya menüden seçme mantığıyla **Satır**, **Sütun** ve **Değer (Toplam, Ortalama vb.)** olarak özetleyebilirsiniz.

---

## 4. Dışa Aktarma (Export) ve Yazdırma

Rapor sonuçlarını kendi bilgisayarınıza indirmek veya kağıda dökmek için ekranın sağ üst köşesindeki butonları kullanabilirsiniz:

1. **Excel İndir:** Tablodaki mevcut filtrelenmiş verileri hızlıca `.xlsx` formatında bilgisayarınıza indirir.
2. **PDF İndir:** Raporu yüksek kaliteli bir PDF dökümanına dönüştürür (Açık/Okuma Modu ile).
3. **Yazdır:** Rapor tablosunu sadece verilerin görüneceği, temiz, renksiz ve baskıya en uygun siyah-beyaz (veya sağa/sola hizalanmış) formatta yeni sekmede açar ve otomatik olarak tarayıcının Yazdır menüsünü tetikler.

---

## 5. Kurumsal Mesajlaşma Modülü

Sistem içinde diğer çalışanlarla haberleşmek için menüde veya üst barda yer alan **Mesajlar (BUMessage İkonu)** bölümünü kullanabilirsiniz:
- Gelen bildirim sayısını (okunmamış mesajlar) kırmızı baloncuk içerisinde anlık olarak takip edebilirsiniz.
- Hızlıca iletişim kurabilir ve kurum içi duyuruları bu bölümden yapabilirsiniz.

---

## 6. Yöneticiler İçin: Yeni Rapor Oluşturma ve Düzenleme

Eğer **Yönetici (Admin)** yetkisine sahipseniz, menüden **"Rapor Yönetimi"** sayfasına erişebilirsiniz.

### a. Temel Sorgu Yazımı
- İlgili veritabanını (MSSQL, MySQL vb.) seçin.
- Rapor ismini ve SQL sorgunuzu (`SELECT * FROM ...`) girin.

### b. Sorguyu Test Etme
- Sistemi yormadan SQL sorgunuzun çalışıp çalışmadığını anlamak için **"Sorguyu Test Et"** butonunu kullanın. 
- Bu butona bastığınızda sorguda bulunan **Kolon İsimleri** etiket (badge) olarak ekrana yansır.
- Ayrıca hemen alt tarafta veritabanınızdan dönen **ilk 10 örnek satır** bir tablo halinde listelenir. Böylece formatları anında teyit edebilirsiniz.

### c. Ek Veri Kaynakları (Data Blending / Join)
- Ana sorgunuz (Örn: Fatura Listesi) ile farklı bir veritabanı veya tablodaki (Örn: Müşteri Bilgileri) verileri eşleştirmek isterseniz **Ek Veri Kaynakları (Yardımcı Sorgular)** alanını kullanabilirsiniz.
- Ana sorgudaki eşleşecek sütun ile yardımcı sorgudaki eşleşecek sütunu belirleyip tek bir tabloda birleştirebilir veya detay tablosu (satıra tıklandığında altta açılan tablo) olarak ayarlayabilirsiniz.

### d. Kolon Formatları ve Tipleri
Sorguyu test ettikten sonra **Kolon Formatları** sekmesine giderek her bir kolonun görünüm tipini belirleyin:
- **Para Birimi / Sayı:** Binlik ayraçlar (1.000,00) ile gösterim sağlar.
- **Tarih:** `d.m.Y` formatında standart gösterim sağlar.
- **Gizli Kolonlar:** Teknik olarak gerekli (ID gibi) ama kullanıcının görmemesi gereken alanları bu sekmeden gizleyebilirsiniz.

### e. Güvenlik Notu
Rapor yönetim ekranı, `DROP TABLE` veya `DELETE/UPDATE` gibi zarar verici sorgulara karşı otomatik korumaya sahiptir. Ancak, performans için geçici tablolar kullanıyorsanız (`DROP TABLE #GeciciTablo`) bunlara sistem tarafından izin verilmektedir.

---

## 7. Planlanmış Görevler (Zamanlanmış Raporlar)

Otomatik olarak belirli periyotlarda (Her gün sabah 08:00, Her pazartesi vb.) belirli mail adreslerine raporların Excel/PDF formatında gitmesini istiyorsanız, Rapor detayından veya Yönetim menüsünden **Zamanlanmış Görevler (Cron/Scheduler)** sekmesini kullanarak bu işlemleri tanımlayabilirsiniz.

---
**Destek ve İletişim:** Olası hata veya ek talepleriniz için sistem yöneticinize başvurabilirsiniz.
