Skip to content

euangt/bin-collection-api

Repository files navigation

🗑️ National Bin Collection API (Laravel-Python Bridge)

🎯 Project Vision

A high-performance, stateless API that provides UK bin collection schedules. It acts as a lightweight wrapper around the uk-bin-collection Python library, using Laravel as the orchestration layer and Redis for aggressive caching to prevent council website rate-limiting.


🏗️ System Architecture

  • Host OS: Windows 11 (WSL2 Ubuntu 24.04)
  • Docker Strategy: Native Linux Docker Engine (No Docker Desktop)
  • Backend: Laravel 11/12 (PHP 8.4)
  • Infrastructure: Laravel Sail (MySQL, Redis)
  • Scraper Logic: Python 3.12 + uk-bin-collection library
  • Data Flow: Request -> Laravel API -> Redis Cache Check -> (If Miss) Python Bridge -> Redis Store -> JSON Response

About

Find out when your bins are being collected

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors