Ride-sharing coordination API for SA townships and rural areas. Drivers post routes, passengers book seats.
- Java 21 + Spring Boot 3
- PostgreSQL + PostGIS
- JWT Authentication
- JUnit 5 + Mockito
- Java 21+
- Maven
- PostgreSQL (or Docker)
docker run --name pg -e POSTGRES_PASSWORD=*** -p 5432:5432 -d postgres:16
docker exec -it pg psql -U postgres -c "CREATE DATABASE khwela_db;"mvn spring-boot:run| Method | Endpoint | Description |
|---|---|---|
| POST | /api/auth/register | Register user |
| POST | /api/auth/login | Login (returns JWT) |
| GET | /api/routes | List routes |
| POST | /api/routes | Create route |
| GET | /api/routes/{id} | Route details |
| POST | /api/routes/{id}/book | Book a seat |
| GET | /api/bookings | My bookings |
In development.