How kvreddy9120/50-microservices-project works
RailShack is an IRCTC-style train-booking platform split across 50 microservices. The principal journey is browser access through the frontend and API gateway to train search, booking, payment, and ticket results; the README also documents accounts, trip history, cancellation/refunds, live status, and ancillary travel services. The graph preserves major product capabilities, but the supplied excerpts do not expose most service-to-service booking calls, so those links are intentionally omitted. Shared runtime kits and data infrastructure are shown at the documented level.
Main entry points: api-gateway/main.go API gateway · booking/main.go Ticket booking · auth/main.go Authentication · index.js Cancellation
Components 34
User entry
- Web frontend
services/frontend/index.js - API gateway
services/api-gateway/main.go
Rail journey
- Train search
services/search/main.go - Train details
services/trains/main.go - Routes
services/routes/main.go - Stations
services/stations/main.go - Schedules
services/schedules/Main.java - Fare quotes
services/fares/Main.java - Seat availability
services/seat-map/main.go - Ticket booking
services/booking/main.go - PNR status
services/pnr/main.go - Live train status
services/live-status/main.go - E-ticket rendering
services/ticket-pdf/app.py
Accounts and finance
- Authentication
services/auth/main.go - User profile
services/user-profile/index.js - Booking history
services/booking-history/index.js - Cancellation
services/cancellation/index.js - Refunds
services/refunds/main.go - Payment gateway
services/payment-gateway/main.go - Wallet
services/wallet/main.go - UPI payments
services/upi/index.js - Tax invoices
services/invoices/Main.java
Travel services
- Food ordering
services/food-ordering/index.js - Retiring rooms
services/retiring-rooms/app.py - Cab booking
services/cab-booking/main.go - Holiday packages
services/tourism/index.js - Identity verification
services/kyc/app.py
Runtime and data
- Go runtime kit
libs/gokit/kit.go - Java runtime kit
libs/javakit/Kit.java - Python runtime kit
libs/pykit/railkit.py - Node runtime kit
libs/nodekit/railshack-kit/index.js - PostgreSQL
- Redis cache
Other components
- Traveler
Connections 15
- Traveler → Web frontend: uses
README.md - Web frontend → API gateway: sends API calls
README.md - API gateway → Train search: routes requests
README.md - API gateway → Ticket booking: routes requests
README.md - API gateway → Authentication: routes requests
README.md - API gateway → Booking history: routes requests
README.md - API gateway → Cancellation: routes requests
README.md - Ticket booking → Authentication: checks identity
README.md - Booking history → Authentication: checks identity
README.md - Cancellation → Authentication: checks identity
README.md - Train search → Fare quotes
- Ticket booking → E-ticket rendering
- Ticket booking → Payment gateway
- Cancellation → Refunds
- PostgreSQL → Redis cache: cached by
README.md