How farhan-labib-afk/roadeo-web-app works
Roadeo is a peer-to-peer car-rental marketplace. Renters search inventory using trip and cargo filters, inspect a car, and request a booking; owners manage listings and booking approvals, then both parties can message and review. Admins handle moderation and account controls. The frontend routes role-based workspaces and calls backend API capabilities; backend services use PostgreSQL. Cargo interpretation can use optional LLM configuration, and student verification/email are additional backend capabilities. Edges between unsampled route handlers and services are omitted or marked unverified; subsystem coverage follows the tree and README rather than implying every implementation call was inspected.
Main entry points: routes Marketplace routes · database.ts Database client · App.tsx Web application · CarSearch.tsx Search and car details
Components 23
Frontend experience
- Web application
roadeo/frontend/src/app/App.tsx - Role workspaces
roadeo/frontend/src/app/routes.tsx - Search and car details
roadeo/frontend/src/app/pages/CarSearch.tsx - Cargo assistant
roadeo/frontend/src/app/components/CargoAssistantField.tsx - API client services
roadeo/frontend/src/app/services - Authentication state
roadeo/frontend/src/app/context/AuthContext.tsx
Backend API
- HTTP application
roadeo/backend/src/app.ts - Authentication routes
roadeo/backend/src/routes/auth.ts - Marketplace routes
roadeo/backend/src/routes
Marketplace services
- Identity and access
roadeo/backend/src/services/auth.service.ts - Inventory and listings
roadeo/backend/src/services/inventory.service.ts - Car management
roadeo/backend/src/services/car.service.ts - Cargo fit and estimates
roadeo/backend/src/services/cargoFit.service.ts - Booking lifecycle
roadeo/backend/src/services/booking.service.ts - In-app messaging
roadeo/backend/src/services/message.service.ts - Ratings and reviews
roadeo/backend/src/services/review.service.ts - Trust and moderation
roadeo/backend/src/services/admin.service.ts - Student verification
roadeo/backend/src/services/student.service.ts
Persistence and integrations
- Database client
roadeo/backend/src/config/database.ts - Marketplace schema
roadeo/backend/src/db/schema.ts - PostgreSQL
Other components
- Renter, owner, admin
- LLM provider
Connections 28
- Renter, owner, admin → Web application: use
README.md - Web application → Role workspaces: renders
roadeo/frontend/src/app/App.tsx - Role workspaces → Search and car details: routes to
roadeo/frontend/src/app/routes.tsx - Search and car details → Cargo assistant: offers cargo filters
roadeo/frontend/src/app/pages/CarSearch.tsx - Search and car details → API client services: uses
roadeo/frontend/src/app/pages/CarSearch.tsx - Web application → Authentication state: provides auth state
roadeo/frontend/src/app/App.tsx - API client services → HTTP application: calls API
README.md - HTTP application → Authentication routes: mounts
roadeo/backend/src/app.ts - HTTP application → Marketplace routes: mounts
roadeo/backend/src/app.ts - Authentication routes → Identity and access: uses
roadeo/backend/src/routes/auth.ts - Marketplace routes → Inventory and listings: dispatches to
- Marketplace routes → Car management: dispatches to
roadeo/backend/src/routes/cars.ts - Marketplace routes → Booking lifecycle: dispatches to
- Marketplace routes → In-app messaging: dispatches to
- Marketplace routes → Ratings and reviews: dispatches to
roadeo/backend/src/routes/reviews.ts - Marketplace routes → Trust and moderation: dispatches to
- Marketplace routes → Student verification: dispatches to
- Inventory and listings → Cargo fit and estimates: uses cargo fit
roadeo/backend/src/services/inventory.service.ts - Car management → Cargo fit and estimates: uses cargo fit
roadeo/backend/src/services/car.service.ts - Identity and access → Database client: queries
roadeo/backend/src/services/auth.service.ts - Inventory and listings → Database client: queries
roadeo/backend/src/services/inventory.service.ts - Car management → Database client: queries
roadeo/backend/src/services/car.service.ts - Booking lifecycle → Database client: queries
- In-app messaging → Database client: queries
- Ratings and reviews → Database client: queries
roadeo/backend/src/services/review.service.ts - Trust and moderation → Database client: queries
roadeo/backend/src/services/admin.service.ts - Database client → PostgreSQL: connects
roadeo/backend/src/config/database.ts - LLM provider → Cargo fit and estimates: interprets needs