| Field |
Nilai |
| ID Dokumen |
SV-DATA-001 |
| Pilar |
Data |
| Standar Acuan |
DAMA-DMBOK & Entity-Relationship Modeling |
| Status |
Aktif / Tersinkronisasi dengan Kode |
| Terakhir Diperbarui |
2026-11-21 |
| Sumber Kebenaran |
prisma/schema.prisma, prisma/migrations/*/migration.sql, prisma.config.ts |
Dokumentasi lengkap skema basis data PostgreSQL Sudirman Voice yang terdiri atas 39 model (tabel) dan 12 enum, dibangun melalui 36 migrasi SQL di prisma/migrations/.
- Kualifikasi Skema Eksplisit (
public.<table>): Proyek Neon organisasi untuk production memakai default server dengan search_path kosong (sekalipun database voice disetel ALTER DATABASE voice SET search_path TO public). Oleh karena itu:
- Setiap query SQL mentah (
$queryRaw / $executeRaw) di aplikasi wajib menulis nama skema lengkap, misalnya public."users", public.forms, public.polls, public.hackathons, public.hackathon_tim, public.poll_votes, public."login_throttles".
- Prisma CLI (
prisma.config.ts) melalui fungsi denganSchema() otomatis menyuntikkan ?schema=public ke URL koneksi agar prisma migrate deploy tidak gagal menginisialisasi tabel persistensi migrasi.
- Tes integrasi dan E2E (
tests/helpers/global-setup.ts) secara sengaja menjalankan ALTER DATABASE sv_test SET search_path TO '' agar SQL tanpa prefix public. langsung terdeteksi gagal di CI sebelum menyentuh production.
- Konvensi Penamaan & Pengenal:
- Nama tabel dan kolom PostgreSQL memakai
snake_case (@@map, @map), sedangkan field Prisma Client memakai camelCase.
- Kunci utama (Primary Key) memakai
UUID (@db.Uuid), kecuali LoginThrottle.ip dan Pengaturan.kunci yang memakai String (TEXT).
- Kode tampilan manusiawi (
ASP-0001, FRM-0001, PLL-0001, HKT-0001, LAP-0001, DAT-0001) dibentuk dari kolom integer berurutan nomor (SERIAL / @default(autoincrement()) unik).
- Seluruh kolom waktu memakai
TIMESTAMPTZ(3) (disimpan UTC, diformat ke WIB di lapisan presentasi).
erDiagram
User ||--o{ UserPeran : memegang
Peran ||--o{ UserPeran : dipegang
User ||--o{ Session : memiliki
User ||--o{ Notification : menerima
User ||--o{ PushSubscription : berlangganan
User ||--o{ Pengingat : diingatkan
User ||--o{ EmailKeluar : antrean_email
User ||--o{ KodeEmail : kode_verifikasi
User ||--o{ Persetujuan : menyetujui
User ||--o{ PermintaanData : mengajukan
User ||--o{ LaporanMasalah : melaporkan
erDiagram
User ||--o{ Aspiration : mengirim
AspirationCategory ||--o{ Aspiration : mengelompokkan
Aspiration ||--o{ AspirationEvent : riwayat
Aspiration ||--o{ AspirationImage : lampiran
AspirationEvent ||--o{ AspirationImage : foto_bukti
User ||--o{ AspirationEvent : bertindak
Peran ||--o{ Form : memiliki
User ||--o{ Form : membuat
Form ||--o| FormBanner : sampul
Form ||--o{ FormResponse : jawaban
Form ||--o{ FormReminder : pengingat_lama
User ||--o{ FormResponse : mengisi
FormResponse ||--o{ FormAnswer : butir
Peran ||--o{ FormTemplate : template_form
User ||--o{ FormTemplate : membuat
Peran ||--o{ Poll : memiliki
User ||--o{ Poll : membuat
Poll ||--o{ PollVote : suara
User ||--o{ PollVote : memilih
Peran ||--o{ PollTemplate : template_poll
User ||--o{ PollTemplate : membuat
erDiagram
Peran ||--o{ Hackathon : menyelenggarakan
User ||--o{ Hackathon : membuat
Hackathon ||--o{ HackathonBidang : memiliki_bidang
Hackathon ||--o{ HackathonKriteria : daftar_kriteria
HackathonBidang ||--o{ HackathonKriteria : kriteria_bidang
Hackathon ||--o{ HackathonJuri : menunjuk
User ||--o{ HackathonJuri : menjadi_juri
Hackathon ||--o{ HackathonTim : peserta
User ||--o{ HackathonTim : mengetuai
HackathonTim ||--o{ HackathonAnggota : beranggotakan
Hackathon ||--o{ HackathonAnggota : indeks_unik_peserta
User ||--o{ HackathonAnggota : tergabung
HackathonTim ||--o| HackathonSubmisi : mengirim_karya
HackathonBidang ||--o{ HackathonSubmisi : kategori_karya
HackathonSubmisi ||--o{ HackathonGambar : tangkapan_layar
HackathonSubmisi ||--o{ HackathonRating : bintang_favorit
User ||--o{ HackathonRating : memberi_bintang
HackathonSubmisi ||--o{ HackathonNilai : dinilai
HackathonKriteria ||--o{ HackathonNilai : aspek
User ||--o{ HackathonNilai : juri_menilai
HackathonSubmisi ||--o{ HackathonKomentar : masukan
User ||--o{ HackathonKomentar : juri_berkomentar
| Enum |
Nilai |
Dipakai pada Model |
AuditAction |
IMPORT, RESET_PIN, BULK_RESET_PIN, UNLOCK, AUTO_LOCK, UPDATE_USER, SET_ROLES, DEACTIVATE, REACTIVATE, PIN_CHANGED, ASP_STATUS, ASP_PRIORITAS, ASP_PUBLIKASI, ASP_MINTA_KETERANGAN, PIN_SEMENTARA, AKTIVASI_GOOGLE, LAPORAN_STATUS, HKT_BUAT, HKT_UBAH, HKT_TAHAP, HKT_UMUMKAN, HKT_TIM, EMAIL_TERIKAT, EMAIL_DILEPAS, ASP_KATEGORI, FORM_BUAT, FORM_UBAH, FORM_TERBIT, FORM_TUTUP, FORM_BUKA, FORM_HAPUS, FORM_TEMPLATE, POLL_TEMPLATE, PERAN_BUAT, PERAN_UBAH, PERAN_STATUS, PERAN_TETAPKAN, POLL_BUAT, POLL_UBAH, POLL_TERBIT, POLL_TUTUP, POLL_BUKA, POLL_HAPUS, FORM_SEMBUNYI, FORM_TAMPIL, POLL_SEMBUNYI, POLL_TAMPIL, DATA_PERMINTAAN, PENGATURAN, FORM_IMPOR, POLL_IMPOR, ASP_IMPOR (52 nilai) |
AuditLog |
AspirationJenis |
SARAN, KRITIK, PERTANYAAN, LAPORAN, LAINNYA |
Aspiration |
AspirationStatus |
TERKIRIM, DITINJAU, DITINDAKLANJUTI, SELESAI, DITOLAK |
Aspiration, AspirationEvent |
AspirationPrioritas |
MENDESAK, NORMAL, RENDAH |
Aspiration |
AspirationEventType |
STATUS, KETERANGAN, PRIORITAS, PUBLIKASI, PERMINTAAN |
AspirationEvent |
FormStatus |
DRAF, TERBIT, DITUTUP |
Form, Poll |
FormKepentingan |
PENTING, BIASA |
Form |
FormJenis |
INTERNAL, TAUTAN |
Form |
PollMode |
SATU, BANYAK |
Poll |
PollHasil |
LANGSUNG, SETELAH_DITUTUP |
Poll |
LaporanStatus |
BARU, DIPROSES, SELESAI |
LaporanMasalah |
HackathonStatus |
DRAF, SUBMISI, PENILAIAN, REKAP, DIUMUMKAN |
Hackathon |
Model (@@map) |
PK & Kunci Unik |
Kolom Penting, Relasi FK & Indeks |
User (users) |
PK id (UUID); Unique: noSerdik, email |
nama, grup (1–4), elemen (1–3), kelas?, emailTerikatPada?, pinHash, mustChangePin (default true), failedAttempts, lockedUntil?, activatedAt?, isActive (default true), ringkasanEmail (default true), lastLoginAt? |
Peran (peran) |
PK id (UUID); Unique: kode, serta indeks unik SQL lower(nama) |
nama, keterangan?, kode? (ADMIN / LEMUSDIK), aktif, izinForm, izinPolling, izinDataUser, izinHackathon |
UserPeran (user_peran) |
PK gabungan [userId, peranId] |
FK ke User & Peran (keduanya onDelete: Cascade); indeks [peranId] |
Session (sessions) |
PK id (UUID); Unique: tokenHash |
userId (FK User Cascade), expiresAt, lastSeenAt, userAgent?; indeks [userId] |
LoginThrottle (login_throttles) |
PK ip (String) |
windowStart, failedCount |
AuditLog (audit_logs) |
PK id (UUID) |
actorId? (UUID tanpa FK keras), action (AuditAction), targetUserId?, meta? (Json), createdAt; indeks [createdAt] |
Notification (notifications) |
PK id (UUID) |
userId (FK User Cascade), type, title, link?, readAt?, createdAt; indeks [userId, createdAt] |
PushSubscription (push_subscriptions) |
PK id (UUID); Unique: endpoint |
userId (FK User Cascade), p256dh, auth, userAgent?; indeks [userId] |
Pengingat (pengingat) |
PK id (UUID); Unique [jenis, kontenId, userId, tahap] |
jenis (FORM / POLL), kontenId (UUID), userId (FK User Cascade), tahap (6 / 3 / 1) |
EmailKeluar (email_keluar) |
PK id (UUID) |
userId (FK User Cascade), alamat, jenis, subjek, teks, html, prioritas (1–3), status (MENUNGGU/TERKIRIM/GAGAL), percobaan, cobaPada, terkirimPada?, galat?; indeks [status, prioritas, cobaPada], [userId, createdAt] |
KodeEmail (kode_email) |
PK id (UUID) |
userId (FK User Cascade), keperluan (AKTIVASI/GANTI_EMAIL), tujuan, kodeHash, kedaluwarsa, percobaan, dipakai; indeks [userId, keperluan, createdAt] |
Persetujuan (persetujuan) |
PK id (UUID) |
userId (FK User Cascade), versi (Int), aksi (SETUJU / TARIK); indeks [userId, createdAt] |
PermintaanData (permintaan_data) |
PK id (UUID); Unique nomor (DAT-XXXX) |
userId (FK User Cascade), jenis (LIHAT/PERBAIKI/HAPUS/INSIDEN/PERTANYAAN), isi, status (BARU/DIPROSES/SELESAI), tanggapan?; indeks [status, createdAt], [userId, createdAt] |
Pengaturan (pengaturan) |
PK kunci (String) |
nilai (Json, mis. hackathon_tampil & ringkasan_email_terakhir), updatedAt, updatedBy? |
Model (@@map) |
PK & Kunci Unik |
Kolom Penting, Relasi FK & Indeks |
AspirationCategory (aspiration_categories) |
PK id (UUID); Unique: nama |
urutan, isActive |
Aspiration (aspirations) |
PK id (UUID); Unique nomor (ASP-XXXX) |
userId (FK User Cascade), isRahasia, grup, elemen, jenis, categoryId (FK AspirationCategory), judul, isi, status, prioritas, isPublik, ringkasanPublik?, ditandai, dibaca, dibacaPengirimPada?, mintaKeterangan, diimpor; indeks [status, prioritas, createdAt], [userId, createdAt], [isPublik, updatedAt] |
AspirationEvent (aspiration_events) |
PK id (UUID) |
aspirationId (FK Aspiration Cascade), type (AspirationEventType), actorId? (FK User SetNull), fromStatus?, toStatus?, pesan?, isInternal; indeks [aspirationId, createdAt] |
AspirationImage (aspiration_images) |
PK id (UUID) |
aspirationId (FK Aspiration Cascade), urutan, mime, ukuran, data (Bytes/bytea), eventId? (FK AspirationEvent Cascade, terisi untuk foto bukti tindak lanjut); indeks [aspirationId, urutan], [eventId] |
LaporanMasalah (laporan_masalah) |
PK id (UUID); Unique nomor (LAP-XXXX) |
userId (FK User Cascade), bagian, apa, sebelum?, info (Json: versi, halaman, perangkat, waktu), status (LaporanStatus); indeks [status, createdAt], [userId, createdAt] |
Model (@@map) |
PK & Kunci Unik |
Kolom Penting, Relasi FK & Indeks |
Form (forms) |
PK id (UUID); Unique nomor (FRM-XXXX) |
peranId (FK Peran), createdById (FK User), judul, deskripsi?, pendahuluan?, kepentingan, wajib, rahasia, tampilkanHasil, targetGrup (Int[]), targetElemen (Int[]), bukaPada?, tenggat?, status (FormStatus), skema (Json), jenis (FormJenis), tautan?, terbitPada?, disembunyikan, diimpor, ditutupPada?; indeks [peranId, status], [status, tenggat] |
FormBanner (form_banner) |
PK formId (UUID, FK Form Cascade) |
mime, ukuran, data (Bytes/bytea), updatedAt — dipisahkan dari forms agar kueri daftar tidak memuat byte gambar |
FormResponse (form_responses) |
PK id (UUID); Unique [formId, userId] |
formId (FK Form Cascade), userId? (FK User Cascade; NULL hanya untuk hasil impor tanpa identitas), grup, elemen, impor; indeks [userId] |
FormAnswer (form_answers) |
PK id (UUID) |
responseId (FK FormResponse Cascade), questionId, teks?, angka?, pilihan (String[]); indeks [responseId], [questionId] |
FormReminder (form_reminders) |
PK id (UUID); Unique [formId, userId] |
formId (FK Form Cascade), userId (FK User Cascade) |
FormTemplate (form_templates) |
PK id (UUID); Indeks unik SQL (peran_id, lower(nama)) |
peranId (FK Peran), nama, skema (Json), pengaturan (Json), createdById (FK User); indeks [peranId, createdAt] |
Poll (polls) |
PK id (UUID); Unique nomor (PLL-XXXX) |
peranId (FK Peran), createdById (FK User), pertanyaan, keterangan?, opsi (Json), mode (PollMode), jumlahPilihan?, anonim, wajib, hasil (PollHasil), targetGrup (Int[]), targetElemen (Int[]), bukaPada?, tenggat?, status (FormStatus), terbitPada?, disembunyikan, diimpor, ditutupPada?; indeks [peranId, status], [status, tenggat] |
PollVote (poll_votes) |
PK id (UUID); Unique [pollId, userId] |
pollId (FK Poll Cascade), userId? (FK User Cascade; NULL hanya impor tanpa identitas), pilihan (String[]), grup, elemen, impor; indeks [userId] |
PollTemplate (poll_templates) |
PK id (UUID); Indeks unik SQL (peran_id, lower(nama)) |
peranId (FK Peran), nama, isi (Json), createdById (FK User); indeks [peranId, createdAt] |
Model (@@map) |
PK & Kunci Unik |
Kolom Penting, Relasi FK & Indeks |
Hackathon (hackathons) |
PK id (UUID); Unique nomor (HKT-XXXX) |
peranId (FK Peran), createdById (FK User), judul, deskripsi, status (HackathonStatus), tenggatSubmisi?, tenggatPenilaian?, minPenilai (default 40), maksAnggota (default 5), tampilDiBeranda, submisiDibukaPada?, penilaianDibukaPada?, penilaianDitutupPada?, diumumkanPada?; indeks [peranId, status], [status] |
HackathonBidang (hackathon_bidang) |
PK id (UUID) |
hackathonId (FK Hackathon Cascade), nama, urutan; indeks [hackathonId, urutan] |
HackathonKriteria (hackathon_kriteria) |
PK id (UUID) |
hackathonId (FK Hackathon Cascade), bidangId (FK HackathonBidang Cascade), nama, keterangan, bobot, urutan; indeks [hackathonId, urutan], [bidangId, urutan] |
HackathonJuri (hackathon_juri) |
PK gabungan [hackathonId, userId] |
FK Hackathon & User (Cascade); indeks [userId] |
HackathonTim (hackathon_tim) |
PK id (UUID); Unique [hackathonId, ketuaId] |
hackathonId (FK Hackathon Cascade), nama, ketuaId (FK User Cascade), peringkatJuri? |
HackathonAnggota (hackathon_anggota) |
PK gabungan [timId, userId]; Unique [hackathonId, userId] |
Menjamin aturan 1 Serdik maksimal 1 tim per hackathon; FK HackathonTim, Hackathon, User (Cascade); indeks [userId] |
HackathonSubmisi (hackathon_submisi) |
PK id (UUID); Unique timId |
timId (FK HackathonTim Cascade), bidangId (FK HackathonBidang Restrict), nama, repo, demo, deskripsi, sumberData, dokumentasi?, teknis?, video?, dikirimPada, diubahPada; indeks [bidangId] |
HackathonGambar (hackathon_gambar) |
PK id (UUID) |
submisiId (FK HackathonSubmisi Cascade), urutan, mime, ukuran, data (Bytes/bytea); indeks [submisiId, urutan] |
HackathonRating (hackathon_rating) |
PK gabungan [submisiId, userId] |
bintang (1–5), FK HackathonSubmisi & User (Cascade); indeks [userId] |
HackathonNilai (hackathon_nilai) |
PK gabungan [submisiId, juriId, kriteriaId] |
nilai (1–5), FK HackathonSubmisi, User (juri), HackathonKriteria (Cascade); indeks [juriId] |
HackathonKomentar (hackathon_komentar) |
PK gabungan [submisiId, juriId] |
teks, FK HackathonSubmisi & User (juri) (Cascade) |
Beberapa aturan integritas diterapkan langsung pada DDL PostgreSQL dalam prisma/migrations/:
- Indeks Unik Case-Insensitive:
peran_nama_lower_key pada peran (lower(nama)), form_templates_peran_id_nama_lower_key pada form_templates (peran_id, lower(nama)), dan poll_templates_peran_nama_key pada poll_templates (peran_id, lower(nama)).
- Check Constraints Form Tautan:
forms_tautan_jenis_check (jenis = 'TAUTAN' OR tautan IS NULL) dan forms_tautan_terbit_check (jenis <> 'TAUTAN' OR status = 'DRAF' OR tautan IS NOT NULL).
- Check Constraints Hackathon:
hackathons_min_penilai_check (min_penilai >= 1), hackathons_maks_anggota_check (maks_anggota BETWEEN 1 AND 10), hackathon_kriteria_bobot_check (bobot BETWEEN 1 AND 100), hackathon_rating_bintang_check (bintang BETWEEN 1 AND 5), dan hackathon_nilai_nilai_check (nilai BETWEEN 1 AND 5).
stateDiagram-v2
[*] --> TERKIRIM: Kirim aspirasi
TERKIRIM --> DITINJAU: Lemusdik meninjau
TERKIRIM --> DITINDAKLANJUTI: Lompat tahap
TERKIRIM --> SELESAI: Selesai langsung
TERKIRIM --> DITOLAK: Ditolak (wajib alasan)
DITINJAU --> DITINDAKLANJUTI
DITINJAU --> SELESAI
DITINJAU --> DITOLAK: Wajib alasan
DITINDAKLANJUTI --> SELESAI
DITINDAKLANJUTI --> DITOLAK: Wajib alasan
SELESAI --> [*]
DITOLAK --> [*]
stateDiagram-v2
[*] --> DRAF: Buat / Duplikat / Impor Draf
DRAF --> TERBIT: Terbitkan (validasi jadwal & target)
state TERBIT {
[*] --> BELUM_DIBUKA: bukaPada > now
BELUM_DIBUKA --> TERBUKA: now >= bukaPada
TERBUKA --> DITUTUP_WAKTU: tenggat <= now (efektif tutup)
}
TERBIT --> DITUTUP: Tutup manual (FOR UPDATE)
DITUTUP --> TERBIT: Buka kembali dengan tenggat baru
DITUTUP_WAKTU --> TERBIT: Buka kembali dengan tenggat baru
DRAF --> [*]: Hapus (bila 0 jawaban/suara)
TERBIT --> [*]: Hapus (hanya bila 0 jawaban/suara)
DITUTUP --> [*]: Hapus (hanya bila 0 jawaban/suara)
(Catatan: Form/Polling hasil impor dengan diimpor = true langsung berstatus DITUTUP dan tidak dapat dibuka kembali).
stateDiagram-v2
[*] --> DRAF: Buat hackathon (4 bidang bawaan)
DRAF --> SUBMISI: Panitia buka submisi (validasi semua bidang bobot = 100)
SUBMISI --> PENILAIAN: Panitia buka penilaian (wajib >= 1 juri tanpa bentrok)
PENILAIAN --> REKAP: Panitia tutup penilaian (hitung skor & seri)
REKAP --> DIUMUMKAN: Panitia umumkan juara (putuskan urutan seri bila ada)
DIUMUMKAN --> [*]
stateDiagram-v2
[*] --> MENUNGGU: antreEmail() dalam transaksi notifikasi
MENUNGGU --> TERKIRIM: SMTP sukses (terkirimPada diisi)
MENUNGGU --> MENUNGGU: Galat sementara (< 3x) atau rate limit 421/451/452 (+30 menit)
MENUNGGU --> GAGAL: Galat 5xx permanen / >= 3x percobaan / di luar EMAIL_IZINKAN
Tiga tabel menyimpan biner gambar langsung sebagai BYTEA di PostgreSQL agar tidak bergantung pada object storage eksternal serta mewarisi transaksi dan pencadangan atomik database:
aspiration_images: Maksimal 3 foto per aspirasi dan 3 foto bukti per perubahan status; setiap foto dikompresi di klien menjadi JPEG <= 1.000.000 byte (1 MB).
form_banner: Maksimal 1 banner 4:1 per form; batas server 600.000 byte (600 KB, klien mengompresi <= 550 KB).
hackathon_gambar: Maksimal 3 tangkapan layar per submisi tim; batas server <= 1 MB per gambar.
Dengan batas kuota Neon free tier 0,5 GB (500 MB) dan asumsi ukuran terkompresi rata-rata 150–400 KB per gambar, kapasitas tersebut cukup menampung sekitar 1.000–2.500 gambar (termasuk indeks dan baris relasional lainnya). Apabila volume unggahan melebihi ambang 70–80% kapasitas database atau frekuensi upload meningkat tajam, migrasi penyimpanan biner ke object storage (S3 / Cloudflare R2) dengan referensi URL bertanda tangan (signed URL) direkomendasikan sebagai fase skalabilitas berikutnya.