How santer1/coreevents works
CoreEvents is an events-and-bookings platform with a React SPA, a BFF-style API gateway, and independent Users, Events, and Bookings services. The user journey is: authenticate, browse or manage events, request a booking, and check its status; booking confirmation and seat reservation cross service boundaries asynchronously through Kafka. The map includes documented storage, caching, and messaging capabilities. Some backend internals were not sampled, so their links rely on README descriptions rather than inspected call sites.
Main entry points: ServiceCollectionExtensions.cs Reverse proxy · App.tsx React SPA · EventService.cs Event operations · authApi.ts Auth UI and API
Components 30
Web client
- React SPA
Frontend/react-web/src/app/App.tsx - Auth UI and API
Frontend/react-web/src/features/auth/api/authApi.ts - Events UI and API
Frontend/react-web/src/features/events/api/eventsApi.ts - Bookings UI and API
Frontend/react-web/src/features/bookings/api/bookingsApi.ts - Session state
Frontend/react-web/src/shared/lib/auth/sessionStore.ts
Gateway
- Reverse proxy
Gateway/Gateway.Api/Extensions/ServiceCollectionExtensions.cs - Cookie transform
Gateway/Gateway.Api/Transforms/CookieToBearerTransformProvider.cs - API documentation
Gateway/Gateway.Api/Configuration/OpenApiDocConfig.cs
User identity
- Auth and profile API
Services/Users/Users.Api/Controllers/AuthController.cs - Session cookies
Services/Users/Users.Api/Services/AuthCookieService.cs - User application
Services/Users/Users.Application/Services/UserService.cs - User and tokens
Services/Users/Users.Domain/Entities/User.cs - Users database
Services/Users/Users.Infrastructure/Data/UsersDbContext.cs
Events service
- Events API
Services/Events/Events.Api/Controllers/EventsController.cs - Event operations
Services/Events/Events.Application/Services/EventService.cs - Event and seats
Services/Events/Events.Domain/Entities/Event.cs - Events database
Services/Events/Events.Infrastructure/Data/EventsDbContext.cs - Event cache
Services/Events/Events.Infrastructure/Caching/RedisCacheService.cs - Booking event consumer
Services/Events/Events.Infrastructure/Messaging/KafkaConsumerBackgroundService.cs
Bookings service
- Bookings API
Services/Bookings/Bookings.Api/Controllers/BookingsController.cs - Booking commands and queries
Services/Bookings/Bookings.Application/Commands/CreateBookingCommand.cs - Booking status
Services/Bookings/Bookings.Domain/Entities/Booking.cs - Bookings database
Services/Bookings/Bookings.Infrastructure/Data/BookingsDbContext.cs - Outbox dispatcher
Services/Bookings/Bookings.Infrastructure/Messaging/OutboxBackgroundWorker.cs
Other components
- Web user
- Kafka broker
- Users PostgreSQL
- Events PostgreSQL
- Redis
- Bookings PostgreSQL
Connections 32
- Web user → React SPA: uses
- React SPA → Auth UI and API: renders
- React SPA → Events UI and API: renders
- React SPA → Bookings UI and API: renders
- Auth UI and API → Session state: updates
- Auth UI and API → Reverse proxy: calls auth
- Events UI and API → Reverse proxy: calls events
- Bookings UI and API → Reverse proxy: calls bookings
- Reverse proxy → Cookie transform: applies
Gateway/Gateway.Api/Extensions/ServiceCollectionExtensions.cs - Reverse proxy → Auth and profile API: proxies auth
- Reverse proxy → Events API: proxies events
- Reverse proxy → Bookings API: proxies bookings
- Reverse proxy → API documentation: serves docs
Gateway/Gateway.Api/Extensions/ServiceCollectionExtensions.cs - Auth and profile API → User application: calls
Services/Users/Users.Api/Controllers/AuthController.cs - Auth and profile API → Session cookies: sets cookies
Services/Users/Users.Api/Controllers/AuthController.cs - User application → User and tokens: manages
- User application → Users database: persists
- Users database → Users PostgreSQL: stores
- Events API → Event operations: calls
Services/Events/Events.Api/Controllers/EventsController.cs - Event operations → Event and seats: manages
- Event operations → Events database: persists
- Event operations → Event cache: caches events
- Events database → Events PostgreSQL: stores
- Event cache → Redis: reads and writes
- Bookings API → Booking commands and queries: dispatches
Services/Bookings/Bookings.Api/Controllers/BookingsController.cs - Booking commands and queries → Booking status: creates booking
Services/Bookings/Bookings.Application/Commands/CreateBookingCommand.cs - Booking commands and queries → Bookings database: persists
- Bookings database → Bookings PostgreSQL: stores
- Bookings database → Outbox dispatcher: feeds outbox
- Outbox dispatcher → Kafka broker: publishes events
- Kafka broker → Booking event consumer: delivers events
- Booking event consumer → Events database: reserves seats