How abhiraljain07/visitor-management-system works
Atithi VMS is a multi-tenant visitor-management product. The principal workflow runs from reception face scanning and visitor registration through visit submission, host notification and approval, then checkout; the system also provides tenant administration, reports, and audit trails. The graph combines sampled frontend and backend modules with capabilities explicitly documented in the README. Some subsystem internals were not sampled, so their connections are shown only where source-index references or README statements support them.
Main entry points: server.js REST API server · visits.js Visit lifecycle and approvals · AppRoutes.tsx Role-based portals · visitors.js Visitor registration and matching
Components 27
Web application
- Role-based portals
frontend/src/routes/AppRoutes.tsx - Landing and dashboards
frontend/src/pages/LandingPage.tsx - HTTP API client
frontend/src/api/client.ts - Offline queue and sync
frontend/src/offline/offlineService.ts
Identity and access
- Authentication UI
frontend/src/features/auth - Authentication routes
backend/routes/auth.js - JWT and role authorization
backend/middleware/auth.js
Visitor operations
- Visitor and check-in UI
frontend/src/features/visitors - Visit approvals UI
frontend/src/features/visits - Visitor registration and matching
backend/routes/visitors.js - Visit lifecycle and approvals
backend/routes/visits.js - Visitor profiles
backend/models/Visitor.js - Visit records
backend/models/Visit.js
Tenant platform
- Tenant administration UI
frontend/src/features/tenant-admin - Platform administration UI
frontend/src/features/super-admin - Employee directory
backend/models/Employee.js - Tenant management
backend/models/Tenant.js - Tenant and office administration
backend/routes/tenants.js - Master data configuration
backend/routes/customMasterData.js - Reports and analytics
backend/routes/reports.js - Audit logging
backend/middleware/auditLog.js
Services and data
- REST API server
backend/server.js - Face recognition service
face-service/app.py - Telegram notifications
backend/telegram.js - Photo storage
backend/cloudinary.js - MongoDB
Other components
- Reception, host and admin users
Connections 38
- Reception, host and admin users → Role-based portals: uses portals
frontend/src/routes/AppRoutes.tsx - Role-based portals → Landing and dashboards: routes to
frontend/src/routes/AppRoutes.tsx - Role-based portals → Authentication UI: routes to
frontend/src/routes/AppRoutes.tsx - Role-based portals → Visitor and check-in UI: routes to
- Role-based portals → Visit approvals UI: routes to
- Role-based portals → Tenant administration UI: routes to
- Role-based portals → Platform administration UI: routes to
- Authentication UI → HTTP API client: sends requests
- Visitor and check-in UI → HTTP API client: sends requests
- Visit approvals UI → HTTP API client: sends requests
- Tenant administration UI → HTTP API client: sends requests
- HTTP API client → REST API server: HTTP requests
- Reception, host and admin users → Offline queue and sync: queues work
- REST API server → Authentication routes: mounts routes
backend/server.js - REST API server → Visitor registration and matching: mounts routes
backend/server.js - REST API server → Visit lifecycle and approvals: mounts routes
backend/server.js - REST API server → Tenant and office administration: mounts routes
backend/server.js - REST API server → Master data configuration: mounts routes
backend/server.js - REST API server → Reports and analytics: mounts routes
backend/server.js - Authentication routes → JWT and role authorization: uses authorization
backend/routes/auth.js - Authentication routes → Audit logging: records events
backend/routes/auth.js - Visitor registration and matching → Visitor profiles: reads and writes
backend/routes/visitors.js - Visit lifecycle and approvals → Visit records: reads and writes
backend/routes/visits.js - Visit lifecycle and approvals → Visitor profiles: loads profiles
backend/routes/visits.js - Visit lifecycle and approvals → Employee directory: loads hosts
backend/routes/visits.js - Visitor registration and matching → Face recognition service: matches faces
backend/routes/visitors.js - Visitor registration and matching → Photo storage: stores photos
backend/routes/visitors.js - Visit lifecycle and approvals → Telegram notifications: notifies host
backend/routes/visits.js - Visit lifecycle and approvals → Audit logging: records events
backend/routes/visits.js - Tenant and office administration → Tenant management: manages tenants
- Master data configuration → MongoDB: persists settings
- Reports and analytics → MongoDB: queries analytics
- REST API server → MongoDB: connects to
backend/server.js - Visitor registration and matching → MongoDB: persists profiles
- Visit lifecycle and approvals → MongoDB: persists visits
- Reception, host and admin users → Visitor and check-in UI: starts face scan
- Visitor and check-in UI → Visit lifecycle and approvals: submits check-in
- Reception, host and admin users → Visit approvals UI: decides request