# sriramas-dev/sentinel-email-gateway architecture

> Architecture diagram of the GitHub repository sriramas-dev/sentinel-email-gateway, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sriramas-dev/sentinel-email-gateway
- Repository: https://github.com/sriramas-dev/sentinel-email-gateway

## Overview

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: [`frontend/src/App.js`](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/App.js) (React app routing), [`backend/server.py`](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/server.py) (FastAPI routes), [`frontend/src/pages/EmailScanner.js`](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/EmailScanner.js) (Email scanner), [`backend/ml_model.py`](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/ml_model.py) (NLP classifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Operator console"]
  node_app["React app routing<br/>[App.js]"]
  node_scanner["Email scanner<br/>[EmailScanner.js]"]
  node_dashboard["Threat dashboard<br/>[Dashboard.js]"]
  node_monitor["Live monitor<br/>[LiveMonitor.js]"]
  node_quarantine["Quarantine review<br/>[Quarantine.js]"]
  node_analytics["Analytics view<br/>[Analytics.js]"]
  node_configuration["Configuration view<br/>[Configuration.js]"]
  node_training["Model training view<br/>[Training.js]"]
  node_scorebadge["Risk score display<br/>[ScoreBadge.js]"]
  node_terminal["Trace display<br/>[TerminalWindow.js]"]
end

subgraph group_api["Gateway API"]
  node_api["FastAPI routes<br/>[server.py]"]
  node_validation["Input validation<br/>[validation.py]"]
end

subgraph group_detection["Detection pipeline"]
  node_classifier["NLP classifier<br/>[ml_model.py]"]
  node_sandbox["Behavior simulator"]
  node_decision{{"Verdict decision<br/>[server.py]"}}
end

subgraph group_records["Review and records"]
  node_store[("Email and feedback store<br/>[database.py]")]
end

node_operator(("Security operator"))

node_operator -->|"uses"| node_app
node_app -->|"routes to"| node_scanner
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_monitor
node_app -->|"routes to"| node_quarantine
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_configuration
node_app -->|"routes to"| node_training
node_scanner -->|"POSTs analysis"| node_api
node_scanner -->|"renders score"| node_scorebadge
node_scanner -->|"renders traces"| node_terminal
node_api -->|"validates input"| node_validation
node_api -->|"requests score"| node_classifier
node_api -->|"simulates behavior"| node_sandbox
node_api -->|"assigns verdict"| node_decision
node_api -->|"reads and writes"| node_store
node_classifier -.->|"provides NLP score"| node_decision
node_sandbox -.->|"provides behavior trace"| node_decision

click node_app "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/App.js"
click node_scanner "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/EmailScanner.js"
click node_dashboard "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Dashboard.js"
click node_monitor "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/LiveMonitor.js"
click node_quarantine "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Quarantine.js"
click node_analytics "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Analytics.js"
click node_configuration "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Configuration.js"
click node_training "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Training.js"
click node_scorebadge "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/components/ScoreBadge.js"
click node_terminal "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/components/TerminalWindow.js"
click node_api "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/server.py"
click node_validation "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/validation.py"
click node_classifier "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/ml_model.py"
click node_sandbox "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/sandbox_simulator.py"
click node_decision "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/server.py"
click node_store "https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/database.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_scanner,node_dashboard,node_monitor,node_quarantine,node_analytics,node_configuration,node_training,node_scorebadge,node_terminal toneBlue
class node_api,node_validation toneAmber
class node_classifier,node_sandbox,node_decision toneMint
class node_store toneRose
class node_operator toneIndigo
```

## Components

### Operator console

- [React app routing](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Email scanner](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/EmailScanner.js): `frontend/src/pages/EmailScanner.js`
- [Threat dashboard](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Dashboard.js): `frontend/src/pages/Dashboard.js`
- [Live monitor](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/LiveMonitor.js): `frontend/src/pages/LiveMonitor.js`
- [Quarantine review](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Quarantine.js): `frontend/src/pages/Quarantine.js`
- [Analytics view](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Analytics.js): `frontend/src/pages/Analytics.js`
- [Configuration view](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Configuration.js): `frontend/src/pages/Configuration.js`
- [Model training view](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/pages/Training.js): `frontend/src/pages/Training.js`
- [Risk score display](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/components/ScoreBadge.js): `frontend/src/components/ScoreBadge.js`
- [Trace display](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/frontend/src/components/TerminalWindow.js): `frontend/src/components/TerminalWindow.js`

### Gateway API

- [FastAPI routes](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/server.py): `backend/server.py`
- [Input validation](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/validation.py): `backend/validation.py`

### Detection pipeline

- [NLP classifier](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/ml_model.py): `backend/ml_model.py`
- [Behavior simulator](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/sandbox_simulator.py): `backend/sandbox_simulator.py`
- [Verdict decision](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/server.py): `backend/server.py`

### Review and records

- [Email and feedback store](https://github.com/sriramas-dev/sentinel-email-gateway/blob/main/backend/database.py): `backend/database.py`

### Other components

- **Security operator**

## Connections

- Security operator → React app routing: uses (evidence: `frontend/src/App.js`)
- React app routing → Email scanner: routes to (evidence: `frontend/src/App.js`)
- React app routing → Threat dashboard: routes to (evidence: `frontend/src/App.js`)
- React app routing → Live monitor: routes to (evidence: `frontend/src/App.js`)
- React app routing → Quarantine review: routes to (evidence: `frontend/src/App.js`)
- React app routing → Analytics view: routes to (evidence: `frontend/src/App.js`)
- React app routing → Configuration view: routes to (evidence: `frontend/src/App.js`)
- React app routing → Model training view: routes to (evidence: `frontend/src/App.js`)
- Email scanner → FastAPI routes: POSTs analysis (evidence: `frontend/src/pages/EmailScanner.js`)
- Email scanner → Risk score display: renders score (evidence: `frontend/src/pages/EmailScanner.js`)
- Email scanner → Trace display: renders traces (evidence: `frontend/src/pages/EmailScanner.js`)
- FastAPI routes → Input validation: validates input (evidence: `backend/server.py`)
- FastAPI routes → NLP classifier: requests score (evidence: `backend/server.py`)
- FastAPI routes → Behavior simulator: simulates behavior (evidence: `README.md`)
- FastAPI routes → Verdict decision: assigns verdict (evidence: `README.md`)
- FastAPI routes → Email and feedback store: reads and writes (evidence: `backend/server.py`)
- NLP classifier → Verdict decision: provides NLP score (evidence: `README.md`)
- Behavior simulator → Verdict decision: provides behavior trace (evidence: `README.md`)
