Visual Factory Guardian

## Visual Factory Guardian Visual Factory Guardian (VFG) is an industrial quality-monitoring and fault-investigation prototype designed to help manufacturing operators understand not only what defect occurred, but also which process conditions may have contributed to it. Conventional visual inspection can flag a defective product without showing the machine conditions surrounding the event. VFG connects image-based anomaly detection, timestamped sensor telemetry, statistical root-cause analysis, and technical-manual retrieval into an evidence-driven investigation workflow. The prototype includes: - **Computer vision:** An OpenCV-based inspection pipeline with a lightweight PatchCore-style anomaly detector and an optional Anomalib/PatchCore backend for compatible AMD ROCm environments. - **Machine telemetry:** A deterministic simulation of temperature, vibration, and motor current, with fault injection and synchronized inspection timestamps. - **Root-cause investigation:** CUSUM change-point analysis, baseline deviations, z-scores, temporal precedence, and ranked candidate causes. - **Technical documentation:** Retrieval of relevant passages from a sample tile-production maintenance manual to support operator review. - **Interactive visualization:** A React and Three.js factory experience with inspection events, sensor trends, evidence review, and a dedicated live-backend interface. VFG distinguishes simulated inputs from real model outputs and treats root-cause results as **evidence-supported hypotheses rather than proof of causation**. Recommended actions remain subject to human review; the prototype does not control industrial machinery. The project demonstrates an extensible approach to industrial quality investigation that combines machine vision, telemetry, explainable analytics, and an accessible operator interface. The repository includes the application, test suites, API contracts, scenario configuration, and instructions for running the prototype.