muhiddin@grimoire:~$ cat ./uygulamalar/okuliz/README.md
Okuliz_
Eğitim · Web
Öğretmenlere ücretsiz materyal.
Arayüzden sunucuya kadar uçtan uca geliştirdiğim bir eğitim platformu. Okul öncesi ve ilkokul öğretmenlerine pano, takvim, kart ve okuma etkinliği gibi materyalleri PDF ya da Canva şablonu olarak sunar. SEO odaklı yapısıyla arama motorlarında öne çıkar; kapsamlı yönetim paneli, detaylı istatistikler ve kolay içerik yönetimi sağlar.
## nasıl çalışır
- 01
Materyali bul
Öğretmen sınıf ve konuya göre kategorilerde gezer ya da Türkçe’ye uyarlanmış aramayı kullanır.
- 02
İncele
Ürün sayfasında görseller, boy seçenekleri ve kullanım açıklaması yer alır.
- 03
Ücretsiz indir
Materyal PNG ya da PDF olarak indirilip yazdırılır.
- 04
Kaydet ve geri dön
Üye olanlar materyalleri favorilerine ekleyip beğenebilir.
## özellikler
Ücretsiz sınıf materyalleri
Okul öncesi ve ilkokul için pano, kart, boyama ve etkinlik şablonları.
Akıllı Türkçe arama
Türkçe karakter normalizasyonu, kök bulma, yazım hatası toleransı, eş anlamlılar ve otomatik tamamlama.
SEO odaklı yapı
Sunucuda oluşturulan sayfalar, dinamik sitemap, JSON-LD şemaları ve kalıcı URL yönlendirmeleri.
Yönetim paneli
Ürün ve kategori yönetimi; indirme, arama, hata ve ziyaretçi raporları.
Sohbetle içerik ekleme
MCP sunucusu sayesinde bir yapay zekâ asistanına Canva linki verilerek ürün taslağı oluşturulup yayınlanabilir.
Uygulama içi tarayıcı desteği
İndirmeyi engelleyen Instagram ve TikTok tarayıcılarında sayfa, sistem tarayıcısında açılmaya çalışılır.
## teknik detaylar
kullanılan teknolojiler
zorluk
Sayfaları hızlı tutarken yeni bir ürünün hemen yayına çıkması.
çözüm
Etiketli ISR önbelleği kullanılıyor; ürün yayınlandığında sunucu güvenli bir dahili uca istek atıp yalnızca ilgili etiketleri revalidateTag ile yeniliyor.
zorluk
Teknik bilgisi olmayan bir öğretmenin içerik ekleyebilmesi.
çözüm
PKCE’li OAuth 2.1 arkasında bir MCP sunucusu yazıldı. Asistan Canva tasarımını önizleyip metni kurallara göre yazıyor; sunucu sayfaları PNG ve A4 PDF’e çeviriyor, sharp ile WebP ve kapak görseli üretiyor, yayın öncesi onay istiyor.
zorluk
Türkçe aramada veritabanı regex’inin yetersiz kalması.
çözüm
Katalog bellekte kısa ömürlü bir indekste tutuluyor; alan ağırlıkları, eş anlamlılar, yazım toleransı ve popülerlik puanıyla sıralanıyor.