LifeRide is a cutting-edge emergency medical transportation platform connecting patients with ambulances in real-time.
Explore the API »
Quick Start
·
Features
·
Report Bug
·
Request Feature
·
Devlogs
|
LifeRide is revolutionizing emergency medical transportation by leveraging modern technology to save lives. Our platform seamlessly connects patients with the nearest available ambulances through an intuitive interface, providing real-time tracking, transparent pricing, and reliable service when it matters most.
|
- Team
- Project Overview
- Live Demo
- Key Features
- System Architecture
- Database Design
- API Documentation
- Tech Stack
- Development Logs
- Getting Started
- Development Guidelines
- Testing
- Resources
- Contributing
- License
| Role | Name | GitHub |
|---|---|---|
| Team Leader | Imdad Rakib |  |
| Developer | SA-K1B | |
| Developer | IAmAreza | |
- Shakil Shahan -
LifeRide is a comprehensive web-based platform designed to revolutionize emergency medical transportation by connecting users with nearby ambulance drivers in real-time. The system leverages Google Maps API integration and real-time notifications to provide a seamless experience during medical emergencies when every second counts.
- Reduce ambulance response time in emergencies
- Provide transparent pricing and ETA information
- Create a reliable platform for medical transport
- Enable real-time tracking and communication
Experience LifeRide in action by visiting our live demo:
| Role | Password | |
|---|---|---|
| Driver | reza123@gmail.com | 123456 |
| User | imdadraqib@gmail.com | 123456 |
Explore the platform's features and see how it simplifies emergency medical transportation in real-time.
- Intuitive Profile Management: Create and manage your personal profile
- Location-Based Services: View nearby available ambulances on a map
- Route Planning: Add precise start and end locations for your journey
- Transparent Information: View ETA and approximate price before booking
- Seamless Booking: Request an ambulance with a single click
- Quality Control: Rate drivers and provide feedback after service completion
- Professional Profiles: Create and manage driver profiles with vehicle details
- Availability Management: Toggle availability status to control incoming requests
- Request Handling: Accept or reject ride requests based on availability
- Trip Control: Start, track, and end rides through an intuitive interface
- Payment System: Manage payments and view earnings history
Our platform uses a microservices architecture with the following key components:
| Service | Description |
|---|---|
| Location Service | Tracks and manages real-time driver locations |
| Ambulance Finder Service | Identifies available ambulances within proximity |
| Auth Service | Handles user authentication and token validation |
| Trip Service | Manages trip creation, updates, and completion |
| WebSocket Service | Facilitates real-time communication between users and drivers |
-
User Request Initiation 📱
- User specifies start and end locations through the app interface
-
Proximity-Based Ambulance Search 🔍
- The Ambulance Finder Service locates available drivers within a 2km radius
-
Driver Notification System 📣
- Available drivers receive notifications and can accept or decline
-
Trip Commencement 🚦
- Upon acceptance, real-time tracking is activated via Google Maps API
-
Real-Time Updates 📊
- Users receive continuous updates on driver location, ETA, and trip status
-
Service Completion and Feedback 💯
- Post-trip payment processing and driver rating system activation
The ER diagram illustrates our relational database structure, showing the relationships between users, drivers, trips, and other key entities.
All of our services are deployed on Render. We maintained standard CI/CD flow for deployment
We maintain comprehensive API documentation to facilitate integration and development.
- FastAPI: High-performance Python framework for building APIs
- Go: Used for performance-critical microservices
- WebSockets: For real-time bidirectional communication
- React: JavaScript library for building user interfaces
- Redux: State management for the application
- Google Maps API: For mapping, routing, and location services
- PostgreSQL: Relational database for storing application data
- Nginx: Load balancer for distributing traffic
- Docker: Containerization for consistent development and deployment
- CI/CD: Automated testing and deployment pipelines
Stay updated with our progress and insights by visiting our development logs:
Follow these steps to set up the development environment:
# Clone the repository
git clone https://github.com/your-organization/liferide.git
# Navigate to project directory
cd liferide
# Install dependencies
# For frontend
cd frontend && docker compose up --build frontend
# For backend services
# Follow instructions in respective service directoriesThis project is structured as a monorepo containing multiple microservices. For detailed setup instructions:
- Navigate to the specific service directory
- Follow the README instructions within each service folder
- Adhere to the coding standards and contribution guidelines
We enforce rigorous testing standards for all components:
# Create coverage reports directory
mkdir -p <service-name>/coverage-reports
# Run tests using Docker
cd <service-name>
docker compose -f docker-compose.dev.yml up --build <service-name>-test
# Example for auth service
cd auth-service
docker compose -f docker-compose.dev.yml up --build auth-service-testWe welcome contributions from the community! Please review our Contributing Guidelines before submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by the LifeRide Team