SpeedCam VisionGuard Intelligent Speed Enforcement & ANPR System

flowchart TD
    subgraph Radar_Acquisition ["Radar Beam & Velocity Detection"]
        Veh["🚗 Passing Vehicle (Multi-Lane Corridor)"] --> Radar["📡 24GHz K-Band Doppler Radar"]
        Lidar["🔦 905nm Pulsed Laser LIDAR Telemetry"] --> Radar
    end

    subgraph Speed_Math ["Velocity Math & Limit Check"]
        Radar --> MathEngine["🧮 Doppler Shift Frequency Math: v = (fd * c) / (2 * f0 * cos θ)"]
        MathEngine --> Compare{"Detected Speed > Posted Limit?"}
    end

    subgraph Trigger_Output ["Edge Camera Triggering"]
        Compare -- No --> Privacy["🛡️ Discard Telemetry (Maintain Driver Privacy)"]
        Compare -- Yes --> Trigger["📸 Dispatch High-Speed Pulse Trigger to Dual 4K Cameras"]
    end

    classDef radar fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef math fill:#1e1b4b,stroke:#818cf8,stroke-width:2px,color:#fff;
    classDef trig fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Veh,Radar,Lidar radar;
    class MathEngine,Compare math;
    class Privacy,Trigger trig;
                

flowchart TD
    subgraph Dual_Camera ["Dual 4K IR Image Acquisition"]
        Trig["⚡ Speed Trigger Signal"] --> IR_Flash["💡 850nm Infrared LED Strobe Illuminator"]
        IR_Flash --> CamFront["📸 Camera A: Front Vehicle License Plate View"]
        IR_Flash --> CamDriver["📸 Camera B: Windshield Driver Facial Snapshot"]
    end

    subgraph ANPR_OCR ["PyTorch & OpenCV Character Extraction"]
        CamFront --> BoundingBox["🎯 YOLOv8 License Plate Bounding Box Detection"]
        BoundingBox --> PlateCrop["✂️ Plate Image Normalization & OCR Text Extraction"]
        CamDriver --> DriverCrop["👤 Driver Face Detection & Privacy Watermarking"]
    end

    subgraph Package_Output ["Evidence Package"]
        PlateCrop --> Pkg["📦 Dual-Image Evidence Package (Plate + Driver)"]
        DriverCrop --> Pkg
    end

    classDef cap fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef ocr fill:#1e1b4b,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef pkg fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Trig,IR_Flash,CamFront,CamDriver cap;
    class BoundingBox,PlateCrop,DriverCrop ocr;
    class Pkg pkg;
                

flowchart TD
    subgraph Raw_Payload ["Raw Violation Payload Packaging"]
        PhotoPlate["📸 Raw Vehicle Plate Photo"] --> Pkg["📦 Package Evidence Object"]
        PhotoDriver["👤 Front Driver Face Photo"] --> Pkg
        Speed["⚡ Radar Velocity & GPS Coordinates"] --> Pkg
        Time["🕒 UTC Atomic Timestamp"] --> Pkg
    end

    subgraph Cryptographic_Engine ["SHA-256 Hash Generation"]
        Pkg --> HashEngine["🔒 SHA-256 Hash Digest Engine"]
        HashEngine --> DigitalSig["✍️ Hardware Security Module (HSM) Private Key Signature"]
    end

    subgraph Secure_Vault ["Tamper-Proof Storage"]
        DigitalSig --> EncryptedStore["🛡️ Immutable PostgreSQL Audit Vault"]
    end

    classDef payload fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef crypto fill:#1e1b4b,stroke:#a78bfa,stroke-width:2px,color:#fff;
    classDef vault fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class PhotoPlate,PhotoDriver,Speed,Time,Pkg payload;
    class HashEngine,DigitalSig crypto;
    class EncryptedStore vault;
                

flowchart TD
    subgraph ANPR_Result ["Extracted Plate Data"]
        Plate["🔤 License Plate String (e.g. 'ABC-1234')"]
    end

    subgraph API_Gateways ["Encrypted REST API Gateway Queries"]
        Plate --> DMV_Req["🌐 Query National DMV Registry"]
        Plate --> Ins_Req["🌐 Query Motor Insurance Bureau (MIB) Database"]
    end

    subgraph Verification_Results ["Registration & Insurance Validity Badges"]
        DMV_Req --> RegStatus["✅ Vehicle Registration: ACTIVE (Expires Nov 2026)"]
        Ins_Req --> InsStatus["✅ Insurance Policy: VALID (Allianz Policy #ALZ-882910)"]
        DMV_Req --> DriverRecord["👤 Driver Identity: Alexander Mercer (License #DL-99482)"]
    end

    classDef plate fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef api fill:#1e1b4b,stroke:#eab308,stroke-width:2px,color:#fff;
    classDef status fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Plate plate;
    class DMV_Req,Ins_Req api;
    class RegStatus,InsStatus,DriverRecord status;
                

flowchart TD
    subgraph Officer_Queue ["Police Review Queue"]
        Ticket["📄 Violation Record Routed to Queue"]
    end

    subgraph Workbench_Inspection ["Split-Screen Officer Verification"]
        Ticket --> Panel["🖥️ Inspection Workbench: Raw Photo vs Driver Face vs Insurance Status"]
        Panel --> Check["👮 Officer Inspects Plate, Driver Facial Match & Insurance Validity"]
    end

    subgraph Officer_Action ["Adjudication Decision"]
        Check --> Choice{"Officer Action"}
        Choice -- Reject / Mismatch --> Reject["❌ Mark INVALID & Archive"]
        Choice -- Manual Override --> FixText["✏️ Apply Manual Correction"]
        Choice -- Confirm Valid --> Endorse["✍️ Apply Digital Signature Endorsement"]
        FixText --> Endorse
    end

    classDef queue fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef inspect fill:#1e1b4b,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef act fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Ticket queue;
    class Panel,Check inspect;
    class Choice,Reject,FixText,Endorse act;
                

flowchart TD
    subgraph Approved_Record ["Endorsed Citation Input"]
        Endorsed["✍️ Officer Endorsed Record + Driver Details"]
    end

    subgraph PDF_Engine ["ReportLab & Barcode Generation Engine"]
        Endorsed --> PDF_Maker["📄 ReportLab Vector PDF Builder"]
        PDF_Maker --> Barcode["📊 Code-128 Notice Barcode Generator"]
        PDF_Maker --> MapQR["📍 Scannable QR Code -> Opens Google Maps Location (Lat: 51.5074, Lng: -0.1278)"]
    end

    subgraph Notice_Dispatch ["Multi-Channel Delivery"]
        PDF_Maker --> Postal["✉️ Postal Print Notice Letter (Front Driver Photo + Plate)"]
        PDF_Maker --> Digital["📱 Email & SMS Digital Notice Alert"]
    end

    classDef input fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef pdf fill:#1e1b4b,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef dispatch fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Endorsed input;
    class PDF_Maker,Barcode,MapQR pdf;
    class Postal,Digital dispatch;
                

flowchart TD
    subgraph Citizen_Login ["Public Driver Portal"]
        Citizen["🚗 Citizen Log In (Notice # + Plate)"] --> Portal["🔍 View Full Driver Details, Photos, Reg & Insurance Status"]
    end

    subgraph Payment_Options ["Multi-Payer Fine Gateway"]
        Portal --> PayMethod{"Select Payment Gateway"}
        PayMethod -- PayPal --> PayPalAPI["💙 Instant PayPal Checkout"]
        PayMethod -- Credit Card --> CardAPI["💳 Stripe / Visa / Mastercard"]
        PayMethod -- Bank Wire --> WireAPI["🏦 Pro-Forma Wire Transfer Invoice"]
    end

    subgraph Clearance_Output ["Penalty Settlement"]
        PayPalAPI --> Settled["✅ Clear Citation & Remove DMV Penalty Points"]
        CardAPI --> Settled
        WireAPI --> Settled
        Settled --> Receipt["🧾 Issue Downloadable Payment Clearance Certificate"]
    end

    classDef login fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef pay fill:#1e1b4b,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef clear fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Citizen,Portal login;
    class PayMethod,PayPalAPI,CardAPI,WireAPI pay;
    class Settled,Receipt clear;
                

flowchart TD
    subgraph Dispute_Submission ["Driver Dispute Filing"]
        Driver["🚗 Driver Files Formal Appeal"] --> Stepper["📝 Online Stepper: Attach Proof (Stolen Vehicle / Emergency Permit)"]
    end

    subgraph Appeals_Board ["Municipal Appeals Desk Review"]
        Stepper --> Board["⚖️ Traffic Appeals Magistrate Workbench"]
        Board --> CheckEvidence["🔍 Inspect SHA-256 Hash Integrity & Radar Calibration Certificate"]
    end

    subgraph Verdict_Output ["Appeals Decision"]
        CheckEvidence --> Verdict{"Appeals Board Decision"}
        Verdict -- Appeal Granted --> CancelTicket["🟢 Cancel Citation & Void Fine"]
        Verdict -- Appeal Dismissed --> Upheld["🔴 Uphold Fine & Route to Payment"]
    end

    classDef driver fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef board fill:#1e1b4b,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef verdict fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class Driver,Stepper driver;
    class Board,CheckEvidence board;
    class Verdict,CancelTicket,Upheld verdict;
                

flowchart TD
    subgraph Data_Stream ["Live Telemetry & Payment Streams"]
        RadarStream["📡 Real-Time Radar Velocity Stream"] --> Aggregator["⚡ Redis In-Memory Telemetry Aggregator"]
        PaymentStream["💳 Fine Settlement Stream"] --> Aggregator
    end

    subgraph Analytics_Engine ["SCADA Executive Analytics Engine"]
        Aggregator --> Heatmap["🔥 Highway Speeding Hotspot Heatmap Engine"]
        Aggregator --> RevenueReport["📊 Municipal Revenue & Fine Collection Reporting"]
        Aggregator --> SafetyIndex["🛡️ Average Speed Reduction & Uninsured Rate Index"]
    end

    subgraph RBAC_Access ["Role-Based Access Control (RBAC) Matrix"]
        Heatmap --> PoliceRole["👮 Traffic Police Commander (Full Telemetry & Enforcement)"]
        RevenueReport --> CityRole["🏛️ Municipal Finance Officer (Revenue & Collections)"]
        SafetyIndex --> PublicRole["🚗 General Public (Aggregated Safety Stats Only)"]
    end

    classDef stream fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff;
    classDef engine fill:#1e1b4b,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef rbac fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff;

    class RadarStream,PaymentStream,Aggregator stream;
    class Heatmap,RevenueReport,SafetyIndex engine;
    class PoliceRole,CityRole,PublicRole rbac;