A production-focused engineering reference for Python automation in municipal waste routing, IoT telemetry sync, and regulatory compliance logging.

🌐 www.routeoptimization.org

Waste Route Optimization is a deep, hands-on reference for the people who own a municipal waste-dispatch pipeline: operations managers who answer to municipal contracts, logistics engineers who feed a solver, and Python developers who have to make the whole thing idempotent, memory-bounded, and audit-safe.

Every page carries a single idea from problem to running code: constraint model → prerequisites and data schema → step-by-step Python → verification → the exact compliance record it produces. Nothing here is a toy. The reference architectures treat determinism and constraint hardness as first-class engineering goals, so a route plan can never silently emit an illegal or unverifiable dispatch.

Heuristic, stochastic routing demos collapse the moment an auditor asks for a reproducible trace. The patterns here are built to survive real fleets, real audits, and real field conditions.

51 in-depth guides across four areas, each drilling from an architectural overview down to focused, runnable implementations:

• VRP Route Optimization Algorithms — constraint-hardened Vehicle Routing with Google OR-Tools: capacity and axle-weight envelopes, time windows, multi-depot assignment, distance-matrix backends (OR-Tools, OSRM, Valhalla), and telemetry-driven threshold tuning.
• Telematics & Sensor Data Ingestion — deterministic GPS, CAN, and IoT bin-sensor pipelines: adaptive polling, payload parsing, schema validation, Kalman GPS smoothing, and backpressure-aware async ingestion with cryptographic audit trails.
• Core Architecture & Compliance Mapping — route schema design and versioning, DOT/FMCSA rule mapping, RBAC for operations dashboards, HMAC-signed audit chains, and deterministic fallback state machines under degradation.
• Compliance Reporting & Automation — turning routing and telemetry output into filed, defensible regulatory artifacts: EPA e-Manifest submission, FMCSA ELD sync, DOT hours-of-service logging, and tamper-evident audit reports.

Every guide ships with complete, type-hinted Python (OR-Tools, Pydantic, asyncio), inline CFR and EPA citations, KaTeX formulas where the math matters, hand-authored inline SVG diagrams, and structured JSON-LD.

• ✅ Runnable code — pasteable Python 3.10+, pinned dependencies, and verification tests.
• ✅ Audit-grade by design — SHA-256 input hashes, append-only ledgers, and reproducible solves.
• ✅ Regulation-mapped — constraints tied to real CFR parts and EPA forms, not prose assertions.
• ✅ Accessible & fast — WCAG 2 AA, responsive theme-aware diagrams, and a mobile performance budget.
• ✅ Offline-capable PWA — installable, with a service worker and full icon set.

The reference is published at www.routeoptimization.org.

• Eleventy static site generator (Nunjucks + Markdown)
• markdown-it with anchors, attributes, task lists, and KaTeX math
• Hand-authored inline SVG diagrams; no diagram runtime shipped to the browser
• Deployed on Cloudflare Pages

npm install        # install dependencies
npm start          # serve locally with live reload
npm run build      # build the static site into _site/

The build reads Markdown from content/, templates and assets from src/, and writes the finished site to _site/.

content/   Markdown source for every guide (one folder per URL)
src/       Nunjucks layouts, data, styles, scripts, and PWA assets
_site/     Generated output (not committed)

© Waste Route Optimization. Content and code are provided as an engineering reference. Maintained by @waste-route-optimization.