How carrick87/web.cs.visitorregistrationsystem works
Harrisons is a multi-warehouse visitor registration PWA centered on reusable QR tags: a visitor scans a tag, joins or starts a group check-in, and the storekeeper tracks and checks out that group. Separate capabilities cover legacy individual check-in, visitor history, tag/label administration, site and warehouse management, and role-scoped user administration. The sampled sources show Prisma-backed APIs and session/RBAC helpers; several UI-to-API links and unsampled routes are not verified, so those links are marked dashed with no evidence path.
Main entry points: prisma.ts Prisma client · route.ts Check-in API · dashboard/page.tsx Storekeeper dashboard · [tagCode]/page.tsx Tag check-in
Components 31
Visitor operations
- Tag check-in
app/tag/[tagCode]/page.tsx - Group check-in
app/api/tag/[code]/checkin/route.ts - Tag lookup
app/api/tag/[code]/route.ts - Individual check-in
app/checkin/page.tsx - Check-in API
app/api/checkin/route.ts - Check-in result
app/checkin/success/page.tsx - Warehouse check-in
app/checkin/[warehouseCode]/page.tsx - Checkout screen
app/checkout/page.tsx - Checkout API
app/api/checkout/route.ts - Group checkout
app/api/tags/[id]/checkout/route.ts - Tag result
app/tag/success/page.tsx
Staff workspace
- Storekeeper dashboard
app/dashboard/page.tsx - Visitor history
app/dashboard/history/page.tsx - Visitor records API
app/api/visitors/route.ts
Administration
- Site and warehouse admin
app/admin/page.tsx - Site administration
app/admin/site/page.tsx - Site details
app/admin/sites/[id]/page.tsx - Tag management
app/admin/tags/page.tsx - User management
app/admin/users/page.tsx - Warehouse details
app/admin/warehouses/[id]/page.tsx - Tag administration API
app/api/admin/tags/route.ts - User administration API
app/api/admin/users/route.ts - Demo data seeding
app/api/admin/seed/route.ts
Access control
- Login
app/login/page.tsx - Login API
app/api/auth/login/route.ts - Session handling
lib/session.ts - Role authorization
lib/rbac.ts
Persistence
- Prisma client
lib/prisma.ts - PostgreSQL
Other components
- Visitor
- QR tag
Connections 25
- Visitor → QR tag: receives
- QR tag → Tag check-in: scans URL
- Tag check-in → Tag lookup: loads tag
- Tag check-in → Group check-in: submits group
- Group check-in → Tag result: shows result
- Individual check-in → Check-in API: submits details
- Warehouse check-in → Check-in API: submits details
- Check-in API → Check-in result: shows result
- Checkout screen → Checkout API: requests checkout
- Storekeeper dashboard → Group checkout: checks out group
- Storekeeper dashboard → Checkout API: checks out visitor
- Storekeeper dashboard → Visitor records API: loads records
- Visitor history → Visitor records API: loads history
- Tag management → Tag administration API: manages tags
- User management → User administration API: manages users
- Login → Login API: authenticates
- Login API → Session handling: creates session
app/api/auth/login/route.ts - Role authorization → Session handling: reads session
lib/rbac.ts - Role authorization → Prisma client: queries access
lib/rbac.ts - Check-in API → Prisma client: creates visitor
app/api/checkin/route.ts - Visitor records API → Prisma client: queries visitors
app/api/visitors/route.ts - Tag administration API → Prisma client: queries tags
app/api/admin/tags/route.ts - User administration API → Prisma client: queries users
app/api/admin/users/route.ts - Demo data seeding → Prisma client: seeds records
app/api/admin/seed/route.ts - Prisma client → PostgreSQL: persists data