# kimbopulus/opshub architecture

> Architecture diagram of the GitHub repository kimbopulus/opshub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kimbopulus/opshub
- Repository: https://github.com/kimbopulus/opshub

## Overview

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: [`frontend/src/main.jsx`](https://github.com/kimbopulus/opshub/blob/main/frontend/src/main.jsx) (OpsHub interface), [`src/main/java/pl/fortaco/opshub/web/OpsHubController.java`](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/OpsHubController.java) (Issue workflow API), [`src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java`](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java) (Telemetry service), [`src/main/java/pl/fortaco/opshub/web/ReportingController.java`](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/ReportingController.java) (Reporting API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Issue workflow"]
  node_ui["OpsHub interface<br/>[main.jsx]"]
  node_issue_api["Issue workflow API"]
  node_issue_rules["Issue rules and SLA<br/>[IssueRules.java]"]
  node_issue_domain["Issue, machine, order"]
  node_issue_store[("Issue repositories")]
  node_audit_api["Audit API"]
  node_audit_store[("Activity repository")]
  node_upload["Attachment checks"]
end

subgraph group_platform["Access and events"]
  node_auth["Authentication API"]
  node_security["Access and headers"]
  node_events_api["Live events endpoint"]
  node_events["Operations event stream"]
end

subgraph group_insights["Reporting and exports"]
  node_report_api["Reporting API"]
  node_report_schema["Reporting mappings"]
  node_pdf["Weekly PDF export"]
end

subgraph group_iot["Factory IoT"]
  node_iot_ui["IoT dashboard<br/>[main.jsx]"]
  node_iot_api["IoT API<br/>[IoTController.java]"]
  node_iot_service["Telemetry service"]
  node_iot_analytics["Anomaly and OEE<br/>[IoTAnalytics.java]"]
  node_iot_simulator["Reading simulator<br/>[IoTSimulator.java]"]
  node_iot_store[("IoT entities and repositories")]
end

node_operator(("Factory user"))
node_erp["Simulated ERP"]
node_bi["Power BI-style consumer"]

node_operator -->|"uses"| node_ui
node_ui -->|"calls workflow API"| node_issue_api
node_issue_api -->|"checks transitions"| node_issue_rules
node_issue_api -->|"reads and saves"| node_issue_store
node_issue_store -->|"persists"| node_issue_domain
node_issue_api -->|"publishes updates"| node_events
node_events_api -->|"subscribes"| node_events
node_ui -->|"opens live stream"| node_events_api
node_ui -->|"logs in"| node_auth
node_security -.->|"protects requests"| node_issue_api
node_issue_api -->|"records activity"| node_audit_store
node_audit_api -->|"searches events"| node_audit_store
node_ui -->|"views audit"| node_audit_api
node_issue_api -->|"checks uploads"| node_upload
node_ui -->|"requests reports"| node_report_api
node_report_api -.->|"uses mappings"| node_report_schema
node_ui -.->|"requests PDF export"| node_pdf
node_report_api -->|"serves reporting data"| node_bi
node_ui -->|"requests telemetry"| node_iot_api
node_iot_api -->|"delegates"| node_iot_service
node_iot_service -->|"detects and summarizes"| node_iot_analytics
node_iot_service -->|"reads and writes"| node_iot_store
node_iot_service -->|"generates readings"| node_iot_simulator
node_iot_ui -->|"loads dashboard"| node_iot_api
node_issue_api -->|"simulates schedule and downtime"| node_erp

click node_ui "https://github.com/kimbopulus/opshub/blob/main/frontend/src/main.jsx"
click node_issue_api "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/OpsHubController.java"
click node_issue_rules "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/IssueRules.java"
click node_issue_domain "https://github.com/kimbopulus/opshub/tree/main/src/main/java/pl/fortaco/opshub/model"
click node_issue_store "https://github.com/kimbopulus/opshub/tree/main/src/main/java/pl/fortaco/opshub/repository"
click node_audit_api "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/AuditController.java"
click node_audit_store "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/repository/IssueActivityRepository.java"
click node_auth "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/AuthController.java"
click node_security "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/SecurityConfig.java"
click node_events_api "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/OperationsEventsController.java"
click node_events "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/OperationsEventService.java"
click node_report_api "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/ReportingController.java"
click node_report_schema "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/ReportingSchema.java"
click node_pdf "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/WeeklyReportPdfBuilder.java"
click node_upload "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/SecureFileUploadPolicy.java"
click node_iot_ui "https://github.com/kimbopulus/opshub/blob/main/frontend/src/main.jsx"
click node_iot_api "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/IoTController.java"
click node_iot_service "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java"
click node_iot_analytics "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTAnalytics.java"
click node_iot_simulator "https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTSimulator.java"
click node_iot_store "https://github.com/kimbopulus/opshub/tree/main/src/main/java/pl/fortaco/opshub/iot"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_issue_api,node_issue_rules,node_issue_domain,node_issue_store,node_audit_api,node_audit_store,node_upload,node_operator toneBlue
class node_auth,node_security,node_events_api,node_events toneAmber
class node_report_api,node_report_schema,node_pdf toneMint
class node_iot_ui,node_iot_api,node_iot_service,node_iot_analytics,node_iot_simulator,node_iot_store toneRose
class node_erp,node_bi toneIndigo
```

## Components

### Issue workflow

- [OpsHub interface](https://github.com/kimbopulus/opshub/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Issue workflow API](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/OpsHubController.java): `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`
- [Issue rules and SLA](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/IssueRules.java): `src/main/java/pl/fortaco/opshub/service/IssueRules.java`
- [Issue, machine, order](https://github.com/kimbopulus/opshub/tree/main/src/main/java/pl/fortaco/opshub/model): `src/main/java/pl/fortaco/opshub/model`
- [Issue repositories](https://github.com/kimbopulus/opshub/tree/main/src/main/java/pl/fortaco/opshub/repository): `src/main/java/pl/fortaco/opshub/repository`
- [Audit API](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/AuditController.java): `src/main/java/pl/fortaco/opshub/web/AuditController.java`
- [Activity repository](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/repository/IssueActivityRepository.java): `src/main/java/pl/fortaco/opshub/repository/IssueActivityRepository.java`
- [Attachment checks](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/SecureFileUploadPolicy.java): `src/main/java/pl/fortaco/opshub/service/SecureFileUploadPolicy.java`

### Access and events

- [Authentication API](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/AuthController.java): `src/main/java/pl/fortaco/opshub/web/AuthController.java`
- [Access and headers](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/SecurityConfig.java): `src/main/java/pl/fortaco/opshub/web/SecurityConfig.java`
- [Live events endpoint](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/OperationsEventsController.java): `src/main/java/pl/fortaco/opshub/web/OperationsEventsController.java`
- [Operations event stream](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/OperationsEventService.java): `src/main/java/pl/fortaco/opshub/service/OperationsEventService.java`

### Reporting and exports

- [Reporting API](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/ReportingController.java): `src/main/java/pl/fortaco/opshub/web/ReportingController.java`
- [Reporting mappings](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/ReportingSchema.java): `src/main/java/pl/fortaco/opshub/service/ReportingSchema.java`
- [Weekly PDF export](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/service/WeeklyReportPdfBuilder.java): `src/main/java/pl/fortaco/opshub/service/WeeklyReportPdfBuilder.java`

### Factory IoT

- [IoT dashboard](https://github.com/kimbopulus/opshub/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [IoT API](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/web/IoTController.java): `src/main/java/pl/fortaco/opshub/web/IoTController.java`
- [Telemetry service](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java): `src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java`
- [Anomaly and OEE](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTAnalytics.java): `src/main/java/pl/fortaco/opshub/iot/service/IoTAnalytics.java`
- [Reading simulator](https://github.com/kimbopulus/opshub/blob/main/src/main/java/pl/fortaco/opshub/iot/service/IoTSimulator.java): `src/main/java/pl/fortaco/opshub/iot/service/IoTSimulator.java`
- [IoT entities and repositories](https://github.com/kimbopulus/opshub/tree/main/src/main/java/pl/fortaco/opshub/iot): `src/main/java/pl/fortaco/opshub/iot`

### Other components

- **Factory user**
- **Simulated ERP**
- **Power BI-style consumer**

## Connections

- Factory user → OpsHub interface: uses (evidence: `README.md`)
- OpsHub interface → Issue workflow API: calls workflow API (evidence: `README.md`)
- Issue workflow API → Issue rules and SLA: checks transitions (evidence: `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`)
- Issue workflow API → Issue repositories: reads and saves (evidence: `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`)
- Issue repositories → Issue, machine, order: persists (evidence: `src/main/java/pl/fortaco/opshub/repository/ProductionIssueRepository.java`)
- Issue workflow API → Operations event stream: publishes updates (evidence: `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`)
- Live events endpoint → Operations event stream: subscribes (evidence: `src/main/java/pl/fortaco/opshub/web/OperationsEventsController.java`)
- OpsHub interface → Live events endpoint: opens live stream (evidence: `README.md`)
- OpsHub interface → Authentication API: logs in (evidence: `README.md`)
- Access and headers → Issue workflow API: protects requests
- Issue workflow API → Activity repository: records activity (evidence: `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`)
- Audit API → Activity repository: searches events (evidence: `src/main/java/pl/fortaco/opshub/web/AuditController.java`)
- OpsHub interface → Audit API: views audit (evidence: `README.md`)
- Issue workflow API → Attachment checks: checks uploads (evidence: `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`)
- OpsHub interface → Reporting API: requests reports (evidence: `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 (evidence: `README.md`)
- OpsHub interface → IoT API: requests telemetry (evidence: `README.md`)
- IoT API → Telemetry service: delegates (evidence: `src/main/java/pl/fortaco/opshub/web/IoTController.java`)
- Telemetry service → Anomaly and OEE: detects and summarizes (evidence: `src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java`)
- Telemetry service → IoT entities and repositories: reads and writes (evidence: `src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java`)
- Telemetry service → Reading simulator: generates readings (evidence: `src/main/java/pl/fortaco/opshub/iot/service/IoTDataService.java`)
- IoT dashboard → IoT API: loads dashboard (evidence: `README.md`)
- Issue workflow API → Simulated ERP: simulates schedule and downtime (evidence: `src/main/java/pl/fortaco/opshub/web/OpsHubController.java`)
