# tarkvex/sentinel-cyber-portal architecture

> Architecture diagram of the GitHub repository tarkvex/sentinel-cyber-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tarkvex/sentinel-cyber-portal
- Repository: https://github.com/tarkvex/sentinel-cyber-portal

## Overview

SENTINEL is a cyber incident and threat-intelligence portal. Users authenticate, report and manage incidents, and consult dashboard and AI analysis features; uploaded files also pass through a separate threat-analysis and quarantine workflow. The graph combines sampled runtime wiring with major README-documented capabilities whose implementation was not sampled; those broader UI and feature relationships are shown conservatively.

Main entry points: [`src/server.js`](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/server.js) (Express server), [`pages`](https://github.com/tarkvex/sentinel-cyber-portal/tree/main/pages) (Portal pages), [`src/controllers/file.controller.js`](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/controllers/file.controller.js) (Analysis controller), [`src/middleware/auth.middleware.js`](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/middleware/auth.middleware.js) (JWT access control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Portal and API"]
  node_web["Portal pages"]
  node_server["Express server<br/>[server.js]"]
end

subgraph group_operations["Incident operations"]
  node_incidents["Incident registry<br/>[incident.routes.js]"]
  node_dashboard["Threat dashboard"]
  node_assets["Asset registry<br/>[asset.routes.js]"]
  node_map["Global threat map<br/>[threats.html]"]
  node_protocols["Response protocols<br/>[protocols.html]"]
  node_audit["Audit log<br/>[audit.html]"]
end

subgraph group_intelligence["Threat intelligence"]
  node_ai_api["AI endpoints<br/>[ai.routes.js]"]
  node_ai_service["Threat AI service<br/>[ai.service.js]"]
  node_groq["Groq AI"]
end

subgraph group_files["File analysis"]
  node_file_routes["File analysis routes<br/>[file.routes.js]"]
  node_upload["Upload handling"]
  node_file_controller["Analysis controller<br/>[file.controller.js]"]
  node_file_analysis["Threat analysis pipeline"]
  node_virustotal["VirusTotal"]
  node_quarantine[("Quarantined files")]
end

subgraph group_platform["Identity and storage"]
  node_auth["Authentication<br/>[auth.routes.js]"]
  node_jwt["JWT access control<br/>[auth.middleware.js]"]
  node_db[("PostgreSQL pool<br/>[database.js]")]
  node_logger["Analysis logging<br/>[logger.js]"]
end

node_analyst(("Portal users"))

node_analyst -->|"uses"| node_web
node_web -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_auth
node_server -->|"mounts routes"| node_incidents
node_server -->|"mounts routes"| node_dashboard
node_server -->|"mounts routes"| node_ai_api
node_server -->|"mounts routes"| node_assets
node_server -->|"mounts routes"| node_file_routes
node_incidents -->|"verifies tokens"| node_jwt
node_dashboard -->|"verifies tokens"| node_jwt
node_ai_api -->|"verifies tokens"| node_jwt
node_assets -->|"verifies tokens"| node_jwt
node_file_routes -->|"verifies tokens"| node_jwt
node_auth -->|"queries users"| node_db
node_incidents -->|"reads and writes"| node_db
node_dashboard -->|"queries metrics"| node_db
node_ai_api -->|"queries incidents"| node_db
node_incidents -->|"analyzes incidents"| node_ai_service
node_ai_api -->|"dispatches AI tasks"| node_ai_service
node_ai_service -->|"requests completions"| node_groq
node_web -.->|"includes feature"| node_map
node_web -.->|"includes feature"| node_protocols
node_web -.->|"includes feature"| node_audit
node_file_routes -->|"handles uploads"| node_upload
node_file_routes -->|"dispatches handlers"| node_file_controller
node_file_controller -->|"analyzes file"| node_file_analysis
node_file_controller -->|"stores results"| node_db
node_file_analysis -->|"checks signatures"| node_virustotal
node_file_analysis -->|"requests AI analysis"| node_ai_service
node_file_controller -->|"moves threat files"| node_quarantine
node_file_controller -->|"logs events"| node_logger
node_file_analysis -->|"logs analysis"| node_logger

click node_web "https://github.com/tarkvex/sentinel-cyber-portal/tree/main/pages"
click node_server "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/server.js"
click node_auth "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/auth.routes.js"
click node_jwt "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/middleware/auth.middleware.js"
click node_db "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/config/database.js"
click node_incidents "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/incident.routes.js"
click node_dashboard "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/dashboard.routes.js"
click node_assets "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/asset.routes.js"
click node_map "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/pages/threats.html"
click node_protocols "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/pages/protocols.html"
click node_audit "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/pages/audit.html"
click node_ai_api "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/ai.routes.js"
click node_ai_service "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/services/ai.service.js"
click node_file_routes "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/file.routes.js"
click node_upload "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/middleware/upload.middleware.js"
click node_file_controller "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/controllers/file.controller.js"
click node_file_analysis "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/services/fileAnalysis.service.js"
click node_quarantine "https://github.com/tarkvex/sentinel-cyber-portal/tree/main/uploads/quarantine"
click node_logger "https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/utils/logger.js"

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_web,node_server,node_analyst toneBlue
class node_incidents,node_dashboard,node_assets,node_map,node_protocols,node_audit toneAmber
class node_ai_api,node_ai_service,node_groq toneMint
class node_file_routes,node_upload,node_file_controller,node_file_analysis,node_virustotal,node_quarantine toneRose
class node_auth,node_jwt,node_db,node_logger toneIndigo
```

## Components

### Portal and API

- [Portal pages](https://github.com/tarkvex/sentinel-cyber-portal/tree/main/pages): `pages`
- [Express server](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/server.js): `src/server.js`

### Incident operations

- [Incident registry](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/incident.routes.js): `src/routes/incident.routes.js`
- [Threat dashboard](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/dashboard.routes.js): `src/routes/dashboard.routes.js`
- [Asset registry](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/asset.routes.js): `src/routes/asset.routes.js`
- [Global threat map](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/pages/threats.html): `pages/threats.html`
- [Response protocols](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/pages/protocols.html): `pages/protocols.html`
- [Audit log](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/pages/audit.html): `pages/audit.html`

### Threat intelligence

- [AI endpoints](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/ai.routes.js): `src/routes/ai.routes.js`
- [Threat AI service](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/services/ai.service.js): `src/services/ai.service.js`
- **Groq AI**

### File analysis

- [File analysis routes](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/file.routes.js): `src/routes/file.routes.js`
- [Upload handling](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/middleware/upload.middleware.js): `src/middleware/upload.middleware.js`
- [Analysis controller](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/controllers/file.controller.js): `src/controllers/file.controller.js`
- [Threat analysis pipeline](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/services/fileAnalysis.service.js): `src/services/fileAnalysis.service.js`
- **VirusTotal**
- [Quarantined files](https://github.com/tarkvex/sentinel-cyber-portal/tree/main/uploads/quarantine): `uploads/quarantine`

### Identity and storage

- [Authentication](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [JWT access control](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/middleware/auth.middleware.js): `src/middleware/auth.middleware.js`
- [PostgreSQL pool](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/config/database.js): `config/database.js`
- [Analysis logging](https://github.com/tarkvex/sentinel-cyber-portal/blob/main/src/utils/logger.js): `src/utils/logger.js`

### Other components

- **Portal users**

## Connections

- Portal users → Portal pages: uses (evidence: `README.md`)
- Portal pages → Express server: calls API
- Express server → Authentication: mounts routes (evidence: `src/server.js`)
- Express server → Incident registry: mounts routes (evidence: `src/server.js`)
- Express server → Threat dashboard: mounts routes (evidence: `src/server.js`)
- Express server → AI endpoints: mounts routes (evidence: `src/server.js`)
- Express server → Asset registry: mounts routes (evidence: `src/server.js`)
- Express server → File analysis routes: mounts routes (evidence: `src/server.js`)
- Incident registry → JWT access control: verifies tokens (evidence: `src/routes/incident.routes.js`)
- Threat dashboard → JWT access control: verifies tokens (evidence: `src/routes/dashboard.routes.js`)
- AI endpoints → JWT access control: verifies tokens (evidence: `src/routes/ai.routes.js`)
- Asset registry → JWT access control: verifies tokens (evidence: `src/routes/asset.routes.js`)
- File analysis routes → JWT access control: verifies tokens (evidence: `src/routes/file.routes.js`)
- Authentication → PostgreSQL pool: queries users (evidence: `src/routes/auth.routes.js`)
- Incident registry → PostgreSQL pool: reads and writes (evidence: `src/routes/incident.routes.js`)
- Threat dashboard → PostgreSQL pool: queries metrics (evidence: `src/routes/dashboard.routes.js`)
- AI endpoints → PostgreSQL pool: queries incidents (evidence: `src/routes/ai.routes.js`)
- Incident registry → Threat AI service: analyzes incidents (evidence: `src/routes/incident.routes.js`)
- AI endpoints → Threat AI service: dispatches AI tasks (evidence: `src/routes/ai.routes.js`)
- Threat AI service → Groq AI: requests completions (evidence: `src/services/ai.service.js`)
- Portal pages → Global threat map: includes feature (evidence: `README.md`)
- Portal pages → Response protocols: includes feature (evidence: `README.md`)
- Portal pages → Audit log: includes feature (evidence: `README.md`)
- File analysis routes → Upload handling: handles uploads (evidence: `src/routes/file.routes.js`)
- File analysis routes → Analysis controller: dispatches handlers (evidence: `src/routes/file.routes.js`)
- Analysis controller → Threat analysis pipeline: analyzes file (evidence: `src/controllers/file.controller.js`)
- Analysis controller → PostgreSQL pool: stores results (evidence: `src/controllers/file.controller.js`)
- Threat analysis pipeline → VirusTotal: checks signatures (evidence: `src/services/fileAnalysis.service.js`)
- Threat analysis pipeline → Threat AI service: requests AI analysis (evidence: `src/services/fileAnalysis.service.js`)
- Analysis controller → Quarantined files: moves threat files (evidence: `src/controllers/file.controller.js`)
- Analysis controller → Analysis logging: logs events (evidence: `src/controllers/file.controller.js`)
- Threat analysis pipeline → Analysis logging: logs analysis (evidence: `src/services/fileAnalysis.service.js`)
