1 · Proje Kimliği

Holland, Hollanda'da yaşayan Türk topluluğunun CBR theorie examen'i Türkçe çalışarak ve ilk seferde geçebilmesi için kurulmuş bir SaaS platformudur.

2 · Halka Açık Yüz (Public)

Ziyaretçilerin ilk karşılaştığı yüz: hero, akıllı öğrenme bölümü, paketler, ücretsiz deneme testi, kayıt ve giriş.

2.1 Anasayfa — Hero

1000+ Türkçe soru bankası ve örnek soru kartı sağ tarafta — kullanıcı kayıt olmadan platformun tadına bakabiliyor.

Stats bandı: 7+ saat video · 1000+ soru bankası · 4+ kategori · %100 Türkçe. Tüm metinler admin panelinden yönetilebilir.

2.2 Akıllı Öğrenme Bölümü YENİ

Sistemin "neyi farklı yaptığını" anlatan bölüm. Yanlış cevapladığın soruları nasıl takip ettiğimiz, zayıf konuları nasıl daha sık çıkardığımız ve 50 soruluk gerçek sınav simülasyonunda dengeli karışım sunduğumuz görsel olarak anlatılıyor.

2.3 Paketler — Pakete Özel Özellik Listesi YENİ

Her paketin kendine özel özellik listesi vardır; admin panelinden satır satır düzenlenebilir. Anasayfa kartlarındaki bullet'lar artık hardcoded değil — her pakette farklı görünür.

2.4 Paket Özellikleri Admin Yönetimi YENİ

Admin → Paketler → Düzenle ekranında Özellik Listesi textarea'sı: her satır anasayfada bir madde olarak görünür. Boş bırakılırsa standart 4 madde (varsayılan) gösterilir.

2.5 Ücretsiz Deneme Testi

Kayıt olmadan denenebilir 10 soruluk akıllı deneme — kullanıcıyı pakete yönlendirmek için stratejik bir sayfa.

2.6 Kayıt Formu — Opsiyonel Sınav Tarihi YENİ

Kullanıcı sınav tarihini paylaşırsa hem sınavdan 1 gün önce başarı dileği, hem 3 gün sonra sonuç anketi maili otomatik gönderilir.

2.7 Giriş

3 · Otomatik Mail Sistemi YENİ

3 farklı durumda otomatik mail gönderimi. Hepsi Hollanda yerel saatiyle, DST otomatik ayarlı. Şablonlar admin panelden HTML olarak düzenlenebilir.

3.1 Mail Şablonları Admin Sayfası

3.2 Sınavdan 1 Gün Önce — Başarı Dilekleri & Hatırlatma

3.3 Sınavdan 3 Gün Sonra — Sonuç Anketi

3.4 İnaktif Kullanıcı Hatırlatma (2 günde bir)

3.5 Hesabım — Bildirim Tercihleri

4 · Öğrenci Paneli (Student Area)

Aboneliği aktif kullanıcının video sihirbazı, modül sınavları, gerçek sınav simülasyonu ve hesap yönetimi.

4.1 Vimeo Video Altyapısı 🎬 YENİ

Tüm dersler Vimeo (Standard plan) üzerinden yayınlanır. Holland sunucusunda video saklanmaz; transcoding/storage/bant genişliği maliyeti yoktur.

Admin Yönetimi

1. Ayarlar → Vimeo sekmesi: Personal Access Token, hesap kullanıcı adı, player renk akzanı (HEX), marka temizliği (logo / başlık / "by username" / avatar toggle), Do-not-track (GDPR)
2. "Bağlantıyı Test Et" butonu: api.vimeo.com/me çağrısı yapar — hesap adı, plan ve toplam video sayısı 1 saniyede döner
3. Vimeo'ya videoyu yükle → Privacy → "Hide from Vimeo" + "Only specific domains" + sitenin domainini whitelist'le
4. Holland Admin → Modül → Video Ekle: Vimeo URL veya ID'yi yapıştır (vimeo.com/76979871 → otomatik 76979871 olarak ayıklanır)

Öğrenci tarafı izleme kontrolleri

4.2 Eğitimim — Kurs Listesi

4.3 50 Soruluk Gerçek Sınav Simülasyonu YENİ

Kurs detay sayfasının üstüne yerleştirilmiş gradient renkli CTA butonu — tek tıkla CBR formatında 50 soruluk gerçek sınav simülasyonu başlatır.

4.4 Paket Yükseltme (Upgrade) YENİ 🚀

Aktif aboneliği olan kullanıcı, fiyat farkını ödeyerek üst pakete geçebilir. Gün hesabı yok — sadece "yeni paket − mevcut paket" farkı alınır.

Aboneliklerim sayfasında CTA

Üst Paket Listesi

Sadece aynı kurs tipinde ve daha pahalı paketler listelenir. Her kartta net hesaplama:

Onay Ekranı

5 · Admin Paneli (Backoffice)

Tabler tabanlı modern yönetim arayüzü — KPI dashboard, kullanıcı yönetimi, içerik & ayarlar.

5.1 Dashboard YENİ

Üst sıra 4 KPI: Toplam Kullanıcı · Aktif Üye · Pasif Üye · Bu Ay Ciro. Alt sıra 4 KPI: Bekleyen Fatura · Toplam Sınav (anket) · Sınav Geçen · Başarı Oranı %. Altında 12 aylık aylık ciro & satış bar chart.

5.2 Kullanıcılar — Tümü / Aktif / Pasif Sekmeleri YENİ

5.3 Sistem Ayarları

8 sekme içinde tüm sistem yönetilebilir:

Anasayfa Metinleri → Yöntem Bölümü

6 · Soru Bankası — Esnek Atama YENİ

Bir soru artık birden fazla modüle ve birden fazla kursa ortak olarak atanabilir. Toplu seçimle birlikte yönetim çok hızlandı.

6.1 Çoklu Modül Ataması (N-N)

Bir soru ortak ise (örn. "Kırmızı ışıkta ne yapmalısınız?") aynı anda birden fazla modülde kullanılabilir. Edit sayfasında multi-select ile seçilir, listede mor rozetler ile görünür.

6.2 Kurs Havuzu (Kurs Seviyesinde Ortak Soru) YENİ

Bir soru hiç modüle bağlanmadan doğrudan bir kurs havuzuna atanabilir. Bu sorular o kursun tüm modülleri için ortak bir havuz oluşturur ve simülasyon algoritması bunları da dengeli dahil eder.

6.3 Toplu Seçim & Toplu Atama YENİ

Listede checkbox ile birden fazla soru seçilir. Üstte beliren toolbar'dan "Toplu Atama" modal'ı açılır: 3 mod (Ekle / Değiştir / Çıkar) + Modüller + Kurs Havuzu çoklu seçimleri.

7 · Güvenlik & Üretim Kalitesi

4 bağımsız uzman incelemesi (Project / UI / Backend / Security admin) — kritik bulgu sıfır.

7.1 Yapılan Sıkılaştırmalar

7.2 Kritik Güvenlik Garantileri

• CSRF — Tüm admin POST'larında ValidateAntiForgeryToken
• Token bütünlüğü — ASP.NET DataProtection HMAC ile imzalı, manipüle edilemez
• Token kullanım amacı ayrı — ExamSurvey ve CourseReminderOptOut farklı Protector purpose'u, cross-use imkânsız
• Idempotent landing'ler — Mail linkleri kaç kez tıklanırsa tıklansın yalnızca ilk tıklama DB'ye yazar
• Admin yetkilendirme — AdminBaseController üzerinden [Authorize(Roles="Admin")]
• Hangfire dashboard — HollandHangfireAuthFilter ile yalnızca Admin erişebilir
• SQL injection — EF Core parametre tabanlı sorgular, string concat yok
• Iyzico 3D Secure — Tüm kart ödemeleri 3DS ile korunuyor
• Şifre koruma — PBKDF2, kişisel bilgi HTTPS, GDPR uyumlu opt-out

7.3 CSP (Content Security Policy)

SecurityHeadersMiddleware ile production'da whitelist edilmiş kaynaklar: Google Fonts, GTM/GA, Iyzico ödeme sayfası, Tabler CDN, Facebook pixel. Diğer her şey engellenir.

8 · Veritabanı Şeması

Bu son sprint'te eklenen yapılar — kullanıcı izleme, soru-modül-kurs many-to-many ilişkileri.

8.1 AspNetUsers Yeni Kolonlar

8.2 Yeni Many-to-Many Join Tabloları

8.3 Paket & Ödeme Yeni Kolonları YENİ

8.4 Migration Zinciri

1. UserExamDate — SinavTarihi + SinavAnketGonderildiAt
2. SinavHatirlatma — SinavHatirlatmaGonderildiAt
3. KursHatirlatma — KursHatirlatmaKapali + KursHatirlatmaSonGonderim
4. QuestionModuleManyToMany — eski Question.ModuleId verilerini koruyarak join tablosuna taşır
5. QuestionCourseManyToMany — yeni QuestionCourses join tablosu
6. PackageOzellikler YENİ — Package.Ozellikler text alanı
7. PaymentUpgrade YENİ — Payment.UpgradeFromSubscriptionId
8. UpgradeFromSubscriptionIdLong YENİ — int→long düzeltme

9 · Mimari Özet

Kullandığımız teknolojiler ve nasıl konuştukları.

┌────────────────────────┐
│ Client (Tailwind+JS)   │
└──────────┬─────────────┘
           │ HTTPS
┌──────────▼──────────────────────────────────────┐
│ ASP.NET Core 8 MVC                              │
│  - Public Area (Home, Account, Bildirim, Sinav) │
│  - Student Area (Hesabim, Course, Quiz)         │
│  - Admin Area (Tabler UI, CRUD, Settings)       │
│  - Middleware: CSP, RateLimit, Forwarded, Comp. │
└──────────┬───────────┬────────────┬─────────────┘
           │           │            │
   ┌───────▼─────┐ ┌───▼────────┐ ┌─▼──────────┐
   │ PostgreSQL  │ │  Hangfire  │ │  Iyzico    │
   │ (17 + EF8)  │ │ (Postgres) │ │  Paraşüt   │
   └─────────────┘ └──────┬─────┘ └────────────┘
                          │
              ┌───────────┼──────────────┐
              │           │              │
         ExamSurvey  ExamReminder  InactiveUser
            (12:00)     (12:00)       (18:00)
              Hollanda lokal saat (DST-aware)

Anahtar Servisler

• StudentProgressService — modül başarı takibi, simülasyon algoritması, weighted sampling
• SettingsService — DB tabanlı dinamik config (admin'den canlı düzenlenebilir)
• MailTemplateRenderer — placeholder ikamesi (XSS-safe, tek-pass regex)
• NlTime — Europe/Amsterdam DST-aware cron yardımcısı
• PromotionService — sadakat ve sınav indirimleri
• OdemeService — Iyzico 3DS + Paraşüt fatura akışı

Otomatik İş Yükü (Hangfire Recurring Jobs)

10 · Teklif & Fiyatlandırma

Yazılım kapsamı, müşteri-sorumluluğunda olan altyapı, fiyatlandırma ve destek modeli.

10.1 Kapsam

10.2 Fiyatlandırma

10.3 Yıllık Yenileme / Destek Paketi (1.000 €/yıl) — Neleri İçerir?

• Hata düzeltmeleri (bug fix)
• Teknik soru-cevap (WhatsApp / e-posta üzerinden)
• Küçük ayar ve güncellemeler (logo, metin, paket fiyatı yapısı, vb.)
• Güvenlik yamaları + .NET ve paket sürüm yükseltmeleri
• İhtiyaç doğrultusunda yıllık 1 oturum mini eğitim

10.4 Özel Ek Geliştirme (200 €/saat) — Nasıl Çalışır?

1. Talep yazılı alınır (WhatsApp / e-posta)
2. Maksimum 8 saat içinde projelendirme yapılır ve net teslim süresi bildirilir
3. Müşteri onayından sonra geliştirmeye başlanır
4. Saat bazında faturalandırılır

10.5 Ödeme Koşulları

10.6 USDT Cüzdan Adresi (TRC-20)

10.7 Anlık EUR ↔ USDT Hesaplama

11 · Müşteri Kabul Listesi

Gözle doğrulayabileceğin maddeler — tek tek check edebilirsin.

• Anasayfada "Akıllı Öğrenme" bölümü görünüyor mu?
• Kayıt formunda Sınav Tarihi alanı (opsiyonel) var mı?
• Login sonrası admin → /Admin, öğrenci → /Student yönlendirmesi çalışıyor mu?
• Admin Dashboard'da 4+4 KPI kartı + 12 aylık ciro grafiği görünüyor mu?
• Admin → Kullanıcılar sayfasında Tümü/Aktif/Pasif sekmeleri çalışıyor mu?
• Admin → Ayarlar → Mail Şablonları sayfası 3 mail şablonu düzenleyebiliyor mu?
• Admin → Ayarlar → Anasayfa Metinleri → Yöntem Bölümü editörü açılıyor mu?
• Soru bankasında bir soru birden fazla modüle atanabiliyor mu?
• Soru bankasında bir soru kurs havuzuna atanabiliyor mu?
• Soru listesinde checkbox ile çoklu seçim + Toplu Atama modal'ı çalışıyor mu?
• Bir kursa girince üstte gradient "50 Soruluk Sınav Simülasyonu" butonu var mı?
• Hesabım sayfasında Bildirim Tercihleri bölümü görünüyor mu?
• /bildirim-kapat?token=bogus açıldığında "geçersiz bağlantı" mesajı çıkıyor mu?
• Test mail (örn. SMTP debug) → şablonlardaki HTML doğru render ediliyor mu?
• Admin → Paketler → Düzenle ekranında Özellik Listesi textarea'sı görünüyor mu?
• Anasayfa paket kartlarında her pakette farklı bullet listesi görünüyor mu?
• Paket CourseId set edildiğinde kullanıcı sadece o kursa erişebiliyor mu?
• Aktif aboneliği olan kullanıcının Aboneliklerim sayfasında "Paketi Yükselt" butonu görünüyor mu?
• Yükselt sayfasında üst paketler için net fark fiyatı (gün hesabı yok) gösteriliyor mu?
• Yükselt ödeme akışı Iyzico'ya yönleniyor ve sonunda eski abonelik iptal + yeni abonelik tam süre başlıyor mu?