How paulinotech1/flock-off works
Flock-Off is a public tracker for Flock Safety ALPR contracts, renewals, costs, cancellations, and their sources. Its principal user workflow is to search and filter the agency dataset, inspect contract history and citations, and use the resulting renewal or cancellation information for civic research. Separate branches provide map, learning, and ecosystem tools, plus a quarantined tip-submission and human-review flow. The maintenance tooling validates source identity and evidence, monitors records, and archives source snapshots. Some subsystem links are based on README descriptions; unsampled implementation details are left unconnected.
Main entry points: flockoff.py Maintenance commands · source_fingerprints.py Source fingerprints · report.js Tip intake · promote.js Human review
Components 26
Public tracker
- Contract tracker
js/tracker.js - Agency contracts
data/agencies.json - Page navigation
js/app.js - Camera map
js/sources.js - Civic resources
index.html
Evidence research
- Evidence tiers
scripts/evidence.py - Source classification
scripts/classify_sources.py - Citation identity
scripts/source_keys.py - Source fingerprints
scripts/source_fingerprints.py - Snapshot archive
scripts/blob_archive.py - Archived source data
data/source_archive
Tip review
- Tip intake
api/report.js - Privacy signals
api/_signals.js - Pending queue
api/pending.js - Human review
api/promote.js - Approved history
api/history.js - API error codes
api/_errors.js
Maintenance tooling
- Weekly review
scripts/weekly_monitor.py - Maintenance commands
scripts/flockoff.py - Pipeline configuration
scripts/flockoff_config.py - Manifest signing
scripts/sign_manifest.py - Build evidence checks
scripts/vercel_build.py - Pipeline error codes
scripts/flockoff_errors.py
Other components
- Public visitor
- Map services
- Vercel Blob
Connections 32
- Public visitor → Page navigation: opens
README.md - Page navigation → Contract tracker: shows
README.md - Contract tracker → Agency contracts: reads
README.md - Public visitor → Camera map: opens
README.md - Camera map → Map services: fetches map data
README.md - Public visitor → Civic resources: uses
README.md - Maintenance commands → Citation identity: dispatches
scripts/flockoff.py - Maintenance commands → Source fingerprints: dispatches
scripts/flockoff.py - Maintenance commands → Source classification: dispatches
scripts/flockoff.py - Maintenance commands → Weekly review: dispatches
scripts/flockoff.py - Maintenance commands → Snapshot archive: retrieves snapshots
scripts/flockoff.py - Source fingerprints → Citation identity: uses
scripts/source_fingerprints.py - Source fingerprints → Snapshot archive: uses
scripts/source_fingerprints.py - Source classification → Pipeline configuration: loads settings
scripts/classify_sources.py - Citation identity → Pipeline configuration: loads settings
scripts/source_keys.py - Weekly review → Pipeline configuration: loads settings
scripts/weekly_monitor.py - Weekly review → Agency contracts: checks dataset
scripts/weekly_monitor.py - Build evidence checks → Evidence tiers: uses
scripts/vercel_build.py - Public visitor → Tip intake: submits tip
README.md - Tip intake → Privacy signals: computes signals
api/report.js - Tip intake → Vercel Blob: writes pending tip
api/report.js - Public visitor → Pending queue: requests queue
README.md - Pending queue → Vercel Blob: lists pending tips
README.md - Public visitor → Human review: reviews tip
README.md - Human review → Vercel Blob: moves reviewed tip
api/promote.js - Human review → Privacy signals: updates decisions
api/_signals.js - Public visitor → Approved history: views reports
README.md - Approved history → Vercel Blob: reads approved reports
README.md - Tip intake → API error codes: returns errors
api/report.js - Human review → API error codes: returns errors
api/promote.js - Maintenance commands → Manifest signing: dispatches
scripts/flockoff.py - Source fingerprints → Archived source data: archives snapshots