# Canlı Ders Entegrasyonu — Durum ve Test Rehberi Bu dosya, `docs/CANLI-DERS-VIDEO-CHART-SENKRON-RAPORU.md`'daki plana göre şu ana kadar **gerçekten kodlanmış ve test edilmiş** olanı özetler. Rapor "ne yapılmalı"yı anlatır, bu dosya "ne yapıldı ve nasıl test edilir"i anlatır. Tarih: 2026-08-04 --- ## 1. Genel durum | Faz | Açıklama | Durum | |---|---|---| | Faz 1 | Altyapı (Reverb, `live_sessions` tablosu, kanal yetkilendirmesi) | ✅ Tamamlandı | | Faz 2 | Chart senkron (`setActive`/`ajaxRefreshTransit` wrap) | ✅ Tamamlandı | | Faz 2b | Tam state senkronu (`request_sync`/`full_sync`) | ✅ Tamamlandı | | Faz 3 | Video (WebRTC P2P sinyalizasyonu) | ✅ Tamamlandı | | TURN | Ücretsiz TURN havuzu entegrasyonu (kod hazır) | ⏳ Sadece API key bekleniyor | | Faz 4 | Öğretmen paneli (gerçek `panel.blade.php`'ye bağlama) | ✅ Tamamlandı | | Faz 5 | Whiteboard (çizim) | ✅ Tamamlandı | | Faz 6 | Ders kayıtları | ✅ Tamamlandı | | Faz 7 | Cilalama (reconnect, mobil, saklama politikası) | ✅ Reconnect doğrulandı — mobil/saklama açık karar bekliyor (bkz. §9) | | "Canlı ders başlat" UI | Host toolbar butonu + Ders Kayıtlarım linki | ✅ Tamamlandı | | **Rework (2. tur)** | Kamera → sol üst sub-chart slotu, modern UI, kritik bug fix'leri | ✅ Tamamlandı (bkz. §10) | | Sunucu kurulumu | NSSM, ARR, coturn (Windows VDS) | ⏸️ Bilinçli olarak en sona bırakıldı | --- ## 2. Mimari özet - **Sinyal/senkron altyapısı:** Laravel Reverb (self-hosted WebSocket, Pusher protokolü uyumlu). - **Roller:** Öğretmen = `users.role === 'astrologer'` (mevcut ama kullanılmayan bir alan, yeniden kullanıldı — yeni migration gerekmedi). `User::isTeacher()` / `isStudent()`. - **Oturum modeli:** `live_sessions` tablosu (`teacher_id`, `student_id` nullable, `room_id` uuid, `status`, `started_at`, `ended_at`). Öğretmen oturum açar, öğrenci linke tıklayınca "claim" eder (`LiveSessionController::join`). - **Kanal:** `private-session.{room_id}` — sadece o oturumun öğretmeni/öğrencisi girebilir (`routes/channels.php`). - **Chart senkronu — yazma yetkisi asimetrik:** Sadece öğretmen (host) chart event'i yayınlayabilir (`LiveSessionController::publish`, backend'de zorunlu kılınır). Tek istisna: öğrenci `request_sync` gönderebilir ("bana mevcut tüm haritaları gönder" sinyali, chart verisi taşımaz). - **WebRTC sinyalizasyonu — kasıtlı olarak simetrik:** offer/answer/ICE candeyi her iki taraf da gönderebilir (`LiveSessionController::signal`), çünkü görüşme kurulumu doğası gereği iki yönlü. - **Video/ses verisi sunucudan hiç geçmiyor** — sadece bağlantıyı kurmak için gereken SDP/ICE meta verisi Reverb üzerinden taşınıyor (ham P2P WebRTC). - **Tek event sınıfı:** `App\Events\LiveSessionEvent` — `type` alanına göre (`setActive`, `ajaxRefreshTransit`, `full_sync`, `request_sync`, `webrtc.offer`, `webrtc.answer`, `webrtc.ice-candidate`, `webrtc.hangup`, `test.ping`) farklı davranır. Yeni bir senkron türü eklemek için yeni bir class yazmaya gerek yok, sadece yeni bir `type` string'i yeterli. - **Faz 4 — gerçek panele bağlanma mantığı:** `/panel/live/{roomId}` artık gerçek `panel.blade.php`'yi render ediyor (`IndexController::index()` üzerinden, `$liveSession` adında opsiyonel/additive bir parametreyle). **"Kimin haritası" sorusu ayrıca çözülmedi** — öğretmen kendi hesabıyla, öğrenci kendi hesabıyla girer (panelin normal davranışı, hiç değişmedi); ekrana gerçekte ne görüneceğini `request_sync`/`full_sync` akışı belirliyor (öğretmenin ekranındaki tüm açık haritalar öğrenciye anında kopyalanır). Öğrenci girişinde kısa bir an kendi (normal) chart'ı görünüp hemen öğretmeninkiyle değişebilir — bu bilinen, kabul edilmiş bir MVP davranışı. - **Öğrenci input kilidi:** `` (sadece öğrenci rolünde) + CSS `pointer-events:none`. `.live-session-controls` class'ı bu kilidin dışında tutuluyor (video/host toolbar overlay'i, `partials/live-session-controls.blade.php`). - **`panel.js`'e hâlâ hiçbir satır eklenmedi/değiştirilmedi** — bkz. aşağıdaki not. - **Faz 5 — whiteboard:** `#mainDropzone`'un üstüne (chart DOM'una dokunmadan) şeffaf bir `