4.8 yıldız, 0 yorum: portföyünüzdeki sahte metrikler
Bir portföy sitesinin proje sayfasında şu ikili yan yana duruyordu:
4.8 ★
Yeterli değerlendirme yok
Puanın kaynağı veritabanı şemasındaki bir varsayılan değerdi:
rating Float @default(5.0)
reviewCount Int @default(0)
downloadCount String? @default("1K+")
Buna bir de demo verisi eklenmişti — rating: 4.8, reviewCount: 42 gibi. Demo verisi canlıya taşındı, sayfalar rating sütununu doğrudan okudu, ve sitedeki her proje hiç almadığı bir puanla yayına girdi.
Neden referans eksikliğinden daha kötü
Genç bir şirketin referansının olmaması normaldir; ziyaretçi bunu "yeni kurulmuş" diye okur. Uydurma metrik ise başka bir şey söyler. Üstelik yakalanması kolaydır: 4,8 puanın yanında sıfır yorum yazıyorsa, o sayfadaki diğer iddialar da sorgulanmaya başlar. Bir kez kaybedilen güveni geri kazanmak, hiç kazanılmamış güveni kazanmaktan zordur.
Kural: sayı, arkasındaki kanıtla birlikte gösterilir
Çözüm puanı silmek değil, gösterme koşulunu değiştirmek:
export function resolveProjectRating(reviews, externalRating, externalCount) {
const fromReviews = ratingFromReviews(reviews);
if (fromReviews) return fromReviews;
// Bir mağaza listelemesi her iki değeri de taşır; ikisi de gerekli.
if (externalRating && externalCount && externalCount > 0) {
return { average: externalRating, count: externalCount };
}
return null;
}
Kritik nokta son satır: null. Veri yoksa bileşen hiçbir şey basmıyor. Yer tutucu yok, "Henüz puan yok" yazısı yok — bölüm tamamen kayboluyor.
Ve arkasında sayısı olmayan bir puan kabul edilmiyor. Tek başına "4.8" uydurma sosyal kanıtın aldığı şeklin ta kendisi; "128 değerlendirmeye göre 4,6" ise doğrulanabilir bir iddia.
Şema varsayılanları sessizce içerik üretir
Buradaki asıl ders şemayla ilgili. @default("1K+") yazan bir sütun, hiç dokunulmamış her satıra bir iddia yerleştiriyor. Kod bunu bir gün okuduğunda, kimse bir şey girmemiş olmasına rağmen sitede bir sayı beliriyor.
İçerik alanlarının varsayılanı boş olmalı. "Bilinmiyor" ile "1K+" arasındaki fark, veritabanı açısından küçük; okuyucu açısından her şey.
Aynı ailedeki diğer hata: uygulanmayan bayrak
Aynı denetimde ikinci bir şey çıktı: projelerde isVisible alanı vardı, admin panelinde bir anahtar olarak duruyordu, ama public taraftaki hiçbir sorgu onu filtrelemiyordu. Gizli işaretlenmiş yedi proje — ikisi müşteriye ait — herkese açık şekilde listeleniyordu. Sitemap bile onları arama motorlarına gönderiyordu.
Bir bayrağın var olması uygulandığı anlamına gelmiyor. Şemaya bir görünürlük alanı eklediyseniz, onu okuyan her sorguyu — liste, detay sayfası, meta veri, sitemap, RSS — tek tek doğrulayın.