# AyrisLegal (LawOS) — Kapsamlı Uygulama Özellikleri, Buton & Prompt Rehberi

Bu belge, **AyrisLegal (LawOS)** masaüstü hukuk otomasyonu ve yapay zeka işletim sisteminin tüm sayfalarını, modüllerini, butonlarını, işlevlerini, yapay zeka promptlarını ve yerel entegrasyonlarını en ince ayrıntısına kadar açıklayan eksiksiz teknik ve kullanıcı kılavuzudur.

---

## 📑 İÇİNDEKİLER

1. [Sistem Mimarisi ve Temel Yetenekler](#1-sistem-mimarisi-ve-temel-yetenekler)
2. [Global Arayüz Bileşenleri ve Kısayollar](#2-global-arayüz-bileşenleri-ve-kısayollar)
   - [2.1. Kenar Çubuğu (Sidebar) & Marka Alanı](#21-kenar-çubuğu-sidebar--marka-alanı)
   - [2.2. Hızlı Arama & Komut Paleti (Spotlight / Cmd+K)](#22-hızlı-arama--komut-paleti-cmdk)
   - [2.3. Hızlı Başlangıç Rehberi (Onboarding Modal)](#23-hızlı-başlangıç-rehberi-onboarding-modal)
   - [2.4. Video Eğitimleri & Akademi Modalı](#24-video-eğitimleri--akademi-modalı)
   - [2.5. Tema Değiştirici (Dark / Light Mode)](#25-tema-değiştirici-dark--light-mode)
3. [Sayfa ve Modül Detay İncelemesi](#3-sayfa-ve-modül-detay-incelemesi)
   - [3.1. Genel Bakış (Komuta Merkezi)](#31-genel-bakış-komuta-merkezi)
   - [3.2. Dava Dosyaları (Arşiv & Yönetim)](#32-dava-dosyaları-arşiv--yönetim)
   - [3.3. Dava Detay Paneli (12 Alt Modül)](#33-dava-detay-paneli-12-alt-modül)
     - [3.3.1. Genel Bakış](#331-genel-bakış)
     - [3.3.2. Yapay Zeka Özeti](#332-yapay-zeka-özeti)
     - [3.3.3. Dosya Röntgeni (Usul & Eksiklik Taraması)](#333-dosya-röntgeni-usul--eksiklik-taraması)
     - [3.3.4. İfade & Çelişki Avcısı (Çapraz Sorgu)](#334-ifade--çelişki-avcısı-çapraz-sorgu)
     - [3.3.5. Dava Stratejisi & Kazanma Planı](#335-dava-stratejisi--kazanma-planı)
     - [3.3.6. Müzakere & Arabuluculuk Simülatörü](#336-müzakere--arabuluculuk-simülatörü)
     - [3.3.7. Belgeler & Ekler (OCR, Filtreleme, Detay)](#337-belgeler--ekler-ocr-filtreleme-detay)
     - [3.3.8. Dilekçeler (Taslak Yönetimi)](#338-dilekçeler-taslak-yönetimi)
     - [3.3.9. Duruşma & Süreler (Dosya Takvimi)](#339-duruşma--süreler-dosya-takvimi)
     - [3.3.10. AyrisLegal'e Sor (CaseChat - Dosya İçi RAG)](#3310-ayrislegale-sor-casechat---dosya-içi-rag)
     - [3.3.11. Dijital Stajyer (Canlı Duruşma Nokta Atışı)](#3311-dijital-stajyer-canlı-duruşma-nokta-atışı)
     - [3.3.12. Duruşma Simülatörü (Hakim / Karşı Taraf)](#3312-duruşma-simülatörü-hakim--karşı-taraf)
   - [3.4. İçtihat ve Mevzuat Arama](#34-i̇çtihat-ve-mevzuat-arama)
     - [3.4.1. Emsal İçtihatlar (18M+ Yargıtay, Danıştay, AYM, BAM)](#341-emsal-i̇çtihatlar-18m-yargıtay-danıştay-aym-bam)
     - [3.4.2. Mevzuat & Kanun Maddeleri (26.900+ Madde & Çevrimdışı Depo)](#342-mevzuat--kanun-maddeleri-26900-madde--çevrimdışı-depo)
   - [3.5. Dilekçe Hazırlama Stüdyosu (Drafting Studio)](#35-dilekçe-hazırlama-stüdyosu-drafting-studio)
     - [3.5.1. Kategori & Dilekçe Türü Seçimi](#351-kategori--dilekçe-türü-seçimi)
     - [3.5.2. Yapay Zeka Dilekçe Oluşturma Akışı](#352-yapay-zeka-dilekçe-oluşturma-akışı)
     - [3.5.3. Tiptap Zengin Metin Editörü & Araç Çubuğu](#353-tiptap-zengin-metin-editörü--araç-çubuğu)
     - [3.5.4. Kanun Maddesi Ekleme Modalı](#354-kanun-maddesi-ekleme-modalı)
     - [3.5.5. Dışa Aktarma: UDF, Word (DOCX), PDF](#355-dışa-aktarma-udf-word-docx-pdf)
   - [3.6. Duruşma Takvimi (Calendar)](#36-duruşma-takvimi-calendar)
   - [3.7. Belge & Dilekçe Şablonları (Templates)](#37-belge--dilekçe-şablonları-templates)
   - [3.8. Müvekkiller & Cari Bakiye Takibi (Clients)](#38-müvekkiller--cari-bakiye-takibi-clients)
   - [3.9. Global Hukuk Asistanı (Sohbet / Chat)](#39-global-hukuk-asistanı-sohbet--chat)
   - [3.10. Ayarlar (Settings)](#310-ayarlar-settings)
     - [3.10.1. Kullanıcı Profili & Şifre Değiştirme](#3101-kullanıcı-profili--şifre-değiştirme)
     - [3.10.2. Abonelik & Lisans Yönetimi](#3102-abonelik--lisans-yönetimi)
     - [3.10.3. Google Drive Otomatik Yedekleme & Geri Yükleme](#3103-google-drive-otomatik-yedekleme--geri-yükleme)
     - [3.10.4. Destek Talebi & Hata Bildirimi](#3104-destek-talebi--hata-bildirimi)
     - [3.10.5. Gizlilik, Güvenlik & Güvenli Mod (Safe Mode)](#3105-gizlilik-güvenlik--güvenli-mod-safe-mode)
     - [3.10.6. Görünüm & Tema](#3106-görünüm--tema)
     - [3.10.7. Oturum Kapatma](#3107-oturum-kapatma)
4. [Tüm Yapay Zeka Promptları & Sistem Motoru Mimarisi](#4-tüm-yapay-zeka-promptları--sistem-motoru-mimarisi)
5. [UYAP Entegrasyonu, UDF Formatı ve Masaüstü Köprüsü](#5-uyap-entegrasyonu-udf-formatı-ve-masaüstü-köprüsü)

---

# 1. Sistem Mimarisi ve Temel Yetenekler

AyrisLegal, modern hukuk bürolarının tüm operasyonel ihtiyaçlarını karşılamak üzere geliştirilmiş, **Electron + Next.js (App Router) + TypeScript + TailwindCSS / Vanilla CSS** tabanlı bir masaüstü hukuk işletim sistemidir.

* **Yerel Öncelikli Veri Modeli (Local-First):** Dava evrakları, UDF belgeleri, OCR metinleri ve önbelleğe alınan içtihatlar istemcinin yerel diskinde (SQLite / Local Data Store) güvenli bir şekilde saklanır.
* **UYAP Chrome Eklentisi Köprüsü:** UYAP Avukat Portalındaki dava dosyaları, tensip tutanakları, evraklar, tebligatlar ve duruşma listeleri tek tıkla masaüstü uygulamasına aktarılır.
* **Çok Modelli Yapay Zeka Altyapısı (Hybrid RAG):** Büyük dava dosyalarını semantik vektörleştirme ve bağlam sıkıştırma teknikleriyle analiz ederek delil değerlendirmesi, çapraz sorgu, strateji ve dilekçe üretimi yapar.
* **Doğal UDF Motoru:** UYAP Doküman Editörü (.udf) dosyalarını doğrudan ayrıştırır, okur ve Tiptap editöründen tek tıkla UYAP uyumlu `.udf` formatında dışa aktarır.

---

# 2. Global Arayüz Bileşenleri ve Kısayollar

## 2.1. Kenar Çubuğu (Sidebar) & Marka Alanı

Sol sütunda yer alan sabit veya daraltılabilir gezinti panelidir.

| Arayüz Unsuru / Buton | İşlev ve Davranış | Arka Plandaki Eylem |
| :--- | :--- | :--- |
| **Logo & Marka Alanı** | Sol üstte AyrisLegal logosunu ve başlığını gösterir. | Genişletilmiş durumda "AyrisLegal" yazar, daraltılmış durumda sadece logo simgesi kalır. |
| **Daralt / Genişlet Butonu (`Icon.chevL` / `Icon.chevR`)** | Kenar çubuğunun genişliğini 252px ile 64px arasında değiştirir. | Tercihi `localStorage ('ayrislegal-sidebar-collapsed')` içinde saklar. |
| **Hızlı Ara... (Spotlight Butonu)** | Arama simgesi ve "⌘K" etiketi barındıran buton. | Tıklandığında Spotlight / Command Palette modalını açar. |
| **Menü Butonları (`NAV_ITEMS`)** | 9 ana sekmeye tek tıkla geçiş sağlar: Genel Bakış, Sohbet/Asistan, Dava Dosyaları, İçtihat Arama, Dilekçe Hazırlama, Duruşma Takvimi, Belge Şablonları, Müvekkiller, Ayarlar. | Ziyaret edilen görünümleri bellekte (`visitedViews`) canlı tutar, arka plandaki AI akışları veya arama sonuçları kaybolmaz. |
| **🚀 Başlangıç Rehberi Butonu** | Kenar çubuğunun alt kısmında mavi vurgulu buton. | `open-onboarding` olayını tetikler ve 4 adımlı büro kurulum sihirbazını açar. |
| **🎓 Eğitim Videoları Butonu** | Mor vurgulu Akademi butonu. | `open-tutorials` olayını tetikler ve video dersler modalını açar. |
| **Koyu Mod / Aydınlık Mod Butonu** | Güneş/Ay ikonlu buton. | `html[data-theme]` değerini `dark` veya `light` olarak değiştirir ve `localStorage ('ayrislegal-theme')` kaydeder. |
| **Kullanıcı Profil Avatarı & Çıkış** | Kullanıcının adının baş harflerini gösterir. | Genişletilmiş modda "Çıkış Yap" butonu, daraltılmış modda avatara tıklandığında `supabase.auth.signOut()` çağrılır. |

---

## 2.2. Hızlı Arama & Komut Paleti (Cmd+K)

Klavyeden `⌘ + K` (Mac) veya `Ctrl + K` (Windows/Linux) tuşlarına basıldığında ya da sol menüdeki arama butonuna tıklandığında açılır.

* **Arama Girdisi:** Yazılan metne göre anında eşleşen sayfaları, modülleri ve eylemleri filtreler.
* **Yukarı / Aşağı Ok Tuşları (`ArrowUp` / `ArrowDown`):** Liste öğeleri arasında gezinir.
* **Enter Tuşu:** Seçili komutu veya sayfayı anında çalıştırır/açar.
* **Escape Tuşu:** Paleti kapatır.
* **Desteklenen Hızlı Komutlar:**
  * 📊 `Genel Bakış (Komuta Merkezi)` -> `overview`
  * 📁 `Dava Dosyaları & Arşiv` -> `cases`
  * 🔍 `İçtihat Arama (Yargıtay, Danıştay, BAM)` -> `research`
  * ✍️ `Dilekçe Hazırlama Stüdyosu` -> `drafting`
  * 📅 `Duruşma Takvimi & Süreler` -> `calendar`
  * 📝 `Hukuki Belge & Dilekçe Şablonları` -> `templates`
  * 👥 `Müvekkiller & Cari Hesaplar` -> `clients`
  * 💬 `AyrisLegal Hukuki Yapay Zeka Sohbeti` -> `chat`
  * ⚙️ `Uygulama Ayarları & Tercihler` -> `settings`
  * 🎨 `Açık / Koyu Tema Değiştir` -> `toggleTheme()`
  * 🚪 `Oturumu Kapat` -> `handleSignOut()`

---

## 2.3. Hızlı Başlangıç Rehberi (Onboarding Modal)

İlk girişte otomatik açılan, istendiğinde kenar çubuğundan tekrar çağrılabilen 4 adımlı büro kurulum sihirbazıdır.

1. **Adım 1 - Büro Profili & Uzmanlık Alanları:**
   * Avukat Adı/Soyadı, Hukuk Bürosu Adı giriş alanları.
   * Uzmanlık Alanı Seçicileri: *Ceza Hukuku, İş & Tazminat, Ticaret & Şirketler, Aile & Boşanma, İcra & İflas, Gayrimenkul & Kira, İdare & Vergi, Fikri & Sınai Mülkiyet, Tüketici & Sözleşmeler*.
2. **Adım 2 - UYAP Chrome Eklentisi Entegrasyonu:**
   * "Chrome Web Mağazası'nda Aç" butonu ile resmi eklenti sayfasına yönlendirme.
   * Canlı handshake dinleyicisi (`ayris-chrome-extension` mesajı algılandığında eklenti durumu "Yüklendi" yeşil onayına geçer).
3. **Adım 3 - Temel Özellikler Turu:**
   * 18 Milyon İçtihat Arama, Tensip Zaptı Analizi, AI Dilekçe Motoru, Dijital Stajyer tanıtımları.
4. **Adım 4 - Başlangıç & Yönlendirme:**
   * "Komuta Merkezine Git" veya "Yeni Dava Dosyası Ekle" butonlarıyla sistemi başlatır.

---

## 2.4. Video Eğitimleri & Akademi Modalı

Uygulamanın gelişmiş yeteneklerini görsel olarak anlatan YouTube destekli video eğitim merkezidir.

* **Kategori Filtreleme Butonları:** *Tümü, 🚀 Hızlı Başlangıç, ⚖️ UYAP & Eklenti, 🤖 AI Dilekçe & Savunma, 🔍 18M İçtihat, 📑 Dava & Tensip Analizi, 📚 Şablonlar & Mevzuat*.
* **Video Oynatıcı Kartı:** Seçilen videonun yerleşik oynatıcısı, süresi, video açıklaması ve öne çıkan başlıklar listesi.
* **"Modüle Git" Eylem Butonu:** Videoda anlatılan ilgili sayfaya (örneğin dilekçe yazımı veya içtihat arama) kullanıcıyı doğrudan yönlendirir.

---

# 3. Sayfa ve Modül Detay İncelemesi

## 3.1. Genel Bakış (Komuta Merkezi)

Uygulamanın ana kumanda merkezidir. Canlı UYAP bildirim akışı, yaklaşan duruşmalar ve acil hukuki işlemler burada toplanır.

### Arayüz Öğeleri ve Butonlar:
* **`AYRIS AI: CANLI` Durum Rozeti:** Sağ üstte yapay zeka servislerinin operasyonel olduğunu gösteren yeşil neon nabız göstergesi.
* **Stat Kartı 1: `AKTİF DAVA DOSYALARI`**
  * Toplam aktif dava sayısını ve ilerleme çubuğunu gösterir.
  * Tıklandığında doğrudan `cases` (Dava Dosyaları) sayfasına geçer.
* **Stat Kartı 2: `EN YAKIN DURUŞMA GÜNÜ`**
  * Yaklaşan duruşma sayısını ve en yakın duruşmanın gün/saat bilgisini gösterir.
  * Tıklandığında doğrudan `calendar` (Duruşma Takvimi) sayfasına geçer.
* **`Bildirimler (Canlı UYAP Akışı)` Paneli:**
  * UYAP Chrome Eklentisi üzerinden aktarılan dosya hareketlerini listeler.
  * *Kategori İkonları ve Rozetleri:* 🩺 Bilirkişi Raporu, ⚖️ Mahkeme Kararı / Tensip, 💰 İcra Tahsilat / Reddiyat, 📬 Tebligat / Müzekkere, ✍️ Dilekçe / İtiraz, 👤 Taraf / Vekalet Kaydı.
  * Tıklanan bildirim kartı doğrudan ilgili dava dosyasına yönlendirir.
* **`Acil İşlemler` Paneli:**
  * Önümüzdeki 7 gün içindeki duruşmaları ve süresi yaklaşan ara kararları filtreler.
  * *Öncelik Rozetleri:* `BUGÜN DURUŞMA VAR` (Kırmızı), `SÜRESİ YAKLAŞIYOR` (Turuncu), `7 GÜN İÇİNDE` (Mavi).
  * **"Tüm Dosya Görevlerini Görüntüle →" Butonu:** Dava arşivine yönlendirir.

---

## 3.2. Dava Dosyaları (Arşiv & Yönetim)

Kayıtlı tüm dava dosyalarının listelendiği, arandığı ve yeni davaların açıldığı ana arşiv ekranıdır.

### Butonlar ve İşlevler:
1. **`DOSYA VEYA TARAF ARA...` Arama Girdisi:**
   * Esas numarasına veya taraf isimlerine göre anlık Türkçe karakter duyarlı (`normalizeTr`) arama yapar.
   * `✕` Butonu: Arama filtresini temizler.
2. **`Yeni Dosya (+)` Butonu:**
   * Yeni Dava Dosyası Ekleme Modalı'nı açar.
   * *Modal İçi Girdiler:* Dosya Adı / Esas No (Örn: `2024/145 E. Kozmos vs. Demirtaş`).
   * *Modal Butonları:* "İptal" (kapatır), "Dosya Oluştur" (`POST /api/cases` çağırır ve listeyi günceller).
3. **Tablo Satırı:**
   * Herhangi bir satıra tıklandığında o davanın kapsamlı `CaseDetail` görünümü açılır.
4. **`Sil (Çöp Kutusu)` Butonu:**
   * Dava dosyasını, bağlı tüm evrakları, analizleri ve sohbet geçmişini kalıcı olarak silmek için onay diyaloğu (`useToast.confirm`) çıkarır ve onaylanırsa `DELETE /api/cases/:id` çağrısı yapar.

---

## 3.3. Dava Detay Paneli (12 Alt Modül)

Dava Detay görünümü, sol tarafta 3 ana grupta toplanmış 12 alt sekme içeren tam teşekküllü bir dava yönetim ve yapay zeka çalışma ortamıdır.

### Sol Navigasyon Grupları:
* **Dava Yönetimi:** Genel Bakış, Belgeler & Ekler, Dilekçeler, Duruşma & Süreler
* **Yapay Zeka & Analiz:** Yapay Zeka Özeti, Dosya Röntgeni, İfade & Çelişki Avcısı, Dava Stratejisi, Müzakere & Arabuluculuk
* **Asistan & Araçlar:** AyrisLegal'e Sor, Dijital Stajyer, Duruşma Simülatörü

---

### 3.3.1. Genel Bakış
* **`Dosyalara dön (←)` Butonu:** Dava arşiv listesine geri döner.
* **Esas No ve `ANALİZ EDİLDİ` Rozeti:** Dosya kimliğini gösterir.
* **4 Ana Hızlı Aksiyon Kartı:**
  * `Duruşma Öncesi İncele` -> AI özetine yönlendirir.
  * `Röntgen & Usul Taraması` -> Röntgen sekmesine aktarır.
  * `Çapraz Sorgu & İfade Analizi` -> İfade & Çelişki sekmesine aktarır.
  * `Dilekçe Hazırla` -> Dilekçeler sekmesine aktarır.
* **`Dijital Kenar Notu` Paneli:** Dosyaya ilişkin tespit edilen kritik uyarılar, süreler ve kanun maddeleri.
* **`Dosya İstatistikleri`:** Toplam taranan belge sayısı, OCR metin oranı ve dosya boyutu.

---

### 3.3.2. Yapay Zeka Özeti
* **`Yeniden Analiz Et` Butonu:** Dosyadaki tüm güncel evrakları yeniden tarayarak yapay zeka özetleme motorunu (`POST /api/cases/:id/summarize`) tetikler.
* **İlerleme Günlüğü (Progress Log):** Evrakların okunması, kronolojik olay örgüsünün kurulması ve delil haritasının çıkarılması adımlarını canlı loglar.
* **Rapor Çıktısı (Markdown):**
  * *Taraflar ve Talepler:* Davacı, davalı, vekiller ve netice-i talep dökümü.
  * *Kronolojik Olay Örgüsü:* Olayların tarih sırasına göre gelişimi.
  * *Hukuki Nitelendirme & Kanun Maddeleri:* İlgili mevzuat hükümleri.
  * *Deliller & İspat Durumu:* Mevcut delillerin hukuki kuvveti.
  * *Hukuki Riskler ve Tavsiyeler:* Dava sürecindeki muhtemel riskler.

---

### 3.3.3. Dosya Röntgeni (Usul & Eksiklik Taraması)
* **`Dosya Röntgenini Çek` Butonu:** HMK / CMK usul hükümlerine göre davanın usul röntgenini başlatır (`POST /api/cases/:id/deficiency-analysis`).
* **Çıktı Kartları:**
  * *Mevcut Yargılama Aşaması:* (Örn: Dilekçeler Teatisi, Ön İnceleme, Tahkikat, Hüküm).
  * *Eksiklikler & Usul Hataları:* Tebligat eksiklikleri, harç tamamlama ihtarları, bilirkişi itiraz süreleri (Aciliyet derecesine göre: Yüksek/Kırmızı, Orta/Sarı, Düşük/Mavi).
  * *Tamamlanan Usul Adımları:* Yeşil onay işaretli tamamlanmış aşamalar.

---

### 3.3.4. İfade & Çelişki Avcısı (Çapraz Sorgu)
* **`İfadeleri Getir (Önizleme)` Butonu:** Dosya içerisindeki şüpheli, sanık, müşteki, mağdur ve tanık beyanlarını içeren evrakları tespit edip listeler.
* **`Çelişkileri ve İfadeleri Analiz Et` Butonu:** Seçilen ifade evraklarını karşılaştırmalı analiz motoruna gönderir (`POST /api/cases/:id/statement-analysis`).
* **Çıktı Analizi:**
  * Kişi bazında kimlik ve rol (Örn: Sanık A, Tanık B).
  * Farklı aşamalardaki beyanların özeti (Kolluk, Savcılık, Sorgu Hakimliği, Mahkeme Duruşması).
  * **Tespit Edilen Çelişkiler:** İfadeler arasındaki zaman, yer, eylem tutarsızlıkları ve çapraz sorguda sorulması gereken kilit sorular.

---

### 3.3.5. Dava Stratejisi & Kazanma Planı
* **Müvekkil Adı / Taraf Seçimi:** Stratejinin hangi müvekkil adına kurulacağını belirler.
* **`Strateji Analizini Başlat` Butonu:** Kapsamlı dava kazanma planını üretir (`POST /api/cases/:id/strategy-analysis`).
* **Çıktı Bölümleri:**
  * *Temel Hedef ve Rol:* Müvekkilin savunma veya alacak hedefi.
  * *Ana Strateji & Kazanma Adımları:* Adım adım izlenecek yol haritası.
  * *Lehe Hukuki Dayanaklar & Yargıtay Kararları:* Davayı destekleyen kanun maddeleri ve içtihatlar.
  * *Zayıf Yönler & Karşı Tarafın İtiraz İhtimalleri:* Savunmadaki açık noktalar.
  * *Gerekli Deliller & Karşı Hamleler:* Mahkemeden istenmesi gereken müzekkereler ve delil toplama talepleri.

---

### 3.3.6. Müzakere & Arabuluculuk Simülatörü
* **`Kazanma İhtimali ve Tazminat Aralığını Hesapla` Butonu:** Dava riskini ve tahmini mali sonucu modeller (`POST /api/cases/:id/mediation-analysis`).
* **Çıktı Göstergeleri:**
  * *Kazanma Olasılığı Yüzdesi:* (Örn: `%75 - %85`).
  * *Tahmini Tazminat / Kazanım Aralığı:* Minimum, Maksimum ve En Olası Tutar (TL) + Güven Skoru.
  * *Masadan Kalkış Noktası (Walk-Away Point):* Kabul edilmemesi gereken alt sınır.
  * *Önerilen Teklif Stratejisi:* Arabuluculuk masasında sunulacak ilk teklif ve müzakere adımları.

---

### 3.3.7. Belgeler & Ekler (OCR, Filtreleme, Detay)
* **`Akıllı Görünüm (Filtre)` Butonu:** Tebligat mazbataları, tahsilat makbuzları ve harç pulları gibi tali evrakları gizleyerek sadece ana dilekçe, rapor ve zabıtları gösterir.
* **`Sıralama Seçici`:** Tarihe Göre (Yeniden Eskiye / Eskiden Yeniye), İsim Sırasına Göre, Kategoriye Göre.
* **`Yeniden Tara / İçe Aktar` Butonları:** Yerel klasördeki yeni eklenen UDF/PDF dosyalarını içe aktarır.
* **Belge Önizleme & OCR Detay Modalı:**
  * Belgenin tam OCR metnini görüntüler.
  * "Metni Kopyala" butonu ile panoya alır.
  * Belgeye özel yapay zeka özetini gösterir.

---

### 3.3.8. Dilekçeler (Taslak Yönetimi)
* **`Yeni Dilekçe Oluştur` Butonu:** Dilekçe Stüdyosunu bu dosya bağlamında açar.
* **Hızlı Şablon Butonları:** *Cevap Dilekçesi, Beyan Dilekçesi, İstinaf Başvuru Dilekçesi, Bilirkişi İtiraz Dilekçesi*.
* **Kayıtlı Taslaklar Listesi:**
  * **Düzenle:** Tiptap editöründe açar.
  * **UDF İndir:** UYAP Doküman Editörü formatında indirir.
  * **Word (DOCX) İndir:** Düzenlenebilir Word formatında indirir.
  * **PDF İndir:** A4 standartlarında çıktısını alır.
  * **Sil:** Taslağı siler.

---

### 3.3.9. Duruşma & Süreler (Dosya Takvimi)
* Dosyaya özel duruşma günlerini, kesin süreleri ve ara karar tarihlerini gösterir.
* "Yeni Etkinlik Ekle" butonu ile bu dosyaya bağlı duruşma veya hatırlatma kaydı oluşturur.

---

### 3.3.10. AyrisLegal'e Sor (CaseChat - Dosya İçi RAG)
* Sadece bu dava dosyasındaki tüm evraklar, bilirkişi raporları ve zabıtlar üzerinde semantik arama yaparak soruları yanıtlar.
* **`Geçmişi Temizle` Butonu:** Dosya sohbet geçmişini sıfırlar.
* **Örnek Soru Önerileri:**
  * "Bilirkişi raporunda hesaplanan asıl alacak ve faiz tutarı nedir?"
  * "Davacı tanığı olay anı hakkında ne ifade vermiştir?"

---

### 3.3.11. Dijital Stajyer (Canlı Duruşma Nokta Atışı)
Duruşma esnasında avukatın saniyeler içinde dosya evraklarından net tarih, saat, sayfa ve alıntı çekmesini sağlayan ultra-hızlı duruşma asistanıdır.

* **Hazır Nokta Atışı Butonları:**
  * 🏥 *Hastane ve adli tıp raporu hangi tarihteydi?*
  * 📜 *Sanığın kolluktaki ifadesi saat kaçta alınmış?*
  * 🚗 *Olay yeri inceleme raporunda ne yazıyor?*
  * 📞 *HTS & Baz istasyonu kayıt tarihleri nelerdir?*
  * ⚖️ *Görgü tanıklarının beyanlarındaki tarihler?*
  * 📋 *İddianamede geçen ilk sevk maddesi nedir?*
* **Çıktı Kartı Yapısı:**
  * 📌 `NOKTA ATIŞI DURUŞMA YANITI`
  * 📅 Tarih / Saat bilgisi
  * 📄 İlgili Evrak Adı ve Sayfa No
  * 🟢 Güven Skoru (`%95+`)
  * 💬 İlgili metinden doğrudan tırnak içi alıntı

---

### 3.3.12. Duruşma Simülatörü (Hakim / Karşı Taraf)
Duruşmaya girmeden önce savunmanın açıklarını test etmek için geliştirilmiş rol yapma simülatörüdür.

* **Persona Seçim Butonları:**
  * `⚖️ Hakim Rolü`: Usul kurallarına, kesin sürelere ve ispat yüküne odaklanır, avukatı çapraz sorguya çeker.
  * `💼 Karşı Taraf Avukatı Rolü`: Dilekçedeki en zayıf noktaları, çelişkileri ve zamanaşımı açıklarını yüzünüze vurur.
* **Hızlı Başlatıcılar:**
  * "Hakimim, Duruşma Açıldı: Sorguyu Başlat"
  * "Usul ve İspat Yükü Açısından Çapraz Sorgula"
  * "Karşı Taraf Ol: Savunmamın Açıklarını Bul"
  * "Çelişkileri Ve Zayıf Karnı Yüzüme Vur"

---

## 3.4. İçtihat ve Mevzuat Arama

### 3.4.1. Emsal İçtihatlar (18M+ Yargıtay, Danıştay, AYM, BAM)
* **Arama Çubuğu:** Dava konusu, kavram veya anahtar kelimelerle arama yapar.
* **Mahkeme Seçim Filtreleri (Checklist):**
  * *Yargıtay, Danıştay, Anayasa Mahkemesi (AYM), İstinaf (BAM), Yerel Mahkemeler, Uyuşmazlık Mahkemesi, Sayıştay, Kanun Yararına Bozma (KYB), GİB Özelgeleri, KİK, KVKK, Rekabet Kurumu, BDDK, BTK, Sigorta Tahkim, UYAP Emsaller*.
* **Popüler Arama Önerileri:**
  * *Kıdem & İhbar Tazminatında İspat Yükü*
  * *Kiralananın Tahliyesi (Konut İhtiyacı)*
  * *Trafik Kazası Araç Değer Kaybı*
  * *İşe İade Davası & Geçersiz Fesih*
* **Sonuç Listesi & Detay Görüntüleyici:**
  * Daire, Esas No, Karar No, Karar Tarihi ve Karar Özeti.
  * Karara tıklandığında sağ panelde tam metin açılır.
  * **"Metni Kopyala" Butonu:** Karar metnini panoya kopyalar.

---

### 3.4.2. Mevzuat & Kanun Maddeleri (26.900+ Madde & Çevrimdışı Depo)
* **Popüler Kanun Hızlı Seçim Butonları:**
  * `HMK (6100)`, `TCK (5237)`, `CMK (5271)`, `TMK (4721)`, `TBK (6098)`, `İİK (2004)`, `İYUK (2577)`, `İŞK (4857)`, `TTK (6102)`.
* **Madde No Filtresi:** Doğrudan madde numarası girilerek anında ilgili maddeye gider.
* **Metin İçi Arama:** Kanun maddelerinin içeriğinde arama yapar.
* **Çevrimdışı Mod:** İnternet bağlantısı olmasa dahi daha önce açılan maddeleri yerel depodan anında getirir.
* **"Bu Maddeye İlişkin İçtihat Ara" Butonu:** Tek tıkla ilgili kanun maddesini emsal içtihat motorunda aratır.

---

## 3.5. Dilekçe Hazırlama Stüdyosu (Drafting Studio)

Profesyonel, mevzuata ve Yargıtay standartlarına tam uyumlu dilekçelerin üretildiği ve düzenlendiği ortamdır.

### 3.5.1. Kategori & Dilekçe Türü Seçimi
* **10 Ana Hukuk Kategorisi:**
  1. Hukuk Yargılaması (HMK)
  2. Ceza Yargılaması (CMK & TCK)
  3. İcra ve İflas Hukuku (İİK)
  4. İdare ve Vergi Yargılaması (İYUK)
  5. İş ve Sosyal Güvenlik Hukuku
  6. Aile ve Kişiler Hukuku (TMK)
  7. Ticaret, Şirketler ve Tüketici Hukuku
  8. Gayrimenkul ve Eşya Hukuku (TBK)
  9. Anayasa Mahkemesi ve Uluslararası Yargı (AYM / AİHM)
  10. Genel Usul, Kalem ve Duruşma Talepleri
* **50+ Dilekçe Türü Kataloğu:** Dava dilekçesi, cevap, replik, düplik, istinaf, temyiz, ihtiyati tedbir, suç duyurusu, KYOK itiraz, tutukluluğa itiraz, ödeme emrine itiraz, menfi tespit, yürütmeyi durdurma, işe iade, anlaşmalı boşanma protokolü, tahliye davası vb.

---

### 3.5.2. Yapay Zeka Dilekçe Oluşturma Akışı
* **Dava Dosyası Seçimi:** Dilekçenin hangi davanın delil ve taraf verileriyle besleneceğini belirler.
* **Büro Şablonu Seçimi (Opsiyonel):** Büroya ait özel bir şablon formatı kullanılmak istenirse seçilir.
* **Avukatın Notları & Özel Talepleri:** Özel talepler, talep edilen tazminat miktarı, faiz türü vb.
* **`Dilekçe Taslağı Üret (⚡)` Butonu:** Yapay zeka motorunu çalıştırır ve Tiptap editörüne yapılandırılmış dilekçeyi akıtır.

---

### 3.5.3. Tiptap Zengin Metin Editörü & Araç Çubuğu
* **Metin Stilleri:** Kalın (`Ctrl+B`), İtalik (`Ctrl+I`), Altı Çizili (`Ctrl+U`), Üstü Çizili.
* **Başlıklar:** Başlık 1 (Mahkeme Başlığı), Başlık 2 (Bölüm Başlıkları), Paragraf.
* **Hizalama:** Sola Hizala, Ortala (Mahkeme Başlığı için), Sağa Hizala, İki Yana Yasla (Resmi dilekçe gövdesi için).
* **Listeler:** Sırasız Liste (Madde İmleri), Numaralı Liste (Sıralı Deliller).
* **Alıntı Bloğu (Quote):** Yargıtay emsal kararlarını ve tanık beyanlarını kutu içine almak için.
* **Geri Al / Yinele:** `Undo` / `Redo`.
* **Biçimlendirmeyi Temizle:** Yapıştırılan metinlerdeki bozuk stilleri sıfırlar.
* **`📚 Kanun Maddesi Ekle` Butonu:** Mevzuat ekleme modalını açar.

---

### 3.5.4. Kanun Maddesi Ekleme Modalı
* Editörün araç çubuğundaki "Kanun Maddesi Ekle" butonuna basıldığında açılır.
* Kanun (HMK, TCK, TBK vb.) ve Madde No seçilir.
* "Dilekçeye Ekle" butonuna basıldığında, ilgili kanun maddesi imlecin bulunduğu yere otomatik olarak yasal formatta eklenir.

---

### 3.5.5. Dışa Aktarma: UDF, Word (DOCX), PDF
* **`UYAP (.udf) İndir`:** UYAP Doküman Editöründe doğrudan açılan, imzalanmaya hazır orijinal `.udf` dosyası üretir.
* **`Word (.docx) İndir`:** Kenar boşlukları ve yazı tipleri ayarlanmış Word dosyası üretir.
* **`PDF (.pdf) İndir`:** Doğrudan yazdırmaya ve müvekkile sunmaya hazır PDF oluşturur.
* **`Taslağı Kaydet` Butonu:** Üzerinde çalışılan metni davanın dilekçeler havuzuna kalıcı olarak kaydeder.

---

## 3.6. Duruşma Takvimi (Calendar)

* **Görünüm Seçicileri:** `Ay`, `Hafta`, `Liste`.
* **Otomatik UYAP Duruşma Senkronizasyonu:** UYAP eklentisinden çekilen duruşmalar otomatik olarak takvime işlenir.
* **`Yeni Etkinlik Ekle (+)` Butonu:**
  * Başlık, Tür (*Duruşma, Görüşme, Süre/Son Gün*), Tarih/Saat, Konum/Mahkeme.
* **Etkinlik Detay Modalı & Dışa Aktarma:**
  * **Google Calendar'a Ekle:** Tek tıkla Google Takvim etkinliği oluşturur.
  * **Apple / Outlook (.ics) İndir:** Takvim dosyası indirerek yerel takvimle eşitler.
  * **Sil Butonu:** Etkinliği takvimden kaldırır.

---

## 3.7. Belge & Dilekçe Şablonları (Templates)

Büronun sık kullandığı sözleşmeler, ihtarnameler, protokoller ve vekaletnameleri yönettiği şablon havuzudur.

* **Kategori Filtreleri:** *Tümü, Dava Dilekçeleri, Sözleşmeler, İhtarnameler, İcra Belgeleri, Protokoller*.
* **Arama Kutusu:** Şablon adı veya açıklamasında arama yapar.
* **`Yeni Şablon Yükle` Butonu:**
  * Şablon Adı, Kategori, Açıklama ve Dosya Yükleme (PDF, DOCX, TXT, UDF).
  * Yüklenen dosyanın metni OCR ile çıkarılarak AI dilekçe motorunun kullanımına sunulur.
* **Şablon Kartı Butonları:**
  * *İncele & Düzenle:* Şablon metnini görüntüleme ve güncelleme.
  * *Metni Kopyala:* Panoya alma.
  * *İndir:* Orijinal dosyayı indirme.
  * *Sil:* Şablonu arşivden kaldırma.

---

## 3.8. Müvekkiller & Cari Bakiye Takibi (Clients)

Müvekkil portföyünün ve büro mali hareketlerinin yönetildiği CRM ve cari hesap modülüdür.

* **Tür Filtresi:** `Tümü`, `Kurumsal`, `Bireysel`.
* **Arama Kutusu:** Müvekkil adı veya notlarında anında filtreleme yapar.
* **`Yeni Müvekkil Ekle` Butonu:** Ad/Soyad/Unvan, Tür (Bireysel/Kurumsal), Özel Notlar.
* **Müvekkil Detay Görünümü (`ClientDetail`):**
  * **Notlar Alanı:** Müvekkile özel notlar ve "Notu Kaydet" butonu.
  * **Bakiye Kartı:** Toplam Alacak, Tahsil Edilen Ödeme ve Güncel Bakiye (TL).
  * **Yeni Cari Hareket Formu:** Tarih, Tür (*Alacak / Hizmet Bedeli* veya *Ödeme / Tahsilat*), Tutar (₺), Açıklama ve "+ Ekle" butonu.
  * **Cari Hareketler Tablosu:** Tüm finansal hareketlerin dökümü ve silme butonu.

---

## 3.9. Global Hukuk Asistanı (Sohbet / Chat)

Genel hukuki araştırmalar, mevzuat yorumları, doküman incelemeleri ve beyin fırtınası için kullanılan çoklu oturumlu AI asistanıdır.

* **Sol Panel - Sohbet Oturumları (Threads):**
  * `+ Yeni Sohbet` Butonu: Temiz bir yapay zeka oturumu başlatır.
  * Sohbet Listesi: Geçmiş konulara göre isimlendirilmiş oturumlar ve her oturumun silme (`Çöp Kutusu`) butonu.
* **Dosya Eki Yükleme (`Ataş` İkonu):**
  * PDF, Word veya metin belgesi yükleyerek dosya üzerinde anlık analiz isteme.
* **Öneri Kartları (Hızlı Başlatıcılar):**
  * 📄 *Dilekçe Taslağı Oluştur*
  * 🔍 *İçtihat Araştır*
  * 📋 *Belge Analizi*
  * ⚖️ *Hukuki Değerlendirme*
* **Girdi Alanı ve `Gönder` Butonu:**
  * Enter tuşu ile gönderir (Shift+Enter yeni satır).
  * AI yanıtları gerçek zamanlı akış (streaming) ile ekrana yansır.

---

## 3.10. Ayarlar (Settings)

7 alt kategoriden oluşan sistem yapılandırma merkezidir:

### 3.10.1. Kullanıcı Profili & Şifre Değiştirme
* Ad-Soyad, Baro Adı, Baro Sicil No güncelleme ve "Profili Kaydet" butonu.
* Yeni Şifre ve Şifre Tekrarı alanları ile "Şifreyi Değiştir" butonu.

### 3.10.2. Abonelik & Lisans Yönetimi
* Lisans Durumu (*Aktif, Deneme, Süresi Doldu*), Bitiş Tarihi ve Maksimum Cihaz Sayısı göstergesi.
* "Lisansı Yenile / Yükselt" butonu.

### 3.10.3. Google Drive Otomatik Yedekleme & Geri Yükleme
* **Google Drive Bağlantısı:** "Google Drive'ı Bağla" butonu ile OAuth yetkilendirmesi.
* **Otomatik Yedekleme Servisi:** Belirlenen aralıklarla (Örn: her 15 dakikada bir) dava dosyalarını ve yerel SQLite verilerini şifreli olarak buluta yedekler.
* **"Şimdi Yedekle" Butonu:** Manuel tam yedekleme tetikler.
* **"Buluttan Geri Yükle" Butonu:** Yeni bir bilgisayara geçildiğinde tüm dava dosyalarını Drive'dan tek tıkla geri yükler.

### 3.10.4. Destek Talebi & Hata Bildirimi
* Destek Kategorisi: *Hata Bildirimi, Geri Bildirim, Soru, Diğer*.
* Konu, Mesaj ve Ekran Görüntüsü / Dosya Yükleme alanı.
* "Destek Talebini Gönder" butonu (Talepler anında teknik ekibin destek paneline iletilir).
* Geçmiş Destek Talepleri Listesi ve durum takibi.

### 3.10.5. Gizlilik, Güvenlik & Güvenli Mod (Safe Mode)
* **Otomatik Hata Raporlama (Crash Reporter):** Uygulama çökmelerinde anonim hata logu gönderme açma/kapama anahtarı.
* **Güvenli Mod (Safe Mode):** Ağır dosya yüklemelerinde veya bellek kısıtlarında eklentileri devre dışı bırakan kararlı mod.

### 3.10.6. Görünüm & Tema
* Koyu Tema (Cyber-Juris Dark) veya Aydınlık Tema seçimi.

### 3.10.7. Oturum Kapatma
* "Oturumu Kapat" butonu ile güvenli çıkış.

---

# 4. Tüm Yapay Zeka Promptları & Sistem Motoru Mimarisi

AyrisLegal bünyesinde çalışan yapay zeka ajanlarının sistem talimatları Türk Hukuk terminolojisine ve yargılama usullerine göre özelleştirilmiştir:

### 1. Dava Özeti ve Olay Örgüsü Promptu:
> *"Sen Türk Hukukunda uzman kıdemli bir avukatsın. Sana verilen dava dosyası evraklarını incele; tarafları, dava konusunu, harca esas değeri, kronolojik olay örgüsünü, toplanan delillerin ispat gücünü, mevzuat maddelerini ve davanın hukuki risklerini maddeler halinde kapsamlı bir rapor olarak hazırla."*

### 2. Dosya Röntgeni & Usul Eksiklikleri Promptu:
> *"HMK ve CMK usul hükümlerine göre dava dosyasını tara. Tebligat usulsüzlükleri, kaçırılan hak düşürücü süreler, eksik harçlar, yerine getirilmemiş ara kararlar ve bilirkişi itiraz sürelerini aciliyet derecesiyle (Yüksek, Orta, Düşük) tespit et."*

### 3. İfade & Çelişki Avcısı Promptu:
> *"Dosyadaki şüpheli, sanık, mağdur ve tanık beyanlarını karşılaştır. Kişilerin kolluk, savcılık ve mahkeme aşamalarındaki ifadeleri arasındaki zaman, mekân ve eylem çelişkilerini çıkar. Çapraz sorguda yöneltilecek can alıcı soruları listele."*

### 4. Duruşma Simülatörü Promptu:
> *(Hakim Modu)*: *"Sen duruşmayı yöneten, usul ve ispat yükü kurallarına son derece katı bir Mahkeme Başkanısın. Avukatın iddia ve savunmalarını HMK/CMK çerçevesinde sorgula, delil açıklarını sor."*  
> *(Karşı Taraf Modu)*: *"Sen karşı taraf vekilisin. Dilekçedeki zayıf noktaları, zamanaşımı itirazlarını ve çelişkileri agresif bir şekilde ileri sür."*

### 5. Dijital Stajyer Nokta Atışı Promptu:
> *"Duruşma salonundaki avukatın sorusuna saniyeler içinde cevap ver. Yanıtın başında net tarih/saat, ilgili evrak adı, güven skoru ve evraktan doğrudan yapılan tırnak içi alıntıyı JSON/nokta atışı formatında sun."*

### 6. Dilekçe Üretim Kataloğu Motoru:
> *Seçilen dilekçe türünün yasal dayanağını (Örn: HMK m. 119, HMK m. 129, CMK m. 268), mahkeme başlığını, zorunlu unsurlarını, delil listesini ve Netice-i Talep fıkrasını eksiksiz kurgulayan prompt şablonu.*

---

# 5. UYAP Entegrasyonu, UDF Formatı ve Masaüstü Köprüsü

* **UYAP Eklentisi (Chrome Extension):**
  * UYAP Avukat Portalında açık olan dosyanın safahatını, evrak listesini ve duruşma günlerini tek tıkla yakalar.
  * Yerel köprü sunucusu (`127.0.0.1:49152+`) üzerinden Electron ana sürecine veri aktarır.
* **UDF Ayrıştırıcı ve Üretici (`parseUdf.js` / `generateUdf.js`):**
  * Adalet Bakanlığı UYAP Doküman Editörü XML/ZIP formatını yerel olarak çözer ve metin katmanını çıkarır.
  * Tiptap editöründe yazılan dilekçeleri doğrudan UYAP uyumlu `.udf` dosyasına dönüştürür.
* **Yerel OCR & Metin Çıkarma (`extractText.js`):**
  * Taranmış PDF ve resim evraklarını yerel Tesseract / PDF.js motorlarıyla işleyerek aranabilir metne dönüştürür.
* **Çevrimdışı SQLite Deposu (`localDb.js` / `localDataStore.js`):**
  * Dava evraklarını ve mevzuat maddelerini yerel veritabanında saklayarak internet kesintilerinde bile anında erişim sağlar.

---

*Belge Sürümü: v2.4.0 — AyrisLegal LawOS Desktop*
