Back to Blog
Case Study
Date
Read time7 min read

Automating Vendor Compliance: Building a Violations Tracking System

How we replaced a paper-based vendor compliance process with an automated violations tracking system featuring photo evidence, automatic fines, and compliance scoring.

AutomationComplianceProperty ManagementPython

Property management at a multi-vendor venue is a diplomatic balancing act. You need vendors to follow the rules — proper signage, clean stall areas, correct operating hours, health code compliance — but enforcing those rules consistently with paper processes is nearly impossible. When we started working with a venue managing 60+ vendor stalls, their violations process was a mess of handwritten notes, photographs saved to someone's phone camera roll, and inconsistent follow-through that bred resentment among vendors who felt the rules were applied unevenly.

The Pain Points: Why Paper Tracking Fails

The existing process worked like this: a property manager would walk the venue, spot a violation, take a photo on their personal phone, write a note on a clipboard, and later transcribe that note into a spreadsheet. Violation notices were printed and handed to vendors — sometimes days after the infraction. Fines were calculated manually, often inconsistently. When vendors disputed a violation, there was no reliable evidence trail. And management had no way to see patterns — was a particular vendor a repeat offender? Were violations concentrated in certain categories? Were the rules actually being enforced, or were managers just letting things slide?

The consequences were real. Vendors who followed the rules resented those who didn't. Health code issues went undocumented. And when lease renewals came around, management had no objective data to support their decisions. The entire process had a documentation rate of roughly 30% — meaning 70% of observed violations were never formally recorded.

The Solution: Capture, Calculate, Communicate

We built a three-layer system. The capture layer is a mobile-first web app that property managers use during their walkthroughs. They select the vendor, choose the violation category from a predefined list (health/safety, signage, cleanliness, operating hours, noise, unauthorized modifications), snap a photo with geolocation and timestamp embedded, add optional notes, and submit. The whole process takes under 30 seconds per violation.

The calculation layer automatically determines the fine based on a configurable rules engine. First offense for a minor violation might be a warning. Second offense triggers a $50 fine. Third offense within 90 days escalates to $150. Serious violations (health code, safety) carry immediate fines. The rules are stored in a configuration table, so management can adjust fine schedules without touching code. Each violation is automatically tagged with the offender's history, so the system knows this is their third cleanliness violation in the quarter and applies the correct escalation.

The communication layer generates and delivers violation notices automatically. Within minutes of a manager submitting a violation, the vendor receives an email with the violation details, photo evidence, the applicable fine, and instructions for appeal. The notice is also stored as a PDF in the vendor's file for lease review purposes. No more handwritten notes that get lost. No more week-long delays between observation and notification.

Compliance Scoring: The Game Changer

The feature that management didn't know they needed was the compliance score. Each vendor starts the quarter with a score of 100. Violations reduce the score based on severity: a minor infraction costs 5 points, a moderate infraction costs 15, and a serious infraction costs 30. Points are restored over time if no new violations occur (5 points per clean month). The score is visible to vendors through their portal, creating a transparent, gamified incentive to stay compliant.

Management uses the compliance score for lease renewal decisions — vendors below 60 get a warning letter, below 40 triggers a lease review meeting. This transformed what was a subjective, relationship-driven process into a data-driven one. Vendors couldn't claim unfair treatment when the score was calculated by the same formula for everyone, based on documented violations with photo evidence.

The Management Dashboard

We built a comprehensive reporting dashboard that gives management visibility into violation trends over time, the most common violation categories, repeat offenders, enforcement rates per property manager (so management can ensure their team is actually conducting walkthroughs), and revenue from fines. The dashboard revealed some surprising patterns — for instance, noise violations spiked on Thursdays (live music night), which led management to update their noise policy for event days rather than penalizing vendors for something outside their control.

Results and Impact

Within the first quarter, violation documentation rate went from approximately 30% to 100%. Every observed violation was now captured with photo evidence and a timestamp. Vendor disputes dropped by 85% because the evidence was indisputable. Average time from violation observation to vendor notification went from 3-5 days to under 10 minutes. And compliance scores became a core part of the lease renewal process, giving management a defensible, data-driven basis for their decisions.

Perhaps the most telling metric: within two months of deployment, the average venue compliance score rose from 72 to 91. When vendors know violations are being tracked consistently and transparently, behavior changes. The system didn't just document problems — it prevented them.