word-match

Amaç ve Kapsam

İngilizce kelimeleri seviye ve kategori üzerinden çalışmaya yönelik bir web uygulaması. Mevcut Practice akışı, İngilizceden Türkçeye, Türkçeden İngilizceye ve karma yönlerde çoktan seçmeli veya yazılı sorular sunar. Kullanıcının oturumu ve kelime ilerlemesi kalıcı olarak saklanır.

Mimari ve Depo Yapısı

• WordMatch.API: ASP.NET Core API; Features/Auth, Features/Practice ve Features/Words altında kimlik, çalışma oturumları ve kelime kataloğu.
• WordMatch.Web: React ve TypeScript istemcisi; özelliklere ayrılmış sayfalar, TanStack Query ve ortak API istemcisi.
• Data/WordMatch.csv: kelime verisinin kaynak dosyası.
• WordMatch.API.Tests ve istemcideki test dosyaları: servis, endpoint ve arayüz davranışları.

Veriler EF Core aracılığıyla PostgreSQL’de tutulur. Tarayıcı oturumu ASP.NET Core Identity çerezleriyle yürütülür; değişiklik yapan isteklerde XSRF doğrulaması kullanılır.

Çalışma Akışı

Kullanıcı giriş yaptıktan sonra seviye, kategori ve çalışma yönünü seçer. API soru planını oluşturur, sorunun metnini ve cevap bilgisini oturum kaydına alır. İstemci soruları sırayla gösterir; cevaplar oturum ve kelime ilerlemesine işlenir. Yarım kalan oturuma devam etme, tamamlanan içeriği yeniden çalışma ve kategori ilerlemesini sıfırlama akışları bulunur.

Teknik Kararlar

Soru üretimi PracticeQuestionFactory içinde toplanır. Çoktan seçmeli soruların yanlış seçenekleri önce oturumdaki kelimelerden, sonra aynı seviyeden ve gerekirse tüm katalogdan aranır. Türkçe cevap karşılaştırmasında kültüre duyarlı karşılaştırma ve Unicode normalleştirmesi kullanılır.

Cevap kaydı ile ilerleme güncellemesi veritabanı işlemi içinde yürütülür. Soruların oturumda anlık kopyalarının tutulması, çalışma sırasında gösterilen içerikle cevap değerlendirmesini aynı veriye bağlar.

Sınırlar ve Doğrulama

İncelenen sürüm kategori temelli Practice üzerine kuruludur. Learn, Review ve dört boyutlu mastery modeli mevcut özellik olarak sunulmaz; bunlar repo belgelerinde planlanan işlerdir. CSV için otomatik ve tekrar çalıştırılabilir bir veri yükleme komutu bulunmadığından ilk kelime yüklemesi ayrı bir adımdır.

Depoda API testleri ve Vitest tabanlı istemci testleri bulunur. Bu incelemede kaynak kod okundu; uygulama servisleri ve bu test takımları çalıştırılmadı.

Kaynaklar

İnceleme tarihi: 8 Eylül 2026. İncelenen sürüm (7d5efd9).