How seemant-dev/resource-booking-engine works
Resource-Booking-Engine is a Next.js booking interface backed by a Spring API. Its principal user path is sign in, browse resources and dated slots, book or cancel, then review bookings; administrators manage resources and generate slots, and inspect bookings and summary statistics. The backend separates HTTP controllers, domain services, and persistence. The tree documents these capabilities, but sampled UI pages use mock data and the UI API wiring for most flows was not shown, so those links are omitted rather than assumed.
Main entry points: client.ts API client · SlotService.java Slot discovery and generation · BookingService.java Booking and cancellation · AuthService.java Authentication
Components 30
Booking interface
- Sign in / register
SlotEngine-UI/src/app/(auth)/login/page.tsx - Browse resources
SlotEngine-UI/src/app/(user)/resources/page.tsx - Resource slots
SlotEngine-UI/src/app/(user)/resources/[resourceId]/page.tsx - My bookings
SlotEngine-UI/src/app/(user)/bookings/page.tsx - Admin pages
SlotEngine-UI/src/app/(admin)/admin/page.tsx - Manage resources
SlotEngine-UI/src/app/(admin)/admin/resources/page.tsx - Generate slots
SlotEngine-UI/src/app/(admin)/admin/resources/[resourceId]/slots/new/page.tsx - Booking search
SlotEngine-UI/src/app/(admin)/admin/bookings/page.tsx - API client
SlotEngine-UI/src/api/client.ts
HTTP and identity
- Auth endpoints
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AuthController.java - Resource and slot endpoints
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java - Booking endpoints
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/BookingController.java - Admin endpoints
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AdminController.java - JWT security
SlotEngine-Server/src/main/java/com/resourcebooking/server/security/JwtAuthenticationFilter.java
Booking domain
- Authentication
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java - Resource management
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/ResourceService.java - Slot discovery and generation
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java - Candidate generation
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotCandidateGenerator.java - Booking and cancellation
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java - Admin reports
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java - Refresh tokens
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/RefreshTokenService.java - Booking mapping
SlotEngine-Server/src/main/java/com/resourcebooking/server/mapper/BookingMapper.java
Persistence
- Slot storage
SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/SlotRepository.java - Booking storage
SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/BookingRepository.java - User storage
SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/UserRepository.java - Resource storage
SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/ResourceRepository.java - Admin queries
SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/AdminRepository.java - Refresh-token storage
SlotEngine-Server/src/main/java/com/resourcebooking/server/repository/RefreshTokenRepository.java
Other components
- User
- Administrator
Connections 39
- User → Sign in / register: uses
- User → Browse resources: browses
- User → Resource slots: selects slot
- User → My bookings: reviews
- Administrator → Admin pages: uses
- Administrator → Manage resources: manages
- Administrator → Generate slots: generates
- Administrator → Booking search: searches
- Sign in / register → API client: requests
- Browse resources → API client: requests
- Resource slots → API client: requests
- My bookings → API client: requests
- Manage resources → API client: requests
- Generate slots → API client: requests
- Booking search → API client: requests
- API client → Auth endpoints: HTTP requests
- API client → Resource and slot endpoints: HTTP requests
- API client → Booking endpoints: HTTP requests
- API client → Admin endpoints: HTTP requests
- Auth endpoints → Authentication: delegates
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AuthController.java - Resource and slot endpoints → Resource management: delegates
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java - Resource and slot endpoints → Slot discovery and generation: delegates
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/ResourceController.java - Admin endpoints → Admin reports: delegates
SlotEngine-Server/src/main/java/com/resourcebooking/server/controller/AdminController.java - Booking endpoints → Booking and cancellation: delegates
- Authentication → User storage: reads/writes users
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java - Authentication → Refresh tokens: creates / rotates
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AuthService.java - Authentication → Refresh-token storage: via token service
- Slot discovery and generation → Candidate generation: generates candidates
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java - Slot discovery and generation → Resource storage: loads resource
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java - Slot discovery and generation → Slot storage: reads existing slots
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/SlotService.java - Slot discovery and generation → Booking mapping: maps slots
- Booking and cancellation → Slot storage: locks / reads slot
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java - Booking and cancellation → User storage: loads user
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java - Booking and cancellation → Booking storage: reads / saves booking
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java - Booking and cancellation → Booking mapping: maps response
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/BookingService.java - Admin reports → Admin queries: queries reports
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java - Admin reports → Booking mapping: maps bookings
SlotEngine-Server/src/main/java/com/resourcebooking/server/service/AdminService.java - Admin queries → Booking storage: queries booking data
- Refresh tokens → Refresh-token storage: stores tokens