# mr-hoodich/owws-ecs-backend- architecture

> Architecture diagram of the GitHub repository mr-hoodich/owws-ecs-backend-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mr-hoodich/owws-ecs-backend-
- Repository: https://github.com/mr-hoodich/owws-ecs-backend-

## Overview

This is a Spring Boot telemetry backend for worker sensor packets. Its active demonstrated workflow is startup fake data through CSV parsing into in-memory per-worker state and bounded packet history, then REST clients query workers, counts, status, or events. A serial receiver can read newline-delimited input but currently only logs it; its parser connection is explicitly unfinished, so it is shown separately. The 3-second packet parser is reserved and has no implemented behavior. Edges reflect shown calls or controller semantics; no README was provided.

Main entry points: [`backend/src/main/java/owwsecs/StateManager.java`](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/StateManager.java) (State Manager), [`backend/src/main/java/owwsecs/FakeDataRunner.java`](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/FakeDataRunner.java) (Fake Data Runner), [`backend/src/main/java/owwsecs/PacketParser.java`](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/PacketParser.java) (CSV Packet Parser), [`backend/src/main/java/owwsecs/ApiController.java`](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/ApiController.java) (REST Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Packet Ingestion"]
  node_fake["Fake Data Runner"]
  node_serial["Serial Receiver"]
  node_parser["CSV Packet Parser<br/>[PacketParser.java]"]
end

subgraph group_state["Telemetry State"]
  node_packet["Sensor Packet<br/>[SensorPacket.java]"]
  node_manager["State Manager<br/>[StateManager.java]"]
end

subgraph group_access["REST Access"]
  node_api["REST Controller<br/>[ApiController.java]"]
end

node_app["Spring Boot App"]
node_client(("HTTP Client"))
node_device(("Serial Device"))

node_fake -->|"parses packets"| node_parser
node_parser -->|"creates"| node_packet
node_fake -->|"updates state"| node_manager
node_manager -->|"stores packets"| node_packet
node_client -->|"requests endpoints"| node_api
node_api -->|"queries state"| node_manager
node_device -->|"sends serial data"| node_serial

click node_app "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/OwwsecsApplication.java"
click node_fake "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/FakeDataRunner.java"
click node_serial "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/SerialReceiver.java"
click node_parser "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/PacketParser.java"
click node_packet "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/SensorPacket.java"
click node_manager "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/StateManager.java"
click node_api "https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/ApiController.java"

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_fake,node_serial,node_parser,node_client toneBlue
class node_packet,node_manager toneAmber
class node_api toneMint
class node_app toneTeal
class node_device toneIndigo
```

## Components

### Packet Ingestion

- [Fake Data Runner](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/FakeDataRunner.java): `backend/src/main/java/owwsecs/FakeDataRunner.java`
- [Serial Receiver](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/SerialReceiver.java): `backend/src/main/java/owwsecs/SerialReceiver.java`
- [CSV Packet Parser](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/PacketParser.java): `backend/src/main/java/owwsecs/PacketParser.java`

### Telemetry State

- [Sensor Packet](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/SensorPacket.java): `backend/src/main/java/owwsecs/SensorPacket.java`
- [State Manager](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/StateManager.java): `backend/src/main/java/owwsecs/StateManager.java`

### REST Access

- [REST Controller](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/ApiController.java): `backend/src/main/java/owwsecs/ApiController.java`

### Other components

- [Spring Boot App](https://github.com/mr-hoodich/owws-ecs-backend-/blob/main/backend/src/main/java/owwsecs/OwwsecsApplication.java): `backend/src/main/java/owwsecs/OwwsecsApplication.java`
- **HTTP Client**
- **Serial Device**

## Connections

- Fake Data Runner → CSV Packet Parser: parses packets (evidence: `backend/src/main/java/owwsecs/FakeDataRunner.java`)
- CSV Packet Parser → Sensor Packet: creates (evidence: `backend/src/main/java/owwsecs/PacketParser.java`)
- Fake Data Runner → State Manager: updates state (evidence: `backend/src/main/java/owwsecs/FakeDataRunner.java`)
- State Manager → Sensor Packet: stores packets (evidence: `backend/src/main/java/owwsecs/StateManager.java`)
- HTTP Client → REST Controller: requests endpoints (evidence: `backend/src/main/java/owwsecs/ApiController.java`)
- REST Controller → State Manager: queries state (evidence: `backend/src/main/java/owwsecs/ApiController.java`)
- Serial Device → Serial Receiver: sends serial data (evidence: `backend/src/main/java/owwsecs/SerialReceiver.java`)
