How cs455-carpooling/campus_ridepooling_automation works
Campus Ride-Pooling is a Next.js application for IIT Kanpur students to offer rides, request seats, coordinate trips, split fares, and manage post-trip feedback and safety reports. The main journey runs from account/profile setup through ride creation and matching, owner approval, trip coordination, and settlement tracking; payment itself stays external. Operations staff administer configuration, incidents, complaints, and enforcement. AI offers recommendations and chatbot assistance, with advisory complaint analysis. README-level workflow statements support the broad domain links; source excerpts specifically show chatbot request dispatch and realtime server wiring, while unsampled modules are represented at their exact tree paths.
Main entry points: rides Ride APIs · route.ts Chatbot endpoint · app Account and profile UI · trip.ts Trip coordination
Components 27
Accounts and access
- Account and profile UI
apps/web/src/app - Account APIs
apps/web/src/app/api/auth - Authentication
apps/web/src/lib/auth.ts - Profiles
apps/web/src/lib/profile-data.ts
Ride pooling
- Ride workflows
apps/web/src/app/(app)/rides - Ride APIs
apps/web/src/app/api/rides - Ride search
apps/web/src/lib/ride-search.ts - Ride options
apps/web/src/lib/ride-options.ts - Seat requests
apps/web/src/lib/join-requests.ts
Trip and safety
- Trip coordination
apps/web/src/lib/trip.ts - Fare settlement
apps/web/src/lib/payment-settlement.ts - Ratings and complaints
apps/web/src/lib/complaints.ts - Live coordination
apps/web/server.mjs
AI assistance
- Ride recommendations
apps/web/src/lib/ai/recommendation-pipeline.ts - Chatbot endpoint
apps/web/src/app/api/chatbot/route.ts - Chatbot assistant
apps/web/src/lib/ai/chatbot.ts - Gemini interpretation
apps/web/src/lib/ai/chatbot-gemini.ts - Chatbot audit
apps/web/src/lib/ai/chatbot-audit.ts
Operations
- Admin console
apps/web/src/app/admin - Administration APIs
apps/web/src/app/api/admin - Admin operations
apps/web/src/lib/admin-actions.ts
Other components
- Student
- Administrator
- Web application
apps/web/src/app - Socket.IO
- PostgreSQL
- Gemini API
Connections 30
- Student → Web application: uses
README.md - Administrator → Web application: uses
README.md - Web application → Account and profile UI: routes to
README.md - Account and profile UI → Account APIs: submits credentials
README.md - Account APIs → Authentication: authenticates
- Authentication → PostgreSQL: reads and writes
- Account and profile UI → Profiles: manages profile
README.md - Student → Ride workflows: offers or finds
README.md - Ride workflows → Ride APIs: submits ride actions
README.md - Ride APIs → Ride search: searches rides
- Ride APIs → Ride options: loads options
- Ride APIs → Seat requests: manages requests
README.md - Seat requests → Ride APIs: returns request state
README.md - Ride APIs → Trip coordination: advances trip
README.md - Trip coordination → Fare settlement: records shares
README.md - Trip coordination → Ratings and complaints: enables feedback
README.md - Student → Live coordination: coordinates live
README.md - Live coordination → Socket.IO: hosts
apps/web/server.mjs - Student → Ride recommendations: requests suggestions
README.md - Ride recommendations → Ride search: searches candidates
apps/web/src/lib/ai/recommendation-pipeline.ts - Student → Chatbot endpoint: sends query
README.md - Chatbot endpoint → Chatbot assistant: processes message
apps/web/src/app/api/chatbot/route.ts - Chatbot endpoint → Ride options: loads options
apps/web/src/app/api/chatbot/route.ts - Chatbot assistant → Gemini interpretation: interprets request
apps/web/src/lib/ai/chatbot.ts - Gemini interpretation → Gemini API: calls model
- Chatbot endpoint → Chatbot audit: logs requests
apps/web/src/app/api/chatbot/route.ts - Administrator → Admin console: reviews operations
README.md - Admin console → Administration APIs: submits decisions
README.md - Administration APIs → Admin operations: applies controls
- Admin operations → PostgreSQL: audits changes