Skip to content

Design System & Information Architecture (HUB-DES-001)

Field Value
Document ID HUB-DES-001
Pillar Design
Standard Alignment WCAG 2.1 AA / Mobile-First PWA Design Standard
Status Active / Synchronized with Codebase
Last Updated 2026-11-21
Source of Truth tailwind.config.js, src/style.css, index.html, public/manifest.webmanifest, src/layouts/DashboardLayout.vue, src/components/BottomNavBar.vue, src/components/MobileMenuSheet.vue, src/components/AppDialog.vue, src/components/BaseModal.vue, src/components/TopProfilePill.vue, src/components/AdminRoleSwitcher.vue, src/composables/useDialog.js, src/composables/useScrollLock.js, src/composables/usePwaInstall.js, src/router/index.js, src/utils/constants.js, src/views/*.vue, tests/shell-modal-a11y.test.mjs, tests/mobile-ux.test.mjs

Soedirman Hub adopts a crisp, high-legibility operational command aesthetic anchored in deep navy (#0f1729), muted military olive (army), ceremonial brass/amber (gold), and an atmospheric sky-blue translucent surface (.portal-app + .glass).

1.1 Color Tokens (tailwind.config.js & src/style.css)

Section titled “1.1 Color Tokens (tailwind.config.js & src/style.css)”
Token Group Values / Scale Usage
Navy (navy.*) 800: #162032, 900: #0f1729, 950: #0b111e Primary dark CTA buttons (.btn-primary, #0f1729), active tab pills, PWA theme_color (#0f1729), deep sidebar/badge highlights.
Army (army.50–army.950) RGB triplet scale from 244 246 238 (50) to 23 29 14 (950); core accent army-500 rgb(111 132 65) Command/elemen identity badges, routine schedule dot (bg-army-400), institutional accents.
Gold (gold.50–gold.950) RGB triplet scale from 253 249 235 (50) to 66 32 6 (950); core accent gold-400 rgb(233 173 40), gold-500 rgb(217 147 26) Komandan Grup badges, apel schedule accents (bg-gold-400 / bg-gold-500), celebratory/highlight CTAs (.btn-gold).
Shell Canvas & Glass Body gradient canvas (#f8fafc PWA background_color), .glass translucent white surfaces, subtle cloud accents .portal-cloud (disabled below 767px and under prefers-reduced-motion: reduce) High-contrast white cards (bg-white border-slate-200/90) over atmospheric backdrop for effortless scanning.
Z-Index Scale (src/style.css) --z-base: 0, --z-sidebar: 20, --z-header: 30, --z-bottom-nav: 30, --z-drawer-backdrop: 40, --z-drawer: 50, --z-modal: 60, --z-confirm: 70, --z-toast: 80 Prevents stacking-context traps (explicit invariant enforced in tests/shell-modal-a11y.test.mjs).

1.2 Role, Group & Element Semantic Badges (src/utils/constants.js)

Section titled “1.2 Role, Group & Element Semantic Badges (src/utils/constants.js)”
  • Roles (ROLE_BADGE_CLASSES): super_admin (amber), komandan_batch (red), kabid_sdm (indigo), kabid_ops (teal), komandan_grup (gold), komandan_elemen (army), poldik (red), penerangan (cyan), lemusdik (violet), serdik (slate), pengasuh (red-50/red-900).
  • Groups (GRUP_BADGE_CLASSES): Grup 1 (emerald), Grup 2 (blue), Grup 3 (amber), Grup 4 (purple).
  • Elements (ELEMEN_BADGE_CLASSES): Elemen 1 (emerald), Elemen 2 (amber), Elemen 3 (sky).

1.3 Typography & Component Primitives (index.html, src/style.css)

Section titled “1.3 Typography & Component Primitives (index.html, src/style.css)”
  • Font Family: "Plus Jakarta Sans" (primary --font-sans & Tailwind sans), paired with Inter loaded in index.html, falling back to ui-sans-serif, system-ui, sans-serif, plus system monospace (font-mono tabular-nums) for NOSIS, NRP, live clocks, and KPI counters.
  • Core CSS Primitives (src/style.css): .card, .btn-primary, .btn-secondary, .btn-danger, .btn-gold, .btn-1, .btn-2, .input, .select, .textarea, .field, .badge*, .tab*.

2. Application Shell & Responsive Navigation

Section titled “2. Application Shell & Responsive Navigation”

DashboardLayout.vue coordinates three viewport tiers (< 768px mobile, 768px–1023px tablet, >= 1024px desktop) while ensuring overflow-x: clip and min-height: 100dvh on .portal-app.

flowchart TD
    Shell["DashboardLayout.vue"] --> Breakpoint{"Viewport Width"}
    Breakpoint -->|">= 1024px (lg Desktop)"| Sidebar["Collapsible Fixed Side Nav (.side-nav 264px, Ctrl/Cmd+B)"]
    Breakpoint -->|"< 1024px (Mobile & Tablet)"| TopMobile["Top Header (.top) + Hamburger (.mobile-menu-trigger)"]
    Breakpoint -->|"< 1024px (Bottom Bar)"| BottomBar["BottomNavBar.vue (z-30, safe-area-inset-bottom)"]
    BottomBar -->|"Slot 3 Center FAB"| QuickPhoto["LivePhotoModal (1-Click Current Rundown Camera)"]
    BottomBar -->|"Slot 5 Menu"| Sheet["MobileMenuSheet.vue / Drawer (z-50)"]
    TopMobile --> Profile["TopProfilePill.vue + AdminRoleSwitcher.vue + Sync Indicator"]
    Sidebar --> Profile

2.1 Shell Ergonomics & Stacking Invariants

Section titled “2.1 Shell Ergonomics & Stacking Invariants”
  1. Tablet Dead-Zone Prevention (< 1024px): .side-nav hides below 1024px, while .bottom-nav-bar stays visible up to 1023px and the header exposes .mobile-menu-trigger (aria-controls="mobile-menu-sheet", aria-expanded).
  2. Backdrop-Filter Trap Prevention: At max-width: 1023px, .top omits backdrop-filter and .main-wrapper defines no z-index, preventing fixed modals/popovers from being clipped behind BottomNavBar or .top.
  3. Scroll & Safe-Area Layering: .content-wrap uses @layer components bottom padding calc(6.5rem + env(safe-area-inset-bottom, 0px)) on < 1024px so mobile bottom bars never obscure action buttons.
  4. Bottom Navigation Bar (BottomNavBar.vue): Fixed 5-slot thumb bar:
    • Slot 1: Dashboard (/)
    • Slot 2: Absensi (/absensi, emerald indicator dot if user is a commander who fills apel)
    • Slot 3 (Raised Center FAB): Presensi (opens LivePhotoModal with auto-start-camera targeting active rundown photo item; amber dot when pending)
    • Slot 4: PAM (/pam)
    • Slot 5: Menu (toggles drawer / full navigation sheet; blue indicator dot when active route is outside slots 1, 2, 4)

DashboardLayout.vue filters visible navigation links based on Permissions, runtime access probes (canAssignCommandDuties, probeKerapianKamarAccess()), and active role:

  • Super Admin: Sees grouped sections MENU (Dashboard, Pendidikan, PAM & Paket, Izin & IB, conditional Poldik & Disiplin, conditional Operasional Korps, conditional Kerapian Kamar, Bagan Organisasi, Peta Persebaran Serdik, WBS Tracking) and OPERASIONAL HARIAN (Absensi Apel, Learning Rabuan, Karya Satu Batch, Apresiasi, Direktori Serdik (Yearbook), Kotak Aspirasi, Agenda Mandiri, Dokumentasi), plus Governance (Laporan Korps with review queue badge, Notulensi & Tugas PIC, Commander's Intent, G-Form & Pengumuman, Pusat Admin).
  • Operational & Non-Admin Roles: Streamlined flat navigation covering core operational screens (Dashboard, Pendidikan, PAM & Paket, Izin & IB, Learning Rabuan, Absensi Apel with Isi Apel vs Lihat Rekap badge, Karya Satu Batch, Apresiasi, Direktori Serdik (Yearbook), Laporan Korps, Notulensi & Tugas PIC, Commander's Intent, G-Form & Pengumuman), plus role-specific entries (Poldik & Disiplin, Operasional Korps, Kerapian Kamar, Dokumentasi for Penerangan, Pendampingan & Penugasan when canAssignCommandDuties succeeds, and read-only Pusat Admin for komandan_batch).
  • Footer Utility Links: Settings (/settings), Pasang Aplikasi (/settings#pasang-aplikasi), and Help Center (/help-center).

3. Complete Information Architecture (Routes & Views)

Section titled “3. Complete Information Architecture (Routes & Views)”

src/router/index.js defines 33 child and standalone routes backed by 30 dynamically imported views, plus InfoDigitalView.vue mounted as a tab inside PamView.vue (31 view files total in src/views/).

Route Path Route Name View File (src/views/) Access / Route Guard Primary Function
/login login LoginView.vue meta.public: true Credential login (NOSIS/NRP + PIN), Authentik OIDC PKCE sign-in, interactive 3D orbit canvas (>= lg).
/ganti-pin force-pin ForcePinView.vue must_change_pin === true Hosts AccountSetupModal guided onboarding (PIN -> optional SSO password -> email -> finish).
/ dashboard DashboardView.vue Authenticated Live WIB clock, mobile/desktop identity header, daily condition prompt availability, DashboardCalendar, rundown timeline, AttendanceAccumulationCard, quick links.
/absensi absensi AbsensiView.vue Authenticated (requiresDirectory) Command roll-call board (H/S/I touch targets, pagination, exemptions, locks, Danbatch official report) & AbsensiPribadi personal history/streak; LivePhotoModal camera/GPS attendance.
/pendidikan pendidikan PendidikanView.vue Authenticated (requiresDirectory) SBM ITB academic schedules, classroom allocations, syllabus materials, kelas_notes persistence.
/pam pam PamView.vue + InfoDigitalView.vue Authenticated (requiresDirectory) Three main tabs (?tab=): pengamanan (lost/found/damage reports), paket (package intake/delivery state machine), and info-digital (InfoDigitalView anonymous digital incident intake + Paminfo/command queue & XLSX export).
/perizinan perizinan PerizinanView.vue Authenticated (requiresDirectory) izin (Izin Keluar Nawasena 3-tier approval + ISO QR Digital Gate Pass modal + CSV export) and ib (Izin Bermalam selfie/GPS geotag check-in + 168h retention notice).
/poldik poldik PoldikView.vue Authenticated (requiresDirectory) Disciplinary tracking (catatan_disiplin), point/status monitoring, corrective records.
/operasional operasional OperasionalView.vue requiresOperasional (kabid_ops, super_admin) Ops command hub for work programs (proker_korps), task routing, daily emphasis, G-Form tracking sync.
/kerapian-kamar kerapian-kamar KerapianKamarView.vue requiresAuth, requiresDirectory (RPC-scoped UI) Room cleanliness review across 3 daily slots (CUTOFF WIB), physical-room status summary, element/mixed-element filters, room commander appointments, IB/manual exemptions.
/laporan-korps laporan-korps LaporanKorpsView.vue Authenticated (requiresDirectory) Dual workspace switcher: Korps Serdik (17 Unit) hierarchical Kasi/Kabid/BPI report & Proker tracker + batch matrix sparklines; Pengasuhan TNI (PengasuhReportsWorkspace) hierarchical supervision & print report.
/notulensi notulensi LearningView.vue Authenticated Appel/pengasuh minutes (notulensi_apel) + PIC task assignments (notulensi_pic_tasks).
/commander-intent commander-intent CommanderIntentView.vue Authenticated Official CommanderIntentArticle feed (Priority Krusial/Standar) + CRUD modal for komandan_batch, super_admin, penerangan.
/forms forms FormsTrackerView.vue Authenticated (requiresDirectory) Self-attestation G-Form completion tracker & batch announcements board.
/pendampingan pendampingan PendampinganView.vue Authenticated (RPC access-gated) Confidential mentoring/counselling cases (active/completed tabs, stale > 7 days indicator, slide-over <dialog> drawer).
/penugasan penugasan PenugasanView.vue Authenticated (non-demo, RPC-gated) Wraps ScopedDutiesPanel to delegate time-bounded (berlaku_mulai..berlaku_sampai) scoped kasi / pic capabilities.
/admin admin-console AdminConsoleView.vue requiresViewAll (super_admin write, komandan_batch read-only) 6-tab management console: crud_data (Serdik/Pengasuh CRUD + login unlock + PIN reset + Core PATCH), categories, hak_akses (ScopedDutiesPanel), data_privasi (IbRetentionPanel), audit (CSV export), sso_accounts (SsoAccountsPanel).
/organisasi organisasi BaganOrganisasiView.vue requiresViewAll (requiresDirectory) Organizational chart visualizer (serdik vs pengasuh tabs via ?tab=) using OrgTier/OrgBranch/OrgNode.
/peta-persebaran peta-persebaran PetaPersebaranView.vue Authenticated (requiresDirectory) Geographic distribution of cohort origins + optional interactive map (VITE_GOOGLE_MAPS_API_KEY or user-supplied localStorage key).
/learning learning LearningRabuanView.vue Authenticated Weekly Wednesday speaker archive (rabuan_sessions), articles (rabuan_articles), Super Admin authoring & approval.
/wbs wbs WbsView.vue Authenticated Dual tabs (Whistleblowing (WBS) & conditional Kotak Aspirasi Lemusdik): anonymous/identified submission + triage dashboard (belum_dibahas, dibahas_sidang, selesai).
/kotak-saran kotak-saran WbsView.vue requiresViewAll (requiresViewAll alias) Direct governance route to WBS & Lemusdik aspiration monitoring view.
/absensi (Sub-flows) absensi AbsensiView.vue Authenticated Embedded components AbsensiPribadi.vue, LivePhotoModal.vue, DailyConditionDialog.vue.
/rundown rundown RundownView.vue Authenticated Daily schedule timeline (Reguler, Rabu Eksternal, Akhir Pekan, Khusus), daily dress code (OUTFIT_TEMPLATES).
/rundown/edit rundown-edit RundownEditView.vue requiresCommander (Permissions.editRundown) Schedule & OOTD template editor persisted to rundown_harian.
/contribution contribution ContributionView.vue Authenticated Batch 1 portfolio showcase (Karya Satu Batch, optimized <=800x500 WebP thumbnails) + lazy LaporanEvaluasiGrup.
/sosiometri sosiometri ContributionView.vue Authenticated (requiresDirectory) Peer appreciation (Apresiasi / positive sociometry feed & submission) sharing ContributionView.vue.
/serdik serdik OrganisasiView.vue Authenticated (requiresDirectory) Student yearbook directory (portal_serdik_directory) searchable by Grup/Elemen/NOSIS.
/pengasuh pengasuh OrganisasiView.vue Authenticated (requiresDirectory) TNI instructor directory (pengasuh).
/dokumentasi dokumentasi DokumentasiView.vue requiresDokumentasiView (requiresDirectory) Photo archive gallery & Google Drive link hub + access to daily print report.
/dokumentasi/upload dokumentasi-upload DokumentasiUploadView.vue requiresDokumentasi Client-side JPEG upload pipeline routed through Code.gs webhook and indexed in public.dokumentasi.
/dokumentasi/laporan-harian/cetak dokumentasi-laporan-harian-cetak LaporanHarianPrintView.vue requiresDokumentasiView (printView: true) A4 formal daily command report preview with lazy image-readiness gate before window.print().
/help-center help-center HelpCenterView.vue Authenticated FAQs, emergency contacts (EmergencyContacts.vue), user guides, and local support ticket drawer (p3md_help_center_tickets_v1).
/settings settings SettingsView.vue Authenticated 3 tabs: Profil Saya (SsoProfileCard + read-only batch profile), Keamanan & PIN (portal_change_pin), Status Sistem (PwaInstallPanel #pasang-aplikasi, sync status, cache clear, logout).
/:pathMatch(.*)* — Redirect Global Redirects unmatched paths cleanly to /.

4. Dialogs, Modals, Notifications & Print Patterns

Section titled “4. Dialogs, Modals, Notifications & Print Patterns”

4.1 Global Dialogs & Stacked Toasts (useDialog.js, AppDialog.vue)

Section titled “4.1 Global Dialogs & Stacked Toasts (useDialog.js, AppDialog.vue)”
  • Imperative Non-Blocking Feedback: Replaced browser-native alert() / confirm() / prompt() across operational flows with useDialog():
    • notify(message, tone) emits stacked accessible toast banners (role="status" / aria-live="polite") positioned at bottom-24 md:bottom-4 right-4 z-[80] so mobile toasts clear the BottomNavBar while staying above modals (z-60).
    • confirmDialog({ title, message, confirmLabel, cancelLabel, tone }) presents a promise-returning centered confirmation dialog at z-[70].

4.2 Modal Foundation & Scroll Locking (BaseModal.vue, useScrollLock.js)

Section titled “4.2 Modal Foundation & Scroll Locking (BaseModal.vue, useScrollLock.js)”
  • Ref-Counted Scroll Lock: useScrollLock (src/composables/useScrollLock.js) maintains an integer lock reference count across concurrent nested modals/drawers (document.body.style.overflow = 'hidden', overscrollBehavior = 'contain', dataset.scrollLocked = 'true') and automatically decrements on Vue effectScope unmount, avoiding stuck scroll locks or underflows.
  • Mobile Sheet & Modal Contracts: Modals teleport to <body>, constrain scroll containers to 90dvh–92dvh with sticky headers/footers and overscroll-contain, implement Escape close + backdrop click close, move focus into the dialog on open, and restore focus to the triggering element on close. Native <dialog> elements (e.g., PendampinganView.vue slide-over drawer) enforce manual focus cycling and @cancel.prevent.

4.3 Print Architecture (src/style.css, LaporanHarianPrintView.vue, PengasuhReportsWorkspace.vue)

Section titled “4.3 Print Architecture (src/style.css, LaporanHarianPrintView.vue, PengasuhReportsWorkspace.vue)”
  • Routes carrying meta.printView: true or print-enabled workspaces isolate output under #print-laporan-root using @media print A4 rules in src/style.css, suppressing shell chrome (.side-nav, .top, .bottom-nav-bar, .no-print) and enforcing explicit image decoding waits (printState.waiting) before invoking window.print().

5. Accessibility (WCAG 2.1 AA) & Mobile Performance Standards

Section titled “5. Accessibility (WCAG 2.1 AA) & Mobile Performance Standards”

Every layout and UI component enforces concrete invariants audited automatically by Vitest/Node assertions in tests/shell-modal-a11y.test.mjs, tests/mobile-ux.test.mjs, tests/absensi-mobile-perf.test.mjs, tests/boot-assets-perf.test.mjs, and tests/camera-modals.test.mjs:

  1. iOS Input Auto-Zoom Prevention: On (hover: none) and (pointer: coarse), base CSS enforces font-size: max(16px, 1em) on :where(input:not([type="checkbox"]):not([type="radio"]):not([type="range"]), select, textarea) and .field.
  2. Minimum 44 px Coarse-Pointer Touch Targets: Primary/secondary/danger/gold buttons (.btn-primary, .btn-secondary, .btn-danger, .btn-gold, .btn-1, .btn-2), .mobile-menu-trigger, bottom nav items, and H/S/I roll-call chips guarantee at least 44px hit areas on touch devices.
  3. Keyboard & Screen Reader Semantics: Tab switchers carry role="tablist" / role="tab" / :aria-selected; toggle filter pills expose :aria-pressed; status feedback uses role="status" or role="alert"; headings expose programmatic focus targets (tabindex="-1", scroll-mt-20/scroll-margin-block-end: 7rem on mobile so sticky bars/bottom nav never occlude focused elements).
  4. Media & Camera Discipline: Static batch contribution thumbnails are constrained to <= 800x500 WebP files (< 8 MB decoded RGBA RAM footprint); camera modals (LivePhotoModal.vue, QrScanDialog.vue) explicitly release MediaStream tracks and GPU canvas buffers on close/unmount to eliminate mobile Safari memory exhaustion.
  5. PWA Installability (usePwaInstall.js, InstallPwaBanner.vue, PwaInstallPanel.vue, PwaInstallCard.vue): Captures beforeinstallprompt when eligible, offers manual iOS Share -> Add to Home Screen instructions where unsupported, and tracks dismissal state cleanly.