Skip to content

Sistem Desain & Arsitektur Informasi — Soedirman Digital Repository (SDR)

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

1. Filosofi Desain & Identitas Visual P3MDI

Section titled “1. Filosofi Desain & Identitas Visual P3MDI”

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.

2. Token Warna & Permukaan (app/globals.css)

Section titled “2. Token Warna & Permukaan (app/globals.css)”

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


3. Tipografi & Skala Teks (app/layout.tsx & app/globals.css)

Section titled “3. Tipografi & Skala Teks (app/layout.tsx & app/globals.css)”

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

4.1 Kelas Utilitas Standar (app/globals.css)

Section titled “4.1 Kelas Utilitas Standar (app/globals.css)”
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).

4.2 Komponen Dialog Native (<dialog class="sdr-dialog">)

Section titled “4.2 Komponen Dialog Native (<dialog class="sdr-dialog">)”

Alih-alih menggunakan pustaka pihak ketiga atau window.confirm(), SDR membangun dua wrapper dialog native di components/ui/:

  1. 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.
  2. 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.