How argonyx-26/t12-gryffindor works
Sentinel fuses CCTV vision, physical-access and cyber-authentication observations into explainable incidents, persists event and incident state, then streams alerts to a tactical dashboard. Producers send normalized events to FastAPI; temporal correlation and contextual scoring produce and update incidents, while PostgreSQL and Redis support persistence and live fan-out. The README documents the broad pipeline; sampled source confirms selected calls and dashboard composition, but does not expose every ingestion, persistence or broadcast call, so those documented links cite the README.
Main entry points: main.py Ingest and incident API · App.jsx Dashboard application · database.py PostgreSQL access · common.py Event producer helper
Components 26
Event sources
- Vision worker
ai/vision_worker.py - Video analytics
backend/video_engine.py - Physical sensors
simulators/sensor_sim.py - Cyber events
simulators/syslog_sim.py - Event producer helper
simulators/common.py
Ingestion and intelligence
- Event and incident schema
backend/models.py - Ingest and incident API
backend/main.py - Temporal analytics
backend/temporal_engine.py - Threat scoring
backend/scoring_engine.py - CCTV adapter
backend/cctv_adapter.py - Zone configuration
backend/location_config.py
State and telemetry
- Runtime configuration
backend/config.py - PostgreSQL access
backend/database.py - Persistence models
backend/db_models.py - Redis state and pub/sub
backend/redis_client.py - Latency collection
backend/latency_collector.py
Tactical dashboard
- Dashboard application
frontend/src/App.jsx - Alert WebSocket hook
frontend/src/hooks/useAlertSocket.js - Live alert feed
frontend/src/components/LiveAlertFeed.jsx - Alert details
frontend/src/components/AlertCard.jsx - Evidence drawer
frontend/src/components/EvidenceDrawer.jsx - Threat map
frontend/src/components/MapPanel.jsx - Operations header
frontend/src/components/Header.jsx
Other components
- Security operator
- PostgreSQL
- Redis
Connections 28
- Vision worker → Ingest and incident API: posts events
README.md - Video analytics → Event and incident schema: creates events
backend/video_engine.py - Physical sensors → Event producer helper: builds events
simulators/sensor_sim.py - Cyber events → Event producer helper: builds events
simulators/syslog_sim.py - Event producer helper → Ingest and incident API: posts events
simulators/common.py - Ingest and incident API → Event and incident schema: validates events
README.md - Ingest and incident API → Temporal analytics: correlates events
backend/main.py - Ingest and incident API → Threat scoring: scores threats
backend/main.py - Threat scoring → Temporal analytics: uses patterns
backend/scoring_engine.py - Ingest and incident API → PostgreSQL access: persists records
README.md - PostgreSQL access → Persistence models: maps records
backend/database.py - PostgreSQL access → PostgreSQL: reads and writes
README.md - Temporal analytics → Persistence models: loads baselines
backend/temporal_engine.py - Ingest and incident API → Redis state and pub/sub: caches and publishes
README.md - Redis state and pub/sub → Redis: uses cache
backend/redis_client.py - Ingest and incident API → Latency collection: records timings
README.md - Video analytics → Latency collection: records timings
backend/video_engine.py - Ingest and incident API → Zone configuration: uses zone context
backend/main.py - Ingest and incident API → Runtime configuration: loads settings
backend/main.py - Dashboard application → Alert WebSocket hook: subscribes to alerts
frontend/src/App.jsx - Alert WebSocket hook → Ingest and incident API: receives alert stream
README.md - Ingest and incident API → Redis state and pub/sub: fans out alerts
README.md - Dashboard application → Live alert feed: renders feed
frontend/src/App.jsx - Live alert feed → Alert details: renders alerts
frontend/src/components/LiveAlertFeed.jsx - Dashboard application → Evidence drawer: renders evidence
frontend/src/App.jsx - Dashboard application → Threat map: renders map
frontend/src/App.jsx - Dashboard application → Operations header: renders header
frontend/src/App.jsx - Security operator → Dashboard application: reviews alerts