How ciphernet01/sentinelstack works
SentinelStack is a multi-tenant security assessment and cyber-risk platform: users manage assessments, scan authorized targets, review findings and reports, and quantify organizational risk. Its repository also contains a separate Log-Whisperer service for log ingestion, anomaly detection, and crash analysis. The graph preserves those documented branches and the risk-engine stages; several connections are omitted where the sampled files do not show runtime wiring.
Main entry points: routes.py Log analysis API · index.ts API routes · riskEngine.service.ts Risk calculation engine · public-api.routes.ts Public assessment API
Components 27
SentinelStack product
- Dashboard UI
src/app/dashboard/page.tsx - Assessment views
src/components/assessments/AssessmentListClient.tsx - Reports and analytics
src/app/dashboard/reports/page.tsx
API and identity
- API server
src/server.ts - API routes
src/routes/index.ts - Authentication
src/middleware/auth.ts - Organization management
src/controllers/org.controller.ts - Application database
src/config/db.ts - Public assessment API
src/routes/public-api.routes.ts
Assessment scanning
- Scan queue
src/services/scanQueue.service.ts - Scan worker
src/services/worker.service.ts - Scanner engine
scanners/engine/engine.py - Security scanner tools
scanners/tools - Findings and reports
src/services/findings.service.ts
Risk analysis
- Cyber-risk API
src/controllers/cyber-risk.controller.ts - Risk calculation engine
src/services/risk/riskEngine.service.ts - Evidence signals
src/services/risk/evidenceSignals.service.ts - Severity modeling
src/services/risk/severity.service.ts - Risk driver attribution
src/services/risk/driverAttribution.service.ts
Log Whisperer
- Log analysis API
log-whisperer/backend/app/api/routes.py - Log ingestion
log-whisperer/backend/app/ingest/service.py - Log data schemas
log-whisperer/backend/app/core/schemas.py - Anomaly detection
log-whisperer/backend/app/detect/anomaly.py - Enhanced analysis
log-whisperer/backend/app/enhance/integration.py - Crash report generation
log-whisperer/backend/app/report/generator.py
Other components
- Platform user
- Log operator
Connections 24
- Platform user → Dashboard UI: uses
- Dashboard UI → Assessment views: opens assessments
- Assessment views → API server: requests data
- API server → API routes: mounts routes
src/server.ts - API routes → Authentication: uses authentication
- API routes → Organization management: routes organization requests
- Authentication → Application database: loads user membership
src/middleware/auth.ts - API routes → Public assessment API: registers API routes
- Public assessment API → Application database: reads assessments and reports
src/routes/public-api.routes.ts - Public assessment API → Scan queue: queues scans
src/routes/public-api.routes.ts - Scan worker → Application database: accesses application data
src/services/worker.service.ts - Scan worker → Scan queue: processes scan work
- Scanner engine → Security scanner tools: executes tools
- Cyber-risk API → Risk calculation engine: calculates risk
- Risk calculation engine → Evidence signals: aggregates signals
src/services/risk/riskEngine.service.ts - Risk calculation engine → Severity modeling: composes severity
src/services/risk/riskEngine.service.ts - Risk calculation engine → Risk driver attribution: attributes drivers
src/services/risk/riskEngine.service.ts - Log operator → Log analysis API: uploads and queries logs
- Log analysis API → Log ingestion: ingests log files
log-whisperer/backend/app/api/routes.py - Log analysis API → Anomaly detection: queries anomalies
log-whisperer/backend/app/api/routes.py - Log analysis API → Crash report generation: queries crash reports
log-whisperer/backend/app/api/routes.py - Log analysis API → Enhanced analysis: requests causal analysis
log-whisperer/backend/app/api/routes.py - Log analysis API → Log data schemas: uses request and response models
log-whisperer/backend/app/api/routes.py - Enhanced analysis → Log data schemas: uses shared schemas
log-whisperer/backend/app/enhance/integration.py