How hemanth2607-cyber/aegis-cyber-cashout works
AEGIS-CYBER forecasts likely cybercrime cash-out locations and supports rapid police interdiction, with an evidence ledger and operational dashboard. The intended flow is complaint ingestion, transaction-graph and spatial analysis, dual-stage forecasting with explanations, then dispatch/interdiction and docketing. The frontend also presents live alerts, ledger inspection, and a staged tactical simulation. Several backend services and surveillance details are unsampled; edges below follow shown imports, calls, route registration, or README claims rather than assuming connections from names alone.
Main entry points: main.py API application · ml_service.py Prediction service · graph_service.py Graph service · interventions.py Intervention API
Components 32
API workflows
- API application
backend/main.py - Complaint intake
backend/routes/complaints.py - Prediction API
backend/routes/predictions.py - Docket API
backend/routes/docket.py - Request schemas
backend/schemas.py
Risk analytics
- Graph service
backend/services/graph_service.py - Transaction graph
features/graph_engine.py - Spatial index
features/spatial_indexer.py - Feature pipeline
features/pipeline.py - Prediction service
backend/services/ml_service.py - ML inference
ml_models/inference.py - Tactical explanation
ml_models/explainer.py
Intervention & evidence
- Intervention API
backend/routes/interventions.py - Interdiction logic
backend/services/interdiction_service.py - Hardware bridge
backend/services/hardware_bridge.py - Surveillance API
backend/routes/surveillance.py - Vision emulator
backend/services/vision_emulator.py - Ledger API
backend/routes/blockchain_routes.py - Sentinel ledger
backend/services/blockchain_engine.py - Docket generator
backend/services/docket_generator.py - Alert WebSocket
backend/websocket.py
Operator experience
- Operations dashboard
frontend/app/dashboard/page.tsx - Simulation view
frontend/app/simulation/page.tsx - Journey map
frontend/components/TacticalJourneyMap.tsx - Algorithm inspector
frontend/components/AlgorithmRealityInspector.tsx - Simulation timeline
frontend/state/simulationTimeline.ts - Block explorer
frontend/components/ConsortiumBlockExplorer.tsx - Realtime alert hook
frontend/hooks/useRealtimeAlerts.ts
Feature data
- Synthetic data generation
data_generator/generate_data.py - Data configuration
data_generator/config.py
Other components
- Investigator
- ATM / kiosk
Connections 38
- API application → Complaint intake: registers route
backend/main.py - API application → Prediction API: registers route
backend/main.py - API application → Intervention API: registers route
backend/main.py - API application → Docket API: registers route
backend/main.py - API application → Surveillance API: registers route
backend/main.py - API application → Ledger API: registers route
backend/main.py - Complaint intake → Graph service: registers complaint
backend/routes/complaints.py - Complaint intake → Prediction service: requests prediction
backend/routes/complaints.py - Complaint intake → Sentinel ledger: records incident
backend/routes/complaints.py - Prediction API → Prediction service: requests forecast
backend/routes/predictions.py - Prediction API → Graph service: reads features
backend/routes/predictions.py - Graph service → Transaction graph: uses graph
backend/services/graph_service.py - Graph service → Spatial index: uses spatial index
backend/services/graph_service.py - Feature pipeline → Transaction graph: builds transaction graph
features/pipeline.py - Feature pipeline → Spatial index: enriches features
features/pipeline.py - Prediction service → Graph service: uses graph features
backend/services/ml_service.py - Prediction service → ML inference: runs inference
backend/services/ml_service.py - Prediction service → Tactical explanation: builds explanation
backend/services/ml_service.py - Intervention API → Interdiction logic: requests interdiction
backend/routes/interventions.py - Intervention API → Hardware bridge: bridges dispatch
backend/routes/interventions.py - Intervention API → Vision emulator: requests surveillance
backend/routes/interventions.py - Intervention API → Sentinel ledger: records intervention
backend/routes/interventions.py - Surveillance API → Vision emulator: requests vision
backend/routes/surveillance.py - Ledger API → Sentinel ledger: queries ledger
backend/routes/blockchain_routes.py - Docket API → Graph service: reads graph data
backend/routes/docket.py - Docket API → Prediction service: reads prediction
backend/routes/docket.py - Docket API → Docket generator: generates docket
backend/routes/docket.py - Investigator → Operations dashboard: operates
frontend/app/dashboard/page.tsx - Operations dashboard → Complaint intake: submits complaint
frontend/app/dashboard/page.tsx - Operations dashboard → Realtime alert hook: uses live alerts
frontend/app/dashboard/page.tsx - Realtime alert hook → Alert WebSocket: receives messages
frontend/hooks/useRealtimeAlerts.ts - Investigator → Simulation view: inspects simulation
frontend/app/simulation/page.tsx - Simulation view → Journey map: renders journey
frontend/app/simulation/page.tsx - Simulation view → Algorithm inspector: renders analysis
frontend/app/simulation/page.tsx - Simulation view → Simulation timeline: controls stages
- Investigator → Block explorer: inspects ledger
- Synthetic data generation → Data configuration: loads configuration
data_generator/generate_data.py - Hardware bridge → ATM / kiosk: signals terminal