How priyayids/vms-myboga works
Visitor Middleware Service accepts visitor registrations and room-management requests, coordinates bookings with Nuveq’s access-control API, and returns booking details and QR-code access. The principal flow validates and deduplicates a registration, resolves its room and doors, creates paired check-in/check-out visitor records upstream, and generates QR codes. Card events then advance booking state; room availability and no-show expiry support the booking lifecycle. The README documents both webhook and polling event modes. Several runtime connections are supported by the README or source index; unsampled implementation details are not inferred.
Main entry points: BookingService.java Booking orchestration · RoomService.java Room and door management · NuveqVisitorClient.java Nuveq API client · RoomController.java Room endpoints
Components 25
API intake
- Visitor endpoints
src/main/java/com/visitorbridge/controller/VisitorController.java - Booking endpoints
src/main/java/com/visitorbridge/controller/BookingController.java - Room endpoints
src/main/java/com/visitorbridge/controller/RoomController.java - Event webhook
src/main/java/com/visitorbridge/controller/EventWebhookController.java
Booking lifecycle
- Booking orchestration
src/main/java/com/visitorbridge/service/BookingService.java - Booking state
src/main/java/com/visitorbridge/model/Booking.java - QR generation
src/main/java/com/visitorbridge/service/QrCodeService.java
Room and access
- Room and door management
src/main/java/com/visitorbridge/service/RoomService.java - Room model
src/main/java/com/visitorbridge/model/Room.java - Door model
src/main/java/com/visitorbridge/model/Door.java - Startup door sync
src/main/java/com/visitorbridge/service/RoomStartupSyncRunner.java
Nuveq integration
- Nuveq API client
src/main/java/com/visitorbridge/client/NuveqVisitorClient.java - Nuveq configuration
src/main/java/com/visitorbridge/config/NuveqProperties.java - Webhook event listener
src/main/java/com/visitorbridge/listener/WebhookCardEventListener.java - Polling event listener
src/main/java/com/visitorbridge/listener/PollingCardEventListener.java
Persistence and operations
- Booking repository
src/main/java/com/visitorbridge/repository/BookingRepository.java - Room repository
src/main/java/com/visitorbridge/repository/RoomRepository.java - Door repository
src/main/java/com/visitorbridge/repository/DoorRepository.java - Webhook event log
src/main/java/com/visitorbridge/model/WebhookEventLog.java - Event log repository
src/main/java/com/visitorbridge/repository/WebhookEventLogRepository.java - Transaction logging
src/main/java/com/visitorbridge/service/TransactionLogger.java - Booking and QR settings
src/main/java/com/visitorbridge/config/VmsProperties.java
Other components
- Visitor form/client
- Room operator
- Nuveq Access API
Connections 28
- Visitor form/client → Visitor endpoints: submits registration
- Visitor endpoints → Booking orchestration: registers visitor
src/main/java/com/visitorbridge/controller/VisitorController.java - Booking orchestration → Booking repository: checks and saves
src/main/java/com/visitorbridge/service/BookingService.java - Booking orchestration → Room repository: resolves room
src/main/java/com/visitorbridge/service/BookingService.java - Booking orchestration → Door repository: resolves doors
src/main/java/com/visitorbridge/service/BookingService.java - Booking orchestration → Nuveq API client: creates visitors
src/main/java/com/visitorbridge/service/BookingService.java - Nuveq API client → Nuveq Access API: sends API requests
src/main/java/com/visitorbridge/client/NuveqVisitorClient.java - Booking orchestration → QR generation: generates QR codes
src/main/java/com/visitorbridge/service/BookingService.java - Booking endpoints → Booking orchestration: handles booking
src/main/java/com/visitorbridge/controller/BookingController.java - Booking endpoints → QR generation: serves QR codes
src/main/java/com/visitorbridge/controller/BookingController.java - Booking orchestration → Booking state: updates state
src/main/java/com/visitorbridge/service/BookingService.java - Event webhook → Booking orchestration: processes event
src/main/java/com/visitorbridge/controller/EventWebhookController.java - Event webhook → Event log repository: records event
- Webhook event listener → Booking orchestration: processes card event
src/main/java/com/visitorbridge/listener/WebhookCardEventListener.java - Polling event listener → Nuveq API client: polls events
src/main/java/com/visitorbridge/listener/PollingCardEventListener.java - Polling event listener → Booking orchestration: processes events
- Room operator → Room endpoints: manages rooms
src/main/java/com/visitorbridge/controller/RoomController.java - Room endpoints → Room and door management: manages rooms
src/main/java/com/visitorbridge/controller/RoomController.java - Room endpoints → Booking orchestration: checks availability
src/main/java/com/visitorbridge/controller/RoomController.java - Room and door management → Room repository: reads and writes
src/main/java/com/visitorbridge/service/RoomService.java - Room and door management → Door repository: reads and writes
src/main/java/com/visitorbridge/service/RoomService.java - Room and door management → Nuveq API client: fetches doors
src/main/java/com/visitorbridge/service/RoomService.java - Room model → Door model: associates doors
src/main/java/com/visitorbridge/model/Room.java - Startup door sync → Room and door management: syncs doors
- Booking orchestration → Transaction logging: logs transactions
src/main/java/com/visitorbridge/service/BookingService.java - QR generation → Booking and QR settings: reads QR settings
src/main/java/com/visitorbridge/service/QrCodeService.java - Nuveq API client → Nuveq configuration: uses API settings
src/main/java/com/visitorbridge/client/NuveqVisitorClient.java - Event log repository → Webhook event log: persists events
src/main/java/com/visitorbridge/repository/WebhookEventLogRepository.java