Skip to content

Sistem Desain & Spesifikasi UI/UX (SV-DES-001)

Field Nilai
ID Dokumen SV-DES-001
Pilar Desain
Standar Acuan WCAG 2.1 AA & Design Token System (Tailwind CSS v4)
Status Aktif / Tersinkronisasi dengan Kode
Terakhir Diperbarui 2026-11-21
Sumber Kebenaran .ux-profile.md, src/app/globals.css, src/app/layout.tsx, src/ui/**, src/ui/icons.tsx, src/features/hackathon/ui/aksen.ts, src/features/hackathon/ui/kartu-juara.tsx

Spesifikasi desain visual, aksesibilitas, tata letak responsif, pustaka ikon, dan suara bahasa antarmuka (microcopy) Sudirman Voice. Setiap perubahan tampilan, CSS, atau teks antarmuka wajib merujuk pada dokumen ini dan .ux-profile.md.

  • Referensi Estetika: Institusional terinspirasi Stripe — rapi, berwibawa, terstruktur, namun tetap ramah dan mudah dipahami oleh seluruh Serdik P3MDI.
  • Prinsip Kedalaman (Depth): Utamakan batas garis bersih (border-garis 1 px) dan latar kontras yang tenang di atas latar kanvas kertas (#f3f5f9). Bayangan halus (shadow-kartu, shadow-panel, shadow-fab) hanya digunakan untuk elemen utama yang mengambang atau menonjol.
  • Hirarki Warna Fungsional:
    • Navy malam (#172b5c): Identitas institusional, hero header, sidebar desktop, dan tombol aksi utama (btnMalam).
    • Emas emas (#d9a520): Disimpan secara ketat untuk sinyal “perlu tindakan” (tombol Suarakan, aksi utama di banner Hackathon bila butuh tindakan, Juara Favorit, pilihan pengguna pada hasil polling).
    • Merah merah (#b91c1c): Hanya untuk kondisi mendesak (tenggat <= 3 jam, wajib segera, galat, status ditutup, dan aksi destruktif).
    • Hijau hijau (#15803d): Menandai kondisi selesai, terbuka, atau berhasil.

Sesuai .ux-profile.md, elemen berikut dilarang keras muncul di antarmuka:

  1. Glassmorphism atau backdrop-filter tanpa batas kontras tinggi.
  2. Badge pil pastel melayang untuk metadata biasa.
  3. Gradien dekoratif sembarangan, garis tepi neon, atau gradien pelangi pada tombol aksi biasa.
  4. Ilustrasi kartun pada keadaan kosong (empty state).
  5. Scrollbar bersarang di dalam komponen dan ikon dekoratif berlebihan di dalam input.
  6. Penggunaan karakter emoji sebagai ikon UI (seperti bintang, centang, pin, atau jam Unicode) — seluruh ikon wajib memakai komponen Icon SVG proyek.
  7. Label huruf kapital berspasi lebar di atas judul (TRACKING-WIDEST UPPERCASE) atau penggabungan metadata dengan titik tengah (A · B · C) sebagai pola umum daftar.
  8. Membungkus seluruh konten dalam kartu yang seragam dengan bayangan identik.

Sumber kebenaran tunggal seluruh token berada di blok @theme dalam src/app/globals.css dan konfigurasi next/font/google di src/app/layout.tsx.

Token Hex Peran & Jaminan Kontras
--color-malam #172b5c Navy utama (sidebar, hero, tombol primer)
--color-malam-2 #203a78 Latar banner Hackathon & variasi navy sekunder
--color-malam-ink #afc0e3 Teks sekunder & label grup di atas latar malam
--color-malam-teks #e6ecf8 Teks isi di atas latar malam
--color-malam-pudar #d5def1 Subjudul pudar di hero layar masuk
--color-malam-lembut #f0f3f9 Latar panel sorotan netral (“Perlu kamu isi”, ajakan aktivasi)
--color-tinta #13213f Teks judul utama & teks kontras tinggi
--color-teks #374151 Teks isi standar (body)
--color-teks-2 #5f6673 Teks sekunder (kontras AA >= 4,5:1 di atas putih, kertas, emas-muda, biru-muda)
--color-emas #d9a520 Aksen utama “perlu tindakan”, batas hero, kartu favorit
--color-emas-tua #8a6a10 Teks kecil & label di atas emas-muda / putih (>= 4,5:1)
--color-emas-pekat #a67c00 Garis aksen urgensi & ikon (>= 3:1 di atas putih)
--color-emas-muda #fbf3dc Latar lembut chip/peringatan emas
--color-emas-lembut #fdf8ec Latar panel sorotan kuning hangat (banner read-only, panel perlu isi)
--color-oranye #c2410c Peringatan tenggat <= 6 jam (teks putih di atasnya 5,2:1) & aksen bidang
--color-biru #2b55b5 Tautan aksi, status terjadwal (BELUM_DIBUKA), aksen bidang
--color-biru-muda #e9effb Latar ubin menu & chip terjadwal
--color-hijau #15803d Status terbuka/selesai/sukses & aksen bidang
--color-hijau-muda #e7f5ec Latar chip terbuka/selesai
--color-merah #b91c1c Status ditutup, tenggat <= 3 jam, galat, aksi destruktif
--color-merah-muda #fdecec Latar chip ditutup & kotak galat (AuthAlert)
--color-kertas #f3f5f9 Latar kanvas aplikasi (body)
--color-garis #e2e6ee Garis pemisah & border kartu standar
--color-sel #cdd3de Border input formulir & bar draf
--color-pegangan #d5dae3 Pegangan (drag handle) bottom sheet & ikon panah ringan
--color-tag #eef1f5 Latar badge draf & pemisah baris tipis

Token Medali Pemenang & Aksen Bidang Hackathon

Section titled “Token Medali Pemenang & Aksen Bidang Hackathon”

Digunakan pada kartu-juara.tsx dan aksen.ts. Angka besar & border memenuhi rasio >= 3:1 di atas putih, sedangkan label kecil (-tua) memenuhi >= 4,5:1:

  • Medali: Perak (--color-perak: #7c8697, --color-perak-tua: #5f6978, --color-perak-muda: #eef0f4), Tembaga (--color-tembaga: #b4622a, --color-tembaga-tua: #9a4f1e, --color-tembaga-muda: #fbeee4), sedangkan Emas memakai token emas.
  • Aksen Bidang Hackathon (berputar berdasarkan indeks urutan bidang):
    1. Biru (biru / biru-muda)
    2. Hijau (hijau / hijau-muda)
    3. Oranye (oranye / --color-oranye-muda: #fdeee4)
    4. Ungu (--color-ungu: #6b46c1 / --color-ungu-muda: #f1ecfb)
    5. Teal (--color-teal: #0f766e / --color-teal-muda: #e0f2f1)
    6. Rose (--color-rose: #be185d / --color-rose-muda: #fce7f1)
  • Font Display (--font-display): Bricolage Grotesque (bobot 700, 800) — dipakai untuk judul halaman, nama aplikasi, angka No. Serdik, dan judul kartu utama.
  • Font Isi (--font-sans): Plus Jakarta Sans (bobot 400, 500, 600, 700) — ukuran dasar 15px, line-height: 1.5, -webkit-font-smoothing: antialiased.
  • Bayangan (@theme):
    • --shadow-panel: 0 24px 48px rgb(19 33 63 / 0.16) (untuk banner utama & popover tooltip)
    • --shadow-kartu: 0 12px 28px rgb(19 33 63 / 0.08) (untuk kartu menonjol di Beranda & Auth)
    • --shadow-fab: 0 8px 18px rgb(217 165 32 / 0.4) (untuk tombol melayang Suarakan di navigasi bawah HP)
  • Tombol (src/ui/button.ts): Semua varian (btnMalam, btnGaris, btnEmas, btnMerah, btnGarisMerah) mewarisi btnBase dengan min-h-12 (48 px), rounded-xl, px-5, text-[15.5px] font-bold, serta kondisi disabled:opacity-45 disabled:cursor-not-allowed.
  • Prosa Pendahuluan Form (.pendahuluan): Gaya terisolasi di globals.css (15.5px, line-height: 1.65, overflow-wrap: anywhere) yang hanya mendukung paragraf, jarak lega ([data-jarak="lega"]), daftar ul/ol, dan rata teks dari sanitasi server bersihkanPendahuluan().
  • Target Kontras: Minimal 4,5:1 untuk teks normal dan 3:1 untuk teks besar, garis tepi kontrol, serta ikon bermakna.
  • Area Sentuh (Touch Target): Seluruh tombol, tab navigasi bawah, item menu, dan tautan interaktif memakai minimum tinggi 44–48 px (min-h-11 atau min-h-12, misalnya size-11 untuk avatar dan tombol lonceng, size-14 untuk tombol Suarakan).
  • Cincin Fokus: Global :focus-visible menetapkan outline: 3px solid #9db6ea; outline-offset: 2px; border-radius: 8px;. Dialog konfirmasi (src/ui/konfirmasi.tsx) menaruh tombol Batal pertama di DOM agar menerima fokus awal sebagai pilihan aman.
  • Motion Reduction: Aturan global @media (prefers-reduced-motion: reduce) menonaktifkan transisi dan animasi (seperti @keyframes tumbuh pada batang hasil polling dan animate-pulse pada PageSkeleton).
  • Screen Reader: Ikon dekoratif menggunakan aria-hidden="true", jumlah notifikasi/badge menyertakan <span className="sr-only"> baru</span>, dan pengelompokan navigasi menggunakan aria-label serta aria-current="page".

4. Arsitektur Tata Letak Responsif & Navigasi

Section titled “4. Arsitektur Tata Letak Responsif & Navigasi”

Tata letak diuji pada viewport ponsel (375 px / 390×844 di E2E Playwright) hingga desktop (1280 px), dengan titik potong utama di 1024 px (lg:):

flowchart TD
  AppShell["AppShell (src/ui/app-shell.tsx)"]
  AppShell -->|"Desktop >= 1024px"| Desktop["Sidebar Navy 264px + Topbar 72px + Konten max-w-1180px"]
  AppShell -->|"Mobile < 1024px"| Mobile["Topbar 58px + Konten + BottomNav fixed"]
  Mobile -->|"Normal Mode (default)"| NormalNav["5 Tab: Beranda, Aspirasi, FAB Suarakan, Polling, Form"]
  Mobile -->|"Mode Kelola (cookie sv_mode=kelola)"| KelolaNav["Menu Kelola sesuai izin + Profil (tanpa Suarakan)"]
  Mobile -->|"Mengisi Form (body:has([data-isi-form]))"| HideNav["BottomNav disembunyikan otomatis"]
  • Navigasi Bawah HP (< 1024 px):
    • Mode Normal: Urutan tetap 5 slot — Beranda, Aspirasi, tombol emas menonjol Suarakan (membuka SuarakanSheet berisi Kirim aspirasi, Ikut polling, Isi form), Polling, Form. Menu Hackathon dan Mode Kelola diakses dari AkunMenu di pojok kanan atas Topbar.
    • Mode Kelola (sv_mode=kelola): Diaktifkan lewat AkunMenu. Menampilkan tab pengelola sesuai fiturUser(user.peran) (Aspirasi, Form, Polling, Hackathon, Serdik) diikuti Profil, serta ikon indikator sliders emas muda di Topbar.
    • Aturan Mengisi Form: Aturan CSS body:has([data-isi-form]) .bottom-nav { display: none; } menyembunyikan navigasi bawah saat Serdik mengisi form di HP agar keyboard layar tidak menjepit kolom input dan ketukan “Kirim jawaban” tidak salah menyentuh tab navigasi.
  • Layar Autentikasi (AuthShell, breakpoint 960 px): Di HP berupa pita navy melengkung dengan kartu formulir menumpuk di atasnya; di desktop >= 960 px berupa kartu belah dua kolom. Untuk ponsel pendek (max-height: 700px dan lebar <= 959px), globals.css memadatkan padding dan menyembunyikan daftar fitur di bawah kartu agar layar /masuk muat dalam satu layar tanpa gulir.
  • Overlay & Dialog (Sheet & useKonfirmasi): Sheet tampil sebagai bottom sheet (rounded-t-[22px], dengan pegangan atas dan batas max-h-[92dvh]) di ponsel, dan berubah menjadi dialog terpusat (w-[440px]) di layar >= 1024 px. Seluruh aksi destruktif wajib memakai useKonfirmasi() (elemen <dialog> native) dan dilarang memakai window.confirm.
  • Komponen: Icon({ name, size = 22, strokeWidth = 1.8, className = "" }) merender <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">.
  • Inventaris 46 Ikon Resmi: home, clipboard, plus, send, message, chart, user, users, help, bell, mic, download, upload, list, shield, pen, x, info, tag, image, urut, eyeOff, flag, inbox, chev, key, logout, search, dots, lock, copy, eye, eye-off, swap, clock, alert, check, pin, calendar, sliders, trophy, star, arrow, badge.
  • Aturan: Dilarang memasang pustaka ikon eksternal (seperti lucide-react langsung atau Heroicons) atau mencampur gaya ikon. Ikon baru ditambahkan langsung ke objek PATHS di src/ui/icons.tsx dengan gaya garis stroke 1.8–2 dan ujung membulat.

6. Pedoman Microcopy & Arsitektur Informasi

Section titled “6. Pedoman Microcopy & Arsitektur Informasi”
  • Gaya Bahasa: Hangat, humanis (Warm & Humancentric), menggunakan Bahasa Indonesia baku-santai dengan sapaan “kamu”.
  • Kapitalisasi: Sentence case pada judul kartu, label, dan seluruh tombol (contoh: "Kirim aspirasi", "Tandai sudah dibaca semua", "Bentuk timmu").
  • Tombol Aksi: Diawali kata kerja aktif ("Isi sekarang", "Kirim jawaban", "Hapus banner").
  • Pesan Galat & Keadaan Kosong: Pesan galat tidak menyalahkan pengguna dan selalu menyertakan langkah perbaikan atau kanal bantuan (mis. menghubungi Admin/DanEl). EmptyState selalu memberi konteks dan ajakan bertindak yang jelas.

6.2 Peta Arsitektur Informasi (IA — 50 Halaman)

Section titled “6.2 Peta Arsitektur Informasi (IA — 50 Halaman)”
Kelompok Rute Rute Halaman (src/app) Akses
Autentikasi /masuk, /aktivasi, /ganti-pin Publik / Sesi wajib ganti PIN
Utama Serdik / (Beranda), /form, /form/[kode], /form/[kode]/hasil, /polling, /polling/[kode] Semua pengguna login
Aspirasi Serdik /aspirasi, /aspirasi/kirim, /aspirasi/[kode], /aspirasi/tindak-lanjut, /aspirasi/tindak-lanjut/[kode] Semua pengguna login
Hackathon /hackathon, /hackathon/[kode], /hackathon/[kode]/submisi, /hackathon/[kode]/nilai Pengguna login (404 bila dimatikan Admin via Pengaturan)
Akun & Privasi /profil, /profil/ganti-pin, /profil/laporkan, /profil/privasi, /profil/privasi/ketentuan, /persetujuan, /panduan Semua pengguna login
Kelola Konten /kelola/form, /kelola/form/impor, /kelola/form/[kode], /kelola/form/[kode]/edit, /kelola/polling, /kelola/polling/impor, /kelola/polling/[kode], /kelola/polling/[kode]/edit, /kelola/hackathon, /kelola/hackathon/baru, /kelola/hackathon/[kode], /kelola/hackathon/[kode]/edit, /kelola/hackathon/[kode]/rekap Pemegang peran dengan izinForm / izinPolling / izinHackathon atau Admin (403 tanpa izin)
Aspirasi Pengelola /lemusdik/aspirasi, /lemusdik/aspirasi/impor, /lemusdik/aspirasi/[kode], /lemusdik/kategori Pemegang peran LEMUSDIK atau ADMIN (403 tanpa izin)
Administrasi /admin/serdik, /admin/peran, /admin/peran/[id], /admin/impor, /admin/log, /admin/laporan, /admin/laporan/[kode], /admin/permintaan-data serdik: izinDataUser atau Admin; lainnya wajib ADMIN (403 tanpa izin)