Skip to content

Pelino-Courses/module-1-safeboda-phase-1-City-TYCOON

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

SafeBoda Rwanda

Project Description

SafeBoda Rwanda is a web-based platform designed to improve urban mobility in Kigali, Rwanda by digitizing the moto-taxi (moto) transportation system. The system aims to address issues of safety, trust, and convenience for both riders and drivers, providing a structured and reliable service.

Problem Statement

Moto-taxis (motos) are an essential part of Kigali’s transportation system, known for affordability and speed. However, challenges exist:

  • Lack of verified driver credentials
  • Inconsistent pricing and fare disputes
  • Limited safety and trip tracking
  • No digital reputation system for drivers
  • Difficulty for trusted drivers to access financial services

Vision

SafeBoda Rwanda seeks to digitize and formalize the moto-taxi ecosystem, creating a safer and more transparent transportation experience that empowers both riders and drivers.


User Roles

1. Rider (Passenger)

  • Needs a safe, reliable, and fairly priced ride.
  • Should be able to request rides, track trips in real-time, and view driver profiles.

2. Driver

  • Needs a platform to prove their credibility through verified profiles.
  • Should receive trip requests, manage completed trips, and build a rating-based reputation.

Core Features & User Stories

1. User Authentication

  • Rider: “As a rider, I want to create an account using my name and phone number so that I can book safe and reliable rides.”
  • Driver: “As a driver, I want to register with my license and moto details so I can be verified and access more customers.”

2. Ride Request

  • Rider: “As a rider, I want to request a ride from my current location to a destination so that I can move easily within Kigali.”
  • Driver: “As a driver, I want to receive ride requests nearby so that I can increase my earnings.”

3. Real-Time Map View

  • Rider: “As a rider, I want to see available drivers near me on a map so that I can choose the closest option.”
  • Driver: “As a driver, I want to view rider pickup locations on a map so that I can navigate efficiently.”

4. Trip History

  • Rider: “As a rider, I want to see my past rides so that I can track my travel expenses.”
  • Driver: “As a driver, I want to view completed trips so I can analyze my work history.”

5. Driver Ratings

  • Rider: “As a rider, I want to rate my driver after each trip so that I can help improve service quality.”
  • Driver: “As a driver, I want to maintain a good rating so that I can attract more customers.”

Architecture Diagram

Below is a simple system architecture for SafeBoda Rwanda:

flowchart TD
    A[Frontend - React] -->|HTTP/REST API| B[Backend - Django]
    B --> C[(Database - PostgreSQL)]
    B --> D[Authentication Service]
    B --> E[Trip Management Service]
    A --> F[Map API Integration]
    
    classDef client fill:#f9f,stroke:#333,stroke-width:1px;
    classDef server fill:#bbf,stroke:#333,stroke-width:1px;
    classDef db fill:#bfb,stroke:#333,stroke-width:1px;

    class A client;
    class B,D,E server;
    class C db;
Loading

Explanation

  • Frontend (React): The client-side interface where users (riders and drivers) interact with the system.
  • Backend (Django): Handles business logic, authentication, and database operations.
  • Database (PostgreSQL): Stores user profiles, ride data, and transaction history.
  • Map API: Integrates location services for real-time ride tracking and map display.

Technology Stack

Layer Technology
Frontend React
Backend Django REST Framework
Database PostgreSQL
Version Control Git & GitHub
Deployment (Future) Docker / Cloud Provider

Getting Started

1. Clone the Repository

git clone <your-repo-url>
cd module-1-safeboda-phase-1-City-TYCOON

2. Run the Backend (Django)

python manage.py runserver

3. Run the Frontend (React)

npm start

Contributors

  • Guillain KALISA – Developer
  • Pelin – Instructor / Reviewer

License

This project is for educational purposes under the College of Science and Technology, Rwanda by instructor pelin. All rights reserved © 2025.

About

module-1-safeboda-phase-1-City-TYCOON created by GitHub Classroom

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published