Upload flare-ui-tasarim.md

flare-ui-tasarim.md

@@ -468,4 +468,165 @@ 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
+
+### TTS/STT Test Senaryoları:
+
+**1. TTS Configuration:**
+- TTS Engine'i ElevenLabs'e ayarla
+- API key gir ve save et
+- Chat'te TTS özelliğini aktifle
+
+**2. Audio Generation:**
+- Bot yanıtlarının seslendirildiğini kontrol et
+- Play butonu işlevselliği
+- Waveform visualization
+- Ses kalitesi kontrolü
+
+**3. Multi-Engine Support:**
+- Farklı TTS motorları arasında geçiş
+- API key güvenliği
+- Hata durumlarının ele alınması
+
+### 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
+- TTS/STT API key'ler şifrelenmiş saklanır
+- Tüm LLM/TTS/STT 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
+
+### TTS Güvenlik:
+- API key şifreleme
+- Rate limiting
+- Concurrent request kontrolü
+- Audio dosya boyutu limitleri
+
+### 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
+- TTS için audio cache yönetimi
+
+## 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, GPT-4o-mini)
+- **TTS Integration**:
+  - ElevenLabs API
+  - Blaze (planned)
+- **STT Integration**:
+  - ElevenLabs (planned)
+  - Flicker (planned)
+- **Encryption**: Fernet (cloud_token/API key şifreleme)
+- **Audio Processing**: Web Audio API (waveform visualization)
+
+Bu güncellemelerle Flare Administration UI, hem Spark hem de GPT-4o desteği, TTS/STT entegrasyonu ile çok daha esnek ve güçlü bir orchestration platform yönetim arayüzü haline gelmiştir.