PermisosQR gives businesses a simple, auditable way to manage short-term permissions — like employee breaks or vendor access — using printed QR codes scanned from any mobile browser. Each permission is time-boxed, tracked to completion, and scored for compliance automatically.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/edgar2420/QrPermision/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Install the backend and frontend, seed the database, and log in within minutes.
Deployment
Run the automated setup script on Ubuntu and start serving from any device.
API Reference
Full REST API documentation with request/response schemas and examples.
Core Features
Understand QR lifecycle, permission tracking, scanning, and reports.
How It Works
PermisosQR centers on a simple three-step permission lifecycle:Generate & Print QR Codes
A Super Admin generates a batch of numbered QR codes (up to 500 at once) from the QR Management screen and prints them on labels or cards. Each code has a unique database ID.
Enable a Permission
When an employee needs to leave, an operator scans the QR code using the built-in camera scanner. They enter the employee’s name and the allowed time (in minutes). The system records the exit time and marks the QR as active.
Register a Return
When the employee returns, the same QR is scanned again. PermisosQR calculates time used, any delay over the allowed window, and marks the permission as compliant or non-compliant automatically.
Key Capabilities
Bulk QR Generation
Generate up to 500 QR codes in a single request. Print them directly from the browser.
Compliance Tracking
Automatic delay detection and compliance scoring on every returned permission.
Mobile-Ready Scanning
Public scan endpoints let any phone browser enable or return a permission — no app required.
Role-Based Access
Two roles: Super Admin manages QR codes and users; Operators handle day-to-day scanning.
Real-Time Dashboard
Live stats auto-refresh every 30 seconds. See active, overdue, and compliant counts at a glance.
REST API
Full JSON API with JWT auth. Integrate PermisosQR into existing workflows or kiosks.
PermisosQR requires Node.js 18+ and PostgreSQL 14+. See the Quickstart for full setup instructions.