How kimbopulus/opshub works
OpsHub is a factory-floor issue workflow with a React interface and Spring backend. Operators create machine-linked issues; leaders manage status and handoff, while activity, attachments, downtime, and SLA data support audit and reporting. Separate branches provide simulated IoT telemetry and reporting/Power Platform readiness; ERP and factory-system connections are simulations, not live integrations. The README documents the broader UI and reporting capabilities; source excerpts and the index substantiate selected backend ownership. Unshown implementation details and SQL view wiring are not inferred.
Main entry points: main.jsx OpsHub interface · OpsHubController.java Issue workflow API · IoTDataService.java Telemetry service · ReportingController.java Reporting API
Components 24
Issue workflow
- OpsHub interface
frontend/src/main.jsx - Issue workflow API
src/main/java/pl/fortaco/opshub/web/OpsHubController.java - Issue rules and SLA
src/main/java/pl/fortaco/opshub/service/IssueRules.java - Issue, machine, order
src/main/java/pl/fortaco/opshub/model - Issue repositories
src/main/java/pl/fortaco/opshub/repository - Audit API
src/main/java/pl/fortaco/opshub/web/AuditController.java - Activity repository
src/main/java/pl/fortaco/opshub/repository/IssueActivityRepository.java - Attachment checks
src/main/java/pl/fortaco/opshub/service/SecureFileUploadPolicy.java
Access and events
- Authentication API
src/main/java/pl/fortaco/opshub/web/AuthController.java - Access and headers
src/main/java/pl/fortaco/opshub/web/SecurityConfig.java - Live events endpoint
src/main/java/pl/fortaco/opshub/web/OperationsEventsController.java - Operations event stream
src/main/java/pl/fortaco/opshub/service/OperationsEventService.java
Reporting and exports
- Reporting API
src/main/java/pl/fortaco/opshub/web/ReportingController.java - Reporting mappings
src/main/java/pl/fortaco/opshub/service/ReportingSchema.java - Weekly PDF export
src/main/java/pl/fortaco/opshub/service/WeeklyReportPdfBuilder.java
Factory IoT
- IoT dashboard
frontend/src/main.jsx - IoT API
src/main/java/pl/fortaco/opshub/web/IoTController.java - Telemetry service
src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java - Anomaly and OEE
src/main/java/pl/fortaco/opshub/iot/service/IoTAnalytics.java - Reading simulator
src/main/java/pl/fortaco/opshub/iot/service/IoTSimulator.java - IoT entities and repositories
src/main/java/pl/fortaco/opshub/iot
Other components
- Factory user
- Simulated ERP
- Power BI-style consumer
Connections 25
- Factory user → OpsHub interface: uses
README.md - OpsHub interface → Issue workflow API: calls workflow API
README.md - Issue workflow API → Issue rules and SLA: checks transitions
src/main/java/pl/fortaco/opshub/web/OpsHubController.java - Issue workflow API → Issue repositories: reads and saves
src/main/java/pl/fortaco/opshub/web/OpsHubController.java - Issue repositories → Issue, machine, order: persists
src/main/java/pl/fortaco/opshub/repository/ProductionIssueRepository.java - Issue workflow API → Operations event stream: publishes updates
src/main/java/pl/fortaco/opshub/web/OpsHubController.java - Live events endpoint → Operations event stream: subscribes
src/main/java/pl/fortaco/opshub/web/OperationsEventsController.java - OpsHub interface → Live events endpoint: opens live stream
README.md - OpsHub interface → Authentication API: logs in
README.md - Access and headers → Issue workflow API: protects requests
- Issue workflow API → Activity repository: records activity
src/main/java/pl/fortaco/opshub/web/OpsHubController.java - Audit API → Activity repository: searches events
src/main/java/pl/fortaco/opshub/web/AuditController.java - OpsHub interface → Audit API: views audit
README.md - Issue workflow API → Attachment checks: checks uploads
src/main/java/pl/fortaco/opshub/web/OpsHubController.java - OpsHub interface → Reporting API: requests reports
README.md - Reporting API → Reporting mappings: uses mappings
- OpsHub interface → Weekly PDF export: requests PDF export
- Reporting API → Power BI-style consumer: serves reporting data
README.md - OpsHub interface → IoT API: requests telemetry
README.md - IoT API → Telemetry service: delegates
src/main/java/pl/fortaco/opshub/web/IoTController.java - Telemetry service → Anomaly and OEE: detects and summarizes
src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java - Telemetry service → IoT entities and repositories: reads and writes
src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java - Telemetry service → Reading simulator: generates readings
src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java - IoT dashboard → IoT API: loads dashboard
README.md - Issue workflow API → Simulated ERP: simulates schedule and downtime
src/main/java/pl/fortaco/opshub/web/OpsHubController.java