How amay-xd/breachalpha works
BreachAlpha is a cyber-risk intelligence product that turns a company or breach search into a market-impact report. The main workflow runs from the dashboard through the REST client to Flask, which looks up breach data, obtains company and benchmark prices, calculates correlation and recovery metrics, and returns AI commentary and an executive risk score. Separate branches support historical and sector analysis and PDF reporting. The README documents the wider API and dashboard capabilities; some backend routes and PDF wiring were not shown in the excerpts, so uncertain links are omitted or marked unverified.
Main entry points: app.py Flask API · App.tsx Search Dashboard · api.ts REST Client · stock_collector.py Price Collector
Components 18
Dashboard
- Search Dashboard
frontend/src/App.tsx - Dashboard Layout
frontend/src/ui.tsx - Pattern Charts
frontend/src/charts.tsx - REST Client
frontend/src/api.ts
Analysis API
- Flask API
backend/app.py
Breach Data
- Breach Search
data/breach_lookup.py - Breach Dataset
data/breaches.json
Market Analysis
- Price Collector
collectors/stock_collector.py - Alpha Vantage
- Synthetic Prices
collectors/stock_collector.py - S&P 500 Prices
- Correlation Metrics
collectors/correlations.py
Intelligence Output
- AI Analysis
ai_engine/mistral_analysis.py - Mistral AI
- Executive Risk Score
backend/app.py - PDF Reports
output/pdf.py - Market Report
backend/app.py
Other components
- Researcher
Connections 19
- Researcher → Search Dashboard: searches
- Search Dashboard → REST Client: requests analysis
frontend/src/App.tsx - Search Dashboard → Dashboard Layout: renders layout
frontend/src/App.tsx - Search Dashboard → Pattern Charts: renders patterns
frontend/src/App.tsx - Dashboard Layout → REST Client: checks health
frontend/src/ui.tsx - REST Client → Flask API: calls REST API
README.md - Flask API → Breach Search: finds breach
backend/app.py - Breach Search → Breach Dataset: loads records
data/breach_lookup.py - Flask API → Price Collector: gets prices
backend/app.py - Price Collector → Alpha Vantage: fetches prices
collectors/stock_collector.py - Price Collector → Synthetic Prices: falls back
collectors/stock_collector.py - Flask API → S&P 500 Prices: compares benchmark
README.md - Flask API → Correlation Metrics: calculates metrics
backend/app.py - Flask API → AI Analysis: requests analysis
backend/app.py - AI Analysis → Mistral AI: generates commentary
ai_engine/mistral_analysis.py - Flask API → Executive Risk Score: scores risk
backend/app.py - Flask API → Market Report: returns analysis
README.md - Flask API → PDF Reports: exports report
backend/app.py - REST Client → Pattern Charts: provides patterns
frontend/src/charts.tsx