How palvash-kumar/viewmax works
ViewMax is a cinema booking and experience platform. Moviegoers discover films and showtimes, choose seats, reserve them during checkout, pay, and receive tickets for entry; theatre operators manage venues and design layouts, while the geometry-based intelligence features score and recommend seats. The map combines documented capabilities with sampled controller and engine relationships. Several service internals were not sampled, so uncertain wiring is omitted; the README documents the major external integrations and reservation behavior.
Main entry points: main.ts NestJS REST API · bookings Booking service · payments Payment handling · app ViewMax web app
Components 21
Customer experience
- ViewMax web app
frontend/src/app - Movies and showtimes
backend/src/movies - Seat intelligence
backend/src/cinema-intelligence
Venue operations
- Theatre management
backend/src/theatres - Screens and layouts
backend/src/theatre-design - Seat geometry
backend/src/theatre-design/engines
Booking and entry
- Booking service
backend/src/bookings - Payment handling
backend/src/payments - Ticket lifecycle
backend/src/tickets
Platform services
- Authentication
backend/src/auth - Notifications
backend/src/notifications - Audit and analytics
backend/src/analytics - NestJS REST API
backend/src/main.ts - MongoDB
- Redis
backend/src/redis
Other components
- Moviegoer
- Theatre operator
- Stripe
- SMTP email
- Cloudinary media
- Google OAuth
Connections 27
- Moviegoer → ViewMax web app: uses
- Theatre operator → ViewMax web app: manages venues
- ViewMax web app → NestJS REST API: REST requests
- NestJS REST API → Authentication: authenticates
- NestJS REST API → Movies and showtimes: routes requests
- NestJS REST API → Theatre management: routes requests
- NestJS REST API → Screens and layouts: routes requests
- NestJS REST API → Seat intelligence: routes requests
- NestJS REST API → Booking service: routes requests
- NestJS REST API → Payment handling: routes requests
- NestJS REST API → Ticket lifecycle: routes requests
- NestJS REST API → Notifications: routes requests
- NestJS REST API → Audit and analytics: routes requests
- Screens and layouts → Seat geometry: generates geometry
- ViewMax web app → Seat intelligence: requests seat insights
- Booking service → Redis: locks seats
- Booking service → Payment handling: starts checkout
- Payment handling → Stripe: creates checkout
- Stripe → Payment handling: sends webhook
- Payment handling → Booking service: confirms or releases
- Ticket lifecycle → Redis: stores QR nonce
- Movies and showtimes → MongoDB: reads catalog
- Booking service → MongoDB: stores bookings
- Ticket lifecycle → MongoDB: reads booking data
- Notifications → SMTP email: sends email
- NestJS REST API → Cloudinary media: uploads media
- Authentication → Google OAuth: OAuth sign-in