GİP Akademi Projesi

Tenant Sistemine Entegrasyon Analizi • v2

Proje Özeti

Basit Anlatım

GİP Akademi, yeni iş kuracak veya işini yürüten kişilere "muhasebe işlerini nasıl doğru yaparsın?" diye öğreten bir online eğitim platformu. İnsanlar önce kendini tanıtıyor (şahıs mı, şirket mi), sonra zorunlu eğitimleri izliyor, sınavları geçiyor ve sertifika alıyor. Amaç: Ceza yemeden önce öğrenmek.

Teknik Özet

LMS (Learning Management System) yapısında, multi-step onboarding flow, zorunlu eğitim modülleri (video + metin), quiz/assessment engine, sertifika üretim sistemi ve kullanıcı ilerleme takibi gerektiren bir platform. MERSİS/KOSGEB benzeri ön başvuru formu ile başlıyor.

Mevcut Sistemde Var mı?

GİP Akademi Özelliği Durum Açıklama
Ön Başvuru / Kayıt FormuKısmiTemel kayıt var ama çok adımlı başvuru formu yok
Eğitim / Kurs ModülüYokHiçbir eğitim/kurs altyapısı mevcut değil
Video İçerik SistemiYokSes streaming altyapısı var, video altyapısı yok
Sınav / Quiz SistemiYokHiçbir değerlendirme sistemi mevcut değil
Sertifika ÜretimiKısmiMevcut sistemde QR kodlu üyelik sertifikası var, eğitim sertifikası değil
İlerleme TakibiYokKullanıcı ilerleme/tamamlama takibi yok
Çok Adımlı Form / WizardYokStep-by-step form altyapısı mevcut değil
Blog / İçerik YönetimiVarAI destekli, çok dilli, SEO uyumlu blog modülü
Kullanıcı YönetimiVarRol/izin sistemi, e-posta doğrulama mevcut
E-posta BildirimleriVarMail modülü ve bildirim altyapısı mevcut

Kullanıcı Yolculuğu Hiyerarşisi

Kullanıcı platforma girdiğinde hangi adımları, hangi sırayla görecek?

1

Anasayfa (Landing Page)

Herkes giriş yapmadan görebilir
Hero Alanı

Platform tanıtımı, "Ücretsiz Başla" butonu, kısa açıklama

Eğitim Modülleri Özet

5 ana modül kartları: Fatura, Yasal Süreler, Banka, İletişim, Riskler

SSS + CTA

Sık sorulan sorular, istatistikler, kayıt çağrısı

2

Kayıt & Giriş

Hesap oluşturma veya mevcut hesapla giriş
Kayıt Formu

Ad-soyad, e-posta, telefon, şifre, KVKK onayı

E-posta Doğrulama

Doğrulama linki gönderilir, tıklanmadan devam edilemez

3

Onboarding Wizard (Ön Başvuru)

Zorunlu — tamamlanmadan platform açılmaz
Adım 1: İşletme Tipi

Şahıs / Limited / Anonim / Serbest Meslek / Henüz kurulmadı

Adım 2: Faaliyet Alanı

Perakende, e-ticaret, hizmet, üretim, sağlık, gıda vs.

Adım 3: Durum

Kurulacak / Yeni kurulmuş / Faaliyette / E-ticaret satıcısı

Adım 4: Özet & Onay

Bilgilerin özeti, düzenleme imkânı, "Eğitime Başla" butonu

4

Kullanıcı Dashboard

Ana kontrol paneli — giriş sonrası ilk sayfa
İlerleme Kartları

Genel ilerleme %, tamamlanan ders sayısı, kalan ders

Aktif Eğitimler

Devam eden kurslar listesi, "Devam Et" butonları

Sertifikalarım

Kazanılan sertifikalar, PDF indir, QR doğrulama

5

Eğitim Listesi & Kurs Detay

Tüm eğitimleri görme ve bir kursa girme
Eğitim Listesi

Kart veya liste görünüm, zorunlu/opsiyonel etiketi, ilerleme barı, süre bilgisi

Kurs Detay Sayfası

Kurs açıklaması, bölüm listesi (accordion), ders sayısı, "Kayıt Ol" butonu

6

Ders İzleme Sayfası

Video/metin içeriği tüketme
Sol: Ders Listesi

Sidebar'da tüm dersler, tamamlananlar tikli, aktif ders vurgulu

Orta: İçerik Alanı

Video player veya metin içerik, ilerleme barı, "Dersi Tamamla" butonu

Alt: Sonraki Adım

Sonraki ders veya "Sınava Geç" butonu

7

Sınav Sayfası

Eğitim sonu değerlendirme
Sınav Başlangıç

Soru sayısı, süre bilgisi, geçme notu, "Sınava Başla" butonu

Soru Ekranı

Tek soru görünümü, şıklar, ileri-geri, kalan süre, soru numarası

Sonuç Ekranı

Puan, geçti/kaldı, doğru/yanlış özeti, tekrar deneme butonu

8

Sertifika Sayfası

Tüm eğitimler + sınavlar tamamlandığında
Tebrikler Ekranı

Animasyonlu başarı mesajı, konfeti efekti, sertifika önizleme

Sertifika İndir

PDF indir, sosyal medyada paylaş, QR doğrulama kodu

Doğrulama Sayfası

Herkese açık /verify/{code} sayfası — üçüncü kişiler kontrol edebilir

Sayfa Draft'ları (Wireframe)

Her sayfanın ana bölümleri ve yerleşim planı.

Draft 1: Anasayfa (Landing Page)

Logo
Hakkında Eğitimler SSS Giriş Yap
Hero Section
Muhasebe Bilinci, İşletmenizin Temelidir
Ceza ile öğrenmek yerine, işe başlamadan doğru bilgiyi edinin.
Ücretsiz Başla
Eğitimleri Gör
Eğitim Modülleri (5 Kart)
Fatura & Fiş
Yasal Süreler
Banka İşlemleri
Muhasebeci İletişimi
Vergi Riskleri
Rakamlarla GİP Akademi
5
Eğitim Modülü
25+
Video Ders
100+
Sınav Sorusu
1
Katılım Belgesi
SSS (Accordion)
Bu eğitim ücretli mi?
Sertifika resmi geçerliliğe sahip mi?
Eğitimi tamamlamak zorunlu mu?
Footer — İletişim, Sosyal Medya, KVKK

Draft 2: Onboarding Wizard

Adım 2 / 4 %50
İşletme Tipi
2
Faaliyet Alanı
3
Durum
4
Özet

Faaliyet alanınız nedir?

İşletmenizin veya kurmayı planladığınız işletmenin sektörünü seçin.

Perakende / Mağaza
E-Ticaret
Hizmet Sektörü
Üretim / İmalat
Sağlık
Gıda / Restoran
Eğitim
Serbest Meslek
Diğer
Geri
İleri

Draft 3: Kullanıcı Dashboard

Hoş geldin, Ahmet!
Eğitimlerinize kaldığınız yerden devam edin.
%35
Genel İlerleme
2/5
Tamamlanan Modül
8/25
Tamamlanan Ders
1/5
Geçilen Sınav
0
Sertifika
Devam Eden Eğitimler
Fatura & Fiş Eğitimi
3/6 ders tamamlandı
Devam Et
Yasal Süreler & Beyanname
1/5 ders tamamlandı
Devam Et

Draft 4: Ders İzleme Sayfası

Fatura & Fiş Eğitimi
1. Fatura Nedir?
2. E-Fatura vs E-Arşiv
3. Gider Belgesi
4. Fiş Türleri
5. Evrak Saklama
Sınav
Video Player Alanı
YouTube Embed veya Plyr.js
12:45 / 18:30
%69

3. Gider Belgesi Nedir, Ne Değildir?

Bu derste hangi harcamaların gider olarak kabul edildiğini, hangilerinin "kanunen kabul edilmeyen gider" sayıldığını öğreneceksiniz.

Önceki Ders
Dersi Tamamla & İlerle

Draft 5: Sınav Sayfası

Fatura & Fiş Eğitimi — Sınav
Soru 3/10 14:22

Aşağıdakilerden hangisi "kanunen kabul edilmeyen gider" kapsamındadır?

Önceki
Sonraki Soru

Draft 6: Sertifika Sayfası

🎉
Tebrikler!
Tüm eğitimleri ve sınavları başarıyla tamamladınız.
GİP Akademi
Katılım Belgesi
Bu belge
Ahmet Yılmaz
adlı katılımcının tüm eğitim modüllerini
başarıyla tamamladığını belgeler.
Tarih: 28.01.2026
No: GIP-2026-00142
PDF İndir
Paylaş
QR Doğrula

Eklenmesi Gereken Modüller ve Detaylı Analiz

1. Eğitim Modülü (Education Module)

Yüksek Öncelik

Basit Anlatım (Herkes İçin)

Bu modül projenin kalbi. Tıpkı Udemy veya bir online kurs sitesi gibi düşünün: Eğitimler bölümlere ayrılmış, her bölümde videolar ve yazılı içerikler var. Kullanıcı sırasıyla izliyor, birini bitirmeden diğerine geçemiyor.

Nasıl olmalı: Her eğitim bir "kurs" olarak tanımlanmalı. Kurslar alt bölümlere (ders) ayrılmalı. Her dersin içinde video, yazı veya sunum olabilmeli. Kullanıcı dersi tamamladığında sistem otomatik olarak "tamamlandı" işaretlemeli ve bir sonraki derse geçiş açılmalı.

Neden önemli: GİP Akademi'nin tüm eğitim içeriği bu modül üzerinden sunulacak. Bu olmadan projenin kendisi olmaz.

Zorunluluk mekanizması: Bazı eğitimler "zorunlu" olarak işaretlenebilmeli. Kullanıcı zorunlu eğitimleri tamamlamadan platforma tam erişim sağlayamamalı.

Teknik Detaylar (Geliştiriciler İçin)

  • Tablolar: courses, course_sections, course_lessons, course_enrollments, lesson_progress
  • Modeller: Course, CourseSection, CourseLesson, Enrollment, LessonProgress
  • İlişkiler: Course hasMany Sections, Section hasMany Lessons, User belongsToMany Courses (pivot: enrollments)
  • Lesson Types: video, text, pdf, presentation (polymorphic content)
  • Erişim Kontrolü: Middleware ile enrollment ve prerequisite kontrolü. is_mandatory flag ile zorunlu eğitim desteği
  • İlerleme: lesson_progress tablosunda completed_at, progress_percentage, last_position (video için saniye bazlı)
  • Çeviri: Mevcut HasTranslatable trait kullanılabilir
  • Konum: Modules/Education/
  • Admin: Livewire componentler ile kurs, bölüm, ders CRUD + sıralama (drag-drop)

2. Sınav / Değerlendirme Modülü (Quiz Module)

Yüksek Öncelik

Basit Anlatım

Her eğitimin sonunda kullanıcıya sorular sorulacak. "Faturanızı kaç gün içinde teslim etmelisiniz?" gibi çoktan seçmeli veya doğru/yanlış sorular. Belirli bir puanı geçemezse eğitim tamamlanmış sayılmayacak.

Nasıl olmalı: Sınav soruları admin panelinden kolayca eklenebilmeli. Geçme notu ayarlanabilir olmalı (örneğin %70). Sınavı geçemeyenler tekrar deneyebilmeli.

Neden önemli: Sertifika vermek için kullanıcının gerçekten öğrenip öğrenmediğini ölçmek şart.

Teknik Detaylar

  • Tablolar: quizzes, quiz_questions, quiz_options, quiz_attempts, quiz_answers
  • İlişki: Quiz belongsTo CourseLesson veya Course (polymorphic quizzable_type/id)
  • Soru Tipleri: multiple_choice, true_false, fill_blank
  • Puanlama: quiz_attempts tablosunda score, passed, passing_score (default 70)
  • Tekrar: max_attempts alanı (null = sınırsız)
  • Soru Karıştırma: shuffle_questions, shuffle_options
  • Süre: time_limit_minutes (opsiyonel)

3. Sertifika Modülü (Certificate Module)

Yüksek Öncelik

Basit Anlatım

Eğitimi ve sınavı başarıyla tamamlayan kişiye "GİP Akademi Katılım Belgesi" verilecek. PDF olarak indirilebilir, QR kod ile doğrulanabilir.

Nasıl olmalı: Sertifika tasarımı admin panelinden özelleştirilebilmeli. Her sertifikanın benzersiz numarası ve doğrulama QR kodu olmalı.

Neden önemli: Katılım belgesi GİP Akademi'nin somut çıktısı. Güvenilir ve doğrulanabilir olması projenin ciddiyetini artırır.

Teknik Detaylar

  • Tablolar: certificates, certificate_templates
  • Doğrulama: UUID bazlı unique code + QR (mevcut QR altyapısı genişletilebilir)
  • PDF: DomPDF veya Snappy ile dinamik PDF üretimi
  • Template: Blade view + CSS ile tasarım, admin'den düzenlenebilir
  • İlişki: Certificate belongsTo User, belongsTo Course
  • Doğrulama Sayfası: Public /certificate/verify/{code}

4. Çok Adımlı Başvuru Sistemi (Onboarding Wizard)

Yüksek Öncelik

Basit Anlatım

Kullanıcı platforma ilk girdiğinde adım adım ilerleyen bir form doldurmalı: İşletme tipi, faaliyet alanı, mevcut durum. Bu bilgiler kullanıcıya özel eğitim yolu belirlemek için kullanılacak.

Neden önemli: Kullanıcıyı tanımadan doğru eğitimi sunmak mümkün değil. Bu wizard, kişiselleştirilmiş eğitim deneyiminin başlangıç noktası.

Teknik Detaylar

  • Tablolar: onboarding_profiles (user_id, business_type, activity_field, business_status, completed_at)
  • Frontend: Alpine.js multi-step form (x-show ile adım geçişi)
  • Backend: Livewire component veya API endpoint
  • Middleware: EnsureOnboardingCompleted → tamamlanmamışı wizard'a yönlendir
  • Yönlendirme: business_type + activity_field'e göre recommended_courses

5. Video İçerik Sistemi

Orta Öncelik

Basit Anlatım

Eğitim videoları platformda oynatılabilmeli. Video izleme süresi takip edilmeli: Kullanıcı videonun en az %80'ini izlemeden "tamamladım" diyememeli.

Nasıl olmalı: Başlangıçta YouTube embed yeterli. İleri aşamada kendi video sunucusu düşünülebilir.

Teknik Detaylar

  • Player: Plyr.js veya Video.js
  • Kaynak: youtube_url, vimeo_url veya local_path
  • Takip: JS timeupdate → her 30s progress API → lesson_progress.last_position
  • Tamamlama: watched_percentage >= 80 → completed
  • Anti-cheat: Tab değişikliği algılama, max 2x hız

6. İlerleme ve Dashboard Sistemi

Orta Öncelik

Basit Anlatım

Kullanıcı giriş yaptığında kontrol panelinde ilerlemesini görür. Tamamlanan dersler yeşil tik, devam edenler turuncu, başlanmamışlar gri.

Neden önemli: İnsanlar ilerlemelerini görmezse motivasyonlarını kaybeder.

Teknik Detaylar

  • Kullanıcı Dashboard: Livewire component → enrollments + progress aggregate sorgusu
  • Admin Dashboard: Toplam kayıt, tamamlama oranı, sektör dağılımı
  • Hesaplama: (completed_lessons / total_lessons) * 100
  • Gamification: Opsiyonel rozet sistemi
  • Cache: TenantCacheService ile uyumlu

7. Bildirim ve Hatırlatma Sistemi

Düşük Öncelik

Basit Anlatım

Kullanıcıya eğitim hatırlatmaları gönderilmeli. "Eğitiminiz yarım kaldı" gibi e-postalar ve platform içi bildirimler.

Neden önemli: Hatırlatma bildirimleri tamamlama oranını ciddi şekilde artırır. Mevcut Mail modülü üzerine inşa edilebilir.

Teknik Detaylar

  • E-posta: Laravel Notification sınıfları
  • In-app: Laravel database notification + Livewire dropdown
  • Zamanlama: 3 gün inaktif → hatırlatma, 7 gün → ikinci
  • Tercihler: notification_preferences tablosu
  • Entegrasyon: Mail + Announcement modülleri

Önerilen Uygulama Sırası

1

Eğitim Modülü + Onboarding Wizard

Projenin temeli. Bunlar olmadan diğer hiçbir şey anlam ifade etmez.

2

Quiz/Sınav + Sertifika Sistemi

Eğitimin çıktısı. Sınav olmadan sertifika verilmez.

3

Video Player + İlerleme Dashboard

Başlangıçta YouTube embed ile hızlı başlanabilir.

4

Bildirim ve Hatırlatma Sistemi

Mevcut Mail ve Announcement modülleri üzerine inşa edilir.

Mevcut Modüllerden Yararlanılabilecekler

Doğrudan Kullanılabilir

  • UserManagement: Roller ve izinler
  • Blog: Ek bilgilendirme yazıları
  • Mail: E-posta bildirimleri altyapısı
  • Announcement: Platform duyuruları
  • SeoManagement: Sayfa SEO optimizasyonu
  • LanguageManagement: Çok dil desteği

Adapte Edilebilir

  • Mevcut Sertifika Altyapısı: QR doğrulama eğitim sertifikasına adapte
  • MediaManagement: Eğitim görselleri ve PDF'ler
  • SettingManagement FormBuilder: Onboarding wizard için baz
  • AI Modülü: Eğitim içeriği üretimi
  • Search: Eğitim içeriklerinde arama

Dikkat Edilmesi Gereken Konular

Tenant İzolasyonu

Basit: GİP Akademi bir tenant olacak. Eğitim modülü sadece bu tenant'ta aktif olmalı, diğer tenant'lara bulaşmamalı.

Teknik: modules_statuses tenant bazlı kontrol edilmeli. Education modülü sadece ilgili tenant DB'sinde migration çalıştırmalı.

KVKK / Kişisel Veri

Basit: Kullanıcılardan iş bilgisi, faaliyet alanı gibi veriler toplanacak. KVKK aydınlatma metni ve açık rıza onayı gerekli.

Teknik: Onboarding formunda KVKK checkbox + aydınlatma metni linki. consent_given_at timestamp kaydı.

Performans

Basit: Videolar YouTube'da barındırılmalı, sunucuya yük binmemeli.

Teknik: Video streaming kendi sunucuda yapılmamalı. YouTube/Vimeo embed veya CDN kullanılmalı. Progress API rate-limit uygulanmalı.