diff --git a/mcp_server_main.py b/mcp_server_main.py index 7c3e512..24afca5 100644 --- a/mcp_server_main.py +++ b/mcp_server_main.py @@ -351,730 +351,6 @@ from fastmcp import FastMCP # Placeholder app for decorators - will be replaced in create_app() after all tools are defined app = FastMCP("Yargı MCP Server Placeholder") -# --- Tool Documentation Resources --- -@app.resource("docs://tools/yargitay") -async def get_yargitay_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Yargıtay (Court of Cassation) Tools Documentation - -## Court Hierarchy and Position -Yargıtay is Turkey's highest civil and criminal court. It serves as the final appellate authority and establishes legal precedents for civil and criminal cases. - -**Dual API System:** -- **Primary API (search_yargitay_detailed)**: Official karararama.yargitay.gov.tr -- **Bedesten API (search_bedesten_unified)**: Unified access to bedesten.adalet.gov.tr (see docs://tools/bedesten_unified) - -## Chamber Filtering Options (52 Total) - -### Civil Chambers (Hukuk Daireleri) -- **Civil General Assembly** (Hukuk Genel Kurulu) -- **1st Civil Chamber** through **23rd Civil Chamber** (23 civil chambers) -- **Civil Chambers Presidents Board** (Hukuk Daireleri Başkanlar Kurulu) - -### Criminal Chambers (Ceza Daireleri) -- **Criminal General Assembly** (Ceza Genel Kurulu) -- **1st Criminal Chamber** through **23rd Criminal Chamber** (23 criminal chambers) -- **Criminal Chambers Presidents Board** (Ceza Daireleri Başkanlar Kurulu) - -### General Assemblies -- **Grand General Assembly** (Büyük Genel Kurulu) - -## Search Techniques - -### Primary API (search_yargitay_detailed) -``` -Simple search: "mülkiyet" -AND operator: "mülkiyet AND tapu" -OR operator: "mülkiyet OR tapu" -NOT operator: "mülkiyet NOT satış" -Wildcard: "mülk*" -Exact phrase: "\"mülkiyet hakkı\"" -``` - -### Bedesten API (search_bedesten_unified) -For detailed usage, see docs://tools/bedesten_unified -``` -Regular search: phrase="mülkiyet kararı", court_types=["YARGITAYKARARI"] -Exact phrase: phrase="\"mülkiyet kararı\"", court_types=["YARGITAYKARARI"] -Date filtering: kararTarihiStart="2024-01-01T00:00:00.000Z" -``` - -## Usage Scenarios -- **Precedent research**: Supreme court decisions on specific topics -- **Chamber-specific search**: Relevant chambers for specific legal areas -- **Historical analysis**: Decision trends in specific periods -- **Jurisprudence tracking**: Changes in legal opinions - -## Best Practices -1. **Use dual APIs**: Try both APIs for maximum coverage -2. **Chamber filtering**: Select chambers based on relevant legal area -3. **Exact phrases**: Use "\"term\"" for precise terms in Bedesten API -4. **Date range**: Focus on last 2-3 years for recent developments - -## Common Civil Chambers -- **1st Civil**: Property, land registry, liens -- **4th Civil**: Labor law, collective agreements -- **11th Civil**: Insurance, social security -- **15th Civil**: Compensation, tort -- **21st Civil**: Execution and bankruptcy - -## Common Criminal Chambers -- **1st Criminal**: General criminal offenses -- **8th Criminal**: Economic and commercial crimes -- **12th Criminal**: Official misconduct -""" - -@app.resource("docs://tools/danistay") -async def get_danistay_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Danıştay (Council of State) Tools Documentation - -## Court Hierarchy and Position -Danıştay is Turkey's highest administrative court. It makes final decisions on administrative acts and actions. - -**Triple API System:** -- **Keyword API (search_danistay_by_keyword)**: AND/OR/NOT logic -- **Detailed API (search_danistay_detailed)**: Comprehensive criteria -- **Bedesten API (search_bedesten_unified)**: Unified access (see docs://tools/bedesten_unified) - -## Chamber Filtering Options (27 Total) - -### Main Councils -- **Grand General Assembly** (Büyük Gen.Kur.) -- **Administrative Cases Council** (İdare Dava Daireleri Kurulu) -- **Tax Cases Council** (Vergi Dava Daireleri Kurulu) -- **Precedents Unification Council** (İçtihatları Birleştirme Kurulu) - -### Chambers (1-17) -- **1st Chamber** through **17th Chamber** (Administrative case chambers) - -### Military Courts -- **Military High Administrative Court** (Askeri Yüksek İdare Mahkemesi) -- **Military High Administrative Court 1st-3rd Chambers** - -## Search Techniques - -### Keyword API -``` -AND logic: andKelimeler=["imar", "plan"] -OR logic: orKelimeler=["iptal", "yürütmeyi durdurma"] -NOT logic: notKelimeler=["ceza"] -``` - -### Detailed API -``` -Chamber selection: daire="3. Daire" -Case year: esasYil="2024" -Decision date: kararTarihiBaslangic="01.01.2024" -Legislation: mevzuatId=123 -``` - -### Bedesten API -``` -Regular: phrase="idari işlem" -Exact: phrase="\"idari işlem\"" -Date: kararTarihiStart="2024-01-01T00:00:00.000Z" -``` - -## Usage Scenarios -- **Administrative law research**: Public administration decisions -- **Tax law**: Financial matters and tax disputes -- **Urban planning law**: City planning and building permits -- **Personnel law**: Civil servant rights - -## Common Chamber Specializations -- **1st Chamber**: Municipal, urban planning, environment -- **2nd Chamber**: Tax, customs, financial -- **3rd Chamber**: Personnel, personal rights -- **5th Chamber**: Administrative fines -- **8th Chamber**: Higher education, education -- **10th Chamber**: Health, social security - -## Best Practices -1. **Triple API**: Use all three APIs for maximum coverage -2. **Chamber selection**: Choose specialized chambers by subject area -3. **Mevzuat bağlantısı**: İlgili kanun/tüzükle filtreleme -4. **Kesin terim**: İdari hukuk terminolojisi için exact search -""" - -@app.resource("docs://tools/constitutional_court") -async def get_constitutional_court_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Anayasa Mahkemesi (Constitutional Court) Tools Documentation - -## Court Position -Constitutional Court is Turkey's highest judicial body. It has two main functions: - -### 1. Norm Control (Norm Control) -**Tool**: search_anayasa_norm_denetimi_decisions -- Reviews constitutional compliance of laws and regulations -- Abstract and concrete norm control - -### 2. Individual Application (Individual Application) -**Tool**: search_anayasa_bireysel_basvuru_report -- Citizens' fundamental rights violation applications -- Turkey's human rights protection mechanism - -## Norm Control Features - -### Comprehensive Filtering -- **Application type**: Annulment, Objection, Other -- **Applicant**: President, Parliament, Courts -- **Legislation type**: Law, Decree, Regulation, Rules of procedure -- **Result type**: Annulment, Rejection, Partial annulment - -### Advanced Search -- **Member names**: Full names of participating justices -- **Rapporteur**: Case rapporteur -- **Dissenting opinion**: Minority opinion, different view -- **Press release**: Important decisions - -## Bireysel Başvuru Özellikleri - -### Temel Haklar Kategorileri -- **Yaşam hakkı**: Ölüm olayları, güvenlik -- **Adil yargılanma**: Süre, tarafsızlık, duruşma hakkı -- **İfade özgürlüğü**: Basın, düşünce, akademik özgürlük -- **Din özgürlüğü**: İbadet, vicdan özgürlüğü -- **Mülkiyet hakkı**: Kamulaştırma, tapu -- **Özel hayat**: Gizlilik, aile hayatı - -### Başvuru Süreci -- **Yurtiçi yollar**: Önce mahkeme kararı gerekli -- **Süre sınırı**: 30 gün (60 gün istisnai) -- **Kabul edilebilirlik**: Ön inceleme kriterleri - -## Paginated Content (5,000 characters) -Her iki tool da sayfalanmış Markdown döndürür: -- **page_number**: Sayfa numarası (1'den başlar) -- **total_pages**: Toplam sayfa sayısı -- **current_page**: Mevcut sayfa - -## Usage Scenarios - -### Norm Denetimi -- **Kanun anayasaya uygunluk**: Yeni çıkan kanunların kontrolü -- **Mahkeme iptali**: Kanunun belirli maddeleri -- **Mevzuat uyum**: Anayasa değişikliği sonrası - -### Bireysel Başvuru -- **İnsan hakları araştırması**: AİHM öncesi iç hukuk -- **Temel hak ihlalleri**: Sistematik ihlal tespiti -- **Emsal karar**: Benzer davalar için içtihat - -## Parameter Details -### search_anayasa_norm_denetimi_decisions -- **keywords_all**: Keywords for AND logic (all must be present) -- **keywords_any**: Keywords for OR logic (any can be present) -- **keywords_exclude**: Keywords to exclude from results -- **period**: Constitutional period - "ALL", "1" (1961 Constitution), "2" (1982 Constitution) -- **case_number_esas**: Case registry number (e.g., '2023/123') -- **decision_number_karar**: Decision number (e.g., '2023/456') -- **first_review_date_start/end**: First review date range (DD/MM/YYYY) -- **decision_date_start/end**: Decision date range (DD/MM/YYYY) -- **application_type**: "ALL", "1" (İptal), "2" (İtiraz), "3" (Diğer) -- **applicant_general_name**: General applicant name -- **applicant_specific_name**: Specific applicant name -- **official_gazette_date_start/end**: Official Gazette date range -- **official_gazette_number_start/end**: Official Gazette number range -- **has_press_release**: "ALL", "0" (No), "1" (Yes) -- **has_dissenting_opinion**: "ALL", "0" (No), "1" (Yes) -- **has_different_reasoning**: "ALL", "0" (No), "1" (Yes) -- **attending_members_names**: List of attending members' exact names -- **rapporteur_name**: Rapporteur's exact name -- **norm_type**: Type of reviewed norm (law, decree, regulation, etc.) -- **norm_id_or_name**: Number or name of the norm -- **norm_article**: Article number of the norm -- **review_outcomes**: List of review outcomes -- **reason_for_final_outcome**: Main reason for decision outcome -- **basis_constitution_article_numbers**: Supporting Constitution article numbers -- **results_per_page**: Results per page (10, 20, 30, 40, 50) -- **page_to_fetch**: Page number to fetch -- **sort_by_criteria**: Sort criteria ('KararTarihi', 'YayinTarihi', 'Toplam') - -### search_anayasa_bireysel_basvuru_report -- **keywords**: Keywords for AND logic (all must be present) -- **page_to_fetch**: Page number for the report (default: 1) - -### Document Tools -- **document_url**: URL path or full URL of the decision -- **page_number**: Page number for paginated content (1-indexed, default: 1) - -## Best Practices -1. **Norm control önce**: Kanun iptal edilmiş mi kontrol -2. **Bireysel başvuru ikinci**: Kişisel hak ihlalleri için -3. **Tarih aralığı**: Anayasa değişiklikleri sonrası dönemler -4. **Anahtar kelime kombinasyonu**: Temel hak + konu alanı -5. **Sayfa yönetimi**: Uzun kararlarda sayfa sayfa okuyun -""" - -@app.resource("docs://tools/emsal") -async def get_emsal_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Emsal (UYAP Precedent System) Tools Documentation - -## System Position -Central precedent decision system providing access to all court decisions through the UYAP system. - -## Court Options -- **Yargıtay**: First and second instance courts -- **Danıştay**: Administrative court decisions -- **Other**: Regional courts of justice, civil courts - -## Advanced Filtering Features -- **Court type**: Civil, criminal, administrative -- **Case/Decision number**: File tracking system -- **Date range**: Flexible date selection -- **Content search**: Keyword search within decision text - -## Usage Scenarios -- **Kapsamlı emsal**: Tüm mahkeme seviyelerinden karar toplama -- **Güncel içtihat**: En son hukuki gelişmeler -- **Cross-reference**: Farklı mahkeme görüşlerini karşılaştırma - -## Best Practices -1. **Spesifik terimler**: Hukuki terminoloji kullanın -2. **Geniş arama**: Önce genel, sonra spesifik -3. **Tarih stratejisi**: Mevzuat değişiklikleri dikkate alın -4. **Cross-platform**: Aynı konuyu farklı mahkemelerde arayın -""" - -@app.resource("docs://tools/uyusmazlik") -async def get_uyusmazlik_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Uyuşmazlık Mahkemesi Tools Documentation - -## Court Position -Adli ve idari yargı arasındaki görev uyuşmazlıklarını çözen özel yetkili mahkeme. - -## Dispute Types -- **Görev uyuşmazlığı**: Hangi mahkeme bakacak konusunda anlaşmazlık -- **Hüküm uyuşmazlığı**: Çelişkili mahkeme kararları -- **Yetki uyuşmazlığı**: Yerel yetki sorunları - -## Form-Based Search Criteria -- **Karar türü**: Müspet, menfi, hüküm uyuşmazlığı -- **Taraf mahkemeler**: Adli-idari yargı organları -- **Konu alanı**: Hukuk dalı bazlı filtreleme -- **Tarih aralığı**: Karar tarihi seçimi - -## Usage Scenarios -- **Yargı türü belirleme**: Hangi mahkemenin yetkili olduğu -- **Çelişkili kararlar**: Farklı mahkeme kararları arasındaki uyuşmazlık -- **Yetki sorunları**: Mahkeme yetkisi tartışmaları - -## Best Practices -1. **Net kriterler**: Arama kriterlerini spesifik tutun -2. **Taraf bilgisi**: Uyuşmazlık taraflarını belirtin -3. **Konu odaklı**: İlgili hukuk dalını seçin -""" - -@app.resource("docs://tools/kik") -async def get_kik_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# KİK (Kamu İhale Kurumu) Tools Documentation - -## Kurum Konumu -Kamu ihale uyuşmazlıklarının ilk ve son merci çözüm organı. Kamu İhale Kanunu kapsamındaki tüm ihaleler için yetkili. - -## Decision Types -- **Uyuşmazlık**: İhale süreç itirazları -- **Düzenleyici**: Mevzuat ve uygulama kararları -- **Mahkeme**: Mahkeme kararlarının uygulanması - -## Filtreleme Seçenekleri -- **Karar numarası**: 2024/UH.II-1766 formatında -- **Tarih aralığı**: Karar tarihi filtreleme -- **İhaleyi yapan idare**: Bakanlık, belediye, hastane, üniversite -- **Başvuru sahibi**: Şirket, firma adı -- **İhale konusu**: Mal, hizmet, yapım işi - -## Sayfalanmış İçerik Özelliği -5.000 karakterlik sayfalar halinde Markdown formatında sunulur. - -## Usage Scenarios -- **İhale hukuku**: Kamu alımları, süreç kuralları -- **Başvuru hazırlığı**: Benzer davalar, emsal kararlar -- **Mevzuat yorumu**: Kamu İhale Kanunu uygulaması -- **İtiraz stratejisi**: Başarılı itiraz örnekleri - -## İhale Süreç Aşamaları -1. **İhale öncesi**: İlan, şartname hazırlığı -2. **İhale aşaması**: Teklif verme, değerlendirme -3. **İhale sonrası**: Sonuç bildirimi, itirazlar -4. **Sözleşme**: İmza, uygulama - -## Parameter Details -### search_kik_decisions -- **karar_tipi**: Decision type - "rbUyusmazlik" (disputes), "rbDuzenleyici" (regulatory), "rbMahkeme" (court) -- **karar_no**: Decision number (e.g., '2024/UH.II-1766') -- **karar_tarihi_baslangic**: Decision start date (DD.MM.YYYY format) -- **karar_tarihi_bitis**: Decision end date (DD.MM.YYYY format) -- **basvuru_sahibi**: Applicant name/company -- **ihaleyi_yapan_idare**: Procuring entity (ministry, municipality, etc.) -- **basvuru_konusu_ihale**: Tender subject/description -- **karar_metni**: Text search with operators: +word (AND), -word (exclude) -- **yil**: Decision year -- **resmi_gazete_tarihi**: Official Gazette date (DD.MM.YYYY) -- **resmi_gazete_sayisi**: Official Gazette number -- **page**: Results page number - -### get_kik_document_markdown -- **karar_id**: Base64 encoded decision identifier from search results -- **page_number**: Page number for paginated content (1-indexed, default: 1) - -## Best Practices -1. **İhale türü**: Açık, belli istekliler arası, pazarlık -2. **Süreç aşaması**: Hangi aşamada sorun olduğu -3. **Hukuki dayanak**: İlgili KİK kanun maddesi -4. **Sayfa yönetimi**: Uzun kararları bölümler halinde okuyun -""" - -@app.resource("docs://tools/rekabet") -async def get_rekabet_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Rekabet Kurumu (Competition Authority) Tools Documentation - -## Kurum Konumu -Rekabet hukuku ihlallerini inceleyen ve ceza veren idari otorite. Rekabet Kanunu kapsamında yetkili. - -## Decision Types -- **Birleşme ve Devralma**: Şirket satın almaları, füzyonlar -- **Rekabet İhlali**: Anlaşma, hakim durum kötüye kullanımı -- **Menfi Tespit ve Muafiyet**: İhlal yok kararları, muafiyetler -- **Özelleştirme**: Kamu şirketleri satışı onayları - -## Filtreleme Özellikleri -- **PDF metin arama**: Tam metin içinde kelime arama -- **Karar türü**: Spesifik kategori seçimi -- **Tarih aralığı**: 1997'den günümüze karar arşivi -- **Sektör**: Telekomünikasyon, bankacılık, enerji, perakende - -## Rekabet Hukuku Temel Kavramları -- **Hakim durum**: Pazar gücü -- **Kartel**: Fiyat anlaşması -- **Dikey anlaşmalar**: Tedarikci-bayi ilişkileri -- **Konsantrasyon**: Birleşme işlemleri - -## Usage Scenarios -- **Antitrust araştırması**: Tekelleşme, kartel soruşturmaları -- **Birleşme incelemesi**: M&A transaction değerlendirmesi -- **Sektör analizi**: Belirli pazarlardaki rekabet durumu -- **Ceza hesaplama**: İhlal cezası örnekleri - -## Sektörel Uzmanlık Alanları -1. **Telekomünikasyon**: Operatör rekabeti -2. **Enerji**: Elektrik, doğalgaz piyasası -3. **Finans**: Bankacılık, sigorta -4. **Perakende**: Zincir mağazalar -5. **İnşaat**: Müteahhitlik sektörü - -## Parameter Details -### search_rekabet_kurumu_decisions -- **sayfaAdi**: Search in decision title (Başlık) -- **YayinlanmaTarihi**: Publication date (DD.MM.YYYY format) -- **PdfText**: Search text. For exact phrases use double quotes: "vertical agreement" -- **KararTuru**: Decision type - "Birleşme ve Devralma", "Rekabet İhlali", etc. -- **KararSayisi**: Decision number (Karar Sayısı) -- **KararTarihi**: Decision date (DD.MM.YYYY format) -- **page**: Page number for results list - -### get_rekabet_kurumu_document -- **karar_id**: GUID from search results -- **page_number**: Requested page for Markdown content (1-indexed, default: 1) - -## Best Practices -1. **Sektör odaklı**: İlgili sektörde arama yapın -2. **Karar türü seçimi**: İhtiyacınıza uygun kategori -3. **Güncel mevzuat**: Mevzuat değişiklikleri takibi -4. **Sayfa yönetimi**: Uzun analizleri bölümler halinde -""" - -@app.resource("docs://tools/bedesten_unified") -async def get_bedesten_unified_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Bedesten API Mahkemeleri Tools Documentation - -## Bedesten API Sistemi -bedesten.adalet.gov.tr üzerinden Türk adalet sistemi hiyerarşisindeki mahkemelere erişim. - -## Mahkeme Hiyerarşisi Kapsamı - -### 1. Yerel Hukuk Mahkemeleri (Local Civil Courts) -**Tool**: search_yerel_hukuk_bedesten -- **Konum**: İlk derece mahkemeler -- **Yetki**: Hukuki uyuşmazlıklar (sözleşme, tazminat, mülkiyet) -- **Önem**: Toplumun günlük hukuki sorunları - -### 2. İstinaf Hukuk Mahkemeleri (Civil Courts of Appeals) -**Tool**: search_istinaf_hukuk_bedesten -- **Konum**: Orta derece (Yerel -> İstinaf -> Yargıtay) -- **Yetki**: Yerel mahkeme kararlarına itiraz -- **Önem**: Temyiz öncesi son kontrol - -### 3. Kanun Yararına Bozma (KYB) -**Tool**: search_kyb_bedesten -- **Konum**: Olağanüstü kanun yolu -- **Başvuru sahibi**: Cumhuriyet Başsavcılığı -- **Amaç**: Hukuka aykırı kararları düzeltme -- **Özellik**: Sanık aleyhine olsa bile hukuk yararına - -## Ortak Bedesten API Özellikleri - -### Tarih Filtreleme (ISO 8601) -``` -Başlangıç: kararTarihiStart="2024-01-01T00:00:00.000Z" -Bitiş: kararTarihiEnd="2024-12-31T23:59:59.999Z" -Tek gün: "2024-06-25T00:00:00.000Z" - "2024-06-25T23:59:59.999Z" -``` - -### Kesin Cümle Arama -``` -Normal: phrase="sözleşme ihlali" (kelimeler ayrı ayrı) -Kesin: phrase="\"sözleşme ihlali\"" (tam cümle) -``` - -### Sayfalama -- **pageSize**: 1-100 arası sonuç sayısı -- **pageNumber**: Sayfa numarası (1'den başlar) - -## Mahkeme Özellikleri - -### Yerel Hukuk Mahkemeleri -**Yaygın Dava Türleri**: -- Sözleşme ihlali davaları -- Tazminat talepleri -- Mülkiyet uyuşmazlıkları -- Aile hukuku (boşanma, nafaka) -- Ticari uyuşmazlıklar (küçük-orta ölçek) - -**Kullanım Senaryoları**: -- Günlük hukuki sorunlar -- Vatandaş hakları -- Ticaret hukuku temelleri -- İcra takipleri - -### İstinaf Hukuk Mahkemeleri -**İnceleme Kapsamı**: -- Yerel mahkeme kararlarının kontrolü -- Hukuki ve maddi hata arayışı -- Yeniden yargılama (sınırlı) - -**Kullanım Senaryoları**: -- Temyiz stratejisi gelişitirme -- İstinaf mahkemesi içtihatları -- Yerel-üst mahkeme uyumu analizi - -### Kanun Yararına Bozma (KYB) -**Başvuru Koşulları**: -- Kesinleşmiş mahkeme kararı -- Hukuka açık aykırılık -- Cumhuriyet Başsavcılığı başvurusu -- Sanık aleyhine sonuç doğurmama - -**Kullanım Senaryoları**: -- Sistematik hukuki hatalar -- İçtihat birliğini sağlama -- Hukuk güvenliği -- Nadir ve özel hukuki durumlar - -## Arama Stratejileri - -### Hiyerarşik Arama -``` -1. Yerel mahkeme -> Gündelik sorunlar -2. İstinaf -> Kompleks yorumlar -3. KYB -> İstisnai hukuki durumlar -``` - -### Kesin Terim Kullanımı -``` -Yerel: "\"sözleşme ihlali\"" -İstinaf: "\"temyiz incelemesi\"" -KYB: "\"kanun yararına bozma\"" -``` - -### Tarih Stratejisi -- **Son 2 yıl**: Güncel içtihat -- **5-10 yıl**: Yerleşik görüşler -- **Mevzuat değişikliği sonrası**: Yeni uygulamalar - -## Best Practices -1. **Hiyerarşi takibi**: Alt mahkemeden üst mahkemeye -2. **Kesin cümle**: Hukuki terimler için "\"terim\"" -3. **Tarih aralığı**: İlgili mevzuat dönemleri -4. **Cross-reference**: Aynı konuyu farklı seviyelerde -5. **Minimal sonuç**: KYB çok nadir, az sonuç beklenir - -## Document ID Formatı -Tüm Bedesten mahkemeleri documentId döndürür: -- **Format**: Alfanumerik string -- **Kullanım**: get_*_bedesten_document_markdown fonksiyonları -- **İçerik**: HTML/PDF -> Markdown conversion -""" - -@app.resource("docs://tools/sayistay") -async def get_sayistay_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# Sayıştay (Court of Accounts) Tools Documentation - -## Sayıştay'ın Konumu -Türkiye'nin en üst mali denetim organı. Kamu kaynaklarının kullanımını denetler ve mali disiplini sağlar. - -## Üç Tür Karar Sistemi - -### 1. Genel Kurul Kararları (Interpretive Rulings) -**Tool**: search_sayistay_genel_kurul -- **İşlev**: Mali mevzuat yorumlama -- **Kapsam**: 2006-2024 yılları arası -- **Özellik**: Bağlayıcı yorumlar - -**Filtreleme Seçenekleri**: -- **Karar numarası**: Spesifik karar arama -- **Tarih aralığı**: Başlangıç-bitiş tarihleri -- **Karar tamamı**: Tam metin arama (400 karakter) - -### 2. Temyiz Kurulu Kararları (Appeals Board) -**Tool**: search_sayistay_temyiz_kurulu -- **İşlev**: Daire kararlarına itiraz incelemesi -- **8 Daire Filtreleme**: Uzmanlık alanlarına göre - -**Daire Uzmanlaşmaları**: -- **1. Daire**: Genel bütçeli idareler -- **2. Daire**: Mahalli idareler -- **3. Daire**: Sosyal güvenlik kurumları -- **4. Daire**: KİT ve bağlı ortaklıklar -- **5. Daire**: Düzenleyici kuruluşlar -- **6. Daire**: Vakıflar, dernekler -- **7. Daire**: Üniversiteler, eğitim -- **8. Daire**: Yatırım projeleri - -**Filtreleme Seçenekleri**: -- **İdare türü**: Bakanlık, belediye, üniversite, KİT -- **Temyiz karar**: Tam metin arama -- **Konu sınıflandırması**: Harcama, gelir, taşınır-taşınmaz - -### 3. Daire Kararları (Chamber Decisions) -**Tool**: search_sayistay_daire -- **İşlev**: İlk derece denetim bulguları -- **8 Daire**: Aynı uzmanlaşma alanları - -**Filtreleme Seçenekleri**: -- **Yargılama dairesi**: 1-8 arası daire seçimi -- **Hesap yılı**: Mali yıl bazlı -- **Web karar metni**: İçerik arama - -## Ortak Özellikler - -### Sayfalanmış Markdown -Tüm Sayıştay belgeleri sayfalanmış format: -- **5.000 karakter** per sayfa -- **page_number**: Sayfa numarası -- **total_pages**: Toplam sayfa - -### Tarih Aralığı Desteği -- **Genel Kurul**: 2006-2024 (18 yıl) -- **Temyiz/Daire**: Mevcut veriler üzerinde - -## Usage Scenarios - -### Mali Mevzuat Araştırması -``` -Genel Kurul -> Hukuki yorum -Temyiz -> Uygulama detayları -Daire -> Spesifik örnekler -``` - -### Kamu Mali Yönetimi -- **Bütçe uygulama**: Harcama usulleri -- **İhale süreçleri**: Kamu alımları denetimi -- **Personel giderleri**: Özlük hakları mali boyutu -- **Yatırım projeleri**: Büyük ölçekli projeler - -### Kurumsal Denetim -- **KİT yönetimi**: Kamu iktisadi teşebbüsleri -- **Belediye maliyesi**: Yerel yönetim harcamaları -- **Üniversite bütçesi**: Yükseköğretim mali yönetimi -- **Sosyal güvenlik**: SGK, Bağ-Kur mali işlemleri - -## Arama Stratejileri - -### Hiyerarşik Yaklaşım -1. **Genel Kurul**: Konunun hukuki çerçevesi -2. **Temyiz**: Tartışmalı uygulamalar -3. **Daire**: Günlük uygulama örnekleri - -### Daire Bazlı Strateji -``` -Mali konu -> İlgili daire seçimi -> Derinlemesine arama -Örnek: KİT mali sorunları -> 4. Daire -``` - -### Tarih Odaklı Strateji -- **Son 2 yıl**: Güncel uygulamalar -- **5 yıl**: Yerleşik görüşler -- **2006-2024**: Tarihsel gelişim - -## Best Practices -1. **Daire uzmanlaşması**: İlgili kuruma uygun daire -2. **Hiyerarşik sıralama**: Genel Kurul -> Temyiz -> Daire -3. **Mali dönem**: Bütçe yılları bazında arama -4. **Teknik terimler**: Mali mevzuat terminolojisi -5. **Cross-reference**: Farklı seviyelerden görüş karşılaştırma - -## İdare Türü Kodları -- **1**: Genel bütçeli -- **2**: Özel bütçeli -- **3**: Düzenleyici kuruluşlar -- **4**: Mahalli idareler -- **5**: Sosyal güvenlik -- **6**: KİT -- **7**: Vakıf/dernek -- **8**: Diğer kamu kuruluşları -""" - -@app.resource("docs://tools/kvkk") -async def get_kvkk_tools_documentation() -> str: - """Get document content as Markdown.""" - return """ -# KVKK (Personal Data Protection Authority) Tools - -## Overview -KVKK (Kişisel Verilerin Korunması Kurulu) - Turkey's GDPR equivalent authority. - -## Search Features -- **Brave Search API**: Searches kvkk.gov.tr with Turkish terms -- **Site-targeted**: Auto `site:kvkk.gov.tr "karar özeti"` -- **Pagination**: page and pageSize parameters -- **5,000-char pages**: Paginated Markdown documents - -## Common Search Terms -**Violations**: "veri ihlali", "açık rıza", "idari para cezası" -**Compliance**: "GDPR uyum", "veri koruma", "güvenlik tedbirleri" -**Sectors**: "e-ticaret", "bankacılık", "sağlık", "mobil uygulama" - -## Key Decision Types -- **Fines**: Data breaches, consent violations -- **Compliance**: GDPR alignment, corporate policies -- **Breach notifications**: 24-hour rule violations - -## Usage Tips -1. Use Turkish legal terms for best results -2. Combine sector + violation type searches -3. Use page_number for long decisions -4. Focus on recent 2-3 years for current practices -""" - - # --- API Client Instances --- yargitay_client_instance = YargitayOfficialApiClient() danistay_client_instance = DanistayApiClient()