İçeriğe geç

Vaka çalışmasıYayında

Mentor Z

Sınıf sınıf Excel çalışma kitaplarının yerini alan bir koçluk paneli — tamamı Cloudflare’ın ücretsiz katmanında çalışıyor.

Rol
Tek mühendis — ürün, backend, frontend, Cloudflare
Ne zaman
2026
  • Backend
  • Full-stack

Panel gerçek öğrenci verisi tutuyor; bu yüzden yalnızca davetle giriliyor ve burada sadece herkese açık sayfalar var. Kaynak kod gizli.

Kimin için

  • Öğrencileri LGS ve YKS’ye hazırlayan ve her öğrenciyi sınıf bazlı bir Excel çalışma kitabından yöneten eğitim koçları — ödevler, yapılan işler, konu listeleri ve deneme sonuçları.
  • Çoğunlukla telefondan giren, bugünün ödevini görmek ve gerçekte ne yaptığını hızlıca girmek isteyen öğrenciler.
  • Bir yönetici koçun diğer koçları ve tüm öğrencileri gördüğü koçluk organizasyonları.

Ne yaptım

  • Domain modelinden ekranlara kadar tek başıma tasarlayıp geliştirdim: on üç ekran; öğrenciler için mobil öncelikli, koçlar için masaüstü öncelikli.
  • Cloudflare Workers üzerinde Hono API, D1 (SQLite) ve Drizzle migration’ları, manuel onaylı özel oturum yönetimi ve organizasyon bazlı veri izolasyonu.
  • Koçların çalışma kitaplarından bir kez çıkarılıp seed SQL olarak repoya giren bir müfredat (sınıf → ders → konu); çalışma kitaplarına bir daha gerek kalmıyor.
  • Her gece bir demo organizasyonu yeniden kuran bir cron — gerçek foreign-key grafiğini çıkaran bir test ve Worker’ın subrequest bütçesini ölçen bir kontrolle korunuyor; ayrıca basılabilir haftalık programlar ve her öğrencinin geçmişini koruyan eğitim yılı dönemleri.

Nasıl çalışıyor

  1. 1Haftayı planla

    Koç öğrencinin haftasını açar ve gün gün ödev ekler — ders, konu, yayın, soru hedefi — ya da geçen haftayı kopyalayıp düzenler.

  2. 2Çalışmayı gir

    Öğrenci telefonundan ne yaptığını girer: tür, sayfa, dakika, soru, doğru ve yanlış. Toplamlar ve çalışma serisi hesaplanır, yazılmaz.

  3. 3Konuları takip et

    Öğrencinin sınıfındaki her konu başlanmadı’dan bitti’ye ilerler; ders bazında ilerleme görünür.

  4. 4Denemeleri analiz et

    Deneme sonuçları ders ders (doğru / yanlış / boş) girilir; netler ve eğilimler koç için hesaplanır.

  5. 5Geride kalanı gör

    Koçun ana ekranı bu hafta ödevde geride kalanları gösterir; basılabilir haftalık program öğrenciyle eve gider.

Önemli kararlar

  1. 01

    Yalnızca edge, ücretsiz katmanda

    Yerine: Node ve PostgreSQL çalıştıran küçük bir sanal makine.

    Neden: Bir koçluk işletmesi için doğru işletme maliyeti sıfır, yamanması gereken doğru sunucu sayısı da hiç. Workers + D1 + Pages bunu sağlıyor; bedeli istek başına CPU ve subrequest bütçesi — bu yüzden ağır işler toplu yapılıp ölçülüyor.

  2. 02

    Multi-tenant, ama kendi kendine kayıt ve ödeme yok

    Yerine: Kaydı ve faturalaması olan self-servis bir SaaS.

    Neden: Organizasyonları ve koçları platform sahibi oluşturup onaylıyor. Bu, kötüye kullanımı, faturalamayı ve onboarding’i v1’in dışında tutuyor; veri modeli ise self-servis mantıklı olduğunda hazır olsun diye zaten organizasyon bazında izole.

  3. 03

    Tek ortak müfredat, bir kez seed’lenir

    Yerine: Her koçun Excel’ini içe aktarmaya devam etmek ya da her koçun kendi müfredatını düzenlemesi.

    Neden: İş akışı tüm sınıflarda aynı — yalnızca konular değişiyor. Bir kez üretilip repoya giren temiz bir sınıf → ders → konu taksonomisi, ve istisnalar için ödev başına serbest metin konu.

  4. 04

    Sayıları hesapla, saklama

    Yerine: Toplamlar, netler ve seriler için denormalize sayaçlar.

    Neden: Soru toplamları, netler (doğru − yanlış ÷ 4), tamamlanma ve seriler girilen çalışmadan türetiliyor; bu yüzden ondan asla sapamıyor — bu ölçekte SQLite bunları rahatça hesaplıyor.

Mimari

İSTEMCILERStudent appReact · mobil öncelikliCoach & adminReact · Vite · TailwindHTTPS · JSONEDGECloudflarePages · WorkersUYGULAMAHono APIoturum · organizasyonkapsamıCron triggergece demo yenilemeSQL · topluVERID1SQLite · Drizzlemigration’larıCurriculum seedüretilmiş SQL, repoda↑ yayına alırTESLIMATWorker testsVitest · WorkersruntimeUI testsVitest · jsdomSeed budgetsubrequest kontrolüwrangler deploymigrate · seed

Her şey Cloudflare’ın ücretsiz katmanında çalışıyor — yamanacak sunucu yok. Buradaki her şey benim.

Sayılar

aylık barındırma (Cloudflare ücretsiz katman)
0 ₺
öğrenci, koç ve yönetici ekranı
13
test dosyası, worker testleri gerçek runtime’da
120+
sınıf seviyesi, tek ortak müfredatta
8

Teknolojiler

Backend

  • Hono
  • TypeScript
  • Cloudflare Workers
  • D1 (SQLite)
  • Drizzle ORM
  • Cron Triggers

Frontend

  • React
  • Vite
  • Tailwind CSS

Kalite

  • Vitest (Workers runtime)
  • Miniflare
  • jsdom
  • tsc project references

Uzun versiyonu ister misin — kod, pipeline, ödünleşimler?

E-posta gönder
Sıradaki vaka çalışmasıHockey Pick’em & Sub PulseReddit’in geliştirici platformunda iki uygulama: ücretsiz bir hokey tahmin oyunu ve moderatörler için uyarılı haftalık sağlık raporu.