# carrick87/web.cs.visitorregistrationsystem architecture

> Architecture diagram of the GitHub repository carrick87/web.cs.visitorregistrationsystem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/carrick87/web.cs.visitorregistrationsystem
- Repository: https://github.com/carrick87/web.cs.visitorregistrationsystem

## Overview

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: [`lib/prisma.ts`](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/prisma.ts) (Prisma client), [`app/api/checkin/route.ts`](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/checkin/route.ts) (Check-in API), [`app/dashboard/page.tsx`](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/dashboard/page.tsx) (Storekeeper dashboard), [`app/tag/[tagCode]/page.tsx`](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/tag/%5BtagCode%5D/page.tsx) (Tag check-in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor operations"]
  node_tag_entry["Tag check-in<br/>[page.tsx]"]
  node_tag_checkin["Group check-in<br/>[route.ts]"]
  node_tag_lookup["Tag lookup<br/>[route.ts]"]
  node_legacy_checkin["Individual check-in<br/>[page.tsx]"]
  node_checkin_api["Check-in API<br/>[route.ts]"]
  node_checkin_success["Check-in result<br/>[page.tsx]"]
  node_warehouse_checkin["Warehouse check-in<br/>[page.tsx]"]
  node_checkout_page["Checkout screen<br/>[page.tsx]"]
  node_checkout_api["Checkout API<br/>[route.ts]"]
  node_tag_checkout["Group checkout<br/>[route.ts]"]
  node_tag_success["Tag result<br/>[page.tsx]"]
end

subgraph group_staff["Staff workspace"]
  node_dashboard["Storekeeper dashboard<br/>[page.tsx]"]
  node_history["Visitor history<br/>[page.tsx]"]
  node_visitor_api["Visitor records API<br/>[route.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_overview["Site and warehouse admin<br/>[page.tsx]"]
  node_admin_site["Site administration<br/>[page.tsx]"]
  node_admin_site_detail["Site details<br/>[page.tsx]"]
  node_admin_tags["Tag management<br/>[page.tsx]"]
  node_admin_users["User management<br/>[page.tsx]"]
  node_admin_warehouses["Warehouse details<br/>[page.tsx]"]
  node_admin_tags_api["Tag administration API<br/>[route.ts]"]
  node_admin_users_api["User administration API<br/>[route.ts]"]
  node_seed_api["Demo data seeding<br/>[route.ts]"]
end

subgraph group_security["Access control"]
  node_login["Login<br/>[page.tsx]"]
  node_login_api["Login API<br/>[route.ts]"]
  node_session["Session handling<br/>[session.ts]"]
  node_rbac["Role authorization<br/>[rbac.ts]"]
end

subgraph group_data["Persistence"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_postgres[("PostgreSQL")]
end

node_visitor(("Visitor"))
node_physical_tag["QR tag"]

node_visitor -->|"receives"| node_physical_tag
node_physical_tag -->|"scans URL"| node_tag_entry
node_tag_entry -.->|"loads tag"| node_tag_lookup
node_tag_entry -.->|"submits group"| node_tag_checkin
node_tag_checkin -.->|"shows result"| node_tag_success
node_legacy_checkin -.->|"submits details"| node_checkin_api
node_warehouse_checkin -.->|"submits details"| node_checkin_api
node_checkin_api -.->|"shows result"| node_checkin_success
node_checkout_page -.->|"requests checkout"| node_checkout_api
node_dashboard -.->|"checks out group"| node_tag_checkout
node_dashboard -.->|"checks out visitor"| node_checkout_api
node_dashboard -.->|"loads records"| node_visitor_api
node_history -.->|"loads history"| node_visitor_api
node_admin_tags -.->|"manages tags"| node_admin_tags_api
node_admin_users -.->|"manages users"| node_admin_users_api
node_login -.->|"authenticates"| node_login_api
node_login_api -.->|"creates session"| node_session
node_rbac -->|"reads session"| node_session
node_rbac -->|"queries access"| node_prisma
node_checkin_api -->|"creates visitor"| node_prisma
node_visitor_api -->|"queries visitors"| node_prisma
node_admin_tags_api -->|"queries tags"| node_prisma
node_admin_users_api -->|"queries users"| node_prisma
node_seed_api -->|"seeds records"| node_prisma
node_prisma -.->|"persists data"| node_postgres

click node_tag_entry "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/tag/%5BtagCode%5D/page.tsx"
click node_tag_checkin "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/tag/%5Bcode%5D/checkin/route.ts"
click node_tag_lookup "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/tag/%5Bcode%5D/route.ts"
click node_legacy_checkin "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkin/page.tsx"
click node_checkin_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/checkin/route.ts"
click node_checkin_success "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkin/success/page.tsx"
click node_warehouse_checkin "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkin/%5BwarehouseCode%5D/page.tsx"
click node_checkout_page "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkout/page.tsx"
click node_checkout_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/checkout/route.ts"
click node_tag_checkout "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/tags/%5Bid%5D/checkout/route.ts"
click node_tag_success "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/tag/success/page.tsx"
click node_dashboard "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/dashboard/page.tsx"
click node_history "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/dashboard/history/page.tsx"
click node_visitor_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/visitors/route.ts"
click node_admin_overview "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/page.tsx"
click node_admin_site "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/site/page.tsx"
click node_admin_site_detail "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/sites/%5Bid%5D/page.tsx"
click node_admin_tags "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/tags/page.tsx"
click node_admin_users "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/users/page.tsx"
click node_admin_warehouses "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/warehouses/%5Bid%5D/page.tsx"
click node_admin_tags_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/admin/tags/route.ts"
click node_admin_users_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/admin/users/route.ts"
click node_seed_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/admin/seed/route.ts"
click node_login "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/login/page.tsx"
click node_login_api "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/auth/login/route.ts"
click node_session "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/session.ts"
click node_rbac "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/rbac.ts"
click node_prisma "https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/prisma.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tag_entry,node_tag_checkin,node_tag_lookup,node_legacy_checkin,node_checkin_api,node_checkin_success,node_warehouse_checkin,node_checkout_page,node_checkout_api,node_tag_checkout,node_tag_success toneBlue
class node_dashboard,node_history,node_visitor_api toneAmber
class node_admin_overview,node_admin_site,node_admin_site_detail,node_admin_tags,node_admin_users,node_admin_warehouses,node_admin_tags_api,node_admin_users_api,node_seed_api toneMint
class node_login,node_login_api,node_session,node_rbac toneRose
class node_prisma,node_postgres,node_visitor,node_physical_tag toneIndigo
```

## Components

### Visitor operations

- [Tag check-in](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/tag/%5BtagCode%5D/page.tsx): `app/tag/[tagCode]/page.tsx`
- [Group check-in](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/tag/%5Bcode%5D/checkin/route.ts): `app/api/tag/[code]/checkin/route.ts`
- [Tag lookup](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/tag/%5Bcode%5D/route.ts): `app/api/tag/[code]/route.ts`
- [Individual check-in](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkin/page.tsx): `app/checkin/page.tsx`
- [Check-in API](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/checkin/route.ts): `app/api/checkin/route.ts`
- [Check-in result](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkin/success/page.tsx): `app/checkin/success/page.tsx`
- [Warehouse check-in](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkin/%5BwarehouseCode%5D/page.tsx): `app/checkin/[warehouseCode]/page.tsx`
- [Checkout screen](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/checkout/page.tsx): `app/checkout/page.tsx`
- [Checkout API](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/checkout/route.ts): `app/api/checkout/route.ts`
- [Group checkout](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/tags/%5Bid%5D/checkout/route.ts): `app/api/tags/[id]/checkout/route.ts`
- [Tag result](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/tag/success/page.tsx): `app/tag/success/page.tsx`

### Staff workspace

- [Storekeeper dashboard](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Visitor history](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/dashboard/history/page.tsx): `app/dashboard/history/page.tsx`
- [Visitor records API](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/visitors/route.ts): `app/api/visitors/route.ts`

### Administration

- [Site and warehouse admin](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Site administration](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/site/page.tsx): `app/admin/site/page.tsx`
- [Site details](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/sites/%5Bid%5D/page.tsx): `app/admin/sites/[id]/page.tsx`
- [Tag management](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/tags/page.tsx): `app/admin/tags/page.tsx`
- [User management](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/users/page.tsx): `app/admin/users/page.tsx`
- [Warehouse details](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/admin/warehouses/%5Bid%5D/page.tsx): `app/admin/warehouses/[id]/page.tsx`
- [Tag administration API](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/admin/tags/route.ts): `app/api/admin/tags/route.ts`
- [User administration API](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/admin/users/route.ts): `app/api/admin/users/route.ts`
- [Demo data seeding](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/admin/seed/route.ts): `app/api/admin/seed/route.ts`

### Access control

- [Login](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Login API](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Session handling](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/session.ts): `lib/session.ts`
- [Role authorization](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/rbac.ts): `lib/rbac.ts`

### Persistence

- [Prisma client](https://github.com/carrick87/web.cs.visitorregistrationsystem/blob/main/lib/prisma.ts): `lib/prisma.ts`
- **PostgreSQL**

### Other components

- **Visitor**
- **QR tag**

## Connections

- 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 (evidence: `app/api/auth/login/route.ts`)
- Role authorization → Session handling: reads session (evidence: `lib/rbac.ts`)
- Role authorization → Prisma client: queries access (evidence: `lib/rbac.ts`)
- Check-in API → Prisma client: creates visitor (evidence: `app/api/checkin/route.ts`)
- Visitor records API → Prisma client: queries visitors (evidence: `app/api/visitors/route.ts`)
- Tag administration API → Prisma client: queries tags (evidence: `app/api/admin/tags/route.ts`)
- User administration API → Prisma client: queries users (evidence: `app/api/admin/users/route.ts`)
- Demo data seeding → Prisma client: seeds records (evidence: `app/api/admin/seed/route.ts`)
- Prisma client → PostgreSQL: persists data
