How xellanix/qr-validator works
This repository appears to be PreMark, a browser-based project and presence-management app with a Go backend and realtime Socket.IO services; the README describes a different QR-scanner product, so its workflow details are not treated as evidence for these modules. The visible frontend entry point leads to home and console experiences, while the backend serves authentication, dataset, download, and report endpoints and registers realtime domain handlers. Several frontend capabilities are clear from the tree but their wiring was not sampled, so those relationships are omitted.
Main entry points: index.go Socket event registry · main.go HTTP server · router.tsx App routes · auth.go Auth endpoints
Components 27
Web application
- Frontend entry
frontend/main.tsx - App routes
frontend/router.tsx - Home workflow
frontend/app/index.tsx - Console
frontend/components/console/index.tsx - Authentication UI
frontend/components/auth.tsx - Auth client
frontend/lib/auth.ts - Project management
frontend/components/dialogs/projects/index.tsx - Scanner and generators
frontend/components/generators/index.tsx - History view
frontend/components/history.tsx - Report experience
frontend/components/report.tsx
HTTP backend
- HTTP server
server/main.go - Auth endpoints
server/handlers/auth.go - JWT security
server/lib/auth.go - Dataset endpoints
server/handlers/csv.go - Downloads
server/handlers/download.go - Report generation
server/handlers/generate.go
Realtime services
- Socket event registry
server/sockets/index.go - Socket authentication
server/sockets/auth.go - Presence events
server/sockets/presence.go - Project events
server/sockets/project.go - Dataset events
server/sockets/dataset.go - History events
server/sockets/history.go
Persistence
- Project storage
server/db/project.go - Dataset storage
server/db/dataset.go - Presence history storage
server/db/presence_history.go - User storage
server/db/user.go
Other components
- User
Connections 18
- Frontend entry → App routes: renders
frontend/main.tsx - App routes → Home workflow: routes to
frontend/router.tsx - App routes → Console: routes to
frontend/router.tsx - Home workflow → History view: renders
frontend/app/index.tsx - User → Authentication UI: provides credentials
frontend/components/auth.tsx - Authentication UI → Auth client: calls
frontend/components/auth.tsx - HTTP server → Auth endpoints: routes requests
server/main.go - HTTP server → Dataset endpoints: routes requests
server/main.go - HTTP server → Downloads: routes requests
server/main.go - HTTP server → Report generation: routes requests
server/main.go - HTTP server → Socket event registry: mounts handler
server/main.go - Auth endpoints → User storage: looks up users
server/handlers/auth.go - Auth endpoints → JWT security: signs and verifies
server/handlers/auth.go - Socket event registry → Socket authentication: registers checks
server/sockets/index.go - Socket event registry → Presence events: registers listeners
server/sockets/index.go - Socket event registry → Project events: registers listeners
server/sockets/index.go - Socket event registry → Dataset events: registers listeners
server/sockets/index.go - Socket event registry → History events: registers listeners
server/sockets/index.go