How ishu-26/sentinel-ai--cyber-defense-platform works
Sentinel AI is a SOC platform where analysts submit URLs, network flows, files, or folders through a React dashboard; FastAPI routes these to detection services, then presents scored, explainable alerts for investigation. The README documents phishing, network IDS, ML malware, YARA scanning, unified risk, alert dashboards, and a RAG Security Copilot. Relationships among sampled API routes and services are supported by the SOURCE INDEX; links for documented but unsampled capabilities cite the README. The graph does not imply unshown calls between sibling detection services.
Main entry points: main.py FastAPI application · alerts_service.py Unified alert feed · malware.py Malware and YARA endpoints · phishing.py Phishing endpoint
Components 21
SOC dashboard
- Dashboard routes
frontend/src/App.tsx - Analysis pages
frontend/src/pages - Alert views
frontend/src/pages - API client
frontend/src/services/api.ts
Threat detection
- Phishing endpoint
backend/app/api/phishing.py - Phishing analysis
backend/app/services/phishing - Network endpoint
backend/app/api/network.py - Network IDS
backend/app/services/network - Malware and YARA endpoints
backend/app/api/malware.py - ML malware scanner
backend/app/services/malware - YARA folder scanner
backend/app/services/yara_scanner
Risk and alerts
- Unified risk engine
backend/app/services/risk_engine/engine.py - Alert endpoints
backend/app/api/alerts.py - Unified alert feed
backend/app/services/alerts_service.py
Security Copilot
- Copilot endpoint
backend/app/api/copilot.py - RAG agent
backend/app/services/copilot/agent.py - Knowledge retrieval
backend/app/services/copilot/qdrant_manager.py - Qdrant vector store
Backend runtime
- FastAPI application
backend/app/main.py - Supabase
backend/app/db/supabase_client.py
Other components
- Security analyst
Connections 29
- Security analyst → Dashboard routes: uses dashboard
- Dashboard routes → Analysis pages: routes to
frontend/src/App.tsx - Dashboard routes → Alert views: routes to
frontend/src/App.tsx - Analysis pages → API client: requests analysis
frontend/src/pages/MalwareAnalysis.tsx - Alert views → API client: requests alerts
frontend/src/pages/LiveAlerts.tsx - API client → FastAPI application: sends REST requests
- FastAPI application → Phishing endpoint: registers route
backend/app/main.py - FastAPI application → Network endpoint: registers route
backend/app/main.py - FastAPI application → Malware and YARA endpoints: registers route
backend/app/main.py - FastAPI application → Alert endpoints: registers route
backend/app/main.py - FastAPI application → Copilot endpoint: registers route
backend/app/main.py - Phishing endpoint → Phishing analysis: uses predictor
backend/app/api/phishing.py - Network endpoint → Network IDS: uses predictor
backend/app/api/network.py - Malware and YARA endpoints → ML malware scanner: uses scanner
backend/app/api/malware.py - Malware and YARA endpoints → YARA folder scanner: starts folder scans
backend/app/api/malware.py - Phishing endpoint → Unified risk engine: evaluates risk
backend/app/api/phishing.py - Network endpoint → Unified risk engine: evaluates risk
backend/app/api/network.py - Malware and YARA endpoints → Unified risk engine: evaluates risk
backend/app/api/malware.py - Phishing endpoint → Unified alert feed: records detections
backend/app/api/phishing.py - Network endpoint → Unified alert feed: records detections
backend/app/api/network.py - Malware and YARA endpoints → Unified alert feed: records detections
backend/app/api/malware.py - Alert endpoints → Unified alert feed: reads alert feed
backend/app/api/alerts.py - Unified alert feed → Supabase: reads and writes
backend/app/services/alerts_service.py - Copilot endpoint → RAG agent: delegates queries
backend/app/api/copilot.py - RAG agent → Knowledge retrieval: retrieves context
backend/app/api/copilot.py - Knowledge retrieval → Qdrant vector store: searches vectors
backend/app/services/copilot/qdrant_manager.py - Knowledge retrieval → Qdrant vector store: stores embeddings
backend/app/services/copilot/qdrant_manager.py - Unified risk engine → Unified alert feed: supplies scored findings
- YARA folder scanner → Supabase: persists scan results