How arcrek/vms works
Acme Corp VMS manages visitor registration, physical check-in/out, role-restricted staff surfaces, and digital passes. The main workflow is host pre-registration or kiosk/mobile walk-in, followed by reception verification and badge issuance; SSE updates the roster and arrival alerts. The app also provides rotating kiosk QR handoff, photo/NDA capture, pass verification, and multi-actor RBAC. Backend calls are shown where excerpts establish them; broader surface workflows follow README documentation, since several UI and API excerpts are partial.
Main entry points: VMSContext.jsx Shared VMS State · KioskWizard.jsx Check-In Wizard · ReceptionConsole.jsx Reception Console · MobileCheckin.jsx Mobile Check-In
Components 26
Identity and Access
- Actor Authentication
src/context/AuthContext.jsx - Surface RBAC
src/components/auth/RBACGuard.jsx
Visitor Registration
- Host Portal
src/components/host/HostPortal.jsx - Pre-Registration
src/components/host/PreRegisterModal.jsx - Entrance Kiosk
src/components/kiosk/KioskView.jsx - Check-In Wizard
src/components/kiosk/KioskWizard.jsx - Photo Capture
src/components/kiosk/CameraCapture.jsx - NDA Signature
src/components/kiosk/SignaturePad.jsx - Rolling QR
src/components/kiosk/RollingQR.jsx - Mobile Check-In
src/components/mobile/MobileCheckin.jsx
Reception Operations
- Reception Console
src/components/reception/ReceptionConsole.jsx - Visitor Roster
src/components/reception/VisitorTable.jsx - Code Scanner
src/components/reception/ScannerListener.jsx - Visit Verification
src/components/reception/VisitorDetailModal.jsx - Printable Badge
src/components/badge/BadgeModal.jsx
Visit Platform
- REST API
server/routes/api.js - Visit Lifecycle
server/services/visitService.js - SQLite Store
server/db/index.js - QR Token Service
server/services/tokenService.js
Pass and Updates
- SSE Broadcast
server/services/sseService.js - Shared VMS State
src/context/VMSContext.jsx - SSE Client
src/hooks/useSSE.js - Digital Pass
src/components/pass/MobilePass.jsx
Other components
- Host Sponsor
- Visitor
- Reception Guard
Connections 31
- Host Sponsor → Host Portal: uses
README.md - Visitor → Entrance Kiosk: checks in
README.md - Visitor → Mobile Check-In: checks in
README.md - Reception Guard → Reception Console: verifies visitors
README.md - Actor Authentication → Surface RBAC: supplies identity
src/App.jsx - Host Portal → Pre-Registration: opens
src/components/host/HostPortal.jsx - Pre-Registration → Shared VMS State: creates visit
README.md - Entrance Kiosk → Check-In Wizard: starts registration
src/components/kiosk/KioskView.jsx - Check-In Wizard → Photo Capture: captures photo
src/components/kiosk/KioskWizard.jsx - Check-In Wizard → NDA Signature: collects signature
src/components/kiosk/KioskWizard.jsx - Entrance Kiosk → Rolling QR: offers handoff
src/components/kiosk/KioskView.jsx - Rolling QR → Mobile Check-In: opens check-in
README.md - Mobile Check-In → NDA Signature: collects signature
src/components/mobile/MobileCheckin.jsx - Check-In Wizard → Shared VMS State: submits walk-in
README.md - Mobile Check-In → Shared VMS State: submits walk-in
README.md - Reception Console → Visitor Roster: renders roster
src/components/reception/ReceptionConsole.jsx - Reception Console → Code Scanner: uses scanner
src/components/reception/ReceptionConsole.jsx - Reception Console → Visit Verification: opens details
src/components/reception/ReceptionConsole.jsx - Visit Verification → Shared VMS State: checks in visitor
README.md - Reception Console → Printable Badge: opens print dialog
src/App.jsx - Shared VMS State → REST API: requests visit actions
README.md - REST API → Visit Lifecycle: routes lifecycle calls
server/routes/api.js - Visit Lifecycle → SQLite Store: reads and writes
server/services/visitService.js - Visit Lifecycle → SSE Broadcast: broadcasts changes
server/services/visitService.js - REST API → QR Token Service: requests QR token
server/routes/api.js - Shared VMS State → SSE Client: subscribes to events
src/context/VMSContext.jsx - SSE Client → SSE Broadcast: receives event stream
README.md - SSE Broadcast → Shared VMS State: refreshes live state
src/context/VMSContext.jsx - Shared VMS State → Digital Pass: provides pass data
README.md - Host Portal → Digital Pass: opens pass link
src/App.jsx - Check-In Wizard → Digital Pass: issues pass