Upload 2 files

flare-tasarim.md

@@ -8,6 +8,8 @@ Flare, Spark LLM motorunun üstünde çalışan, çok adımlı ve akıllı bir o
 ✅ Doğru parameter değerleri ile API çağrıları yapmak,
 ✅ API cevabını Spark üzerinden insanileştirilmiş metne dönüştürmek ve kullanıcıya iletmek,
 ✅ Her şeyi session bazında, state machine mantığında takip etmek.
+✅ TTS (Text-to-Speech) desteği ile bot yanıtlarını sesli olarak sunmak.
+✅ STT (Speech-to-Text) desteği ile kullanıcıdan sesli girdi almak (gelecek özellik).
 
 Bu yapı Parloa gibi sistemlerde kullanılan "flow engine + LLM + tool orchestration" yaklaşımına dayanır.
 
@@ -17,8 +19,9 @@ Flare, farklı LLM provider'larını desteklemek için abstraction layer kullan
 
 - **Spark (HuggingFace)**: On-premise ve HuggingFace cloud deployment'lar için
 - **GPT-4o (OpenAI)**: OpenAI API üzerinden GPT-4o modeli kullanımı için
+- **GPT-4o-mini (OpenAI)**: Düşük maliyetli alternatif için GPT-4o-mini modeli
 
-Work mode'a göre (`hfcloud`, `cloud`, `on-premise`, `gpt4o`) uygun LLM provider seçilir ve tüm LLM çağrıları bu abstraction üzerinden yapılır. Bu sayede farklı LLM'ler aynı intent detection, parameter extraction ve response generation mantığıyla çalışabilir.
+Work mode'a göre (`hfcloud`, `cloud`, `on-premise`, `gpt4o`, `gpt4o-mini`) uygun LLM provider seçilir ve tüm LLM çağrıları bu abstraction üzerinden yapılır. Bu sayede farklı LLM'ler aynı intent detection, parameter extraction ve response generation mantığıyla çalışabilir.
 
 # Spark Entegrasyonu
 
@@ -28,7 +31,7 @@ Spark'a gönderilecek tüm request'lerde header'a Authorization: Bearer <SPARK_T
 
 # GPT-4o Entegrasyonu
 
-Work mode `gpt4o` seçildiğinde, Spark yerine OpenAI API kullanılır. OpenAI API key, config.cloud_token alanında şifrelenmiş olarak saklanır (mevcut encryption_utils kullanılarak).
+Work mode `gpt4o` veya `gpt4o-mini` seçildiğinde, Spark yerine OpenAI API kullanılır. OpenAI API key, config.cloud_token alanında şifrelenmiş olarak saklanır (mevcut encryption_utils kullanılarak).
 
 GPT-4o için özel konfigürasyonlar:
 - Model seçimi: gpt-4o veya gpt-4o-mini
@@ -36,6 +39,40 @@ GPT-4o için özel konfigürasyonlar:
 - Max tokens: Response uzunluğu limiti
 - System prompt ve conversation history OpenAI format'ına dönüştürülür
 
+**Maliyet Optimizasyonu**: 
+- gpt-4o: ~$0.01-0.03 per konuşma
+- gpt-4o-mini: ~$0.001-0.003 per konuşma (10x daha ucuz)
+
+# TTS/STT Entegrasyonu
+
+Flare, sesli etkileşim için TTS (Text-to-Speech) ve STT (Speech-to-Text) motorlarını destekler:
+
+## TTS (Text-to-Speech)
+Desteklenen motorlar:
+- **ElevenLabs**: Yüksek kaliteli, çok dilli TTS desteği
+- **Blaze**: Alternatif TTS motoru (yakında)
+- **No TTS**: TTS devre dışı
+
+TTS Konfigürasyonu service_config.jsonc içinde:
+- `tts_engine`: Kullanılacak motor ("no_tts", "elevenlabs", "blaze")
+- `tts_engine_api_key`: Motor API anahtarı (şifrelenmiş)
+
+## STT (Speech-to-Text)
+Desteklenen motorlar:
+- **ElevenLabs**: Sesli girdi desteği
+- **Flicker**: Alternatif STT motoru (yakında)
+- **No STT**: STT devre dışı
+
+STT Konfigürasyonu:
+- `stt_engine`: Kullanılacak motor
+- `stt_engine_api_key`: Motor API anahtarı (şifrelenmiş)
+
+## Chat'te TTS Kullanımı
+1. Chat başlatılırken "Use TTS" seçeneği işaretlenebilir
+2. Bot yanıtları otomatik olarak TTS ile seslendirilebilir
+3. Her mesaj için ayrı ses dosyası üretilir ve oynatılabilir
+4. Ses oynatma sırasında waveform visualizasyon gösterilir
+
 # Internal Prompt Mekanizması
 
 Flare servisi, tüm LLM isteklerinde kullanılmak üzere merkezi bir internal_prompt tanımına sahiptir. Bu prompt, service_config.jsonc dosyasında config.internal_prompt olarak saklanır ve her intent detection işleminde project version'daki general_prompt'un başına otomatik olarak eklenir.
@@ -211,6 +248,8 @@ Parametre tanımlarında "date" type'ı desteklenmektedir. Date parametreleri:
 | LLM Interface | Farklı LLM provider'larını abstract eden katman |
 | Spark LLM | HuggingFace Spark servisi ile iletişim |
 | GPT-4o LLM | OpenAI API ile iletişim |
+| TTS Interface | Farklı TTS provider'larını abstract eden katman |
+| ElevenLabs TTS | ElevenLabs TTS servisi ile iletişim |
 | Flare Session Manager | Her kullanıcı için session ve state takibi |
 | Flare Prompt Engine | Her aşamada LLM'e gönderilecek uygun system prompt'u dinamik hazırlayan yapı |
 | API Connector | Tanımlı API'lere parametrelerle çağrı yapan, auth/refresh yöneten katman |
@@ -232,6 +271,11 @@ Parametre tanımlarında "date" type'ı desteklenmektedir. Date parametreleri:
 ✅ Internal prompt sistemi
 ✅ Date type desteği
 ✅ Multi-provider support
+✅ TTS (Text-to-Speech) entegrasyonu
+✅ ElevenLabs TTS provider
+⏳ STT (Speech-to-Text) entegrasyonu
+⏳ Blaze TTS provider
+⏳ Flicker STT provider
 
 # 🔑 Önemli Notlar (Unutulmaması Gerekenler)
 
@@ -243,6 +287,8 @@ Parametre tanımlarında "date" type'ı desteklenmektedir. Date parametreleri:
 6. API token yönetimi ve refresh mekanizması, Flare içinde güvenli ve izlenebilir şekilde tutulmalı.
 7. GPT-4o kullanımında token maliyetleri göz önünde bulundurulmalı, conversation history sınırlandırılmalı.
 8. Farklı LLM'lerin response formatları normalize edilmeli (#DETECTED_INTENT ve #PARAMETERS formatları korunmalı).
+9. TTS kullanımında API key güvenliği ve maliyet kontrolü sağlanmalı.
+10. Tüm API key'ler (OpenAI, ElevenLabs, vb.) şifrelenmiş olarak saklanmalı.
 
 # Servis Konfigürasyonu
 
@@ -254,7 +300,7 @@ Flare'in tanımlarını tutan bir document database gibi kullanacağımız servi
   // FLARE GLOBAL CONFIGURATION
   // =====================================================
   "config": {
-    "work_mode": "hfcloud", // "hfcloud" | "cloud" | "on-premise" | "gpt4o"
+    "work_mode": "hfcloud", // "hfcloud" | "cloud" | "on-premise" | "gpt4o" | "gpt4o-mini"
     "cloud_token": "<your cloud token or OpenAI API key>", // work_mode'a göre Spark token veya OpenAI API key (şifrelenmiş)
     "spark_endpoint": "https://ucsturkey-spark.hf.space", // Spark servisi URL (GPT mode'da kullanılmaz)
     "internal_prompt": "⚠️ **NEVER output \"#DETECTED_INTENT:\"...", // Merkezi LLM kuralları
@@ -262,6 +308,12 @@ Flare'in tanımlarını tutan bir document database gibi kullanacağımız servi
     "last_update_date": "2025-06-08T12:00:00.000Z", // Race condition kontrolü için
     "last_update_user": "admin",
     
+    // === TTS/STT Configuration ==============
+    "tts_engine": "no_tts", // "no_tts" | "elevenlabs" | "blaze"
+    "tts_engine_api_key": "enc:...", // Şifrelenmiş TTS API key
+    "stt_engine": "no_stt", // "no_stt" | "elevenlabs" | "flicker"
+    "stt_engine_api_key": "enc:...", // Şifrelenmiş STT API key
+    
     // === Login Users (bcrypt hash + salt): Flare UI kullanılabilecek user'lar ==============
     "users": [
       {
@@ -321,7 +373,7 @@ Flare'in tanımlarını tutan bir document database gibi kullanacağımız servi
             "use_fine_tune": false, // LoRA fine-tune model kullanılma durumu
             "fine_tune_zip": "", // use_fine_tune: true ise, kullanılacak LoRA adapter zip'in URL'i
             
-            // GPT-4o mode için (work_mode = "gpt4o" olduğunda kullanılır):
+            // GPT-4o mode için (work_mode = "gpt4o" veya "gpt4o-mini" olduğunda kullanılır):
             "gpt_model": "gpt-4o", // "gpt-4o" | "gpt-4o-mini"
             "gpt_temperature": 0.3, // 0-2 arası
             "gpt_max_tokens": 512 // Maximum response token sayısı

flare-ui-tasarim.md

@@ -8,7 +8,7 @@ Flare Admin ekranlarında; proje tanımlama, mevcut projeyi düzenleme, projeye
 
 Document database olarak Flare'in service_config.jsonc dosyasını kullanır. Tüm tanım, düzenleme, silme ve listeleme işlemlerini bu dosya üzerinde yapar.
 
-Flare Admin, Flare backend servisi üzerinden Spark veya GPT-4o ile entegre çalışır.
+Flare Admin, Flare backend servisi üzerinden Spark veya GPT-4o ile entegre çalışır. Ayrıca TTS (Text-to-Speech) ve STT (Speech-to-Text) motorları ile sesli etkileşim desteği sunar.
 
 ## Genel Kurallar
 
@@ -85,6 +85,12 @@ Flare backend'de Flare Admin UI işleyişi için bazı eklemeler yapılması ger
 - POST /api/start_session - Chat session başlat
 - POST /api/chat - Mesaj gönder/al (Header: X-Session-ID)
 
+#### TTS/STT Endpoint'leri
+
+- POST /api/tts/generate - Text'ten ses üret
+- GET /api/tts/voices - Desteklenen ses listesi
+- POST /api/stt/transcribe - Sesten text'e dönüştür (gelecek özellik)
+
 #### Ek Yardımcı Endpoint'ler
 
 - POST /api/validate/regex - Regex pattern validasyonu
@@ -103,12 +109,18 @@ Flare backend'de Flare Admin UI işleyişi için bazı eklemeler yapılması ger
 {
   "config": {
     // Mevcut alanlar...
-    "work_mode": "hfcloud", // "hfcloud" | "cloud" | "on-premise" | "gpt4o" - Yeni: gpt4o desteği
+    "work_mode": "hfcloud", // "hfcloud" | "cloud" | "on-premise" | "gpt4o" | "gpt4o-mini" - Yeni: gpt4o desteği
     "cloud_token": "", // work_mode'a göre Spark token veya OpenAI API key (şifrelenmiş)
     "internal_prompt": "⚠️ **NEVER output \"#DETECTED_INTENT:\"...", // Yeni
     "project_id_counter": 1, // Yeni
     "last_update_date": "2025-06-08T12:00:00.000Z", // Yeni
-    "last_update_user": "admin" // Yeni
+    "last_update_user": "admin", // Yeni
+    
+    // TTS/STT Configuration - Yeni
+    "tts_engine": "no_tts", // "no_tts" | "elevenlabs" | "blaze"
+    "tts_engine_api_key": "enc:...", // Şifrelenmiş TTS API key
+    "stt_engine": "no_stt", // "no_stt" | "elevenlabs" | "flicker"
+    "stt_engine_api_key": "enc:..." // Şifrelenmiş STT API key
   },
   
   "projects": [{
@@ -135,7 +147,7 @@ Flare backend'de Flare Admin UI işleyişi için bazı eklemeler yapılması ger
         "use_fine_tune": false,
         "fine_tune_zip": "",
         
-        // GPT-4o mode için (work_mode = "gpt4o" olduğunda kullanılır):
+        // GPT-4o mode için (work_mode = "gpt4o" veya "gpt4o-mini" olduğunda kullanılır):
         "gpt_model": "gpt-4o", // "gpt-4o" | "gpt-4o-mini"
         "gpt_temperature": 0.3, // 0-2 arası
         "gpt_max_tokens": 512 // Maximum response token sayısı
@@ -198,12 +210,16 @@ Bu tab penceresinde login olan kullanıcı mevcut şifresini değiştirebilir. E
 
 Bu tab'da aşağıdaki alanlar bulunur:
 
-- **Work Mode**: Seçenekleri **hfcloud**, **cloud**, **on-premise** ve **gpt4o** olan bir combo. Zorunlu.
+- **Work Mode**: Seçenekleri **hfcloud**, **cloud**, **on-premise**, **gpt4o** ve **gpt4o-mini** olan bir combo. Zorunlu.
 - **Cloud Token / OpenAI API Key** (maskeli): 
   - Work Mode **on-premise** seçildiğinde disable olur.
-  - Work Mode **gpt4o** seçildiğinde label "OpenAI API Key" olarak değişir
+  - Work Mode **gpt4o** veya **gpt4o-mini** seçildiğinde label "OpenAI API Key" olarak değişir
   - Diğer modlarda "Cloud Token" olarak görünür
 - **Spark Endpoint**: URL formatında. GPT-4o mode hariç zorunlu. Yanında "Test Connection" butonu. GPT-4o seçildiğinde disable olur.
+- **TTS Engine**: Seçenekleri **no_tts**, **elevenlabs**, **blaze** olan combo.
+- **TTS API Key** (maskeli): TTS Engine **no_tts** dışında bir değer seçildiğinde zorunlu olur.
+- **STT Engine**: Seçenekleri **no_stt**, **elevenlabs**, **flicker** olan combo.
+- **STT API Key** (maskeli): STT Engine **no_stt** dışında bir değer seçildiğinde zorunlu olur.
 - **Internal System Prompt**: Expansion panel içinde multi-line textarea. LLM'in tüm projeler için kullanacağı temel kuralları içerir. Placeholder'lar:
   - <intent names>: Runtime'da intent listesiyle değiştirilir
   - <intent captions>: Intent caption'larıyla değiştirilir
@@ -211,13 +227,16 @@ Bu tab'da aşağıdaki alanlar bulunur:
 - Save butonu
 - Reload from Spark butonu: Spark'tan güncel config'i çeker (GPT mode'da disable)
 
-**GPT-4o Mode Uyarısı**: Work mode GPT-4o seçildiğinde bir info alert gösterilir:
+**GPT-4o Mode Uyarısı**: Work mode GPT-4o veya GPT-4o-mini seçildiğinde bir info alert gösterilir:
 ```
 ℹ️ GPT-4o mode uses OpenAI's API which has usage-based pricing. 
    Please ensure you have sufficient credits in your OpenAI account.
-   Approximate cost: $0.01-0.03 per conversation turn.
+   Approximate cost: $0.01-0.03 per conversation turn for GPT-4o.
+   Approximate cost: $0.001-0.003 per conversation turn for GPT-4o-mini.
 ```
 
+**TTS/STT Configuration**: Work mode ne olursa olsun TTS ve STT motorları konfigüre edilebilir. TTS motorları bot yanıtlarını seslendirmek, STT motorları ise kullanıcıdan sesli girdi almak için kullanılır.
+
 ### 3. APIs Tab'ı
 
 Tab açıldığında, üstte bir toolbar bulunur:
@@ -271,13 +290,16 @@ Flare chat sistemini test etmek için kullanılır.
 
 **İşleyiş:**
 1. **Project Selection**: Enabled ve published version'u olan projeler listelenir
-2. **Start Chat**: Session başlatır, session_id alır
-3. **Chat Interface**:
+2. **TTS Option**: "Use TTS" checkbox'ı ile sesli yanıt özelliği aktifleştirilebilir (TTS konfigüre edilmişse)
+3. **Start Chat**: Session başlatır, session_id alır
+4. **Chat Interface**:
    - Mesaj history'si
    - Input alanı
    - Send butonu
    - Session bilgileri (ID, project)
-4. **End Session**: Chat'i sonlandırır
+   - TTS enabled ise her bot mesajı için play butonu
+   - Ses oynatılırken waveform visualizasyon
+5. **End Session**: Chat'i sonlandırır
 
 **Özellikler:**
 - Real-time mesajlaşma
@@ -285,6 +307,9 @@ Flare chat sistemini test etmek için kullanılır.
 - Auto-scroll
 - Error handling
 - Loading states
+- TTS desteği (konfigüre edilmişse)
+- Audio waveform visualization
+- Otomatik ses oynatma (opsiyonel)
 
 ### 6. Spark Integration Tab'ı
 
@@ -347,6 +372,7 @@ Bu tab'da sistemin end-to-end testi yapılabilir:
 - Backend Tests: API endpoint'leri, data integrity
 - Integration Tests: UI-Backend entegrasyonu
 - Spark Tests: LLM bağlantısı ve response kalitesi (GPT mode'da "GPT-4o Tests" olarak görünür)
+- TTS Tests: TTS motor bağlantısı ve ses üretimi (TTS konfigüre edilmişse)
 
 **Ekran Düzeni:**
 ```
@@ -364,6 +390,7 @@ Bu tab'da sistemin end-to-end testi yapılabilir:
 │     □ Race Conditions                       │
 │   □ Integration Tests (18 tests)            │
 │   □ LLM Tests (8 tests)                     │
+│   □ TTS Tests (5 tests)                     │
 ├─────────────────────────────────────────────┤
 │ Test Results:                               │
 │ ✓ Login with valid credentials - 120ms      │
@@ -441,132 +468,4 @@ Yeni alanlar eklendi:
 - Description: Proje açıklaması
 - Default Language: Varsayılan dil (tr, en, de, fr, es)
 - Supported Languages: Desteklenen diller (çoklu seçim)
-- Timezone: Saat dilimi (Europe/Istanbul, vb.)
-- Region: Bölge kodu (tr-TR, vb.)
-
-### Edit Version Dialog
-
-**LLM Configuration Tab'a GPT-4o Desteği:**
-
-Work mode'a göre conditional rendering:
-
-**GPT-4o Mode'da:**
-```
-┌─────────────────────────────────────┐
-│ GPT-4o Configuration                │
-├─────────────────────────────────────┤
-│ Model:                              │
-│ [▼ GPT-4o             ]            │
-│                                     │
-│ Temperature: (0 = Deterministic)    │
-│ [====|==============] 0.3           │
-│                                     │
-│ Max Tokens:                         │
-│ [512                 ]              │
-│                                     │
-│ ℹ️ Cost estimate: ~$0.02/request   │
-└─────────────────────────────────────┘
-```
-
-**Spark Mode'da (mevcut):**
-- Model Repository
-- Generation Config (detaylı parametreler)
-- Fine-tune options
-
-### Edit Intent Dialog
-
-[Mevcut içerik korunacak, değişiklik yok]
-
-### Edit Parameter Dialog
-
-Date type desteği eklendi:
-- Type combo'suna "date" seçeneği
-- Date formatı: YYYY-MM-DD (ISO format)
-- Türkçe tarih ifadeleri için özel extraction prompt'lar
-
-### Version Comparison Dialog
-
-[Mevcut içerik korunacak, değişiklik yok]
-
-## Flare Admin Test Planı
-
-[Mevcut test planına ek olarak:]
-
-### GPT-4o Integration Test Senaryoları:
-
-**1. Environment Configuration:**
-- Work mode'u GPT-4o'ya değiştir
-- OpenAI API key gir
-- Save et
-- Spark endpoint'in disable olduğunu kontrol et
-
-**2. Version Management:**
-- GPT-4o mode'da yeni version oluştur
-- LLM tab'ında sadece GPT config'lerinin göründüğünü doğrula
-- Model, temperature, max_tokens ayarla
-- Publish et
-
-**3. Spark Tab Behavior:**
-- GPT-4o mode'da Spark tab'ın disable olduğunu kontrol et
-- Bilgi mesajının göründüğünü doğrula
-
-**4. Chat Testing:**
-- GPT-4o kullanan proje ile chat başlat
-- Intent detection test et
-- Parameter extraction test et
-- Response kalitesini değerlendir
-
-**5. Cost Tracking:**
-- Chat sonrası tahmini maliyet gösterimini kontrol et
-- Token kullanım bilgilerini doğrula
-
-### Multi-Provider Switching:
-
-**1. Mode Değişimi:**
-- Spark → GPT-4o → Spark geçişleri yap
-- Her geçişte config'lerin korunduğunu kontrol et
-- Token/key bilgilerinin şifreli kaldığını doğrula
-
-**2. Project Compatibility:**
-- Aynı projeyi farklı modlarda test et
-- Intent ve parameter mantığının tutarlı çalıştığını doğrula
-
-## Güvenlik ve Performans
-
-### Token Yönetimi:
-- SPARK_TOKEN environment variable'dan alınır
-- OPENAI_API_KEY cloud_token alanında şifrelenmiş saklanır
-- Tüm LLM isteklerinde uygun Authorization header
-- Token rotation desteği
-
-### GPT-4o Özel Güvenlik:
-- API key asla plain text olarak loglanmaz
-- Rate limit handling
-- Cost monitoring ve alerting
-- Quota management
-
-### Race Condition Handling:
-- last_update_date kontrolü tüm CRUD işlemlerinde
-- Concurrent edit detection
-- Optimistic locking pattern
-
-### Session Management:
-- 30 dakika inactivity timeout
-- Session cleanup thread
-- Memory-efficient storage
-- GPT-4o için token count tracking
-
-## Teknoloji Stack
-
-- **Frontend**: Angular 17+ (standalone components)
-- **UI Framework**: Angular Material
-- **State Management**: RxJS
-- **Backend**: Python FastAPI
-- **Authentication**: JWT
-- **Database**: service_config.jsonc (document database pattern)
-- **LLM Integration**: 
-  - Spark servisi (HuggingFace)
-  - OpenAI API (GPT-4o)
-- **Encryption**: Fernet (cloud_token/API key şifreleme)
-
-Bu güncellemelerle Flare Administration UI, hem Spark hem de GPT-4o desteği ile çok daha esnek bir orchestration platform yönetim arayüzü haline gelmiştir.
+-