Build production-grade permit & inspection automation.
A field-tested playbook for modernizing municipal permitting — covering ingestion pipelines, code taxonomies, zoning validation, inspector scheduling, and compliance reporting. Written for Python automation builders who ship software that holds up to public records audits.
What this site is
Municipal permitting sits at the intersection of statutory compliance, public service delivery, and aging legacy infrastructure. This hub collects the operational patterns we keep reaching for when we replace paper workflows with auditable, event-driven software.
Every reference page focuses on one production concern — a JSON schema, an OCR step, a retry strategy, a cache-warming routine — and shows where it fits in the broader pipeline. Cross-links connect architecture, ingestion, scheduling, and compliance so you can move from a single fix to a system view without losing context.
The audience is the team actually shipping the code: gov tech engineers, municipal clerks adopting Python tooling, automation builders, and compliance officers who own the audit trail. The tone is deliberately practical — checklists, schemas, retry budgets, and the kind of detail you need when a build inspector is waiting on Monday morning.
Below: the two top-level tracks the site covers, plus the cross-cutting capabilities they support.
Pick a track
Two top-level pillars. Each one expands into deep references on specific production concerns.
Core Architecture & Code Taxonomy
Foundations for modular, event-driven permit platforms — schema enforcement, taxonomy versioning, GIS-aware zoning, role-based clerk access, and resilient fallback routing.
Explore the architectureAutomated Permit Ingestion & Parsing
Production patterns for ingesting permit data from portals, PDFs, and legacy CSVs — async batch processing, OCR, retries, cache warming, and structured logging.
Dive into ingestion pipelinesWhat you’ll find inside
Every reference page is tuned for the same operational concerns.
Schemas & contracts
JSON schemas, validation strategies, and code taxonomies that survive annual ordinance updates.
Ingestion pipelines
Async batch processing, OCR for scanned PDFs, web scraping, and CSV reconciliation.
Compliance & audit
Role-based clerk portals, structured logging, retention rules, and chain-of-custody hashing.
Spatial & GIS
Zoning overlays, parcel ID linkage, and GeoJSON validation embedded directly into permit payloads.
Resilience
Circuit breakers, fallback routing, idempotent upserts, and recovery from legacy system outages.
Throughput
Cache warming, Celery queue tuning, and scheduling patterns aligned with municipal filing windows.
Recent references
A sampling of the deeper pages in each track. Browse a section to see the full catalogue.