# Danışman Defteri (CounselFlow) - Kapsamlı Sistem & Mimari Dokümantasyonu (LLM Full Context) > Canlı Web Sitesi: https://danismandefteri.com > Ürün: Danışman Defteri (CounselFlow Multi-Tenant Clinic Management Platform) > Hedef Kitle: Psikologlar, Klinik Psikologlar, Aile ve Çift Danışmanları, Psikoterapistler, Çocuk & Ergen Danışmanları, Psikiyatri Merkezleri ve Ruh Sağlığı Klinikleri. > Lisans & Dağıtım: SaaS (Software as a Service) --- ## 1. Ürün Kimliği ve Vizyonu Danışman Defteri, ruh sağlığı profesyonellerinin danışan takip, randevu organizasyonu, klinik notları, genogram çizimi ve finansal kayıtlarını tek bir sakin, estetik ve güvenli platformda birleştirmek amacıyla tasarlanmıştır. Klasik hastane ve muayenehane yazılımlarının soğuk, bürokratik ve karmaşık arayüzlerinin aksine Danışman Defteri; "Serene Nordic" (dingin İskandinav ve Zen estetiği) tasarım diliyle danışman ve klinisyeni sakinleştirir, klinik operasyon yükünü minimize eder ve terapi mahremiyetini en yüksek seviyede korur. --- ## 2. Temel Fonksiyonel Modüller ### 2.1. Çok Kiracılı (Multi-Tenant) Klinik Çalışma Alanı - **Klinik İzolasyonu:** Her klinik bağımsız bir kiracıdır (tenant). Kliniklerin çalışma takvimleri, oda tanımları, terapist kadroları, seans türleri, fiyat politikaları ve danışan veri tabanı tamamen izoledir. - **Rol ve Yetkilendirme:** - `OWNER` (Klinik Sahibi): Tam yetkili yönetici. Finans, ekip, entegrasyon ve klinik ayarlarını yönetir. - `COUNSELOR` (Danışman / Terapist): Yalnızca kendi danışanlarını, seanslarını, takvimini ve izin verilen klinik notlarını görüntüler. - `ASSISTANT` (Asistan / Sekreterya): Randevu planlama, danışan karşılama ve ödeme işlemlerini yürütür; terapistlerin gizli klinik/SOAP notlarına kesinlikle erişemez. ### 2.2. Randevu Planlama ve Esnek Takvim Yönetimi - **Görsel Ajanda:** Haftalık, günlük ve aylık Serene Nordic ajanda görünümü. - **Dinamik Seans Türleri (`SessionType`):** Sabit seans tipleri yerine klinik bazında tamamen özelleştirilebilen seans türleri (Bireysel Terapi, Çift Terapisi, Çocuk & Ergen Seansı, İlk Adım Görüşmesi, vb.). Her seans türü için süre (dakika), tampon/mola süresi (buffer time), online/yüzyüze uygunluğu, ücret ve renk kodu tanımlanabilir. - **Tampon Süre (Buffer Time):** Seanslar arasında terapistin dinlenmesi, not alması veya hazırlanması için otomatik tampon süre bloklama (ör. 10 veya 15 dk). - **Müsaitlik Slotları (Availabilities):** Terapistlerin haftalık çalışma gün ve saatleri esnek şekilde yapılandırılabilir. - **Çakışma Koruması:** Aynı anda aynı danışmana veya terapiste çift randevu verilmesini önleyen sunucu taraflı atomik doğrulama. ### 2.3. Online Randevu ve Dış Web Sitelerine Gömülebilir (Embed) Randevu Widget'ı - **Doğrudan Rezervasyon:** Danışanlar kliniğin doğrudan bağlantısı (`https://danismandefteri.com/{klinik-slug}/book`) üzerinden adım adım seans türü, danışman, tarih ve saat seçerek randevu alabilir. - **Iframe Embed Desteği:** Klinisyenler veya danışmanlık merkezleri kendi kişisel ya da kurumsal web sitelerine (WordPress, Webflow, Laravel, Wix, HTML, vb.) şu tek satır kodla randevu modülünü gömebilir: ```html ``` - **Akıllı Yeniden Boyutlandırma (postMessage API):** Adım geçişlerinde içerik boyu değiştikçe ana pencereye dinamik piksel yüksekliği iletilerek kaydırma çubuğu (scrollbar) oluşması engellenir. - **Tek Danışman Otomatik Atlama:** Klinikte tek bir danışman aktifse sistem terapist seçim adımını otomatik olarak atlar ve danışanı doğrudan takvime yönlendirir. ### 2.4. Şifreli SOAP Klinik Notları (Clinical Notes & SOAP Protocol) - **SOAP Standardı:** - **S (Subjective):** Danışanın öznel beyanı, geliş şikayeti ve duygudurumu. - **O (Objective):** Terapistin seanstaki gözlemleri, danışanın beden dili ve klinik bulgular. - **A (Assessment):** Terapistin klinik değerlendirmesi, hipotezi ve dinamik kavramsallaştırması. - **P (Plan):** Gelecek seans hedefleri, ev ödevleri ve terapi planı. - **Uçtan Uca Şifreleme (Encryption at Rest):** Klinik notlarının içerikleri veritabanında AES-256 algoritmasıyla şifreli saklanır. - **Üç Kademeli Mahremiyet İzolasyonu (`note_scope`):** - `GENERAL`: Tüm klinik ekibinin görebileceği genel idari notlar. - `FAMILY_GENERAL`: İlgili aile sürecine bakan danışmanların gördüğü notlar. - `INDIVIDUAL_PRIVATE`: Sadece notu yazan danışmanın görebileceği özel terapi notu. Aynı klinikteki diğer meslektaşlar veya asistanlar bu nota erişemez (403 Forbidden). ### 2.5. McGoldrick Klinik Genogram Stüdyosu & Bowen Sistemik Analiz - **Vektörel SVG Çizim Alanı:** Pan, zoom ve sürükle-bırak desteği sunan etkileşimli genogram motoru. - **Monica McGoldrick Standartları:** - Erkek (Kare), Kadın (Daire), İndeks Danışan (Çift çizgi), Vefat (X), Hamilelik ve Düşük sembolleri. - Evlilik, boşanma, ayrılık, birlikte yaşama ilişkisel hatları. - Çatışmalı, kopuk, aşırı yakın (enmeshed) ve mesafeli ilişkisel bağ göstergeleri. - **Murray Bowen Sistemik Teori Entegrasyonu:** Kuşaklararası döngüler, aile içi üçgenleşmeler (triangulation) ve duygusal kopuşların (emotional cutoff) görsel analizi. - **Klinik Dosya Dışa Aktarımı:** Tek tıkla yüksek çözünürlüklü SVG veya PNG export alarak adli/resmi dosyalara veya seans dosyasına ekleme. ### 2.6. Otomatik Aile Tanıma & Yaşam Öyküsü Dijital Form Akışı - **Tek Kullanımlık Güvenli Bağlantılar (`/f/{token}`):** Danışanın şifre girmesine veya hesap açmasına gerek kalmadan, telefonuna SMS, WhatsApp veya e-posta ile giden güvenli sihirli form bağlantısı. - **Form Çeşitleri:** - Aile Tanıma Formu (Family Intake Form) - Yaşam Öyküsü Formu (Life Story Form) - Seans Değerlendirme Formu (Session Evaluation) - **Klinik Panele Anında Aktarım:** Danışan formu doldurup onayladığında cevaplar otomatik olarak danışanın dosyasında yapılandırılmış kartlara işlenir. - **Otomatik Hatırlatıcılar:** Randevu saatine 72 saat ve 48 saat kala doldurulmamış formlar için sistemsel otomatik hatırlatma bildirimleri. ### 2.7. Akıllı WhatsApp ve E-Posta Bildirim Motoru - **Resmi WhatsApp API:** Güvenilir, kurumsal onaylı mesajlaşma altyapısı (Spam riski taşımaz). - **Kademeli Hatırlatma Stratejisi:** - Yeni/İlk Seanslar: Randevudan 24 saat önce ve seans sabahı 09:00'da açık adres, yol tarifi ve randevu teyit mesajı. - Rutin Seanslar (5+ seans devam eden danışanlar): Danışanı mesajla boğmamak adına yalnızca randevuya 3 saat kala zarif bir hatırlatma. - **No-Show Azaltma:** Randevu teyitleri ve zamanında bilgilendirme ile seansa gelmeme (no-show) oranını %70'e varan oranda düşürür. ### 2.8. Finans, Tahsilat ve Makbuz Yönetimi - **PayTR Güvenli Ödeme Geçidi:** Kredi kartı ve banka kartı ile online rezervasyon tahsilatı (iFrame ve 3D Secure desteği). - **Klinikte Ödeme ve Havale/EFT:** Esnek ödeme türleri, IBAN ve hesap bilgisi gösterme, klinik personelinin "Ödendi İşaretle" aksiyonu. - **Resmi Tahsilat Makbuzu (PDF):** Her tamamlanan ödeme için mali ve kurumsal standartlara uygun, PDF formatında makbuz çıktısı üretme. --- ## 3. Güvenlik, Veri Koruma ve Hukuki Uyumluluk - **KVKK (Kişisel Verilerin Korunması Kanunu) Uyumu:** Özel nitelikli sağlık ve terapi verilerinin işlenmesinde açık rıza metinleri, aydınlatma bildirimleri ve yasal saklama süreleri tam olarak uygulanır. - **Uçtan Uca Şifreleme:** Danışan notları ve hassas anamnez verileri `encrypted` veritabanı alanlarında tutulur. - **CSRF ve XSS Koruması:** Tüm form ve API uçlarında sıkı CSRF jetonları ve girdi filtreleme. - **Güvenlik İletişimi:** RFC 9116 uyumlu güvenlik iletişim protokolü `https://danismandefteri.com/.well-known/security.txt` altında yayınlanmaktadır. --- ## 4. Teknik Mimari ve Altyapı - **Programlama Dili & Çalışma Zamanı:** PHP 8.4 - **Backend Framework:** Laravel 13 - **Yönetim ve Panel Katmanı:** Filament 5 & Livewire 4 - **Ön Yüz ve Tasarım:** Bootstrap 5.3 (Serene Nordic UI), SCSS, Vite - **Veritabanı:** MySQL / PostgreSQL - **Test ve Güvence:** PHPUnit 12 (830+ test, %100 Feature controller coverage) - **Sunucu & Ağ:** Nginx 1.24, PHP-FPM, HTTP/2, Let's Encrypt SSL --- ## 5. Doğrulanmış Uç Noktalar ve URL Haritası - Ana Sayfa: `https://danismandefteri.com/` - Kayıt Ol: `https://danismandefteri.com/register` - Giriş Yap: `https://danismandefteri.com/login` - Şifremi Unuttum: `https://danismandefteri.com/forgot-password` - XML Sitemap: `https://danismandefteri.com/sitemap.xml` - LLM Executive Context: `https://danismandefteri.com/llms.txt` - LLM Deep Context: `https://danismandefteri.com/llms-full.txt` - Güvenlik Kartı: `https://danismandefteri.com/.well-known/security.txt` - Künye & Ekip: `https://danismandefteri.com/humans.txt` - Web Manifest: `https://danismandefteri.com/manifest.webmanifest` - Örnek Online Randevu: `https://danismandefteri.com/{klinik-slug}/book` - Örnek Embed Randevu: `https://danismandefteri.com/{klinik-slug}/embed/book` --- ## 6. Sıkça Sorulan Sorular ve Cevaplar (FAQ) ### S: Danışman Defteri kimler için uygundur? **C:** Bireysel çalışan psikologlar, aile danışmanları, psikoterapistler, çocuk-ergen uzmanları ve çoklu danışman kadrosuna sahip klinikler/danışmanlık merkezleri için uygundur. ### S: Web sitemize randevu modülü nasıl eklenir? **C:** Danışman Defteri klinik panelinizden alacağınız tek satırlık iframe kodunu web sitenizin istediğiniz sayfasına yapıştırmanız yeterlidir. Sistem otomatik olarak sitenizin tasarımına adapte olur ve kaydırma çubuğu yapmadan çalışır. ### S: Danışan formları güvenli midir? **C:** Evet. Formlar tek kullanımlık, şifreli ve süreli sihirli bağlantılarla danışana iletilir. Doldurulan veriler doğrudan klinisyen paneline şifreli olarak kaydedilir. ### S: WhatsApp hatırlatıcıları için ek ücret veya telefon gerekir mi? **C:** Danışman Defteri resmi WhatsApp API altyapısıyla entegre çalışır. Klinik personeli manuel mesaj atmak zorunda kalmaz, sistem randevu teyitlerini ve form linklerini otomatik iletir. --- ## 7. İletişim Bilgileri - **Resmi Web:** https://danismandefteri.com - **E-Posta:** iletisim@danismandefteri.com / destek@danismandefteri.com - **Geliştirici & İşletici:** Çekirdekod Yazılım ve Bilişim Teknolojileri