How mantraak/ai-powered-soc-incident-generation-and-investigation-platform works
Romulus is a SOC incident-generation and analyst-training platform. Administrators create scenarios manually or from threat intelligence; the backend generates investigation material, which players investigate and submit for evaluation. A parallel daily threat-feed workflow turns ranked threats into labs. The graph also includes collaboration, AI assistance, MITRE ATT&CK, and SOC-tool integration capabilities documented in the README. Some backend services and endpoints were not sampled, so only documented or indexed relationships are shown.
Main entry points: api.py REST API · pipeline.py Threat pipeline · generator_service.py Scenario generation · App.tsx Web application
Components 24
User experience
- Web application
frontend/src/App.tsx - Role-based access
frontend/src/store/authContext.tsx
Scenario authoring
- Scenario portal
frontend/src/pages/admin/ScenarioPages.tsx - Scenario generation
backend/app/services/generator_service.py - AI provider
backend/app/services/ai_provider.py - MITRE ATT&CK
backend/app/services/mitre_service.py
SOC investigation
- Investigation portal
frontend/src/pages/player/LabInvestigationPage.tsx - Answer evaluation
backend/app/evaluators/answer_evaluator.py - Collaborative labs
backend/app/api/v1/endpoints/lab_groups.py - AI assistant
backend/app/services/assistant_service.py - SOC tool integrations
backend/app/integrations/tool_registry.py
Threat intelligence
- Threat feed
backend/app/services/news_service.py - Pipeline controls
frontend/src/pages/admin/ThreatPipelinePage.tsx - Threat pipeline
backend/app/services/threat_intel/pipeline.py - Threat normalization
backend/app/services/threat_intel/normalizer.py - Threat lab creation
backend/app/services/threat_intel/lab_creator.py
Backend platform
- Scenario records
backend/app/models/scenario.py - REST API
backend/app/api/v1/api.py - Application database
backend/app/db/session.py - Platform configuration
backend/app/core/config.py
Other components
- Administrator
- Player analyst
- External SOC tools
- Newsdata.io
Connections 25
- Administrator → Web application: uses
- Player analyst → Web application: investigates in
- Web application → Role-based access: provides routes
frontend/src/App.tsx - Web application → Scenario portal: routes to
frontend/src/App.tsx - Scenario portal → REST API: submits scenarios
frontend/src/pages/admin/ScenarioPages.tsx - REST API → Scenario generation: routes scenario requests
- Scenario generation → AI provider: requests generation
backend/app/services/generator_service.py - Scenario generation → MITRE ATT&CK: validates techniques
backend/app/services/generator_service.py - Scenario generation → Scenario records: creates scenario data
backend/app/services/generator_service.py - Investigation portal → REST API: loads investigation
frontend/src/pages/player/LabInvestigationPage.tsx - REST API → Answer evaluation: routes answers
- Player analyst → Collaborative labs: collaborates in labs
- Investigation portal → SOC tool integrations: opens SOC tools
- SOC tool integrations → External SOC tools: integrates tools
- Administrator → Pipeline controls: manages runs
- Pipeline controls → REST API: requests pipeline data
frontend/src/pages/admin/ThreatPipelinePage.tsx - REST API → Threat pipeline: triggers pipeline
- Threat pipeline → Threat normalization: normalizes articles
backend/app/services/threat_intel/pipeline.py - Threat pipeline → Threat lab creation: creates threat labs
backend/app/services/threat_intel/pipeline.py - Threat pipeline → Newsdata.io: collects threat articles
- Threat pipeline → Scenario records: records generated labs
backend/app/services/threat_intel/pipeline.py - REST API → Application database: serves persisted data
- REST API → AI assistant: routes assistant requests
- Platform configuration → External SOC tools: configures endpoints
backend/app/core/config.py - Administrator → MITRE ATT&CK: selects techniques