How siddheshg01/anomaly-sentinel works
Anomaly Sentinel monitors Excel business metrics through a command-line run or an interactive dashboard. Both entry points load and analyze metrics; the command-line workflow additionally gates email alerts by risk and writes alert logs and anomaly reports. The dashboard supports uploaded workbooks, visualizes trends, and presents insights and investigation recommendations. The source excerpts show the principal calls and file outputs; the README also documents the monitoring capabilities. The dashboard’s direct upload parsing and the AI/email external integrations are represented separately.
Main entry points: main.py Monitor Runner · dashboard.py Monitoring Dashboard · data_loader.py Excel Data Loader · ai_summarizer.py AI Summary
Components 14
User Interfaces
- Monitor Runner
src/main.py - Monitoring Dashboard
dashboard.py
Metric Analysis
- Monitoring Settings
config.py - Excel Data Loader
src/data_loader.py - Business Workbook
data/business_data.xlsx - Anomaly Analysis
src/anomaly_detector.py
Business Interpretation
- Business Insights
src/business_rules.py - AI Summary
src/ai_summarizer.py
Alerts and Outputs
- Email Alert Sender
src/email_alert.py - Alert Log
logs - Anomaly CSV Report
reports/anomaly_report.csv
Other components
- Analyst
- OpenAI API
- SMTP Service
Connections 18
- Analyst → Monitoring Dashboard: uploads or views
dashboard.py - Monitor Runner → Excel Data Loader: loads data
src/main.py - Monitoring Dashboard → Excel Data Loader: loads sample
dashboard.py - Excel Data Loader → Business Workbook: reads workbook
src/data_loader.py - Monitoring Dashboard → Business Workbook: parses upload
dashboard.py - Monitor Runner → Monitoring Settings: uses settings
src/main.py - Monitoring Dashboard → Monitoring Settings: uses settings
dashboard.py - Monitor Runner → Anomaly Analysis: analyzes metrics
src/main.py - Monitoring Dashboard → Anomaly Analysis: analyzes metrics
dashboard.py - Monitor Runner → Business Insights: generates insights
src/main.py - Monitoring Dashboard → Business Insights: generates insights
dashboard.py - Monitor Runner → AI Summary: generates summary
src/main.py - Monitoring Dashboard → AI Summary: generates summary
dashboard.py - AI Summary → OpenAI API: requests summary
src/ai_summarizer.py - Monitor Runner → Email Alert Sender: sends on threshold
src/main.py - Email Alert Sender → SMTP Service: sends message
src/email_alert.py - Monitor Runner → Alert Log: appends sent alert
src/main.py - Monitor Runner → Anomaly CSV Report: writes anomalies
src/main.py