Visitor Management System (VMS)

A mobile-first front-desk visitor check-in kiosk and management app designed for Frappe & ERPNext.

Built for front-desk tablets and desktop stations in corporate and brokerage offices. Visitors check themselves in via an intuitive, touch-friendly kiosk, capture a live photo, sign on-screen, and receive a branded A4 Visitor Pass.

Features

• Mobile-First PWA (/vms): Fully responsive layout optimized for touch targets (48px+ touch area, 56px primary buttons) on phones (390px), tablets (768px), and desktops (1280px+).

• 4 Visitor Categories with Colour-Coded Badges:

  • Client: Blue (#2E6FBA) — Includes optional Client Code and post-visit 4-metric hospitality rating.

  • Interview Candidate: Purple (#7C3AED) — Includes Position and Invited HR employee search.

  • Vendor: Amber (#D69E2E) — Includes Vendor Master live lookup, contact person, work status, and inline first-time vendor registration with GST format validation.

  • New Joiner: Green (#2F855A) — Includes Department and HR Contact employee search.

• Live Front-Camera Capture: Real-time webcam/tablet camera preview via navigator.mediaDevices.getUserMedia with client-side canvas downscaling to 640px JPEG (quality 0.8) and private file storage.

• Retina DPI Signature Pad: High-precision signature capture with DPI scaling, pointer events, and non-empty stroke validation (minimum 10 points).

• A4 Visitor Pass Print Format: Branded top-half A4 visitor pass with photo, large Visitor ID, purpose, host details, company rules, and out-time signoff.

• Fast Check-Out: Quick lookup by Visitor ID or Mobile number with hospitality star ratings for client visits.

• Privacy & Security:

  • Zero delete permissions across all roles on Visitor Entry and Vendor.

  • Automatic 120-second idle reset (with 15s warning banner) to protect visitor privacy on shared devices.

  • Private file storage for photos and signatures.

  • Kiosk access locked to Front Desk, Visitor Admin, and System Manager roles (guests receive a temporary HTTP 302 redirect to login).

Roles & Permissions

• Front Desk: Daily front-desk operations (runs kiosk, checks in/out visitors, adds vendors, prints passes). Cannot delete any records.

• Visitor Admin: Administrative oversight (configures Visitor Settings, reviews visit logs, manages vendor master). Cannot delete records.

• System Manager: System administration and custom app management.

How to Use the Kiosk

1. Front Desk Shift Setup: Log in to the front-desk workstation as a user with the Front Desk role and navigate to your site's /vms PWA interface.

2. Visitor Check-In Flow: Tap Check-In, select the visitor category, fill in contact details and host autocomplete, capture live face photo, sign on the digital signature pad, and submit to generate the printable Visitor ID badge.

3. Visitor Check-Out Flow: Tap Check-Out on the Home screen, enter the Visitor ID or mobile number, provide hospitality ratings for client visits, and confirm check-out.

Go-Live Checklist

Before opening the Visitor Management System to public visitors in production:

1. System & Time Zone Configuration: Verify System Settings -> Time Zone is set correctly (e.g., Asia/Kolkata) so visit timestamps are accurate. Configure Visitor Settings with company name and pass rules.

2. Dedicated Front Desk Kiosk User: Create a dedicated user account with only the Front Desk role.

3. Hardware & HTTPS Setup: Ensure the kiosk page is served over HTTPS so the browser grants camera permissions without security warnings.

4. Physical Printer Test: Print sample visitor passes for each of the 4 visitor types on your reception printer to verify A4 margins and monochrome legibility.

5. Security Verification: Confirm zero delete permissions on Visitor Entry/Vendor and ensure attachments are saved privately.

License

MIT