How hippomasakib1/tinchaka works
TinChaka is a Dhaka ride-pooling platform. Passengers authenticate and submit zoned, seat-counted requests; drivers declare availability, discover same-zone requests, and accept them into capacity-limited pools. Pool transitions update member rides, fares and audit/payment records, which both roles inspect in active-trip and history views. The graph shows the documented two-role journey and the sampled API ownership boundaries. Some web-to-API calls are indicated from the README’s workflow because UI excerpts do not expose those calls; unsampled implementation details are not inferred.
Main entry points: app.ts Express app · pool.service.ts Pool lifecycle engine · db.ts Prisma client · page.tsx Driver dashboard
Components 27
Web experience
- Passenger booking
tinchaka-web/app/passenger/RequestForm.tsx - Ride tracking history
tinchaka-web/app/passenger/ActiveRide.tsx - Driver dashboard
tinchaka-web/app/driver/page.tsx - Pending requests
tinchaka-web/app/driver/PendingList.tsx - Pool controls
tinchaka-web/app/driver/ActivePoolPanel.tsx - Driver history
tinchaka-web/app/driver/DriverHistory.tsx - API client
tinchaka-web/lib/api.ts - Web ride operations
tinchaka-web/lib/rides.ts - Driver API operations
tinchaka-web/lib/driver.ts
API request handling
- Express app
tinchaka-api/src/app.ts - Ride request controller
tinchaka-api/src/controllers/rideRequest.controller.ts - Pool controller
tinchaka-api/src/controllers/pool.controller.ts - Vehicle controller
tinchaka-api/src/controllers/vehicle.controller.ts - Ride routes
tinchaka-api/src/routes/rideRequest.routes.ts - Pool routes
tinchaka-api/src/routes/pool.routes.ts - Auth middleware
tinchaka-api/src/middleware/requireAuth.ts
Pooling domain
- Ride request service
tinchaka-api/src/services/rideRequest.service.ts - Pool lifecycle engine
tinchaka-api/src/services/pool.service.ts - Fare calculation
tinchaka-api/src/domain/fare.ts - State machine
tinchaka-api/src/domain/stateMachine.ts - Zone rules
tinchaka-api/src/domain/zones.ts - Vehicle service
tinchaka-api/src/services/vehicle.service.ts
Persistence and identity
- Authentication
tinchaka-api/src/services/auth.service.ts - Prisma client
tinchaka-api/src/config/db.ts - PostgreSQL data
Other components
- Passenger
- Driver
Connections 35
- Passenger → Passenger booking: books rides
README.md - Passenger booking → Web ride operations: submits requests
- Web ride operations → API client: calls API
tinchaka-web/lib/rides.ts - API client → Express app: sends HTTP
- Express app → Ride routes: mounts routes
tinchaka-api/src/app.ts - Ride routes → Auth middleware: authenticates
tinchaka-api/src/routes/rideRequest.routes.ts - Ride routes → Ride request controller: dispatches
tinchaka-api/src/routes/rideRequest.routes.ts - Ride request controller → Ride request service: invokes
tinchaka-api/src/controllers/rideRequest.controller.ts - Ride request service → Prisma client: reads and writes
tinchaka-api/src/services/rideRequest.service.ts - Prisma client → PostgreSQL data: persists
- Ride request service → Fare calculation: calculates fares
tinchaka-api/src/services/rideRequest.service.ts - Ride request service → Zone rules: checks zones
tinchaka-api/src/services/rideRequest.service.ts - Passenger → Ride tracking history: tracks trips
README.md - Driver → Driver dashboard: manages availability
README.md - Driver dashboard → Pending requests: renders
tinchaka-web/app/driver/page.tsx - Driver dashboard → Pool controls: renders
tinchaka-web/app/driver/page.tsx - Driver dashboard → Driver history: renders
tinchaka-web/app/driver/page.tsx - Pending requests → Driver API operations: loads requests
- Pool controls → Driver API operations: updates pool
- Driver API operations → API client: calls API
tinchaka-web/lib/driver.ts - Driver → Pool routes: accepts and advances
README.md - Express app → Pool routes: mounts routes
tinchaka-api/src/app.ts - Pool routes → Pool controller: dispatches
tinchaka-api/src/routes/pool.routes.ts - Pool controller → Pool lifecycle engine: invokes lifecycle
tinchaka-api/src/controllers/pool.controller.ts - Pool lifecycle engine → Prisma client: locks and updates
tinchaka-api/src/services/pool.service.ts - Pool lifecycle engine → Fare calculation: recomputes fares
tinchaka-api/src/services/pool.service.ts - Pool lifecycle engine → State machine: checks transitions
tinchaka-api/src/services/pool.service.ts - Pool lifecycle engine → Zone rules: checks pickup zone
tinchaka-api/src/services/pool.service.ts - Driver → Driver history: reviews trips
README.md - Express app → Authentication: serves auth routes
- Authentication → Prisma client: reads and writes users
tinchaka-api/src/services/auth.service.ts - Authentication → API client: issues token
- Express app → Vehicle controller: mounts vehicle routes
tinchaka-api/src/app.ts - Vehicle controller → Vehicle service: invokes
tinchaka-api/src/controllers/vehicle.controller.ts - Vehicle service → Prisma client: updates availability