Skip to content

Model Data (SV-DATA-001)

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/.

1. Aturan Kritis Basis Data & search_path Kosong

Section titled “1. Aturan Kritis Basis Data & search_path Kosong”
  • 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).

2.1 Inti Akun, Akses, Privasi & Komunikasi

Section titled “2.1 Inti Akun, Akses, Privasi & Komunikasi”
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

4.1 Akun, Otorisasi, Privasi & Komunikasi (14 Tabel)

Section titled “4.1 Akun, Otorisasi, Privasi & Komunikasi (14 Tabel)”
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)

4.5 Constraint SQL Khusus di Migrasi (Di Luar schema.prisma)

Section titled “4.5 Constraint SQL Khusus di Migrasi (Di Luar schema.prisma)”

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).

5.1 Siklus Status Aspirasi (AspirationStatus)

Section titled “5.1 Siklus Status Aspirasi (AspirationStatus)”
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 --> [*]

5.2 Siklus Form & Polling (FormStatus + Efektif)

Section titled “5.2 Siklus Form & Polling (FormStatus + Efektif)”
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).

5.3 Siklus Tahapan Hackathon (HackathonStatus)

Section titled “5.3 Siklus Tahapan Hackathon (HackathonStatus)”
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

6. Perencanaan Kapasitas Penyimpanan Media (bytea)

Section titled “6. Perencanaan Kapasitas Penyimpanan Media (bytea)”

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.