How jruchsas/bharakoto works
BharaKoto is a Dhaka commuter web app for comparing realistic and official fares while accounting for route geometry and restricted roads. The main flow runs from the browser’s origin/destination and vehicle selections through fare estimation, which combines fare rules, route services, and active restriction data; the browser also supports place lookup, fare history, and community reports. A separate admin flow manages restricted zones. The README documents several integrations, but some endpoint implementations and UI wiring were not sampled, so those links rely on its architecture description.
Main entry points: index.php Fare map UI · database.php Database connection · places.php Places API · FareEstimatorService.php Fare and route engine
Components 21
Commuter experience
- Fare map UI
public/index.php - Nominatim geocoder
- Barikoi places
Public API
- Estimate API
public/api/estimate.php - Places API
public/api/places.php - Reverse geocoder API
public/api/reverse.php - Zones API
public/api/zones.php - Community fares API
public/api/crowdsourced.php - Fare history API
public/api/fare-history.php
Fare and routing
- Fare and route engine
src/FareEstimatorService.php - OSRM routing
- OpenRouteService
- Weather service
Zone management
- Zone admin UI
public/admin-zones.php - Official ban data
database/apply_official_dmp_bans.php
Data and safeguards
- Database connection
config/database.php - MySQL store
- Rate limiter
src/RateLimiter.php - CSRF protection
src/CsrfProtection.php - Dhaka place data
database/seed_expanded_nodes.php
Other components
- Commuter
Connections 27
- Commuter → Fare map UI: uses
README.md - Fare map UI → Estimate API: requests estimate
README.md - Fare map UI → Places API: searches places
README.md - Fare map UI → Reverse geocoder API: requests geocoding
README.md - Fare map UI → Zones API: loads zones
README.md - Fare map UI → Community fares API: submits fares
README.md - Fare map UI → Fare history API: loads history
README.md - Estimate API → Fare and route engine: calculates fare
public/api/estimate.php - Fare and route engine → Database connection: opens connection
src/FareEstimatorService.php - Places API → Database connection: opens connection
public/api/places.php - Reverse geocoder API → Database connection: opens connection
public/api/reverse.php - Zones API → Database connection: opens connection
public/api/zones.php - Community fares API → Database connection: opens connection
public/api/crowdsourced.php - Fare history API → Database connection: opens connection
public/api/fare-history.php - Database connection → MySQL store: connects
config/database.php - Zone admin UI → Zones API: manages zones
public/admin-zones.php - Estimate API → Rate limiter: enforces limits
public/api/estimate.php - Places API → Rate limiter: enforces limits
public/api/places.php - Zones API → CSRF protection: validates changes
public/api/zones.php - Community fares API → CSRF protection: validates submissions
public/api/crowdsourced.php - Fare and route engine → OSRM routing: requests routes
README.md - Fare and route engine → OpenRouteService: fallback routes
README.md - Fare and route engine → Weather service: checks conditions
README.md - Places API → Nominatim geocoder: geocodes fallback
README.md - Places API → Barikoi places: searches optionally
README.md - Dhaka place data → MySQL store: seeds places
database/seed_expanded_nodes.php - Official ban data → MySQL store: seeds restrictions
database/apply_official_dmp_bans.php