
Mini ders 10 / 30 · Sitenizi daha kullanışlı yapın
Kaydetmenin ne anlama geldiğini tanımlayın
Bu ders kimler için?
Web sitesi gönderimlerinin kaydedilmesini isteyenler için. Kodlama asistanı verilen kurulumu uygulayıp formu bağlayabilir; SQL veya sunucu kodu yazmanız gerekmez.
Kayıt, mevcut tarayıcı sayfasının dışında var olmalıdır.
Bu derste ne öğreneceksiniz?
- Form kaydını gerçek depolamaya gönderin.
- Sağlayıcının tablo görünümünde kalıcılığı doğrulayın.
- Herkesin kayıtlarını açığa çıkarmadan geçersiz girdiyi reddedin.
Açıklama, çözülmüş örnek ve alıştırma
Başlamadan önce
Kendi gözden çıkarılabilir Supabase projeniz ve Netlify function deneme projeniz gerekir. Kurulumda sağlanan eksiksiz dosyaları ve kodlama asistanını kullanın. Özel veritabanı kimlik bilgileri sunucuda kalsın; yalnızca yapay test mesajları kullanın. Örnek cevaplar, hesabınızda tamamlanmış testler değildir; bir cevabın nasıl yazılabileceğini gösterir. Örnekteki gözlemlerin yerine kendi sonuçlarınızı yazın ya da hangi adımda takıldığınızı belirtin.
Başlamak için gereken beceriler
Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
Bir alıştırma deposunu barındırma hizmetine bağlayın.
Tahmini süre: 20–37 dk
Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Hesap kurulumu ayrıca zaman ister. Kısıtlı alıştırma, herkese açık anonim geri bildirim hizmeti değildir; herkese uyarlamadan önce kalıcı kötüye kullanım sınırlarını değerlendirin.
Konuyu anlayalım
Hazır formu asistanınızla açıp ayırt edilebilir yapay bir ileti seçin. Bunu verilen sunucu üzerinden ayrı bir alıştırma veritabanına kaydedeceğiz.
Değerin hâlâ sayfada görünmesi veritabanında saklandığının kanıtı değildir. Aynı iletiyi sağlayıcıda ve yeniden açtıktan sonra bulmayı planlayın.
Somut bir örnek
Sağlayıcı tablosu ve o anki tarayıcı sayfası farklı yerlerdir. Uygulamayı kapattıktan sonra tabloda kalan mesaj, gönderme düğmesinin yanında hâlâ duran cümleden daha güçlü kanıttır.
Verilen geri bildirim saklama projesini kullan. Verilen şemayı yalnızca ayrı Supabase alıştırma veritabanıma uygulamama ve özel sunucu ortamını yapılandırmama yardım et. Ziyaretçinin geri bildirim tablosuna erişimini kısıtlı tut. Formu başlat; sağlayıcının tablo görünümüne yönlendir ve geçerli verinin kalıcı olduğunu, geçersiz isteklerin satır oluşturmadığını kontrol etmeme yardım et. SQL sözdizimini değil, yapacağım kontrolleri açıkla.Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
İletinizin gerçekten kaydedildiğini doğrulamak için nereye bakacaksınız?
Çözülmüş örneği göster
Örnek cevap: “D1 — blue notebook” test metnini gönderecek, aynı mesajı site sahibinin feedback tablosu görünümünde bulacak, sonra uygulamayı kapatıp yeniden açarak orada hâlâ bulunduğunu kontrol edeceğim. Formdaki etiket yalnızca ilk görünür yanıt.
İyi bir cevap neleri içermeli?
- Veritabanı sağlayıcısındaki eşleşen saklanmış kaydı, depolama kanıtı olarak belirler.
- Geçici başarı etiketine dayanmak yerine yeniden açma/yükleme kontrolü içerir.
Nasıl çalışır? (isteğe bağlı)
Kaydı tarayıcının dışında saklayın
Veritabanına kaydedilen satır, sayfa kapandıktan sonra da bulunmalıdır.
JavaScript değişkeni sayfası kapanınca kaybolur. Tarayıcının yerel saklama alanı o tarayıcıda kalır. Veritabanı ise kayıtları, uygulamanızın belirli izinlerle ulaşabildiği ayrı bir hizmette tutar.
Özel Supabase tablosu ve sunucu işlevi kullanacağız. Tarayıcı küçük mesaj gönderir; sunucu kontrol edip satırı kaydeder. Bu derste herkesin mesajlarını listeleyen açık bir veri adresi sunulmaz.
Çözülmüş örnek
“Database test D1” gönderdikten sonra sayfayı kapatıp projenin tablo düzenleyicisinde aynı mesajı bulun. Yalnızca sayfada gösterilen metin, kalıcı kaydetme kanıtı değildir.
Ek teknik alıştırma
Sayfa gönderilen mesajı yerel değişkenden gösteriyor. Veritabanına kaydedildiği kanıtlandı mı?
Çözülmüş örneği göster
Hayır. Veritabanındaki gerçek satırı doğrulayın. Hiç sunucu isteği yapılmasa bile tarayıcı yazılan mesajı gösterebilir.
- Ekranda gösterilen durumla saklanan veriyi ayırır.
- İzinli veritabanı görünümünden karşılık gelen satırı kontrol eder.

Adım 1 · Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
Yalıtılmış depolama projesini hazırlayın
Verilen kurulumu asistana güvenli biçimde uygulatın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
Gözden çıkarılabilir Supabase projenizi oluşturun veya seçin. Asistandan schema.sql dosyasını orada inceleyip uygulamanıza yardım etmesini, özel değerleri yapılandırmasını ve run-locally.txt ile tam projeyi çalıştırmasını isteyin.
Değişiklikleri uygulamadan önce doğru projeyi doğrulayın. Herkese açık ziyaretçilerin bütün geri bildirimleri taramasını engelleyin; test satırını incelemek için proje sahibinin Table Editor görünümünü kullanın.
Somut bir örnek
Sağlanan feedback tablosunda mesaj, üretilmiş kimlik ve oluşturulma saati var. Proje sahibi bunu sağlayıcıda inceleyebilir; bu test için ziyaretçilerin herkesin geri bildirimini okuma iznine ihtiyacı yok.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Hangi alıştırma projesini hazırladınız; proje sahibinin tablo görünümünü belirleyebiliyor musunuz?
Çözülmüş örneği göster
Örnek kurulum kaydı: Asistan schema.sql dosyasını yalnızca geçici deneme projemde uyguladı, özel sunucu değerlerini ayarladı ve sağlanan uygulamayı başlattı. Proje sahibi olarak Table Editor’da feedback verisini inceleyebiliyorum. Herkese açık ziyaretçiler bu tabloyu hâlâ göremiyor.
İyi bir cevap neleri içermeli?
- Geçici deneme projesini ve sağlanan şema/sunucu kurulumunun tamamlandığı veya takıldığı yeri belirtir.
- Ziyaretçilere okuma erişimi açmadan site sahibinin feedback Table Editor görünümünü bulur.
Nasıl çalışır? (isteğe bağlı)
Özel bir deneme tablosu oluşturun
Satır güvenliğini açın; bu örnekte tarayıcıdan doğrudan veri erişimini kapalı tutun.
Bu tablo yapısını yalnızca kurulumunuzda belirlediğiniz ayrı Supabase deneme projesinde çalıştırın. Tarayıcı erişimi bilerek kısıtlıdır; satırı proje sahibi olarak Dashboard → Table Editor içinde doğrulayın. Alıştırma SQL’ini canlı veritabanında çalıştırmayın.
Ayrı Supabase projesi oluşturup SQL düzenleyicisinde schema.sql çalıştırın. Tabloda otomatik ID, sınırları olan message alanı ve sunucunun verdiği tarih/saat bulunur. Örnek tablo değişikliklerini ilgisiz canlı veritabanına uygulamayın.
Betik satır güvenliğini açar ve tarayıcı rollerinin tablo izinlerini kaldırır. Sunucunun secret/service-role anahtarı ayrıcalıklı kaydı yapabilir; sunucuda kalmalıdır. Tarayıcıya uygun publishable anahtar farklıdır ve bu yönetici izinlerini vermez.
Deneme satırını görmek için Supabase proje panelinde Table Editor açın; bu, tarayıcının geliştirici konsolu değildir. Ekleme başarısızsa sunucu yanıtını ve proje/veritabanı ayarlarını inceleyin. Yalnızca satır eklendi mi görmek için anonim SELECT açmayın.
Yerel çalışma sırasının tamamı için run-locally.txt dosyasını açın: kökteki özel ortamı hazırlayın, yalnızca deneme projesini bağlayın ve Netlify işlevlerine istek ileten yerel aracı başlatın. server-env.example.txt gerçek sırlar olmadan değişken adlarını listeler. Yalnızca HTML’yi açmak sunucuyu çalıştırmaz.
Çözülmüş örnek
Sunucunun aracılık ettiği bu alıştırmada herkese izin veren genel kural gerekmez. Hatayı araştırmak için anonim SELECT açmak, gönderilen mesajları da ifşa eder.
create table public.feedback (
id uuid primary key default gen_random_uuid(),
message text not null check (char_length(message) between 1 and 1000),
created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.
Supabase: satır düzeyinde güvenlik · Node.js: desteklenen sürümlerin durumu
Ek teknik alıştırma
Tarayıcı sorgusu reddediliyor. Bütün geri bildirim tablosunu anonim kullanıcılara açarak mı düzeltmelisiniz?
Çözülmüş örneği göster
Hayır. Bu düzen bilerek tarayıcı okumalarını reddeder. Sunucunun yazma ayarını kontrol edip tabloyu sahibi olarak inceleyin.
- Verilerin özel kalması için kurulan denetimi korur.
- Herkese okuma izni vermek yerine sunucu yolunu veya yetkili paneli kullanır.

Adım 2 · Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
Sayfadan bir kayıt gönderin
Yazma işlemini hazır sunucu yapsın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
Gerçek yerel veya barındırılan alıştırma uygulamasını açıp D1 gibi bir ileti gönderin. Asistanınızdan kaydedilen kayıtta yalnızca hedeflenen ziyaretçi alanlarını tutmasını isteyin.
Sağlayıcı tablosunda D1 metnini tam olarak bulun; üretilen kimliğini/zamanını inceleyin. Gizli hesap değerlerini ekran görüntülerine veya paylaşılan notlara koymayın.
Somut bir örnek
D1’i gönderin; ardından feedback içinde tam o metni bulun. Üretilen kimlik bu satırı benzer metinli eski mesajdan ayırır; ziyaretçi bu kimliği seçmemeli veya üzerine yazmamalı.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
D1 için formda ve sağlayıcıda ne göründü?
Çözülmüş örneği göster
Örnek kaydetme kaydı: Form, mesajın kaydedildiğini bildirdi. Deneme sağlayıcısının feedback tablosunda “D1 — blue notebook” metnini, üretilmiş kimlik ve oluşturulma saatiyle buldum. Daha sonra aynı satırı tanımak için bu kimliği özel test notlarımda tuttum.
İyi bir cevap neleri içermeli?
- Gönderilen D1 metnini, üretilmiş kimliği/zamanı olan sağlayıcı satırıyla tam olarak eşleştirir.
- Özel yapılandırmayı paylaşmadan sayfa ve depolama sonuçlarını ayrı bildirir.
Nasıl çalışır? (isteğe bağlı)
Veriyi kontrol eden sunucu kaydını bağlayın
Tabloyu ve izin verilen alanları sunucu seçer; istemci yalnızca mesajı verir.
Adı verilen üç sunucu değişkenini ayarlayıp ayrı işlev projesini çalıştırın veya yayımlayın. Deneyen kişi uygulama kodunu girer. Kod bu kısıtlı adrese eriştirir; Supabase hesabına erişim sağlamaz.
mini-feedback.mjs dosyasını okuyun: sağlayıcıdan önce yöntem, erişim kodu, boyut ve mesaj kontrol edilir. İstemcinin verdiği ID veya tablo adları yok sayılır. Ancak ekleme yanıtı başarılıysa kaydedildi sonucu verilir.
Çözülmüş örnek
İsteğe eklenen admin alanı yönetici güncellemesine dönüşmez: sunucu yalnızca message içeren yeni bir nesne oluşturur.
Ek teknik alıştırma
Tarayıcıdaki bütün JSON’u veritabanına geçirmek yerine neden {message} oluşturulur?
Çözülmüş örneği göster
Sunucunun kabul ettiği alanları açık tutar ve beklenmedik alanların kayda dönüşmesini önler. Mesajı da doğrulayın; yalnızca alan seçmek yeterli değildir.
- Yazılabilen alanları sınırlar.
- İstemcinin belirlediği ID, tarih veya ayrıcalıklara güvenmez.

Adım 3 · Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
Kalıcılığı ve hatayı kontrol edin
İlk sayfayı kapattıktan sonra işlemi tekrarlayın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
Uygulamayı kapatıp yeniden açın; D1'in hâlâ depolamada olduğunu doğrulayın. Gözden çıkarılabilir kurulumda eksik/aşırı büyük girdi ve yanlış alıştırma kodunu deneyin.
Geçersiz denemeler yeni satır oluşturmamalıdır. Önceki başarı iletisi, sonraki başarısız deneme de kaydedilmiş gibi görünmeye devam etmemelidir.
Somut bir örnek
Olumsuz testlerden önce geçerli satırı kaydedin, sonra tabloyu yeniden inceleyin. “Form hata gösterdi” ve “geçersiz satır eklenmedi” kontrolün iki yararlı parçasıdır.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Yeniden açtıktan sonra hangi kayıtlar kaldı; geçersiz denemelerinizde ne oldu?
Çözülmüş örneği göster
Örnek olumsuz test kaydı: Sayfayı kapatıp açtıktan sonra D1 sağlayıcı tablosunda duruyordu. Boş, çok uzun ve yanlış deneme kodlu denemeler yeni satır oluşturmadı. Başarısız denemede, önceki Saved message ifadesini yeni denemede de geçerliymiş gibi bırakmak yerine hata gösterildi.
İyi bir cevap neleri içermeli?
- Belirlenen geçerli kaydın yeniden açıldıktan sonra kaldığını kontrol eder.
- Geçersiz veri/erişim denemelerinin satır eklemediğini ve yanıltıcı başarı durumu bırakmadığını doğrular.
Nasıl çalışır? (isteğe bağlı)
Kaydın kalıcılığını ve hataları doğrulayın
Ayırt edici mesajlar kullanıp veritabanına sayfadan bağımsız bakın.
Doğru deneme koduyla D1 gönderip tablo düzenleyicisinde eşleşen satırı inceleyin. Sayfayı kapatıp açın, kaydın hâlâ durduğunu doğrulayın. Hesap sırlarını paylaşmadan ID ve tarihini kaydedin.
Eksik mesajı, aşırı uzun mesajı ve yanlış erişim kodunu deneyin. Hiçbiri yeni satır oluşturmamalı. Gözden çıkarılabilir kurulumda eksik sunucu ayarının doğru hata verdiğini de kontrol edin.
Çözülmüş örnek
Geçerli bir kayıt ve reddedilmiş iki geçersiz istek, üç başarılı tıklamadan daha çok şey gösterir. İlk alıştırmada gerçek kişisel geri bildirim kullanmayın.
Ek teknik alıştırma
Sunucu hata döndürüyor ama tarayıcı önceki denemeden “Saved” (kaydedildi) gösteriyor. Neyi doğrulamalısınız?
Çözülmüş örneği göster
Yeni değerin satırı var mı bakın. Arayüz güncel hatayı göstermeli; önceki başarı bu denemenin sonucu sayılmamalı.
- Güncel yanıtı ve yeni ayırt edici değeri kontrol eder.
- Eski başarıyı başarısız yeni isteğin kanıtı saymaz.

Adım 4 · Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
Verileri açığa çıkarmadan konu ekleyin
Alan değişikliği için asistan kullanıp sonucu inceleyin.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
Asistandan forma, depolama kurulumuna ve sunucu doğrulamasına Project ve Question adlı iki konu eklemesini isteyin. Saklanan değerleri project ve question. Sağlanan referans, gereksinimi keşfetmek zorunda olduğunuz yer değil, kendi denemenizden sonra açılacak karşılaştırmadır.
Konu başına bir denetimli kayıt oluşturun ve asistan yardımıyla other adlı desteklenmeyen konuyu deneyin. feedback tablosunu ziyaretçilere kapalı tutarak iki kaydedilmiş değeri ve reddi doğrulayın.
Somut bir örnek
İzinli iki konu ekleyin: Project ve Question. Seçilen her değer mesajın yanında saklanmalı. Other bir reddetme testi; dolayısıyla güzel bir seçici tek başına depolama değişikliğini tamamlamaz.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
- schema.sqlBu dosyayı indir
- netlify/functions/mini-feedback.mjsBu dosyayı indir
- storage-record.txtBu dosyayı indir
- worksheet.htmlBu dosyayı indir
- reference/assignment-walkthrough.txtBu dosyayı indir
- reference/START-HERE.txtBu dosyayı indir
- reference/public/index.htmlBu dosyayı indir
- reference/public/app.jsBu dosyayı indir
- reference/netlify/functions/mini-feedback.mjsBu dosyayı indir
- reference/add-topic.sqlBu dosyayı indir
Sıra sizde
Konu değişikliğini ve gözlemlenen geçerli/geçersiz depolama sonuçlarını sunun.
Hazırlanacak çıktı: Geçerli verinin kalıcılığını ve geçersiz denemelerin reddini gösteren, hassas bilgileri çıkarılmış depolama kaydı.
Çözülmüş örneği göster
Örnek geliştirme kaydı: “D2 — project test”, project konusuyla; “D3 — question test”, question konusuyla kalıcı olarak saklandı. Desteklenmeyen other değeri reddedildi, yeni satır oluşturmadı. Bunları site sahibi olarak inceledim; ziyaretçilerin tablonun tamamını okuması kapalı kaldı.
İyi bir cevap neleri içermeli?
- Project ve Question konu değerlerini eşleşen denetimli kayıtlarıyla saklar.
- Ziyaretçilerin feedback tablosunu görememesini koruyarak desteklenmeyen konuyu reddeder.
Nasıl çalışır? (isteğe bağlı)
Ödeviniz: doğrulanan bir konu alanı saklayın
Tarayıcı izinlerini açmadan tabloyu ve sunucuyu birlikte genişletin.
Yalnızca project veya question kabul eden topic sütunu ekleyin. Sunucu izin verilen değerleri kontrol edip kaydedeceği nesneyi açıkça oluştursun. Forma da karşılık gelen seçim alanını ekleyin.
İzin verilen her konu için kayıt oluşturup desteklenmeyen değeri reddedin. ID ve tarih/saat üretimi veritabanında kalsın.
Bu alıştırmada DEFAULT, mevcut satırlara question değerini atar. Tabloda önceden satır varsa bir değer veya varsayılan belirlemeden NOT NULL sütunu eklemek başarısız olabilir. Gerçek bir veritabanı şeması değişikliğinde (migration), eski satırları hangi değerle dolduracağınızı mevcut verilere göre seçin; bu örnekteki varsayılanı düşünmeden kopyalamayın.
Çözülmüş örnek
Veritabanı kısıtı sunucu doğrulamasını destekler. Açık hata mesajları ve veri doğruluğunda birinin rolü diğerinin yerini tutmaz.
Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.
-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
check (topic in ('project','question'));Ek teknik alıştırma
Konu alanını ekleyip doğru verinin kalıcı olduğunu, yanlışın reddedildiğini gösterin.
Çözülmüş örneği göster
Konu eklerken üç katman uyuşmalı: tarayıcı select alanı, sunucunun izin listesi ve veritabanı sütunu/kısıtı. Referans ALTER TABLE, kısıtı uygulamadan önce belgelenen varsayılan konuyu atayarak mevcut satırları ele alır.
Sunucu yalnızca {message,topic} yazar. Desteklenmeyen konuyu gizli veritabanı anahtarını kullanmadan reddetmelidir. İstemcinin ID/tablo adlarını yok saymalı; sağlayıcıda yazma başarısızsa hata bildirmelidir.
Kaydedilen tam mesaj ve konuyu tarayıcı başarı paragrafında değil Supabase Table Editor içinde inceleyin. Tarayıcıyı yenileyip veya kapatıp aynı kaydı doğrulayın. Kendi hesabınızın araçlarını kullanın; sorun aramak için anonim okumayı açmayın.
- Konu kontrolü hem sunucuda hem veritabanında vardır.
- Geçerli satırlar kalır; desteklenmeyen değer yeni satır oluşturmaz.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.