GİP Akademi Projesi

📝 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. Fatura, fiş, beyanname, vergi cezaları gibi tüm konular burada ders olarak yer alacak.

Zorunluluk mekanizması: Bazı eğitimler "zorunlu" olarak işaretlenebilmeli. Kullanıcı zorunlu eğitimleri tamamlamadan platforma tam erişim sağlayamamalı. Bu, GİP Akademi'nin "önce öğren, sonra ilerle" felsefesinin teknik karşılığı.

🔧 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 (title, description, content JSON alanları)
• Konum: Modules/Education/
• Admin: Livewire componentler ile kurs, bölüm, ders CRUD + sıralama (drag-drop)

📝 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. Her sorunun birden fazla şıkkı olabilmeli, doğru cevap işaretlenebilmeli. Sınav sonunda puan otomatik hesaplanmalı. Geçme notu ayarlanabilir olmalı (örneğin %70). Sınavı geçemeyenler tekrar deneyebilmeli.

Neden önemli: GİP Akademi'nin "katılım belgesi" vermesi için kullanıcının gerçekten öğrenip öğrenmediğini ölçmek şart. Sadece videoyu açıp kapamak yeterli olmamalı. Bu modül öğrenmeyi doğrulayan mekanizma.

🔧 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 (enum field)
• Puanlama: quiz_attempts tablosunda score, passed (boolean), passing_score (quiz tablosunda, default 70)
• Tekrar: max_attempts alanı (null = sınırsız), attempts_count takibi
• Soru Karıştırma: shuffle_questions, shuffle_options boolean flagları
• Süre: time_limit_minutes (opsiyonel), started_at / finished_at takibi
• Konum: Modules/Quiz/ veya Education modülü içinde alt-modül

📝 Basit Anlatım

Eğitimi ve sınavı başarıyla tamamlayan kişiye "GİP Akademi Katılım Belgesi" verilecek. Bu belge PDF olarak indirilebilir, üzerinde kişinin adı, tamamladığı eğitim ve tarih yazacak. QR kod ile doğrulanabilir olacak (sahte sertifika üretilemeyecek).

Nasıl olmalı: Sertifika tasarımı admin panelinden özelleştirilebilmeli (logo, arka plan, yazı tipi). Her sertifikanın benzersiz bir numarası ve doğrulama QR kodu olmalı. Dışarıdan biri QR kodu okutunca "Bu sertifika geçerlidir" sayfası açılmalı.

Neden önemli: Katılım belgesi GİP Akademi'nin çıktısı. İnsanlar bu belgeyi muhasebecilerine, KOSGEB'e veya iş ortaklarına gösterebilir. Güvenilir ve doğrulanabilir olması projenin ciddiyetini artırır.

🔧 Teknik Detaylar

• Tablolar: certificates, certificate_templates
• Doğrulama: UUID bazlı unique code + QR (SimpleSoftwareIO/QrCode veya mevcut QR altyapısı genişletilebilir)
• PDF: DomPDF veya Snappy ile dinamik PDF üretimi (template-based)
• Template: Blade view + CSS ile tasarım, admin'den logo/arka plan/metin düzenlenebilir
• İlişki: Certificate belongsTo User, belongsTo Course. Otomatik üretim: quiz passed + tüm dersler completed
• Doğrulama Sayfası: Public route: /certificate/verify/{code} → sertifika bilgisi gösterir
• Konum: Modules/Certificate/ veya Education modülü içinde

📝 Basit Anlatım

Kullanıcı platforma ilk girdiğinde, MERSİS'teki gibi adım adım ilerleyen bir form doldurmalı: "Şahıs mı şirket mi?", "Faaliyet alanınız nedir?", "İşletmeniz hangi aşamada?" gibi sorular. Bu bilgiler hem kullanıcıya özel eğitim yolu belirlemek hem de istatistik için kullanılacak.

Nasıl olmalı: Form en az 3-4 adımlı olmalı. Her adımda birkaç soru sorulmalı. İleri-geri gidilebilmeli. Son adımda özet gösterilmeli. Form tamamlanmadan eğitimlere erişim olmamalı. Admin panelinde form adımları ve soruları düzenlenebilmeli.

Neden önemli: Kullanıcıyı tanımadan doğru eğitimi sunmak mümkün değil. Bir e-ticaret yapan kişi ile serbest muhasebeci farklı içeriklere ihtiyaç duyar. 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, mevcut frontend stack ile uyumlu)
• Backend: Livewire component veya API endpoint. Her adım validasyonu ayrı
• Middleware: EnsureOnboardingCompleted middleware → profili tamamlanmamış kullanıcıyı wizard'a yönlendir
• Yönlendirme: business_type + activity_field'e göre recommended_courses belirleme (mapping tablosu veya config)
• İstatistik: Onboarding verileri admin dashboard'da sektör/durum dağılımı grafiği