How johnedwardabearneza/bpm_court_scanner works
BPM Court Scanner is a local desktop application for finding, classifying, and downloading appellate briefs from New York and Kentucky court systems, with Excel tracking and reports. The main user path starts in the desktop interface, proceeds through jurisdiction-specific scanning and classification, then presents hits and saved reports. The graph also includes NY scan orchestration and shared runtime configuration. Some modules are represented from the SOURCE INDEX or README rather than inspected source; uncertain links are omitted or marked unverified.
Main entry points: gui.py Desktop GUI · main.py NY scan orchestration · gui_ky.py KY interface · gui_worker.py NY scan worker
Components 20
Desktop interface
- Desktop GUI
gui.py - NY hit list
gui_hits.py - KY interface
gui_ky.py
New York scanning
- NY scan worker
gui_worker.py - NY scan orchestration
main.py - NYSCEF browser
nyscef_browser.py - Motion PDF parser
pdf_parser.py
Kentucky scanning
- KY docket scanner
ky_scanner.py - KY Excel tracker
ky_xlsx.py
Results and records
- Brief classifier
classifier.py - Hit reports
report_builder.py - Monthly reports
monthly_report.py - Dashboard server
dashboard_server.py
Shared runtime
- Data reset
clear_manager.py - Runtime configuration
config.py - Remote access guard
remote_guard.py - Update checker
updater.py
Other components
- Legal researcher
- NY court portals
- Kentucky court systems
Connections 26
- Legal researcher → Desktop GUI: uses
README.md - Desktop GUI → NY scan worker: starts scans
gui.py - Desktop GUI → NY hit list: opens hits
gui.py - Desktop GUI → KY interface: opens Kentucky
gui.py - Desktop GUI → Data reset: resets data
gui.py - Desktop GUI → Update checker: checks updates
gui.py - Desktop GUI → Remote access guard: checks access
gui.py - NY scan worker → NY scan orchestration: runs scans
gui_worker.py - NY scan worker → NYSCEF browser: opens session
gui_worker.py - NY scan orchestration → NYSCEF browser: checks cases
main.py - NYSCEF browser → NY court portals: browses and downloads
README.md - NY scan orchestration → Motion PDF parser: parses motion lists
main.py - NY scan orchestration → Brief classifier: classifies filings
main.py - NY scan orchestration → Hit reports: saves checkpoints
main.py - NY hit list → Hit reports: displays hit data
gui_hits.py - Desktop GUI → Monthly reports: shows monthly results
gui.py - KY interface → KY docket scanner: synchronizes dockets
gui_ky.py - KY docket scanner → Kentucky court systems: fetches docket data
README.md - KY interface → KY Excel tracker: updates tracker
gui_ky.py - Legal researcher → Dashboard server: views reports
- Dashboard server → KY docket scanner: uses scanner
dashboard_server.py - Dashboard server → Hit reports: uses report data
dashboard_server.py - Desktop GUI → Runtime configuration: uses settings
gui.py - NY scan worker → Runtime configuration: uses scan settings
gui_worker.py - KY interface → Runtime configuration: uses settings
gui_ky.py - Data reset → Runtime configuration: uses data paths
clear_manager.py