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 |
1. Visual Identity & Design Tokens
Section titled “1. Visual Identity & Design Tokens”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& Tailwindsans), paired withInterloaded inindex.html, falling back toui-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”- Tablet Dead-Zone Prevention (
< 1024px):.side-navhides below1024px, while.bottom-nav-barstays visible up to1023pxand the header exposes.mobile-menu-trigger(aria-controls="mobile-menu-sheet",aria-expanded). - Backdrop-Filter Trap Prevention: At
max-width: 1023px,.topomitsbackdrop-filterand.main-wrapperdefines noz-index, preventing fixed modals/popovers from being clipped behindBottomNavBaror.top. - Scroll & Safe-Area Layering:
.content-wrapuses@layer componentsbottom paddingcalc(6.5rem + env(safe-area-inset-bottom, 0px))on< 1024pxso mobile bottom bars never obscure action buttons. - 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
LivePhotoModalwithauto-start-cameratargeting 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)
- Slot 1: Dashboard (
2.2 Role-Scoped Navigation Model
Section titled “2.2 Role-Scoped Navigation Model”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, conditionalPoldik & Disiplin, conditionalOperasional Korps, conditionalKerapian Kamar,Bagan Organisasi,Peta Persebaran Serdik,WBS Tracking) andOPERASIONAL HARIAN(Absensi Apel,Learning Rabuan,Karya Satu Batch,Apresiasi,Direktori Serdik (Yearbook),Kotak Aspirasi,Agenda Mandiri,Dokumentasi), plus Governance (Laporan Korpswith 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 ApelwithIsi ApelvsLihat Rekapbadge,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,Dokumentasifor Penerangan,Pendampingan&PenugasanwhencanAssignCommandDutiessucceeds, and read-onlyPusat Adminforkomandan_batch). - Footer Utility Links:
Settings(/settings),Pasang Aplikasi(/settings#pasang-aplikasi), andHelp 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 withuseDialog():notify(message, tone)emits stacked accessible toast banners (role="status"/aria-live="polite") positioned atbottom-24 md:bottom-4 right-4 z-[80]so mobile toasts clear theBottomNavBarwhile staying above modals (z-60).confirmDialog({ title, message, confirmLabel, cancelLabel, tone })presents a promise-returning centered confirmation dialog atz-[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 VueeffectScopeunmount, avoiding stuck scroll locks or underflows. - Mobile Sheet & Modal Contracts: Modals teleport to
<body>, constrain scroll containers to90dvh–92dvhwith sticky headers/footers andoverscroll-contain, implementEscapeclose + 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.vueslide-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: trueor print-enabled workspaces isolate output under#print-laporan-rootusing@media printA4 rules insrc/style.css, suppressing shell chrome (.side-nav,.top,.bottom-nav-bar,.no-print) and enforcing explicit image decoding waits (printState.waiting) before invokingwindow.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:
- iOS Input Auto-Zoom Prevention: On
(hover: none) and (pointer: coarse), base CSS enforcesfont-size: max(16px, 1em)on:where(input:not([type="checkbox"]):not([type="radio"]):not([type="range"]), select, textarea)and.field. - 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 least44pxhit areas on touch devices. - Keyboard & Screen Reader Semantics: Tab switchers carry
role="tablist"/role="tab"/:aria-selected; toggle filter pills expose:aria-pressed; status feedback usesrole="status"orrole="alert"; headings expose programmatic focus targets (tabindex="-1",scroll-mt-20/scroll-margin-block-end: 7remon mobile so sticky bars/bottom nav never occlude focused elements). - Media & Camera Discipline: Static batch contribution thumbnails are constrained to
<= 800x500WebP files (< 8 MBdecoded RGBA RAM footprint); camera modals (LivePhotoModal.vue,QrScanDialog.vue) explicitly releaseMediaStreamtracks and GPU canvas buffers on close/unmount to eliminate mobile Safari memory exhaustion. - PWA Installability (
usePwaInstall.js,InstallPwaBanner.vue,PwaInstallPanel.vue,PwaInstallCard.vue): Capturesbeforeinstallpromptwhen eligible, offers manual iOS Share -> Add to Home Screen instructions where unsupported, and tracks dismissal state cleanly.