Baca migration Supabase sebagai sumber kebenaran: tabel, index, RLS, fungsi lookup, trigger nomor donasi, status guard, dan seed campaign.
Data contract sudah menjelaskan peta. Sekarang kita cek tanah aslinya: database.
Di project AI coding, migration bukan sekadar file SQL. Migration adalah cara kamu membuktikan bahwa struktur yang kamu bicarakan benar-benar bisa dibuat. Kalau migration gagal, semua prompt fitur setelahnya akan berdiri di atas asumsi yang rapuh.
Starter memakai satu migration inti:
textsupabase/migrations/20260829_vertical_slice.sqlFile ini membuat:
pgcrypto;campaigns, donors, donations, payments;Buka Supabase Dashboard → SQL Editor. Pastikan kamu berada di project yang sama dengan .env.local.
Cara aman mengecek tanpa menampilkan nilai secret:
bashgrep -E '^NEXT_PUBLIC_SUPABASE_URL=' .env.localCocokkan project ref pada URL dengan dashboard yang sedang kamu buka. Jangan paste nilai env ke chat atau laporan.
Setelah yakin project benar, buka isi migration, paste ke SQL Editor, lalu Run.
Kalau migration sudah pernah dijalankan, sebagian statement aman karena memakai if not exists dan on conflict. Tetapi policy dengan nama yang sama bisa tetap bentrok di database tertentu. Kalau muncul error “policy already exists”, itu berarti struktur kemungkinan sudah pernah dibuat. Jangan langsung hapus policy. Cek dulu via dashboard atau query introspeksi.
Jalankan query ini di SQL Editor:
sqlselect table_name
from information_schema.tables
where table_schema = 'public'
and table_name in ('campaigns', 'donors', 'donations', 'payments')
order by table_name;Output yang kamu harapkan:
textcampaigns
donations
donors
paymentsUrutannya bisa berbeda tergantung tampilan, tapi empat tabel itu harus ada.
Lalu cek kolom penting:
sqlselect table_name, column_name, is_nullable, data_type
from information_schema.columns
where table_schema = 'public'
and table_name in ('campaigns', 'donors', 'donations', 'payments')
and column_name in (
'slug', 'status', 'campaign_id', 'donor_id', 'donation_number',
'payment_method', 'lookup_token_hash', 'idempotency_key', 'donation_id'
)
order by table_name, column_name;Dari sini kamu bisa membuktikan beberapa hal:
campaigns.slug ada;donations.campaign_id tidak nullable;donations.donor_id nullable;donations.donation_number ada dan unik di migration;payments.donation_id wajib.Di migration ada dua index penting:
sqlcreate unique index if not exists donations_idempotency_key_idx
on public.donations (idempotency_key)
where idempotency_key is not null;create index if not exists donations_lookup_token_hash_idx
on public.donations (lookup_token_hash)
where lookup_token_hash is not null;Index pertama mencegah submit ganda dengan idempotency key yang sama. Index kedua membantu lookup halaman konfirmasi tanpa menyimpan token mentah sebagai query utama.
Cek index di database:
sqlselect indexname, indexdef
from pg_indexes
where schemaname = 'public'
and tablename = 'donations'
order by indexname;Yang kamu cari:
donations_idempotency_key_idx;donations_lookup_token_hash_idx;donation_number.Migration mengaktifkan RLS:
sqlalter table public.campaigns enable row level security;
alter table public.donors enable row level security;
alter table public.donations enable row level security;
alter table public.payments enable row level security;Cek dari database:
sqlselect relname, relrowsecurity
from pg_class
where relnamespace = 'public'::regnamespace
and relname in ('campaigns', 'donors', 'donations', 'payments')
order by relname;relrowsecurity harus true untuk keempat tabel.
Lalu lihat policy:
sqlselect tablename, policyname, roles, cmd, qual, with_check
from pg_policies
where schemaname = 'public'
order by tablename, policyname;Makna policy yang perlu kamu pahami:
| Tabel | Policy | Inti aturan |
|---|---|---|
| campaigns | Published campaigns are public | anon/authenticated boleh baca campaign published |
| donors | Anyone can create donor | anon/authenticated boleh insert donor |
| donors | User manages own donor | authenticated hanya baca donor miliknya |
| donations | Anyone can insert pending donation | anon/authenticated boleh insert donation hanya status pending |
| donations | Donor reads own donations | authenticated baca donation miliknya |
payments RLS aktif, tetapi belum ada policy publik pada migration ini. Itu berarti akses payment default tertutup. Ini bukan sesuatu yang perlu “dibetulkan” sekarang. Nanti saat payment flow dikerjakan, aksesnya harus didesain dengan sengaja.
Ada fungsi:
sqlcreate or replace function public.get_donation_by_lookup(p_token_hash text)
returns table (...)
language plpgsql
security definer
set search_path = publicFungsi ini penting karena donatur guest tidak selalu punya auth.uid(). Kalau confirmation page perlu membaca donasi guest, ia tidak bisa mengandalkan policy “pemilik akun”. Solusinya: lookup memakai token hash melalui fungsi yang dibatasi.
Perhatikan dua hal:
p_token_hash, bukan token mentah;Cek function:
sqlselect proname, prosecdef
from pg_proc
where proname = 'get_donation_by_lookup';prosecdef = true berarti security definer aktif.
Migration membuat sequence:
sqlcreate sequence if not exists public.donation_number_seq;Lalu trigger nomor donasi:
sqlcreate trigger trg_donations_assign_number
before insert on public.donations
for each row
when (new.donation_number is null)
execute function public.assign_donation_number();Artinya database bisa mengisi donation_number kalau insert tidak mengirim nomor.
Ada juga trigger status:
sqlcreate trigger trg_donations_check_status
before update on public.donations
for each row
execute function public.check_donation_status_transition();Aturannya:
sql(old.status = 'pending' and new.status in ('verified','rejected','cancelled')) or
(old.status = 'verified' and new.status = 'refunded')Jadi transisi seperti rejected → verified harus ditolak. Ini bukan sekadar aturan UI. Database ikut menjaga.
Cek trigger:
sqlselect trigger_name, event_manipulation, event_object_table, action_timing
from information_schema.triggers
where trigger_schema = 'public'
order by event_object_table, trigger_name;Kamu harus menemukan trigger untuk donations.
Di akhir migration ada seed:
sqlinsert into public.campaigns (title, slug, summary, description, target_amount, status)
values (
'Paket Pangan untuk Keluarga',
'paket-pangan-keluarga',
'Bantu kebutuhan pokok keluarga prasejahtera.',
'Campaign contoh untuk vertical slice donation flow.',
100000000,
'published'
)
on conflict (slug) do nothing;Cek datanya:
sqlselect title, slug, target_amount, status
from public.campaigns
where slug = 'paket-pangan-keluarga';Yang kamu harapkan:
textPaket Pangan untuk Keluarga | paket-pangan-keluarga | 100000000 | publishedSeed ini yang membuat homepage punya campaign untuk diklik saat latihan.
Sekarang boleh minta bantuan agent, tapi hanya untuk merangkum.
textSaya ingin membuat docs/schema-catatan.md.
Jangan mengubah migration dan jangan mengubah kode aplikasi.
Baca supabase/migrations/20260829_vertical_slice.sql, lalu bantu saya menulis catatan schema maksimal 1 halaman yang berisi:
1. empat tabel utama dan perannya,
2. index penting untuk donation flow,
3. RLS policy per tabel,
4. fungsi get_donation_by_lookup dan kenapa dipakai untuk guest,
5. trigger nomor donasi dan trigger status transition,
6. seed campaign awal.
Jangan menambahkan aturan yang tidak ada di migration.
Tandai jika ada bagian yang perlu diverifikasi di Supabase Dashboard.Setelah agent memberi draft, cocokkan lagi dengan query di atas. Jangan jadikan agent sebagai sumber kebenaran utama.
docs/schema-catatan.mdIsi ringkasnya bisa seperti ini:
md# Schema Catatan — Platform Donasi Amanah
## Tabel utama
- campaigns: program donasi. Publik membaca yang statusnya published.
- donors: profil/identitas donatur. user_id opsional.
- donations: record utama donasi. Wajib campaign_id, donor_id opsional, status awal pending.
- payments: attempt pembayaran untuk donation.
## Index penting
- donations_idempotency_key_idx: mencegah submit ganda dengan key sama.
- donations_lookup_token_hash_idx: mempercepat lookup confirmation via token hash.
- donations_campaign_id_idx: query donasi per campaign.
- donations_status_idx: query donasi berdasarkan status.
## RLS
- campaigns: anon/authenticated boleh select hanya published.
- donors: anon/authenticated boleh insert; authenticated baca miliknya.
- donations: anon/authenticated boleh insert hanya pending; authenticated baca miliknya.
- payments: RLS aktif; policy publik belum dibuka.
## Guest confirmation
- get_donation_by_lookup(p_token_hash) adalah security definer function.
- Dipakai untuk membaca donasi guest lewat hash token, bukan auth.uid().
- Return field dibatasi untuk confirmation page.
## Trigger
- trg_donations_assign_number: before insert, isi donation_number jika null.
- trg_donations_check_status: before update, batasi transisi status.
## Seed
- Campaign: Paket Pangan untuk Keluarga.
- Slug: paket-pangan-keluarga.
- Target: 100000000.
- Status: published.Migration memberi tiga jenis kebenaran:
Kalau nanti AI mengusulkan perubahan yang bertentangan dengan migration, kamu punya dasar untuk menolak atau meminta revisi. Bukan karena kamu “lebih tahu semua SQL”, tapi karena kamu sudah membaca bukti.
campaigns, donors, donations, dan payments.get_donation_by_lookup.donations.paket-pangan-keluarga ada dan statusnya published.docs/schema-catatan.md selesai.Selesai bagian database awal. Kalau tadi sempat terasa berat karena banyak SQL, wajar kok. Yang penting kamu sudah melihat sendiri bahwa donation flow ini bukan cuma form: ada RLS, lookup token, idempotency index, dan trigger status yang akan jadi pegangan saat agent mulai membangun fitur berikutnya.
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.
Ajukan pertanyaan, beri solusi, atau diskusikan materi pelajaran ini.
Belum ada komentar untuk pelajaran ini.
Jadilah yang pertama memulai diskusi atau mengajukan pertanyaan!