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.
1. Prinsip Estetika & Arah Visual
Section titled “1. Prinsip Estetika & Arah Visual”- 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-garis1 px) dan latar kontras yang tenang di atas latar kanvaskertas(#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.
- Navy
Daftar Anti-Estetika Terlarang
Section titled “Daftar Anti-Estetika Terlarang”Sesuai .ux-profile.md, elemen berikut dilarang keras muncul di antarmuka:
- Glassmorphism atau
backdrop-filtertanpa batas kontras tinggi. - Badge pil pastel melayang untuk metadata biasa.
- Gradien dekoratif sembarangan, garis tepi neon, atau gradien pelangi pada tombol aksi biasa.
- Ilustrasi kartun pada keadaan kosong (empty state).
- Scrollbar bersarang di dalam komponen dan ikon dekoratif berlebihan di dalam input.
- Penggunaan karakter emoji sebagai ikon UI (seperti bintang, centang, pin, atau jam Unicode) — seluruh ikon wajib memakai komponen
IconSVG proyek. - Label huruf kapital berspasi lebar di atas judul (
TRACKING-WIDEST UPPERCASE) atau penggabungan metadata dengan titik tengah (A · B · C) sebagai pola umum daftar. - Membungkus seluruh konten dalam kartu yang seragam dengan bayangan identik.
2. Design Tokens (Tailwind CSS v4 @theme)
Section titled “2. Design Tokens (Tailwind CSS v4 @theme)”Sumber kebenaran tunggal seluruh token berada di blok @theme dalam src/app/globals.css dan konfigurasi next/font/google di src/app/layout.tsx.
2.1 Palet Warna
Section titled “2.1 Palet Warna”| 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 tokenemas. - Aksen Bidang Hackathon (berputar berdasarkan indeks
urutanbidang):- Biru (
biru/biru-muda) - Hijau (
hijau/hijau-muda) - Oranye (
oranye/--color-oranye-muda: #fdeee4) - Ungu (
--color-ungu: #6b46c1/--color-ungu-muda: #f1ecfb) - Teal (
--color-teal: #0f766e/--color-teal-muda: #e0f2f1) - Rose (
--color-rose: #be185d/--color-rose-muda: #fce7f1)
- Biru (
2.2 Tipografi & Bayangan
Section titled “2.2 Tipografi & Bayangan”- Font Display (
--font-display):Bricolage Grotesque(bobot700,800) — dipakai untuk judul halaman, nama aplikasi, angka No. Serdik, dan judul kartu utama. - Font Isi (
--font-sans):Plus Jakarta Sans(bobot400,500,600,700) — ukuran dasar15px,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)
2.3 Komponen Gaya Baku
Section titled “2.3 Komponen Gaya Baku”- Tombol (
src/ui/button.ts): Semua varian (btnMalam,btnGaris,btnEmas,btnMerah,btnGarisMerah) mewarisibtnBasedenganmin-h-12(48 px),rounded-xl,px-5,text-[15.5px] font-bold, serta kondisidisabled:opacity-45 disabled:cursor-not-allowed. - Prosa Pendahuluan Form (
.pendahuluan): Gaya terisolasi diglobals.css(15.5px,line-height: 1.65,overflow-wrap: anywhere) yang hanya mendukung paragraf, jarak lega ([data-jarak="lega"]), daftarul/ol, dan rata teks dari sanitasi serverbersihkanPendahuluan().
3. Aksesibilitas (WCAG 2.1 AA)
Section titled “3. Aksesibilitas (WCAG 2.1 AA)”- Target Kontras: Minimal
4,5:1untuk teks normal dan3:1untuk 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-11ataumin-h-12, misalnyasize-11untuk avatar dan tombol lonceng,size-14untuk tombol Suarakan). - Cincin Fokus: Global
:focus-visiblemenetapkanoutline: 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 tumbuhpada batang hasil polling dananimate-pulsepadaPageSkeleton). - Screen Reader: Ikon dekoratif menggunakan
aria-hidden="true", jumlah notifikasi/badge menyertakan<span className="sr-only"> baru</span>, dan pengelompokan navigasi menggunakanaria-labelsertaaria-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 menonjolSuarakan(membukaSuarakanSheetberisiKirim aspirasi,Ikut polling,Isi form),Polling,Form. MenuHackathondanMode Keloladiakses dariAkunMenudi pojok kanan atas Topbar. - Mode Kelola (
sv_mode=kelola): Diaktifkan lewatAkunMenu. Menampilkan tab pengelola sesuaifiturUser(user.peran)(Aspirasi,Form,Polling,Hackathon,Serdik) diikutiProfil, serta ikon indikatorslidersemas 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.
- Mode Normal: Urutan tetap 5 slot —
- Layar Autentikasi (
AuthShell, breakpoint960 px): Di HP berupa pita navy melengkung dengan kartu formulir menumpuk di atasnya; di desktop>= 960 pxberupa kartu belah dua kolom. Untuk ponsel pendek (max-height: 700pxdan lebar<= 959px),globals.cssmemadatkan padding dan menyembunyikan daftar fitur di bawah kartu agar layar/masukmuat dalam satu layar tanpa gulir. - Overlay & Dialog (
Sheet&useKonfirmasi):Sheettampil sebagai bottom sheet (rounded-t-[22px], dengan pegangan atas dan batasmax-h-[92dvh]) di ponsel, dan berubah menjadi dialog terpusat (w-[440px]) di layar>= 1024 px. Seluruh aksi destruktif wajib memakaiuseKonfirmasi()(elemen<dialog>native) dan dilarang memakaiwindow.confirm.
5. Pustaka Ikon Proyek (src/ui/icons.tsx)
Section titled “5. Pustaka Ikon Proyek (src/ui/icons.tsx)”- 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-reactlangsung atau Heroicons) atau mencampur gaya ikon. Ikon baru ditambahkan langsung ke objekPATHSdi src/ui/icons.tsx dengan gaya garis stroke1.8–2dan ujung membulat.
6. Pedoman Microcopy & Arsitektur Informasi
Section titled “6. Pedoman Microcopy & Arsitektur Informasi”6.1 Suara Merek & Penulisan UI
Section titled “6.1 Suara Merek & Penulisan UI”- 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).
EmptyStateselalu 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) |