Chicago Roofing Signal

Real-time public safety data signals for roof, shingle, and gutter building violations across Chicago. Engineered with zero-LLM deterministic classification, SODA API ingestion, and continuous health gates.

What We Monitor Roof, shingle, parapet & gutter violations

How Many Signals 76 OPEN signals (14-day sample window)

Why It Matters Automated safety telemetry & immediate health verification

OPEN Signals

14-Day Sample Window

22u3-xenr

Socrata Dataset

City of Chicago Open Data

100%

Deterministic

Code-First Classifier (No LLM)

06:00 CT

Daily Schedule

Automated Health Gate

Data Feed Telemetry View Live Feed →

Access real-time OPEN roof-family violations (roof repair, parapet, coping, chimney capping, gutters, downspouts, shingle overrides).

Filtered by whitelist in classifier_rules.json
Displays top 50 active signals in clean data-terminal layout
14-day lookback default sample window

sample.json sample.csv

System Health Gate View Health Status →

Continuous automated verification of the City Socrata API data provider prior to publishing feeds.

Health gate blocks daily feed publish on API error or staleness (> 48h)
Verifies required schema columns & 7-day OPEN count
Machine-readable telemetry output for uptime tracking

status.json

Architecture & Classification Specification

Data Source	City of Chicago Building Violations (22u3-xenr). Official SODA API endpoints only. No scraping.
Classifier	Rule-based lookup via `classifier_rules.json` + `SHINGLE` description override. Zero per-row LLM latency/cost.
Deduplication & Keys	Primary key: `id` for idempotent upsert. Composite key: `(inspection_number, violation_code, address)` for lifecycle tracking.
Ops & Scheduling	Daily job runs at 06:00 America/Chicago. Health gate aborts feed update if health checks fail.
Monetization & Billing	Free public sample site hosted on Cloudflare Pages. Billing integrations stubbed at /billing/.