How uzicodes/northern-paribahan works
Northern Paribahan is a Bangladesh intercity bus reservation and fleet-operations product. The passenger journey searches dated departures, selects seats, pays, then receives or downloads a ticket; separate flows cover accounts, profiles, and ticket verification. Administrators manage buses, routes, bookings, and revenue, while a daily cron maintains the documented 31-day schedule window. The graph includes core UI, API, persistence, scheduling, and ticket-generation layers. Evidence is limited to the README and indexed or excerpted files; unsampled integrations and connections are omitted where their invocation is not shown.
Main entry points: prisma.ts Prisma database · verifyTicket.ts Ticket verification · server.ts Server auth client · TimetableClient.tsx Departure search
Components 33
Passenger booking
- Passenger portal
src/app/page.tsx - Departure search
src/app/timetable/TimetableClient.tsx - Date utilities
src/lib/dateUtils.ts - Schedule search API
src/app/api/schedules/route.ts - Seat selection
src/components/SeatLayout.tsx - Seat booking API
src/app/api/buses/[id]/book/route.ts - Checkout
src/app/checkout/page.tsx - Payment initiation
src/app/api/payment/init/route.ts - Payment callback
src/app/api/payment/callback/route.ts - Ticket download
src/app/api/ticket/download/route.ts
Admin operations
- Admin dashboard
src/app/admin/page.tsx - Fleet dashboard
src/app/admin/buses/AdminBusesClient.tsx - Route dashboard
src/app/admin/routes/AdminRoutesClient.tsx - Admin queries
src/lib/admin-queries.ts
Schedule operations
- Schedule lookup
src/actions/getSchedules.ts - Daily schedule trigger
src/app/api/cron/generate-daily-schedules/route.ts - Schedule generator
src/lib/scheduleGenerator.ts
Identity and tickets
- Account endpoints
src/app/api/auth/register/route.ts - Session manager
src/components/SessionManager.tsx - Server auth client
src/utils/supabase/server.ts - Profile and bookings
src/app/api/user/profile/route.ts - Ticket verification
src/actions/verifyTicket.ts - PNR verification UI
src/components/ticket/PnrVerificationModal.tsx - Ticket data contract
src/types/ticket.ts
Data and delivery
- Ticket email service
src/lib/email/index.ts - Email template
src/lib/email/templates.ts - Ticket PDF renderer
src/lib/email/ticketPdf.ts - PDF theme
src/lib/email/pdfTheme.ts - Prisma database
src/lib/prisma.ts
Other components
- Payment provider
- Passenger
- External scheduler
- Administrator
Connections 33
- Passenger → Departure search: searches
- Departure search → Schedule search API: requests departures
- Schedule search API → Schedule lookup: delegates lookup
src/app/api/schedules/route.ts - Schedule search API → Date utilities: defaults date
src/app/api/schedules/route.ts - Departure search → Date utilities: uses date rules
src/app/timetable/TimetableClient.tsx - Passenger → Seat selection: selects seats
- Seat selection → Seat booking API: submits booking
- Seat booking API → Prisma database: writes booking
- Passenger → Checkout: checks out
- Checkout → Payment initiation: starts payment
- Payment initiation → Payment provider: initiates payment
- Payment provider → Payment callback: posts result
- Payment callback → Prisma database: confirms booking
src/app/api/payment/callback/route.ts - Payment callback → Ticket email service: sends confirmation
src/app/api/payment/callback/route.ts - Passenger → Ticket download: downloads ticket
- External scheduler → Daily schedule trigger: triggers daily
- Daily schedule trigger → Schedule generator: generates schedules
src/app/api/cron/generate-daily-schedules/route.ts - Schedule generator → Prisma database: inserts schedules
src/lib/scheduleGenerator.ts - Administrator → Admin dashboard: reviews operations
- Administrator → Fleet dashboard: manages fleet
- Administrator → Route dashboard: manages routes
- Admin queries → Prisma database: queries data
src/lib/admin-queries.ts - Session manager → Server auth client: refreshes session
- Account endpoints → Server auth client: authenticates
src/app/api/auth/register/route.ts - Profile and bookings → Server auth client: checks identity
src/app/api/user/profile/route.ts - Profile and bookings → Prisma database: reads profile
src/app/api/user/profile/route.ts - PNR verification UI → Ticket verification: requests verification
src/components/ticket/PnrVerificationModal.tsx - Ticket verification → Prisma database: loads booking
src/actions/verifyTicket.ts - Ticket verification → Server auth client: checks identity
src/actions/verifyTicket.ts - Ticket verification → Ticket data contract: returns ticket data
src/actions/verifyTicket.ts - Ticket email service → Ticket PDF renderer: generates attachment
src/lib/email/index.ts - Ticket email service → Email template: renders message
src/lib/email/index.ts - Ticket PDF renderer → PDF theme: uses theme
src/lib/email/ticketPdf.ts