How siddharthsoumya/driftshield works
DriftShield monitors configuration drift against a trusted YAML baseline, records differences, and automatically restores runtime configuration. The primary flow runs on a backend scheduler or detection API, then exposes persisted events and runtime state to a React dashboard that polls every five seconds. The README also documents alerts and persistent JPA storage. The graph follows excerpted calls and indexed references; deployment and unsampled implementation details are omitted.
Main entry points: DriftDetectionEngine.java Detection engine · App.jsx Dashboard app · AutoRevertService.java Auto-revert service · driftApi.js Drift API client
Components 22
Drift monitoring
- Drift API
backend/backend/src/main/java/com/driftshield/backend/controller/drift/DriftController.java - Monitoring scheduler
backend/backend/src/main/java/com/driftshield/backend/scheduler/DriftMonitoringScheduler.java - Detection engine
backend/backend/src/main/java/com/driftshield/backend/detection/drift/DriftDetectionEngine.java - YAML loader
backend/backend/src/main/java/com/driftshield/backend/detection/drift/YamlConfigLoader.java - Config comparator
backend/backend/src/main/java/com/driftshield/backend/detection/drift/ConfigComparator.java
Backend services
- Event service
backend/backend/src/main/java/com/driftshield/backend/service/drift/DriftEventService.java - Auto-revert service
backend/backend/src/main/java/com/driftshield/backend/remediation/drift/AutoRevertService.java - Config restore
backend/backend/src/main/java/com/driftshield/backend/remediation/drift/ConfigRestoreService.java - Runtime config API
backend/backend/src/main/java/com/driftshield/backend/controller/runtime/RuntimeConfigController.java - Runtime config service
backend/backend/src/main/java/com/driftshield/backend/service/runtime/RuntimeConfigService.java - Alert API
backend/backend/src/main/java/com/driftshield/backend/controller/alert/AlertController.java - Alert service
backend/backend/src/main/java/com/driftshield/backend/service/alert/AlertService.java
State and persistence
- Event repository
backend/backend/src/main/java/com/driftshield/backend/repository/drift/DriftEventRepository.java - Persistent database
- Alert repository
backend/backend/src/main/java/com/driftshield/backend/repository/alert/AlertRepository.java
Dashboard
- Dashboard app
frontend/src/App.jsx - Drift API client
frontend/src/api/driftApi.js - Polling service
frontend/src/services/pollingService.js - Monitoring views
frontend/src/components/tables/DriftEventsTable.jsx - Infrastructure status
frontend/src/components/cards/InfrastructureStatus.jsx - Remediation timeline
frontend/src/components/timeline/RemediationTimeline.jsx
Other components
- System activity
Connections 22
- System activity → Drift API: submits activity
README.md - Monitoring scheduler → Detection engine: runs detection
backend/backend/src/main/java/com/driftshield/backend/scheduler/DriftMonitoringScheduler.java - Drift API → Detection engine: runs detection
backend/backend/src/main/java/com/driftshield/backend/controller/drift/DriftController.java - Detection engine → YAML loader: loads configs
backend/backend/src/main/java/com/driftshield/backend/detection/drift/DriftDetectionEngine.java - Detection engine → Config comparator: compares configs
backend/backend/src/main/java/com/driftshield/backend/detection/drift/DriftDetectionEngine.java - Detection engine → Event service: saves differences
backend/backend/src/main/java/com/driftshield/backend/detection/drift/DriftDetectionEngine.java - Detection engine → Auto-revert service: triggers restore
backend/backend/src/main/java/com/driftshield/backend/detection/drift/DriftDetectionEngine.java - Event service → Event repository: saves and reads
backend/backend/src/main/java/com/driftshield/backend/service/drift/DriftEventService.java - Event repository → Persistent database: persists events
README.md - Auto-revert service → Config restore: restores config
backend/backend/src/main/java/com/driftshield/backend/remediation/drift/AutoRevertService.java - Auto-revert service → Event repository: marks reverted
backend/backend/src/main/java/com/driftshield/backend/remediation/drift/AutoRevertService.java - Runtime config API → Runtime config service: gets runtime config
backend/backend/src/main/java/com/driftshield/backend/controller/runtime/RuntimeConfigController.java - Runtime config service → YAML loader: loads runtime
backend/backend/src/main/java/com/driftshield/backend/service/runtime/RuntimeConfigService.java - Alert API → Alert service: handles alerts
backend/backend/src/main/java/com/driftshield/backend/controller/alert/AlertController.java - Alert service → Alert repository: stores and lists
backend/backend/src/main/java/com/driftshield/backend/service/alert/AlertService.java - Dashboard app → Polling service: starts polling
frontend/src/App.jsx - Dashboard app → Drift API client: requests data
frontend/src/App.jsx - Drift API client → Drift API: requests drift events
README.md - Drift API client → Runtime config API: requests runtime state
README.md - Dashboard app → Monitoring views: renders events
frontend/src/App.jsx - Dashboard app → Infrastructure status: renders status
frontend/src/App.jsx - Dashboard app → Remediation timeline: renders history
frontend/src/App.jsx