Kodsuz Bir Yönetici Paneli Nasıl Kurulur (Ve Gerçekten İhtiyacınız Olup Olmadığını Nasıl Anlarsınız)

Yapay zekayla inşa edilen uygulamaların yarısından fazlası bir yönetici paneliyle birlikte çıkıyor. Çoğu işe yarıyor. Bazıları ise sadece geliştirici “yönetici işlevselliği ekle”yi varsayılan olarak uyguladığı ve kurucunun buna hiçbir zaman gerçekten ihtiyaç duymadığı için var oluyor.

İşe yarayan panel ile hayalet buton arasındaki fark netliktir — aslında neyi düzeltmeye çalıştığınızı bilmek.

Yönetici Paneli Tam Olarak Nedir?

Yönetici paneli, verilerinizi görebileceğiniz, değiştirebileceğiniz ve yanlış giden şeyleri silebileceğiniz özel bir sayfadan ibarettir. Hepsi bu kadar. Bir gösterge paneli değil. Analitik değil. Sadece bir tablo, belki birkaç buton, belki bir arama kutusu.

Uygulamanız başka insanlara yönelik bir hizmetse, muhtemelen buna ihtiyacınız olacak. Bir kullanıcının hesabını düzeltmek, bir siparişi iade etmek, spam bir kaydı silmek ya da verilerin doğru göründüğünü kontrol etmek isteyeceksiniz. Uygulamanız sadece kendiniz içinse, hiç ihtiyacınız olmayabilir. Bir e-tablo veya veritabanı aracı kullanabilirsiniz.

Dürüst olmak gerekirse: projelerin %51’i yönetici paneli ekliyor. Bunların çoğu gerçekten kullanılıyor. Bazıları ise inşa edilip unutuluyor.

Yapay Zeka Geliştiricinizden Bir Yönetici Paneli Nasıl İstersiniz?

Bunu somut ayrıntılarla istersiniz — tablo, sütunlar, işlemler — asla “yönetici kontrolleri ekle” gibi belirsiz bir talep değil. Geliştirici, bir tabloya mı yoksa on tabloya mı ihtiyacınız olduğunu, aranabilir mi yoksa sadece sıralanabilir mi olması gerektiğini ya da uygulamanız için “yönetici”nin ne anlama geldiğini bilemez.

Bunun yerine: “Yönetici kontrolleri ekle”

Şunu deyin: “Müşteri adı, sipariş tarihi, fiyat ve durumun yer aldığı bir tabloda tüm siparişleri görebileceğim bir yönetici sayfasına ihtiyacım var. Müşteri adına göre arama yapabilmeli, bir siparişe tıklayıp detaylarını görebilmeli ve kargoya verildi olarak işaretleyebilmeli ya da iade işlemi başlatabilmeliyim.”

Bu, geliştiriciye şunu söyler:

• Hangi verilerin önemli olduğunu (müşteri adı, tarih, fiyat, durum — gerisini atlayın)
• Neyi değiştirmeniz gerektiğini (kargoya verildi işaretleme, iade başlatma)
• Nasıl arama yaptığınızı (müşteri adına göre, sipariş numarasına göre değil)

Fark gerçek. Belirsiz = geliştirici tahmin yürütür ve ihtiyacınız olmayan özellikler inşa ederek zaman kaybeder. Somut = geliştirici tam olarak istediğinizi yarı sürede inşa eder.

Karşılaştırın:

• “Kullanıcıları yönetmem gerekiyor” → 4 saat, asla kullanmayacağınız özellikler dahil
• “Tüm kullanıcıları bir tabloda görmem, e-posta ile arama yapmam ve birini ‘yasaklı’ olarak işaretleyebilmem gerekiyor” → 2 saat, tam olarak istediğinizi alırsınız

Yapay Zeka Geliştirici Bir Yönetici Panelini Gerçekte Nasıl İnşa Eder?

Yapay zeka ile inşa edilen uygulamanız, verileri saklamak için Convex adlı bir veritabanı kullanır ve geliştirici isteğinizi üç görünür parçaya dönüştürür:

1. Bir sayfa (/admin gibi bir URL) ki buraya giriş yaparsınız
2. Bir tablo ki veritabanınızdaki verileri gösterir
3. Birkaç buton (düzenle, sil ya da belki tamamlandı olarak işaretle)

Perde arkasında, geliştirici iki dosya yazar:

• Sayfa (tabloyu ve butonları gösteren React bileşeni)
• Veritabanı bağlantısı (verilerinizi güvenli şekilde okuyup yazan fonksiyonlar)

Sayfa ve veritabanı birbiriyle konuşur. Bir butona tıklarsınız, sayfa bir istek gönderir, veritabanı işi yapar ve sayfa güncellenir.

Geliştirici şunları garanti eder:

• Yönetici sayfasını yalnızca siz (yönetici) görebilirsiniz
• Tablo aranabilir durumdadır
• Butonlar gerçekten çalışır
• Bir şeyler ters giderse, sayfa bozulmak yerine bir hata mesajı alırsınız

Gerçekten Bir Yönetici Paneline İhtiyacınız Var mı?

Uygulamanızda başka insanlar zaman zaman düzeltilmesi gereken veriler oluşturuyorsa buna ihtiyacınız vardır; tek kullanıcı sizsenizse ya da önemli hiçbir şey sizin haberiniz olmadan oluşturulmuyorsa muhtemelen ihtiyacınız yoktur.

Şu durumlarda yönetici paneline ihtiyacınız vardır:

• Uygulamanızda başkaları veri oluşturuyor (siparişler, profiller, gönderiler) ve hataları düzeltmeniz gerekiyor
• Toplu verileri görmeniz gerekiyor (bugün kaç kullanıcı kayıt oldu?)
• Bir şeyleri silmeniz gerekiyor (spam hesaplar, test verileri)
• Zaman zaman bir şeylerin bozulduğu ve elle düzeltmeniz gereken bir hizmet yürütüyorsunuz

Muhtemelen şu durumlarda ihtiyacınız yoktur:

• Uygulamanız sadece sizin için
• Kullanıcılar önemli veri oluşturmuyor
• Ara sıra yapılan küçük ayarlar için bir e-tablo veya veritabanı görüntüleyici kullanmakta bir sakınca görmüyorsunuz

Sık Yapılan Hatalar

Yönetici paneli hatalarının çoğu aynı üç alışkanlıktan kaynaklanır: asla açmayacağınız bir şey inşa etmek, gereğinden fazla cilalamak ve tek bir sayfaya çok fazla şey sıkıştırmak.

Hata 1: Asla kullanmadığınız bir yönetici paneli inşa etmek. Onu tanımlamak için üç gün harcadınız, geliştirici inşa etmek için dört saat harcadı ve şimdi bu, lansman kontrol listenizde işaretleyip unuttuğunuz bir madde. Gerçek bir hikaye: bir SaaS kurucusu “aktivite kayıtlarıyla birlikte tam kullanıcı yönetim panosu” istedi ve sadece bir kez giriş yaptı. Çözüm: birini istemeden önce kendinize “Buraya gerçekten ne zaman giriş yapacağım?” diye sorun. Cevap “ayda bir” veya “bir şeyler bozulduğunda” ise, inşa edin. Cevap “muhtemelen hiçbir zaman” ise, atlayın.

Hata 2: Gereğinden fazla süslemek. Pasta grafikleri veya mini grafiklerle dolu bir gösterge paneline ihtiyacınız yok. Bir tabloya, bir arama kutusuna ve çalışan butonlara ihtiyacınız var. Gerçek zamanlı analitiklerle güzel bir yönetici panosu inşa eden bir kurucu, bunu özelleştirmek için 12 saat harcadı, sonra analitiklere hiç bakmadığını fark etti. Çözüm: bir tablo isteyin. Sadece bir tablo. Cilayı sonra ekleyin.

Hata 3: Her şeyi tek bir sayfaya tıkıştırmaya çalışmak. Siparişleri, kullanıcıları, iadeleri ve abonelikleri yönetmeniz gerekiyorsa, tek bir “yönetici sayfası” istemek geliştiricinin dört tabloyu tek bir görünüme sıkıştırması anlamına gelir ve her şeyi bulmak zorlaşır. Çözüm: ayrı sayfalar isteyin. “Bir siparişler yönetici sayfasına ve bir kullanıcılar yönetici sayfasına ihtiyacım var.” Bu, hem inşa etmesi daha hızlı hem de kullanması çok daha kolay.

İlk Yönetici Paneliniz Nasıl Görünmeli

İlk yönetici paneliniz, bir arama kutusu ve düzenle/sil butonları olan basit bir tablo olmalı — daha fazlası değil. Basit tutun:

• Tablo: Verilerinizi satır ve sütunlar halinde gösterir
• Arama kutusu: Aradığınızı hızlıca bulun
• Düzenle butonu: Değiştirmek için bir satıra tıklayın
• Sil butonu: Hataları kaldırın
• Ekle butonu (isteğe bağlı): Gerekirse yeni veri oluşturun

Gerçekten ihtiyacınız olan bu kadar. Geliştirici size filtreler, sıralama veya toplu işlemler önerebilir. Bunlar olsa iyi olur türünden şeyler. İnşayı onlar için bekleterek geciktirmeyin.

Geliştiricinize Sormanız Gereken Sorular

Yönetici panelinizi tarif ederken şu beş soruyu yanıtlayın, geliştirici onu ilk seferde doğru inşa edebilsin:

1. Hangi tabloyu görmek istiyorum? (Siparişler, kullanıcılar, gönderiler vb.)
2. Hangi sütunlar önemli? (İsim, e-posta, tarih, fiyat, durum)
3. Şeyleri nasıl buluyorum? (İsme göre mi arama yapıyorum? Tarih aralığına göre mi filtreliyorum?)
4. Neyi değiştirmem gerekiyor? (Durum, silme, hepsi bu kadar mı?)
5. Bunu kim görmeli? (Sadece siz mi, yoksa başka yöneticiler de mi?)

Geliştirici geri döner ve farklı bir şey inşa ederse, bunun sebebi muhtemelen kastettiğinizden farklı bir şekilde tarif etmiş olmanızdır. Bu normal. Değiştirmesini isteyin. Uygulama sizin.

İnşa Edildikten Sonra Bir Yönetici Panelini Nasıl Test Edersiniz?

Giriş yapıp onu bozmaya çalışarak hemen test edin — her butona tıklayın, var olmayan şeyleri arayın ve silme işlemlerinin sayfa yenilendikten sonra da kalıcı olduğunu doğrulayın.

1. Giriş yapın ve bozun. Her butona tıklayın. Var olmayan bir şeyi arayın. Bir şeyi silmeyi deneyin, sonra gerçekten gittiğinden emin olmak için sayfayı yenileyin.
2. Uç durumları test edin. Ya bir siparişte müşteri adının içinde bir tırnak işareti varsa? Ya biri zaten iade edilmiş bir siparişi tekrar iade etmeye çalışırsa? Çoğu geliştirici bunu düşünür. Bazen düşünmez. Bozulursa, onlara söyleyin.
3. Bir hafta boyunca gerçekten kullanın. Her gün bir şeyleri düzeltmek için giriş yapıyor musunuz? Harika, işe yarıyor. 5 gündür açmadınız mı? Bu, ya onu silmeniz ya da yönetmediğiniz şeyin gerçekte ne olduğunu kendinize sormanız gerektiğinin bir işaretidir.

Asıl Mesele

Asıl beceri bir yönetici paneli inşa etmek değil — gerçekten neye ihtiyacınız olduğunu bilmektir. Çoğu geliştirici bir öğleden sonrada işlevsel bir yönetici sayfası yapabilir. Zor olan kısım, gerçekten hangi verileri görmeyi önemsediğinizi, “düzeltmenin” ne anlama geldiğini ve ne zaman bittiğini anlamaktır.

Küçük başlayın. Bir tablo ve bir arama kutusu. Gerçekten ihtiyaç duyduğunuzda daha fazlasını ekleyin.

Geliştiriciniz tüm bunları siz tek bir satır kod yazmadan yapabilir. Sizin işiniz ne isteyeceğinizi bilmektir.