How mohamedsafin/rental-car works
This is a UAE car-rental platform with a customer booking site, a staff/admin operations dashboard, and an Express API that owns business rules. The customer journey is vehicle search, availability and server-side pricing, booking, payment, then rental handover and return; staff administer the fleet and manage the same lifecycle. The README also documents finance, documents, notifications, legal outputs, and reporting. Connections between sampled routes and services are evidenced by the source index; broader browser-to-API and database relationships follow the README. Some backend subsystems are documented but not sampled, so their internal links are omitted.
Main entry points: app.ts API Application · prisma.ts PostgreSQL Data · service.ts Booking Lifecycle · api.ts Admin API Client
Components 28
Customer Website
- Customer Pages
frontend/src/routes/AppRoutes.tsx - Customer API Client
frontend/src/services/api.ts
Staff Dashboard
- Admin Pages
admin/src/routes/AppRoutes.tsx - Admin API Client
admin/src/services/api.ts - Admin API Types
admin/src/types/api.ts
Rental Operations API
- API Application
backend/src/app.ts - Booking Lifecycle
backend/src/modules/bookings/service.ts - Vehicle Availability
backend/src/modules/availability/service.ts - Pricing Engine
backend/src/modules/pricing/calculator.ts - Fleet Operations
backend/src/modules/fleet/finesService.ts - Rental Lifecycle
backend/src/modules/rentals/routes.ts - Customer Profiles
backend/src/modules/customers/service.ts
Security and Platform
- Authentication
backend/src/middleware/authenticate.ts - Role Authorization
backend/src/middleware/authorize.ts - Request Validation
backend/src/middleware/validate.ts - Audit Trail
backend/src/modules/audit/service.ts - Runtime Config
backend/src/config/env.ts - Logging
backend/src/config/logger.ts - PostgreSQL Data
backend/src/config/prisma.ts - API Responses
backend/src/utils/apiResponse.ts - Async Route Handling
backend/src/utils/asyncHandler.ts - Private File Uploads
backend/src/middleware/upload.ts - Error Model
backend/src/utils/ApiError.ts
Finance and Outputs
- Payments and Deposits
backend/src/modules/payments/service.ts - Business Settings
backend/src/modules/settings/service.ts - Documents and Reports
backend/src/modules/invoices/service.ts
Other components
- Renter
- Staff
Connections 29
- Renter → Customer Pages: uses
README.md - Customer Pages → Customer API Client: requests through
- Customer API Client → API Application: calls API
README.md - Staff → Admin Pages: uses
README.md - Admin Pages → Admin API Client: requests through
- Admin API Client → Admin API Types: uses types
admin/src/services/api.ts - Admin API Client → API Application: calls API
README.md - API Application → Authentication: guards requests
README.md - API Application → Role Authorization: guards requests
README.md - Booking Lifecycle → Vehicle Availability: checks availability
README.md - Booking Lifecycle → Pricing Engine: computes price
README.md - Booking Lifecycle → PostgreSQL Data: persists bookings
README.md - Fleet Operations → PostgreSQL Data: reads and writes
- Rental Lifecycle → PostgreSQL Data: reads and writes
backend/src/modules/rentals/routes.ts - Rental Lifecycle → Booking Lifecycle: updates lifecycle
README.md - Customer Profiles → PostgreSQL Data: reads and writes
README.md - Payments and Deposits → PostgreSQL Data: records payments
backend/src/modules/payments/routes.ts - Payments and Deposits → Booking Lifecycle: confirms booking
README.md - Pricing Engine → Business Settings: uses settings
- Documents and Reports → PostgreSQL Data: reads records
README.md - API Application → Request Validation: validates inputs
README.md - API Application → API Responses: formats responses
README.md - API Application → Async Route Handling: wraps handlers
README.md - API Application → Error Model: handles failures
README.md - Audit Trail → PostgreSQL Data: writes audit log
backend/src/modules/audit/service.ts - Audit Trail → Logging: logs failures
backend/src/modules/audit/service.ts - PostgreSQL Data → Runtime Config: gets connection config
backend/src/config/prisma.ts - PostgreSQL Data → Logging: logs connection failures
backend/src/config/prisma.ts - API Application → Private File Uploads: accepts files
README.md