How krrishvardhan/mailtraceai works
mailTraceAI accepts raw .eml uploads, computes forensic and authentication signals, enriches probable origin IPs, runs ML classification and a Groq verdict, then returns and persists a case for dashboard review. The principal orchestration is explicit in the analysis route; dashboard visualization and history capabilities are documented, though some frontend wiring and implementation details were not excerpted. External service relationships reflect README documentation.
Main entry points: email_routes.py Analysis and cases · App.tsx Analysis dashboard · database.py Database access · api.ts API client
Components 17
Investigation dashboard
- Analysis dashboard
frontend/src/App.tsx - API client
frontend/src/lib/api.ts - Relay timeline
frontend/src/components/RelayChainTimeline.tsx - Origin map
frontend/src/components/IpLocationMap.tsx - Risk charts
frontend/src/components/charts
API orchestration
- FastAPI app
backend/main.py - Analysis and cases
backend/email_routes.py
Email evidence
- Header forensics
backend/email_forensics.py - Origin assessment
backend/geolocation.py
Risk assessment
- Feature extraction
backend/ml/feature_engineering.py - Phishing classifier
backend/phishing_classifier.py - LLM verdict
backend/llm_verdict.py
Case persistence
- Database access
backend/db/database.py - Postgres case store
Other components
- Investigator
- IP geolocation
- Groq API
Connections 19
- Investigator → Analysis dashboard: uploads email
README.md - Analysis dashboard → API client: requests analysis
- API client → FastAPI app: sends request
- FastAPI app → Analysis and cases: routes requests
backend/main.py - Analysis and cases → Database access: checks cache
backend/email_routes.py - Analysis and cases → Header forensics: parses and analyzes
backend/email_routes.py - Analysis and cases → Origin assessment: assesses origin
backend/email_routes.py - Analysis and cases → IP geolocation: geolocates IPs
README.md - Analysis and cases → Phishing classifier: classifies email
backend/email_routes.py - Phishing classifier → Feature extraction: extracts features
backend/phishing_classifier.py - Analysis and cases → LLM verdict: requests verdict
backend/email_routes.py - LLM verdict → Groq API: requests synthesis
backend/llm_verdict.py - Analysis and cases → Database access: stores analysis
backend/email_routes.py - Analysis and cases → Database access: lists or retrieves cases
backend/email_routes.py - Database access → Postgres case store: reads and writes
README.md - Analysis and cases → Analysis dashboard: returns result
- Analysis dashboard → Relay timeline: renders relay hops
- Analysis dashboard → Origin map: renders origin map
- Analysis dashboard → Risk charts: renders risk evidence