How sriramas-dev/sentinel-email-gateway works
SENTINEL is an email-security gateway: an operator submits a message, the API scores it, may simulate risky behavior, assigns a verdict, and persists the result for review. The React console exposes scanning, monitoring, quarantine, analytics, configuration, and training views. Backend call details are partly omitted, so the documented detection stages are shown with README evidence; frontend API links are included only where the scanner’s request is excerpted.
Main entry points: App.js React app routing · server.py FastAPI routes · EmailScanner.js Email scanner · ml_model.py NLP classifier
Components 17
Operator console
- React app routing
frontend/src/App.js - Email scanner
frontend/src/pages/EmailScanner.js - Threat dashboard
frontend/src/pages/Dashboard.js - Live monitor
frontend/src/pages/LiveMonitor.js - Quarantine review
frontend/src/pages/Quarantine.js - Analytics view
frontend/src/pages/Analytics.js - Configuration view
frontend/src/pages/Configuration.js - Model training view
frontend/src/pages/Training.js - Risk score display
frontend/src/components/ScoreBadge.js - Trace display
frontend/src/components/TerminalWindow.js
Gateway API
- FastAPI routes
backend/server.py - Input validation
backend/validation.py
Detection pipeline
- NLP classifier
backend/ml_model.py - Behavior simulator
backend/sandbox_simulator.py - Verdict decision
backend/server.py
Review and records
- Email and feedback store
backend/database.py
Other components
- Security operator
Connections 18
- Security operator → React app routing: uses
frontend/src/App.js - React app routing → Email scanner: routes to
frontend/src/App.js - React app routing → Threat dashboard: routes to
frontend/src/App.js - React app routing → Live monitor: routes to
frontend/src/App.js - React app routing → Quarantine review: routes to
frontend/src/App.js - React app routing → Analytics view: routes to
frontend/src/App.js - React app routing → Configuration view: routes to
frontend/src/App.js - React app routing → Model training view: routes to
frontend/src/App.js - Email scanner → FastAPI routes: POSTs analysis
frontend/src/pages/EmailScanner.js - Email scanner → Risk score display: renders score
frontend/src/pages/EmailScanner.js - Email scanner → Trace display: renders traces
frontend/src/pages/EmailScanner.js - FastAPI routes → Input validation: validates input
backend/server.py - FastAPI routes → NLP classifier: requests score
backend/server.py - FastAPI routes → Behavior simulator: simulates behavior
README.md - FastAPI routes → Verdict decision: assigns verdict
README.md - FastAPI routes → Email and feedback store: reads and writes
backend/server.py - NLP classifier → Verdict decision: provides NLP score
README.md - Behavior simulator → Verdict decision: provides behavior trace
README.md