How parv-065040/racepulse works
RACEPULSE simulates and publishes race-domain events, validates and analyzes Kafka streams, then persists KPIs and emits alerts for Grafana-oriented operations and commercial dashboards. The graph emphasizes the sampled performance and windowed paths; broader event domains and dashboard capabilities are documented in the README, but their wiring is not fully evidenced in the excerpts.
Main entry points: timing_consumer.py Performance Consumer · windowed_consumer.py Windowed Consumer · simulator.py Race Simulator · alert_engine.py Alert Engine
Components 24
Race Generation
- Race Simulator
simulator/simulator.py - Race State
simulator/state.py - Race Scenarios
simulator/scenario.py - Domain Producers
producers
Event Streaming
- Kafka Topics
- Performance Consumer
consumers/performance/timing_consumer.py - Windowed Consumer
consumers/windowed/windowed_consumer.py - Commercial Consumer
consumers/commercial/commercial_consumer.py - Race Control Consumer
consumers/race_control/race_control_consumer.py - Strategy Consumer
consumers/strategy/strategy_consumer.py
Validation & Analytics
- Validation Gate
engine/validation/gate.py - Live Configuration
engine/config/loader.py - Performance Formulas
engine/formulas - Window Analytics
engine/windows - Severity Rules
engine/rules/severity_rules.py
Persistence & Alerts
- MySQL
- KPI Writer
database/writer.py - Alert Engine
engine/alerts/alert_engine.py - Dead Letter Queue
engine/validation/dlq.py - Stream Health Monitor
engine/alerts/stale_stream_monitor.py
Decision Support
- Grafana Dashboards
tools/dashboard_builder
Other components
- Race Operator
- Race Team
- Commercial Users
Connections 28
- Race Operator → Race Simulator: selects scenario
- Race Simulator → Race Scenarios: applies scenarios
simulator/simulator.py - Race Simulator → Race State: advances race state
simulator/simulator.py - Domain Producers → Race Simulator: generate from
producers/fans/producer.py - Domain Producers → Kafka Topics: publish events
- Kafka Topics → Performance Consumer: timing events
- Kafka Topics → Windowed Consumer: telemetry events
consumers/windowed/windowed_consumer.py - Kafka Topics → Commercial Consumer: business events
- Kafka Topics → Race Control Consumer: incident events
- Kafka Topics → Strategy Consumer: race events
- Performance Consumer → Validation Gate: validates via
consumers/performance/timing_consumer.py - Windowed Consumer → Validation Gate: validates via
consumers/windowed/windowed_consumer.py - Validation Gate → Dead Letter Queue: routes rejects
engine/validation/gate.py - Performance Consumer → Live Configuration: starts watcher
consumers/performance/timing_consumer.py - Performance Consumer → Performance Formulas: computes KPIs
consumers/performance/timing_consumer.py - Performance Consumer → KPI Writer: persists results
consumers/performance/timing_consumer.py - Performance Consumer → Alert Engine: raises alerts
consumers/performance/timing_consumer.py - Performance Consumer → Stream Health Monitor: checks stale cars
consumers/performance/timing_consumer.py - Windowed Consumer → Window Analytics: accumulates windows
consumers/windowed/windowed_consumer.py - Windowed Consumer → Performance Formulas: computes average
consumers/windowed/windowed_consumer.py - Windowed Consumer → KPI Writer: saves window KPI
consumers/windowed/windowed_consumer.py - Performance Formulas → Severity Rules: classifies results
engine/formulas/gap_trend.py - KPI Writer → MySQL: writes KPI rows
database/writer.py - Alert Engine → Kafka Topics: publishes alerts
engine/alerts/alert_engine.py - Alert Engine → MySQL: stores alerts
engine/alerts/alert_engine.py - MySQL → Grafana Dashboards: dashboard queries
- Grafana Dashboards → Race Team: presents decisions
- Grafana Dashboards → Commercial Users: presents metrics