How tarkvex/sentinel-cyber-portal works
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: server.js Express server · pages Portal pages · file.controller.js Analysis controller · auth.middleware.js JWT access control
Components 22
Portal and API
- Portal pages
pages - Express server
src/server.js
Incident operations
- Incident registry
src/routes/incident.routes.js - Threat dashboard
src/routes/dashboard.routes.js - Asset registry
src/routes/asset.routes.js - Global threat map
pages/threats.html - Response protocols
pages/protocols.html - Audit log
pages/audit.html
Threat intelligence
- AI endpoints
src/routes/ai.routes.js - Threat AI service
src/services/ai.service.js - Groq AI
File analysis
- File analysis routes
src/routes/file.routes.js - Upload handling
src/middleware/upload.middleware.js - Analysis controller
src/controllers/file.controller.js - Threat analysis pipeline
src/services/fileAnalysis.service.js - VirusTotal
- Quarantined files
uploads/quarantine
Identity and storage
- Authentication
src/routes/auth.routes.js - JWT access control
src/middleware/auth.middleware.js - PostgreSQL pool
config/database.js - Analysis logging
src/utils/logger.js
Other components
- Portal users
Connections 32
- Portal users → Portal pages: uses
README.md - Portal pages → Express server: calls API
- Express server → Authentication: mounts routes
src/server.js - Express server → Incident registry: mounts routes
src/server.js - Express server → Threat dashboard: mounts routes
src/server.js - Express server → AI endpoints: mounts routes
src/server.js - Express server → Asset registry: mounts routes
src/server.js - Express server → File analysis routes: mounts routes
src/server.js - Incident registry → JWT access control: verifies tokens
src/routes/incident.routes.js - Threat dashboard → JWT access control: verifies tokens
src/routes/dashboard.routes.js - AI endpoints → JWT access control: verifies tokens
src/routes/ai.routes.js - Asset registry → JWT access control: verifies tokens
src/routes/asset.routes.js - File analysis routes → JWT access control: verifies tokens
src/routes/file.routes.js - Authentication → PostgreSQL pool: queries users
src/routes/auth.routes.js - Incident registry → PostgreSQL pool: reads and writes
src/routes/incident.routes.js - Threat dashboard → PostgreSQL pool: queries metrics
src/routes/dashboard.routes.js - AI endpoints → PostgreSQL pool: queries incidents
src/routes/ai.routes.js - Incident registry → Threat AI service: analyzes incidents
src/routes/incident.routes.js - AI endpoints → Threat AI service: dispatches AI tasks
src/routes/ai.routes.js - Threat AI service → Groq AI: requests completions
src/services/ai.service.js - Portal pages → Global threat map: includes feature
README.md - Portal pages → Response protocols: includes feature
README.md - Portal pages → Audit log: includes feature
README.md - File analysis routes → Upload handling: handles uploads
src/routes/file.routes.js - File analysis routes → Analysis controller: dispatches handlers
src/routes/file.routes.js - Analysis controller → Threat analysis pipeline: analyzes file
src/controllers/file.controller.js - Analysis controller → PostgreSQL pool: stores results
src/controllers/file.controller.js - Threat analysis pipeline → VirusTotal: checks signatures
src/services/fileAnalysis.service.js - Threat analysis pipeline → Threat AI service: requests AI analysis
src/services/fileAnalysis.service.js - Analysis controller → Quarantined files: moves threat files
src/controllers/file.controller.js - Analysis controller → Analysis logging: logs events
src/controllers/file.controller.js - Threat analysis pipeline → Analysis logging: logs analysis
src/services/fileAnalysis.service.js