# omg775/anomalydetectionapplication architecture

> Architecture diagram of the GitHub repository omg775/anomalydetectionapplication, 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/omg775/anomalydetectionapplication
- Repository: https://github.com/omg775/anomalydetectionapplication

## Overview

This is a network-traffic anomaly detection backend: clients authenticate, upload traffic CSVs, trigger heuristic detection, and query alerts or ML results. Its central pipeline stores imported traffic, applies configurable rules, persists alerts, then exposes alert analytics and ML scoring/evaluation through a Spring API and FastAPI service. The README documents the hybrid heuristic/ML design and capabilities; source excerpts and the index support the shown service and repository calls. Some controller, security, and ML-service implementation details were not excerpted, so those links rely on documentation where noted.

Main entry points: [`src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java`](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java) (Agreement evaluation), [`src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java`](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java) (Traffic API), [`src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java`](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java) (Rule detection), [`src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java`](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java) (Alert repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Traffic ingestion"]
  node_trafficapi["Traffic API"]
  node_csv["CSV importer"]
  node_trafficrepo["Traffic records"]
  node_trafficdb[("Traffic table<br/>[TrafficRecord.java]")]
end

subgraph group_detect["Detection and alerts"]
  node_detectservice["Rule detection"]
  node_alertrepo["Alert repository"]
  node_alertdb[("Alert table<br/>[AnomalyAlert.java]")]
  node_alertapi["Alert API"]
  node_alertservice["Alert analytics"]
end

subgraph group_api["API and identity"]
  node_spring["Spring Boot app"]
  node_auth["Login API"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_security["JWT security"]
end

subgraph group_ml["ML and evaluation"]
  node_predictionapi["Prediction API"]
  node_prediction["Prediction service"]
  node_features["Feature mapper"]
  node_mlclient["ML client"]
  node_mlservice["FastAPI detectors<br/>[app.py]"]
  node_evaluationapi["Evaluation API"]
  node_evaluation["Agreement evaluation"]
end

node_client(("API client"))

node_client -->|"logs in"| node_auth
node_auth -->|"issues token"| node_jwt
node_client -->|"uploads CSV"| node_trafficapi
node_trafficapi -->|"imports CSV"| node_csv
node_csv -->|"saves records"| node_trafficrepo
node_trafficrepo -->|"persists"| node_trafficdb
node_client -->|"starts detection"| node_trafficapi
node_trafficapi -->|"runs rules"| node_detectservice
node_detectservice -->|"scans records"| node_trafficrepo
node_detectservice -->|"saves alerts"| node_alertrepo
node_alertrepo -->|"persists"| node_alertdb
node_client -->|"queries alerts"| node_alertapi
node_alertapi -->|"requests analytics"| node_alertservice
node_alertservice -->|"queries alerts"| node_alertrepo
node_alertservice -->|"encodes fields"| node_features
node_client -->|"requests predictions"| node_predictionapi
node_predictionapi -->|"requests scoring"| node_prediction
node_prediction -->|"loads ML data"| node_detectservice
node_prediction -->|"trains or scores"| node_mlclient
node_mlclient -->|"calls train or predict"| node_mlservice
node_client -->|"checks agreement"| node_evaluationapi
node_evaluationapi -->|"computes agreement"| node_evaluation
node_evaluation -->|"loads alerts"| node_alertrepo
node_evaluation -->|"encodes fields"| node_features
node_evaluation -->|"requests predictions"| node_mlclient

click node_spring "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/AnomalyDetectionApplication.java"
click node_auth "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/AuthController.java"
click node_jwt "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/security/JwtUtil.java"
click node_security "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/security/SecurityConfig.java"
click node_trafficapi "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java"
click node_csv "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/CsvImportService.java"
click node_trafficrepo "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/repository/TrafficRecordRepository.java"
click node_trafficdb "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/entity/TrafficRecord.java"
click node_detectservice "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java"
click node_alertrepo "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java"
click node_alertdb "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/entity/AnomalyAlert.java"
click node_alertapi "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/AnomalyAlertController.java"
click node_alertservice "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java"
click node_predictionapi "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/PredictionController.java"
click node_prediction "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java"
click node_features "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/util/MLFeatureMapper.java"
click node_mlclient "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/MlServiceClient.java"
click node_mlservice "https://github.com/omg775/anomalydetectionapplication/blob/master/ml-service/app.py"
click node_evaluationapi "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/EvaluationController.java"
click node_evaluation "https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.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_trafficapi,node_csv,node_trafficrepo,node_trafficdb,node_client toneBlue
class node_detectservice,node_alertrepo,node_alertdb,node_alertapi,node_alertservice toneAmber
class node_spring,node_auth,node_jwt,node_security toneMint
class node_predictionapi,node_prediction,node_features,node_mlclient,node_mlservice,node_evaluationapi,node_evaluation toneRose
```

## Components

### Traffic ingestion

- [Traffic API](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java): `src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java`
- [CSV importer](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/CsvImportService.java): `src/main/java/com/om/AnomalyDetectionApplication/service/CsvImportService.java`
- [Traffic records](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/repository/TrafficRecordRepository.java): `src/main/java/com/om/AnomalyDetectionApplication/repository/TrafficRecordRepository.java`
- [Traffic table](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/entity/TrafficRecord.java): `src/main/java/com/om/AnomalyDetectionApplication/entity/TrafficRecord.java`

### Detection and alerts

- [Rule detection](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java): `src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java`
- [Alert repository](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java): `src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java`
- [Alert table](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/entity/AnomalyAlert.java): `src/main/java/com/om/AnomalyDetectionApplication/entity/AnomalyAlert.java`
- [Alert API](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/AnomalyAlertController.java): `src/main/java/com/om/AnomalyDetectionApplication/controller/AnomalyAlertController.java`
- [Alert analytics](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java): `src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java`

### API and identity

- [Spring Boot app](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/AnomalyDetectionApplication.java): `src/main/java/com/om/AnomalyDetectionApplication/AnomalyDetectionApplication.java`
- [Login API](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/AuthController.java): `src/main/java/com/om/AnomalyDetectionApplication/controller/AuthController.java`
- [JWT utilities](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/security/JwtUtil.java): `src/main/java/com/om/AnomalyDetectionApplication/security/JwtUtil.java`
- [JWT security](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/security/SecurityConfig.java): `src/main/java/com/om/AnomalyDetectionApplication/security/SecurityConfig.java`

### ML and evaluation

- [Prediction API](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/PredictionController.java): `src/main/java/com/om/AnomalyDetectionApplication/controller/PredictionController.java`
- [Prediction service](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java): `src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java`
- [Feature mapper](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/util/MLFeatureMapper.java): `src/main/java/com/om/AnomalyDetectionApplication/util/MLFeatureMapper.java`
- [ML client](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/MlServiceClient.java): `src/main/java/com/om/AnomalyDetectionApplication/service/MlServiceClient.java`
- [FastAPI detectors](https://github.com/omg775/anomalydetectionapplication/blob/master/ml-service/app.py): `ml-service/app.py`
- [Evaluation API](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/controller/EvaluationController.java): `src/main/java/com/om/AnomalyDetectionApplication/controller/EvaluationController.java`
- [Agreement evaluation](https://github.com/omg775/anomalydetectionapplication/blob/master/src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java): `src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java`

### Other components

- **API client**

## Connections

- API client → Login API: logs in (evidence: `README.md`)
- Login API → JWT utilities: issues token (evidence: `src/main/java/com/om/AnomalyDetectionApplication/controller/AuthController.java`)
- API client → Traffic API: uploads CSV (evidence: `README.md`)
- Traffic API → CSV importer: imports CSV (evidence: `src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java`)
- CSV importer → Traffic records: saves records (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/CsvImportService.java`)
- Traffic records → Traffic table: persists (evidence: `src/main/java/com/om/AnomalyDetectionApplication/repository/TrafficRecordRepository.java`)
- API client → Traffic API: starts detection (evidence: `README.md`)
- Traffic API → Rule detection: runs rules (evidence: `src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java`)
- Rule detection → Traffic records: scans records (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java`)
- Rule detection → Alert repository: saves alerts (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java`)
- Alert repository → Alert table: persists (evidence: `src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java`)
- API client → Alert API: queries alerts (evidence: `README.md`)
- Alert API → Alert analytics: requests analytics (evidence: `src/main/java/com/om/AnomalyDetectionApplication/controller/AnomalyAlertController.java`)
- Alert analytics → Alert repository: queries alerts (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java`)
- Alert analytics → Feature mapper: encodes fields (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java`)
- API client → Prediction API: requests predictions (evidence: `README.md`)
- Prediction API → Prediction service: requests scoring (evidence: `src/main/java/com/om/AnomalyDetectionApplication/controller/PredictionController.java`)
- Prediction service → Rule detection: loads ML data (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java`)
- Prediction service → ML client: trains or scores (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java`)
- ML client → FastAPI detectors: calls train or predict (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/MlServiceClient.java`)
- API client → Evaluation API: checks agreement (evidence: `README.md`)
- Evaluation API → Agreement evaluation: computes agreement (evidence: `src/main/java/com/om/AnomalyDetectionApplication/controller/EvaluationController.java`)
- Agreement evaluation → Alert repository: loads alerts (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java`)
- Agreement evaluation → Feature mapper: encodes fields (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java`)
- Agreement evaluation → ML client: requests predictions (evidence: `src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java`)
