| Field |
Nilai |
| ID Dokumen |
SDR-DES-001 |
| Pilar |
Desain |
| Standar Acuan |
WCAG 2.1 AA & W3C Design Tokens |
| Status |
Aktif / Tersinkronisasi dengan Kode |
| Terakhir Diperbarui |
2026-11-21 |
| Sumber Kebenaran |
app/globals.css, app/layout.tsx, components/ui/ModalDialog.tsx, components/ui/ConfirmDialog.tsx, components/layout/**, components/home/**, components/public/**, components/repository/**, components/admin/** |
Antarmuka Soedirman Digital Repository (SDR) mengadopsi identitas resmi P3MDI Soedirman dengan tema permukaan terang (light-surface) yang bersih, berwibawa, dan selaras dengan ekosistem portal P3MDI (simpul-p3md dan soedirman-hub).
- Prinsip utama: Keterbacaan tinggi, hierarki tipografi tegas, kontras warna memenuhi WCAG 2.1 AA, dan interaksi cepat tanpa animasi berlebihan.
- Perubahan dari Baseline Awal: Rancangan awal bertema gelap (
#171D25, referensi Steam Store di docs/PRD.md) telah digantikan sepenuhnya dalam kode produksi oleh tema terang berbasis P3MDI Navy (#14254d), P3MDI Gold (#c9a227), serta kartu putih bersih (#ffffff) di atas latar #f5f7fa.
Seluruh token warna didefinisikan pada blok :root dengan color-scheme: light di app/globals.css.
| Token CSS |
Nilai Hex |
Penggunaan Utama |
--p900 |
#14254d |
Warna utama merek: kartu identitas beranda, tombol .sdr-btn-primary, header kategori, panel kiri login, tab aktif. |
--p800 |
#1b3266 |
Keadaan hover .sdr-btn-primary, teks lencana kategori/teknologi, teks angka klik shortlink. |
--p700 |
#22408a |
Ikon aksen, tautan teks interaktif, tautan .prose-sdr a. |
--p600 |
#2c50a8 |
Fokus border input (.sdr-input:focus), fokus ring keyboard (:focus-visible), hover border kartu katalog. |
--p100 |
#dfe7f7 |
Border chip teknologi, border lencana peran Admin, border tombol detail Linktree. |
--p50 |
#eef3fb |
Latar chip teknologi, latar lencana Admin, latar ikon header, latar opsi terpilih pengaturan. |
--navy |
#0f1729 |
Latar sidebar navigasi panel admin (AdminSidebar) dan tooltip DeadlineBadge. |
| Token CSS |
Nilai Hex |
Penggunaan Utama |
--s700 |
#8a6a10 |
Teks lencana Super Admin dan lencana Pilihan (featured) agar memiliki kontras terbaca di latar terang. |
--s600 |
#b8901c |
Keadaan hover .sdr-btn-gold, penanda ikon bintang pilihan, marker list .prose-sdr li::marker. |
--s500 |
#c9a227 |
Tombol utama emas (.sdr-btn-gold pada login admin & CTA Tambah karya di sidebar), border avatar logo P3MDI, indikator garis menu aktif admin. |
--s100 |
#f6e9bd |
Border lencana Super Admin, teks aksen sekunder di atas latar --p900, latar hover tombol Ajukan Karya. |
--s50 |
#fbf5e1 |
Latar lencana Super Admin, latar tombol Ajukan Karya di header publik, panel peringatan verifikasi kata sandi saat ini. |
| Token CSS |
Nilai Hex |
Penggunaan Utama |
--bg |
#f5f7fa |
Latar halaman global (body), latar sub-panel metadata dan input nonaktif. |
--card |
#ffffff |
Latar .sdr-card, header publik/admin, dialog modal, panel form. |
--hover |
#f3f4f6 |
Keadaan hover baris tabel, tombol sekunder, dan item menu. |
--ink |
#111827 |
Teks heading (h1–h4), label formulir, judul karya, teks utama kontras tinggi. |
--text |
#374151 |
Teks isi paragraf (body), deskripsi karya, teks .prose-sdr. |
--mute |
#4b5563 |
Teks sekunder, subjudul, breadcrumb, keterangan bantuan formulir, tanggal. |
--faint |
#6b7280 |
Placeholder input dan ikon pencarian pasif. |
--line |
#e5e7eb |
Border kartu, garis pemisah (border-b), pembatas baris tabel. |
--line2 |
#94a3b8 |
Border elemen interaktif (.sdr-input, .sdr-btn-secondary, tombol paginasi). |
| Status |
Teks / Ikon |
Latar |
Border |
Penggunaan |
Sukses (ok) |
--ok (#15803d) |
--ok-bg (#dcfce7) |
--ok-border (#86efac) |
Status PUBLISHED, pengajuan APPROVED, tautan aktif, toast sukses. |
Peringatan (warn) |
--warn (#92400e) |
--warn-bg (#fef3c7) |
--warn-border (#fcd34d) |
Status DRAFT, pengajuan PENDING, tautan dinonaktifkan, prioritas H-3, error.tsx. |
Bahaya / Galat (bad) |
--bad (#b91c1c) |
--bad-bg (#fee2e2) |
--bad-border (#fca5a5) |
Tombol .sdr-btn-danger, pengajuan REJECTED, validasi error, alert kegagalan, 404. |
(Catatan: app/globals.css juga menyediakan alias legacy --color-paper, --color-ink, --color-ink-2, --color-muted, --color-rule, --color-accent, --color-accent-hi, --color-accent-2 yang dipetakan ke token P3MDI di atas.)
Font dimuat melalui next/font/google (self-hosted otomatis saat build Next.js) dan diekspos ke Tailwind CSS v4 melalui blok @theme inline:
| Keluarga Font |
Variabel CSS |
Bobot |
Kegunaan |
| Plus Jakarta Sans |
--font-jakarta → --font-sans |
400, 500, 600, 700 |
Seluruh antarmuka, heading (letter-spacing: -0.02em), isi teks (15px, line-height: 1.55), tombol, dan kartu. |
| JetBrains Mono |
--font-jetbrains-mono → --font-mono |
400, 500, 600 |
Slug, alias shortlink (go.p3mdi.id/...), URL input, tanggal rilis/deadline, alamat IP & metadata JSON audit log, penghitung angka (font-variant-numeric: tabular-nums). |
| Kelas CSS |
Spesifikasi Desain |
.sdr-card |
Latar --card, border 1px solid var(--line), radius 12px, bayangan halus 0 1px 2px rgba(15, 23, 41, 0.04). |
.sdr-btn-primary |
Latar --p900 (hover: --p800), teks putih, min-height: 40px (44px pada pointer kasar), radius 8px, transisi 150ms ease-out. |
.sdr-btn-gold |
Latar --s500 (hover: --s600), teks --p900, font-weight 700, min-height: 40px, radius 8px. |
.sdr-btn-secondary |
Latar --card (hover: --hover), teks --ink, border 1px solid var(--line2), min-height: 40px, radius 8px. |
.sdr-btn-danger |
Latar --bad (hover: #991b1b), teks putih, min-height: 40px, radius 8px. |
.sdr-input |
Lebar penuh 100%, min-height: 42px, border --line2 (focus: --p600), radius 8px, teks 0.875rem (naik menjadi 16px pada @media (max-width: 639px)). |
.prose-sdr |
Kontainer editorial lebar maksimal 72ch, line-height: 1.7, dukungan styling spesifik untuk h2, h3, p, ul, ol, li::marker (--s600), dan a (--p700). |
Alih-alih menggunakan pustaka pihak ketiga atau window.confirm(), SDR membangun dua wrapper dialog native di components/ui/:
ModalDialog (components/ui/ModalDialog.tsx)
- Menggunakan elemen HTML
<dialog> + .showModal() yang otomatis mengelola top layer, backdrop (rgba(15, 23, 41, 0.55)), focus trap bawaan browser, dan tombol Esc.
- Mendukung atribut
closedby="any" | "none" disertai fallback listener pointerdown + pointerup untuk browser yang belum mendukung properti closedBy.
- Dipakai oleh
CategoryFormDialog, ShortLinkFormDialog, SubmissionReviewDialog, AdminManagementView (tambah admin & reset sandi), dan AuditLogTableView (rincian metadata log).
RepositoryGallery juga menggunakan elemen <dialog className="sdr-dialog max-w-5xl ..."> secara langsung untuk modal lightbox gambar dengan navigasi panah kiri/kanan.
ConfirmDialog (components/ui/ConfirmDialog.tsx)
- Dibangun di atas
ModalDialog (max-w-md) dengan varian "danger" (ikon peringatan merah + fokus otomatis di tombol Batal demi keamanan) dan "primary".
- Saat
isPending bernilai true, dialog bersifat non-dismissible (dismissible={!isPending}) untuk mencegah penutupan tidak sengaja saat Server Action berjalan.
- Publik:
PublicHeader (sembunyi otomatis di rute /admin/*), PublicFooter, LinktreeHome, PublicSubmissionForm, CatalogFilters, RepositoryCatalogView, RepositoryCard, CategoryCard, DeadlineBadge (menampilkan H-n / jam tersisa + tooltip tanggal WIB Asia/Jakarta), RepositoryGallery, RepositoryInfoSidebar, ProductAccessButtons, RelatedRepositories, Pagination, EmptyState.
- Admin:
AdminLayoutClient (sidebar fixed 256px di desktop dan drawer responsif di mobile, menutup otomatis dengan Esc), AdminSidebar (menyesuaikan menu SUPER_ADMIN vs ADMIN), AdminHeader, AdminLoginForm, RepositoryForm, RepositoryTable, ImageUploader, ScreenshotManager (reorder via tombol naik/turun), RichTextEditor (mode Editor & Pratinjau tersanitasi), CategoryTable + CategoryFormDialog, SubmissionApprovalView + SubmissionReviewDialog, ShortLinkTableView + ShortLinkFormDialog, AdminManagementView, AuditLogTableView, MyActivityView, AccountSettingsView, HomepageDisplaySettingCard.
| Rute |
Komponen / Halaman |
Fungsi & Konten Utama |
/ |
app/page.tsx → LinktreeHome |
Kartu identitas P3MDI Soedirman (max-w-lg), daftar tautan karya terbaru (dibatasi homepage_display_limit, prioritas formulir deadline <= 72 jam), tombol ke /repositories dan /ajukan. |
/repositories |
app/repositories/page.tsx → RepositoryCatalogView |
Katalog grid responsif (1–4 kolom) dengan pencarian q, filter kategori, 4 mode urut (latest, oldest, az, za), dan paginasi 12 item per halaman berbasis query URL. |
/repositories/[slug] |
app/repositories/[slug]/page.tsx |
Breadcrumb, header pengembang & judul, grid 12 kolom (col-span-8 galeri lightbox + CTA akses; col-span-4 sidebar info), daftar fitur utama, dan maksimal 4 karya terkait. |
/categories/[slug] |
app/categories/[slug]/page.tsx |
Header kategori bernuansa Navy (--p900), daftar karya kategori tersebut, dan paginasi. |
/ajukan |
app/ajukan/page.tsx → PublicSubmissionForm |
Formulir pengajuan karya publik 4 bagian (Identitas pengaju, Detail karya + opsional deadline formulir, Tautan & media, Teknologi). |
/s/[alias] |
app/s/[alias]/page.tsx |
Pengalihan tautan pendek (go.p3mdi.id/[alias]), penambahan clickCount, serta halaman status informatif jika alias tidak ditemukan atau dinonaktifkan. |
| Rute |
Hak Akses |
Fungsi & Konten Utama |
/admin/login |
Publik (redirect jika sudah masuk) |
Tampilan split 2 kolom (panel identitas P3MDI Navy di kiri, form username + password di kanan). |
/admin |
ADMIN & SUPER_ADMIN |
4 kartu statistik (total, terpublikasi, draf, pilihan) dan daftar 6 karya terakhir diperbarui. |
/admin/repositories |
ADMIN & SUPER_ADMIN |
Tabel kelola karya, filter tab status, pencarian, toggle publish/featured cepat, dan soft-delete. |
/admin/repositories/new |
ADMIN & SUPER_ADMIN |
Formulir 6 bagian untuk menambah karya baru sebagai Draf atau Terpublikasi. |
/admin/repositories/[id]/edit |
ADMIN & SUPER_ADMIN |
Formulir pembaruan karya lengkap beserta manajemen gambar dan screenshot. |
/admin/categories |
ADMIN & SUPER_ADMIN |
Tabel kategori dengan penghitung karya aktif serta dialog tambah/ubah/hapus. |
/admin/submissions |
ADMIN & SUPER_ADMIN |
Antrean pengajuan publik dengan filter status (ALL, PENDING, APPROVED, REJECTED), badge antrean pending, dan modal tinjauan (SubmissionReviewDialog). |
/admin/shortlinks |
ADMIN & SUPER_ADMIN |
Manajemen tautan pendek go.p3mdi.id, ringkasan total tautan & total klik, tombol salin tautan, dan switch aktif/nonaktif. |
/admin/administrators |
Khusus SUPER_ADMIN |
Pengelolaan akun administrator (tambah ADMIN, aktif/nonaktif akun, reset kata sandi). |
/admin/audit-logs |
Khusus SUPER_ADMIN |
Tabel log audit global (20 catatan/halaman), filter username/aksi/entitas, dan modal rincian metadata JSON + IP/User-Agent. |
/admin/my-activity |
ADMIN & SUPER_ADMIN |
Daftar kronologis aktivitas milik akun administrator yang sedang masuk (15 per halaman). |
/admin/settings |
ADMIN & SUPER_ADMIN |
Pembaruan username/password pribadi (wajib verifikasi sandi lama); kartu pengaturan jumlah display beranda (HomepageDisplaySettingCard) tampil khusus SUPER_ADMIN. |
| Kriteria WCAG / Mekanisme |
Implementasi Terverifikasi di Kode |
| Navigasi Keyboard & Skip Link |
app/layout.tsx merender <a href="#main-content" className="skip-link">Langsung ke konten utama</a> menuju <main id="main-content" tabIndex={-1}>. .skip-link hanya muncul visual saat menerima fokus keyboard. |
| Indikator Fokus Jelas |
Selector global a:focus-visible, button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-visible, summary:focus-visible memakai outline: 2px solid var(--p600); outline-offset: 2px; agar tetap terlihat pada Forced Colors Mode OS. |
| Target Sentuh Perangkat Layar Sentuh |
Media query @media (pointer: coarse) memperbesar tinggi minimum seluruh kelas tombol (.sdr-btn-*) menjadi 44px. |
| Pencegahan Auto-Zoom iOS |
Media query @media (max-width: 639px) menaikkan ukuran font .sdr-input menjadi 16px. |
Pengurangan Gerak (prefers-reduced-motion) |
@media (prefers-reduced-motion: reduce) di app/globals.css memangkas animation-duration, transition-duration, dan scroll-behavior menjadi instan. |
| Semantik & Screen Reader |
Satu <h1> per halaman, atribut aria-label pada seluruh tombol ikon, aria-pressed pada tombol toggle status pilihan/filter, aria-current="page" pada navigasi aktif & paginasi, role="alert" / role="status" pada umpan balik formulir, serta <caption className="sr-only"> pada tabel data admin. |