How marwaneproo/sentinelgraph-ai works
SentinelGraph-AI is a SIEM application for collecting and normalizing security logs, detecting threats, managing alerts, investigating relationships, and presenting findings to analysts. The frontend’s authenticated navigation exposes log, alert, graph, AI, server, rules, and dashboard views; backend APIs and services provide those capabilities. Sampled code confirms detection reads MongoDB logs and rules, persists alerts, and syncs new alerts to Neo4j. Some API implementations and UI-to-endpoint mappings were not sampled, so those connections are left unverified.
Main entry points: App.tsx Authenticated app · api.ts API client · router.py API router · detector.py Detection engine
Components 24
Analyst Experience
- Authenticated app
frontend/src/App.tsx - Auth context
frontend/src/context/AuthContext.tsx - API client
frontend/src/services/api.ts - Dashboard
frontend/src/pages/Dashboard.tsx - Log explorer
frontend/src/pages/LogsExplorer.tsx - Alert management
frontend/src/pages/AlertsManagement.tsx - Threat graph view
frontend/src/components/graph/ThreatGraphView.tsx - AI assistant
frontend/src/pages/AIAssistant.tsx
API and Identity
- API router
backend/app/api/router.py - Authentication API
backend/app/api/auth.py - Logs API
backend/app/api/logs.py - Alerts API
backend/app/api/alerts.py - Graph API
backend/app/api/graph.py - AI API
backend/app/api/ai.py
Security Operations
- Log processing
backend/app/services/log_service.py - Detection engine
backend/app/engine/detector.py - Alert lifecycle
backend/app/services/alert_service.py - Audit trail
backend/app/services/audit_service.py - Detection rules
backend/app/engine/rules
Threat Intelligence
- Graph investigations
backend/app/services/graph_service.py - AI analysis
backend/app/services/ai_service.py
Data Stores
- MongoDB manager
backend/app/db/mongodb.py - Neo4j manager
backend/app/db/neo4j.py
Other components
- Security analyst
Connections 38
- Security analyst → Authenticated app: uses
frontend/src/App.tsx - Authenticated app → Auth context: provides auth
frontend/src/App.tsx - Authenticated app → Dashboard: routes to
frontend/src/App.tsx - Authenticated app → Log explorer: routes to
frontend/src/App.tsx - Authenticated app → Alert management: routes to
frontend/src/App.tsx - Authenticated app → Threat graph view: routes to
frontend/src/App.tsx - Authenticated app → AI assistant: routes to
frontend/src/App.tsx - Auth context → API client: requests auth
frontend/src/context/AuthContext.tsx - API router → Authentication API: registers
backend/app/api/router.py - API router → Logs API: registers
backend/app/api/router.py - API router → Alerts API: registers
backend/app/api/router.py - API router → Graph API: registers
backend/app/api/router.py - API router → AI API: registers
backend/app/api/router.py - API client → API router: HTTP requests
- Logs API → Log processing: delegates to
- Alerts API → Alert lifecycle: uses
backend/app/api/alerts.py - Alerts API → Detection engine: invokes
backend/app/api/alerts.py - AI API → AI analysis: invokes
backend/app/api/ai.py - Detection engine → MongoDB manager: reads and writes
backend/app/engine/detector.py - Detection engine → Detection rules: evaluates
backend/app/engine/detector.py - Detection engine → Neo4j manager: syncs alerts
backend/app/engine/detector.py - Log processing → MongoDB manager: stores logs
backend/app/services/log_service.py - Log processing → Neo4j manager: syncs graph
backend/app/services/log_service.py - Alert lifecycle → MongoDB manager: reads and writes
backend/app/services/alert_service.py - Alert lifecycle → Neo4j manager: syncs graph
backend/app/services/alert_service.py - Graph investigations → Neo4j manager: queries graph
backend/app/services/graph_service.py - AI analysis → Alert lifecycle: uses alert data
backend/app/services/ai_service.py - AI analysis → MongoDB manager: reads data
backend/app/services/ai_service.py - Authentication API → MongoDB manager: reads users
backend/app/api/auth.py - Authentication API → Audit trail: records actions
backend/app/api/auth.py - Alerts API → Audit trail: records actions
backend/app/api/alerts.py - Dashboard → API client: requests data
frontend/src/pages/Dashboard.tsx - Log explorer → API client: requests logs
frontend/src/pages/LogsExplorer.tsx - Alert management → API client: requests alerts
frontend/src/pages/AlertsManagement.tsx - Threat graph view → API client: requests graph
frontend/src/components/graph/ThreatGraphView.tsx - AI assistant → API client: requests analysis
frontend/src/pages/AIAssistant.tsx - Log processing → Detection engine: detection workflow
- Threat graph view → Graph investigations: investigates