Angkat aturan yang sudah ada di validasi dan migration menjadi dokumen project-rules.md: nominal, payment method, status, RLS, dan acceptance criteria yang bisa diuji.
PRD mini menjawab: apa yang ingin dibangun?
Rules menjawab: apa aturan main yang tidak boleh dilanggar?
Di aplikasi donasi, rules tidak boleh kabur. Kalimat seperti “donasi harus aman” terdengar bagus, tapi belum bisa diuji. Aman yang mana? Aman dari input palsu? Aman dari akses data donatur? Aman dari status yang loncat sembarangan?
Rules yang berguna harus spesifik dan bisa dicek.
Contoh:
textIni bisa diuji.
Bandingkan dengan:
textNominal donasi harus masuk akal.Ini terlalu subjektif.
Untuk starter ini, sebagian aturan sudah tertanam di dua tempat:
textsrc/lib/validations/donation.ts
supabase/migrations/20260829_vertical_slice.sqlBuka file validasi donasi. Kamu akan menemukan aturan seperti:
tsamount: z.coerce
.number()
.int('Nominal harus bilangan bulat')
.min(10_000, 'Minimum donasi Rp10.000')
.max(100_000_000, 'Maksimum donasi Rp100.000.000')Dari sini, rule-nya bukan “nominal harus valid”, tapi:
textNominal harus bilangan bulat, minimal Rp10.000, maksimal Rp100.000.000.Buka juga bagian metode pembayaran:
tspaymentMethod: z.enum(['qris', 'va'], {
errorMap: () => ({ message: 'Metode pembayaran tidak didukung' }),
})Rule-nya:
textMetode pembayaran yang diterima hanya QRIS dan Virtual Account.Migration juga menyimpan aturan penting:
sqlstatus text not null default 'pending'
check (status in ('pending','verified','rejected','cancelled','refunded'))Artinya status donasi hanya boleh salah satu dari daftar itu.
Ada juga policy insert:
sqlcreate policy "Anyone can insert pending donation"
on public.donations
for insert
to anon, authenticated
with check (status = 'pending');Ini memberi aturan yang sangat penting:
textDonasi baru dari user publik hanya boleh masuk dengan status pending.User tidak boleh mengirim donasi langsung dengan status verified. Kalau AI membuat form yang mengirim status dari client, itu red flag.
Rules menjelaskan batasan. Acceptance criteria menjelaskan bukti selesai.
Misalnya rule:
textNominal minimal Rp10.000.Acceptance criteria-nya bisa:
textJika user submit nominal Rp5.000, server mengembalikan error validasi dan donasi tidak tersimpan.Rule:
textCampaign publik hanya yang status published.Acceptance criteria:
textCampaign draft tidak muncul di halaman utama.Rule:
textDonasi baru harus pending.Acceptance criteria:
textSetelah submit valid, row terbaru di donations memiliki status pending.Acceptance criteria yang baik membuat hasil AI bisa diuji tanpa debat.
Gunakan prompt ini:
textSaya sedang menulis docs/project-rules.md untuk Platform Donasi Amanah.
Jangan mengubah file apa pun.
Baca:
- src/lib/validations/donation.ts
- supabase/migrations/20260829_vertical_slice.sql
Tolong keluarkan rules yang SUDAH ADA, bukan rules karangan.
Kelompokkan menjadi:
1. rules input donasi,
2. rules campaign,
3. rules status donasi,
4. rules akses/RLS,
5. acceptance criteria yang bisa diuji manual.
Untuk setiap rule, sebutkan sumber file atau potongan constraint-nya.Perhatikan frasa yang sudah ada. Kita tidak sedang meminta AI menciptakan aturan baru. Kita meminta AI membantu mengangkat aturan yang tersebar di kode menjadi dokumen yang bisa dibaca ulang.
Jangan salin hasil agent begitu saja. Cek dengan command:
bashgrep -n "min(10_000\|max(100_000_000\|paymentMethod" src/lib/validations/donation.ts
grep -n "status in\|create policy\|with check" supabase/migrations/20260829_vertical_slice.sqlDari output itu, cocokkan:
pending;published.Kalau agent menyebut rule yang tidak bisa kamu temukan sumbernya, jangan masukkan dulu ke dokumen.
docs/project-rules.mdBuat file:
textdocs/project-rules.mdIsi awal:
md# Project Rules — Platform Donasi Amanah
## Input donasi
- Nominal harus bilangan bulat.
- Nominal minimal Rp10.000.
- Nominal maksimal Rp100.000.000.
- Nama donatur wajib, minimal 2 karakter dan maksimal 120 karakter.
- Email opsional, tetapi jika diisi harus valid.
- Nomor WhatsApp opsional, tetapi jika diisi harus memakai format nomor Indonesia yang valid.
- Metode pembayaran hanya `qris` atau `va`.
- Consent wajib dicentang.
## Campaign
- Campaign publik hanya yang statusnya `published`.
- Campaign punya `target_amount` lebih dari 0.
## Donasi
- Donasi baru selalu dimulai dari status `pending`.
- Status yang dikenal: `pending`, `verified`, `rejected`, `cancelled`, `refunded`.
- User publik hanya boleh insert donasi dengan status `pending`.
- Nomor donasi harus unik.
## Akses data
- Campaign published boleh dibaca publik.
- Donasi hanya boleh dibaca pemiliknya atau lewat mekanisme lookup token yang aman.
- Token lookup disimpan sebagai hash, bukan token mentah.
## Acceptance criteria umum
- Nominal di bawah Rp10.000 ditolak oleh server.
- Campaign draft tidak tampil publik.
- Submit valid membuat donasi berstatus `pending`.
- User tidak bisa mengirim status `verified` dari form publik.Dokumen ini akan dipakai prompt berikutnya. Jadi tulis dengan bahasa yang jelas, bukan sekadar copy paste constraint SQL.
Satu rule dianggap bagus kalau bisa menjawab:
textBisakah saya membuktikan rule ini benar/salah?Kalau jawabannya tidak, rule itu masih terlalu kabur.
Contoh yang perlu diperbaiki:
textData donatur harus aman.Versi yang lebih bisa diuji:
textEmail dan phone donatur tidak tampil di laporan publik.Output sesi ini:
textdocs/project-rules.mdPlus minimal tiga acceptance criteria yang nanti bisa dipakai di prompt:
md## Acceptance criteria untuk prompt pertama
- Dari halaman utama, klik campaign published harus menuju halaman donasi, bukan 404.
- Perubahan tidak boleh menyentuh schema database.
- Setelah perubahan, `npm run build` tetap berhasil.Kamu akan memakai acceptance criteria ini di prompt pertama.
docs/project-rules.md ada.donation.ts atau migration, bukan imajinasi.pending, bukan verified.Sekarang PRD menjelaskan arah, rules menjelaskan pagar, dan acceptance criteria menjelaskan bukti selesai. Setelah ini baru masuk akal meminta Antigravity menyentuh kode.
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!