# The Therapist AI - Kullanıcı Yolculuğu ve Akış Dökümanı ## Sistem Bağlamı Bu PWA, 12 katmanlı AI orkestratör sistemiyle entegre çalışır: - Kriz tespiti (M-1) otomatik eskalasyon ile - Duygu analizi (M-3) valans/yoğunluk takibi - Bellek sistemi (M-5) semantik geri çağırma - Metodoloji seçimi (M-7) - BDT/ACT/Şema/Kişi Merkezli - Seanslar arası durum yönetimi - İnsan terapist (Servet) denetim kanalı --- ## Kullanıcı Personaları ### Birincil: "Destek Arayan" - **Profil**: 25-45 yaş arası, kaygı, stres veya hafif depresyon yaşayan yetişkinler - **Hedefler**: Erişilebilir psikolojik destek, kendini anlama, başa çıkma becerileri - **Bağlam**: Uygulamayı yolda, yatmadan önce, duygusal anlarda kullanır - **Teknoloji rahatlığı**: Orta-yüksek, mesajlaşma uygulamalarına aşina ### İkincil: "Sürdürüm Modu" - **Profil**: Devam eden terapiye sahip, seanslar arası destek isteyen kullanıcılar - **Hedefler**: Teknikleri pratik etme, ruh halini takip etme, ödev tamamlama - **Bağlam**: Yüz yüze terapiyi tamamlar --- ## Temel Kullanıcı Akışları ## Akış 1: İlk Kayıt (Onboarding) ``` ┌─────────────────────────────────────────────────────────────────┐ │ AÇILIŞ EKRANI │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ [The Therapist AI Logo] │ │ │ │ │ │ │ │ "Düşünceleriniz için güvenli bir alan" │ │ │ │ │ │ │ │ [Başla] butonu │ │ │ └─────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ BİLGİLENDİRME EKRANI │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ "Başlamadan önce..." │ │ │ │ │ │ │ │ ⚬ Yapay zeka destekli psikolojik destek │ │ │ │ ⚬ Uzman psikolog Servet Aşan denetiminde │ │ │ │ ⚬ Bu acil durum bakımının yerini tutmaz │ │ │ │ ⚬ Kriz anında sizi 182 ALO Psikiyatri'ye yönlendiririz │ │ │ │ │ │ │ │ [Anladım] butonu │ │ │ └─────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ HIZLI PROFİL KURULUMU │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ "Size nasıl hitap edeyim?" │ │ │ │ [İsim giriş alanı] │ │ │ │ │ │ │ │ "Bugün sizi buraya ne getirdi?" │ │ │ │ ○ Stres ve kaygıyla başa çıkmak │ │ │ │ ○ Zor duygularla çalışmak │ │ │ │ ○ Kendimi daha iyi anlamak │ │ │ │ ○ Sadece keşfetmek │ │ │ │ │ │ │ │ [Devam Et] butonu │ │ │ └─────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ İLK GÖRÜŞME BAŞLANGICI │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ [AI Avatar] │ │ │ │ │ │ │ │ "Merhaba [İsim], hoş geldiniz. Sizi dinlemek │ │ │ │ ve desteklemek için buradayım. Acele yok— │ │ │ │ size uygun olan hızda ilerleyebiliriz. │ │ │ │ │ │ │ │ Bugün aklınızda olanları benimle paylaşmak │ │ │ │ ister misiniz?" │ │ │ │ │ │ │ │ [Mesaj giriş alanı] [Gönder] │ │ │ └─────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - Profil kurulumu → Kullanıcı kaydı oluşturur, boş `session_state` başlatır - İlk mesaj → K-0'dan K-11'e kadar tetikler, intake aşaması (M-2) - Alliance skoru 5.0'dan başlar, katılıma göre ayarlanır --- ## Akış 2: Aktif Sohbet Seansı ``` ┌─────────────────────────────────────────────────────────────────┐ │ ◀ Geri Seans #4 [•••] Menü │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ [AI mesaj balonu] │ │ "Geçen sefer işte bunalmış hissettiğinizden │ │ bahsetmiştiniz. Bu hafta nasıl gitti?" │ │ │ │ [Kullanıcı mesaj balonu] │ │ "Açıkçası daha kötü. │ │ Salı günü panik │ │ atak geçirdim." │ │ │ │ [AI mesaj balonu] │ │ "Bu gerçekten zor olmuş olmalı. Bunu benimle │ │ paylaştığınız için memnunum. Salı günü olanları │ │ biraz daha anlatır mısınız?" │ │ │ │ │ │ [Duygu Seçici] (kapalı, dokunarak açılır) │ │ │ ├─────────────────────────────────────────────────────────────────┤ │ [Mesaj giriş alanı ] [🎤] [Gönder] │ └─────────────────────────────────────────────────────────────────┘ ``` ### Duygu Seçici Açık Durumu ``` ┌─────────────────────────────────────────────────────────────────┐ │ "Şu an nasıl hissediyorsunuz?" │ │ │ │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │ │ │ 😊 │ │ 😢 │ │ 😰 │ │ 😤 │ │ │ │Mutlu │ │Üzgün │ │Kaygılı│ │ Öfkeli│ │ │ └───────┘ └───────┘ └───────┘ └───────┘ │ │ │ │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │ │ │ 😌 │ │ 😴 │ │ 🙏 │ │ 😕 │ │ │ │Sakin │ │Yorgun │ │Minnet.│ │Kafası │ │ │ │ │ │ │ │ │ │Karışık│ │ │ └───────┘ └───────┘ └───────┘ └───────┘ │ │ │ │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │ │ │ 🌅 │ │ 😵 │ │ 😐 │ │ 🤗 │ │ │ │Umutlu │ │Bunalmış│ │ Nötr │ │Güvende│ │ │ └───────┘ └───────┘ └───────┘ └───────┘ │ │ │ │ Yoğunluk: [●───────────────] Düşük ←→ Yüksek │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - Duygu seçimi → M-3'e açık kullanıcı girdisi besler - Yoğunluk kaydırıcı → `yogunluk` 0-10 ölçeğine eşlenir - Seans sürekliliği → M-5 ilgili geçmiş içeriği getirir - Yazıyor göstergesi → M-6 zamanlama modülü tarafından kontrol edilir ### Sesli Mesaj Durumu ``` ┌─────────────────────────────────────────────────────────────────┐ │ │ │ ┌─────────────────────┐ │ │ │ ◉ Kayıt │ │ │ │ │ │ │ │ ▁▃▅▇▅▃▁▃▅▇▅▃▁ │ │ │ │ │ │ │ │ 0:12 │ │ │ └─────────────────────┘ │ │ │ │ [İptal] [Sesi Gönder] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - Ses → K-0 Whisper STT → temizlenmiş transkript → normal akış --- ## Akış 3: Seans Sonu ``` ┌─────────────────────────────────────────────────────────────────┐ │ SEANS ÖZETİ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ "Bugün paylaştıklarınız için teşekkürler, [İsim]." │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 📋 Bugünün Özeti │ │ │ │ │ │ │ │ Konuştuklarımız: │ │ │ │ • Panik atak deneyiminiz │ │ │ │ • İş baskısıyla bağlantısı │ │ │ │ • Deneyebileceğiniz bir topraklama tekniği │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 📝 Seanslar Arası Ödev │ │ │ │ │ │ │ │ Kaygının yükseldiğini hissettiğinizde │ │ │ │ 5-4-3-2-1 topraklama egzersizini deneyin. │ │ │ │ │ │ │ │ [Tamamlandığında İşaretle] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 🌡️ Bu seans nasıl hissettirdi? │ │ │ │ │ │ │ │ [😟] [😐] [🙂] [😊] [🤗] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ [Ana Sayfaya Dön] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - Özet → K-10 seans işleyici tarafından üretilir - Ödev → K-10 ödev oluşturma - Seans değerlendirmesi → Alliance skor ayarlamasına beslenir --- ## Akış 4: Kriz Tespiti ``` ┌─────────────────────────────────────────────────────────────────┐ │ ⚠️ KRİZ EKRANI │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌───────────────────────────────────────────┐ │ │ │ │ │ │ │ Şu an çok zor bir dönemden │ │ │ │ geçtiğinizi duyuyorum. │ │ │ │ │ │ │ │ Güvenliğiniz en önemli şey. │ │ │ │ │ │ │ └───────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 📞 182 ALO Psikiyatri │ │ │ │ Ücretsiz 7/24 kriz desteği │ │ │ │ │ │ │ │ [Şimdi Ara] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 🏥 En Yakın Acil Servis │ │ │ │ Yakınınızdaki konumları bulmak için dokunun │ │ │ │ │ │ │ │ [Acil Bakım Bul] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ │ │ "Bir danışman bilgilendirildi ve │ │ yakında sizinle iletişime geçebilir." │ │ │ │ [Kendimi daha güvende hissediyorum] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - M-1 risk_skoru ≥ 0.7 olduğunda tetiklenir - LLM yanıtı durdurulur (K-7 çağrılmaz) - Servet admin kanalına uyarı gönderilir - Seans veritabanında işaretlenir --- ## Akış 5: Seanslar Arası (Ana Sayfa) ``` ┌─────────────────────────────────────────────────────────────────┐ │ İyi akşamlar, [İsim] │ │ Yolculuğunuzun 4. seansı │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 💬 Görüşmeye Devam Et │ │ │ │ │ │ │ │ "Geçen sefer iş stresi ve topraklama tekniği │ │ │ │ öğrenmekten bahsetmiştik..." │ │ │ │ │ │ │ │ [Seansa Başla] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 📋 Ödeviniz │ │ │ │ │ │ │ │ ○ 5-4-3-2-1 topraklama pratiği (3 kez) │ │ │ │ ● İş tetikleyicileri hakkında günlük yaz [Tamamlandı] │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 🌡️ Ruh Hali Kontrolü │ │ │ │ │ │ │ │ Bugün nasıl hissediyorsunuz? │ │ │ │ │ │ │ │ [Ruh halini kaydet] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 📈 İlerlemeniz │ │ │ │ │ │ │ │ ▂▄▃▅▆▅▇ (7 günlük ruh hali trendi) │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ ├─────────────────────────────────────────────────────────────────┤ │ [🏠] [💬] [📊] [⚙️] │ │ Ana Sayfa Sohbet İlerleme Ayarlar │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - "Geçen sefer" metni → K-10 momentum kaydı - Ödev durumu → K-10 ödev durumu - Ruh hali kaydı → Saklanır, sonraki seansta M-3'e sunulur --- ## Akış 6: Hızlı Ruh Hali Kontrolü ``` ┌─────────────────────────────────────────────────────────────────┐ │ GÜNLÜK KONTROL │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ "Şu an nasıl hissediyorsunuz?" │ │ │ │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │ │ │ 😢 │ │ 😔 │ │ 😐 │ │ 🙂 │ │ 😊 │ │ │ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘ │ │ │ │ "Aklınızda ne var?" (isteğe bağlı) │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ [Kontrolü Kaydet] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Akış 7: İlerleme ve İçgörüler ``` ┌─────────────────────────────────────────────────────────────────┐ │ YOLCULUĞUNUZ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 📊 Zaman İçinde Ruh Haliniz │ │ │ │ │ │ │ │ ▁▂▃▂▄▅▄▅▆▅▇▆▇ │ │ │ │ ←─────────────────────────────────────────────────→ │ │ │ │ 2 hafta önce Bugün │ │ │ │ │ │ │ │ Ortalama: 6.2/10 (geçen haftadan +0.8) │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 🎯 Tamamlanan Seanslar │ │ │ │ │ │ │ │ [●] [●] [●] [●] [○] [○] [○] [○] │ │ │ │ 4 / 8 kilometre taşı │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 🌱 Gelişim Alanları │ │ │ │ │ │ │ │ İş-yaşam dengesi [████████░░] İlerliyor │ │ │ │ Kaygı yönetimi [██████░░░░] Geliştiriliyor │ │ │ │ Öz-şefkat [████░░░░░░] Başladı │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 💡 İçgörü │ │ │ │ │ │ │ │ "Hafta içi sabahları daha kaygılı hissetme │ │ │ │ eğilimindesiniz. Bunu keşfetmek faydalı olabilir." │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ ├─────────────────────────────────────────────────────────────────┤ │ [🏠] [💬] [📊] [⚙️] │ │ Ana Sayfa Sohbet İlerleme Ayarlar │ └─────────────────────────────────────────────────────────────────┘ ``` **Backend eşleşmesi:** - Ruh hali verileri → Günlük kontrollerden toplanır - Gelişim alanları → Vaka formülasyonundan türetilir - İçgörüler → K-10 örüntü analizi --- ## Ekran Envanteri | Ekran | Amaç | Birincil Aksiyon | |-------|------|------------------| | Açılış | Marka anı | Başla | | Bilgilendirme | Yasal/etik kurulum | Anladım | | Profil Kurulumu | İlk veri toplama | Devam Et | | Sohbet | Ana terapi deneyimi | Mesaj gönder | | Duygu Seçici | Açık duygu girdisi | Seç + yoğunluk | | Ses Kaydı | Sesli girdi | Sesi gönder | | Seans Sonu | Kapanış + ödev | Ana sayfaya dön | | Kriz | Güvenlik müdahalesi | 182 Ara | | Ana Sayfa | Seans merkezi | Seansa Başla | | Ruh Hali Kontrolü | Günlük takip | Kaydet | | İlerleme | İçgörüler ve trendler | Detayları gör | | Ayarlar | Yapılandırma | Çeşitli | --- ## Durum Makinesi: Seans Akışı ``` ┌───────────────┐ │ BEKLEMEDE │ │ (Ana Sayfa) │ └───────┬───────┘ │ [Seansa Başla] ▼ ┌───────────────┐ │ YÜKLEME │ │ K-1 yükler │ │ session_state│ └───────┬───────┘ │ ▼ ┌─────────────────────────────────────┐ │ AKTİF │ │ │ │ ┌──────────────────────────────┐ │ │ │ DİNLEME │ │ │ │ (Kullanıcı girdisi bekliyor)│ │ │ └──────────────┬───────────────┘ │ │ │ [Kullanıcı gönderir]│ │ ▼ │ │ ┌──────────────────────────────┐ │ │ │ İŞLEME │ │ │ │ K-2 → K-3 → K-4 → K-5 │ │ │ │ (Yazıyor göstergesi) │ │ │ └──────────────┬───────────────┘ │ │ │ │ │ ┌───────┴───────┐ │ │ ▼ ▼ │ │ ┌─────────┐ ┌───────────┐ │ │ │ YANITLA │ │ KRİZ │ │ │ │ K-7→K-9a│ │ M-1≥0.7 │ │ │ └────┬────┘ └─────┬─────┘ │ │ │ │ │ │ ▼ ▼ │ │ [DİNLEME'ye [Kriz Ekranı] │ │ geri dön] │ │ │ └─────────────────────────────────────┘ │ [/dur veya timeout] ▼ ┌───────────────┐ │ SONLANMA │ │ K-10 çalışır │ │ Özet gösterir│ └───────┬───────┘ │ ▼ ┌───────────────┐ │ BEKLEMEDE │ └───────────────┘ ``` --- ## Navigasyon Yapısı ``` ┌─────────────┐ │ Açılış │ └──────┬──────┘ │ ┌──────┴──────┐ │ Kayıt │ │ (3 ekran) │ └──────┬──────┘ │ ┌──────────────────────┼──────────────────────┐ │ │ │ ▼ ▼ ▼ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │ Ana Sayfa │◄────►│ Sohbet │◄────►│ İlerleme │ │ (Sekme 1) │ │ (Sekme 2) │ │ (Sekme 3) │ └───────┬───────┘ └───────┬───────┘ └───────────────┘ │ │ ▼ ▼ ┌───────────────┐ ┌───────────────┐ │ Ruh Hali │ │ Seans Sonu │ │ (Modal) │ │ (Modal) │ └───────────────┘ └───────────────┘ ┌───────────────┐ │ Ayarlar │ │ (Sekme 4) │ └───────────────┘ ``` --- ## Mikro-etkileşimler ve Animasyonlar ### Sohbet Balonları - AI mesajları: Soldan fade in (200ms ease-out) - Kullanıcı mesajları: Sağdan slide in (150ms ease-out) - Yazıyor göstergesi: Üç nokta pulse (M-6 kontrollü süre) ### Duygu Seçici - Duyguya dokun: Ölçek bounce (1.0 → 1.2 → 1.0, 200ms) - Seçili durum: Yumuşak parıltı halka animasyonu ### Seans Geçişleri - Seans başlangıcı: Yumuşak fade + yukarı kayma - Seans sonu: Özet kartı alttan yukarı kayar ### Kriz Ekranı - Anında: Animasyon gecikmesi yok (güvenlik öncelikli) - Arama butonunda pulse animasyonu --- ## Erişilebilirlik Gereksinimleri - **Dokunma hedefleri**: Minimum 44x44px (48px tercih edilir) - **Kontrast**: Metin için minimum 4.5:1 - **Hareket**: `prefers-reduced-motion` saygı göster - **Ekran okuyucu**: Tüm duyguların açıklayıcı etiketleri var - **Yazı tipi ölçekleme**: %200'e kadar sistem yazı tipi boyutunu destekle --- ## PWA-Özel Özellikler ### Çevrimdışı Destek - Ana sayfa ve statik varlıkları önbelleğe al - Çevrimdışıyken mesajları kuyruğa al, çevrimiçi olunca senkronize et - "Bağlanıyor..." durumu göster ### Push Bildirimleri - Günlük ruh hali kontrol hatırlatıcısı (kullanıcı yapılandırılabilir) - Ödev hatırlatıcısı (ayarlanmışsa) - "Servet ilerlemenizi inceledi" (isteğe bağlı) ### Kurulum İstemi - 2. seanstan sonra göster - "Daha kolay erişim için Ana Ekrana Ekle" --- ## Sonraki Adımlar 1. Figma/tasarım aracında detaylı wireframe'ler oluştur 2. Tasarım sistemi token'larıyla bileşen kütüphanesi oluştur 3. Ekran ekran React/Vue'da uygula 4. Backend API'ye bağlan (orkestratör endpoint'leri) 5. 5-10 katılımcıyla kullanıcı testi