How omg775/anomalydetectionapplication works
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: EvaluationService.java Agreement evaluation · DetectionController.java Traffic API · DetectionService.java Rule detection · AnomalyAlertRepository.java Alert repository
Components 21
Traffic ingestion
- Traffic API
src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java - CSV importer
src/main/java/com/om/AnomalyDetectionApplication/service/CsvImportService.java - Traffic records
src/main/java/com/om/AnomalyDetectionApplication/repository/TrafficRecordRepository.java - Traffic table
src/main/java/com/om/AnomalyDetectionApplication/entity/TrafficRecord.java
Detection and alerts
- Rule detection
src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java - Alert repository
src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java - Alert table
src/main/java/com/om/AnomalyDetectionApplication/entity/AnomalyAlert.java - Alert API
src/main/java/com/om/AnomalyDetectionApplication/controller/AnomalyAlertController.java - Alert analytics
src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java
API and identity
- Spring Boot app
src/main/java/com/om/AnomalyDetectionApplication/AnomalyDetectionApplication.java - Login API
src/main/java/com/om/AnomalyDetectionApplication/controller/AuthController.java - JWT utilities
src/main/java/com/om/AnomalyDetectionApplication/security/JwtUtil.java - JWT security
src/main/java/com/om/AnomalyDetectionApplication/security/SecurityConfig.java
ML and evaluation
- Prediction API
src/main/java/com/om/AnomalyDetectionApplication/controller/PredictionController.java - Prediction service
src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java - Feature mapper
src/main/java/com/om/AnomalyDetectionApplication/util/MLFeatureMapper.java - ML client
src/main/java/com/om/AnomalyDetectionApplication/service/MlServiceClient.java - FastAPI detectors
ml-service/app.py - Evaluation API
src/main/java/com/om/AnomalyDetectionApplication/controller/EvaluationController.java - Agreement evaluation
src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java
Other components
- API client
Connections 25
- API client → Login API: logs in
README.md - Login API → JWT utilities: issues token
src/main/java/com/om/AnomalyDetectionApplication/controller/AuthController.java - API client → Traffic API: uploads CSV
README.md - Traffic API → CSV importer: imports CSV
src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java - CSV importer → Traffic records: saves records
src/main/java/com/om/AnomalyDetectionApplication/service/CsvImportService.java - Traffic records → Traffic table: persists
src/main/java/com/om/AnomalyDetectionApplication/repository/TrafficRecordRepository.java - API client → Traffic API: starts detection
README.md - Traffic API → Rule detection: runs rules
src/main/java/com/om/AnomalyDetectionApplication/controller/DetectionController.java - Rule detection → Traffic records: scans records
src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java - Rule detection → Alert repository: saves alerts
src/main/java/com/om/AnomalyDetectionApplication/service/DetectionService.java - Alert repository → Alert table: persists
src/main/java/com/om/AnomalyDetectionApplication/repository/AnomalyAlertRepository.java - API client → Alert API: queries alerts
README.md - Alert API → Alert analytics: requests analytics
src/main/java/com/om/AnomalyDetectionApplication/controller/AnomalyAlertController.java - Alert analytics → Alert repository: queries alerts
src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java - Alert analytics → Feature mapper: encodes fields
src/main/java/com/om/AnomalyDetectionApplication/service/AnomalyAlertService.java - API client → Prediction API: requests predictions
README.md - Prediction API → Prediction service: requests scoring
src/main/java/com/om/AnomalyDetectionApplication/controller/PredictionController.java - Prediction service → Rule detection: loads ML data
src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java - Prediction service → ML client: trains or scores
src/main/java/com/om/AnomalyDetectionApplication/service/PredictionService.java - ML client → FastAPI detectors: calls train or predict
src/main/java/com/om/AnomalyDetectionApplication/service/MlServiceClient.java - API client → Evaluation API: checks agreement
README.md - Evaluation API → Agreement evaluation: computes agreement
src/main/java/com/om/AnomalyDetectionApplication/controller/EvaluationController.java - Agreement evaluation → Alert repository: loads alerts
src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java - Agreement evaluation → Feature mapper: encodes fields
src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java - Agreement evaluation → ML client: requests predictions
src/main/java/com/om/AnomalyDetectionApplication/service/EvaluationService.java