How 25a31a05gb/tracexmail works
TraceX is an email-forensics and threat-triage application: analysts ingest an email or connect Gmail, receive a normalized analysis with threat and network context, then investigate cases, alerts, and evidence in the workspace. The map shows the client-to-server analysis path, plus major documented UI and service capabilities. Several backend and workspace relationships rely on the SOURCE INDEX rather than complete excerpts; uncertain links are omitted or marked dashed.
Main entry points: server.ts API & Ingestion · api.ts Analysis API · App.tsx Workspace Shell · GmailConnectionView.tsx Gmail Connection
Components 25
Analyst Workspace
- Workspace Shell
src/App.tsx - Email Ingestion
src/components/IngestionPipelineView.tsx - Gmail Connection
src/components/GmailConnectionView.tsx - Cases & Investigation
src/components/CasesView.tsx - Alerts & Timeline
src/components/AlertsView.tsx
Email Analysis
- Analysis API
src/lib/api.ts - Email Parser
src/utils/parser.ts - Threat Classifier
src/server/classifier.ts - Analysis Model
src/types.ts - API & Ingestion
server.ts
Threat Intelligence
- Network Intelligence
src/server/intelligence/index.ts - Domain Intelligence
src/server/domainService.ts - RDAP Lookup
src/server/intelligence/rdap.ts - Threat Correlation
src/server/correlationEngine.ts
SOC Operations
- Gmail Service
src/server/gmailService.ts - Gmail Pub/Sub
src/services/gmailPubSub.ts - Audit & Compliance
src/server/compliance.ts - Live Threat Feed
src/server/realWorldThreatService.ts - Realtime Alerts
src/hooks/useWebSocketAlerts.ts
Identity & Platform
- Authentication Routes
src/server/authRoutes.ts - User Profiles
src/server/userProfileStore.ts - Organization Users
src/server/orgUserStore.ts - Supabase Store
src/server/supabase.ts - Client Supabase
src/lib/supabase.ts
Other components
- Analyst
Connections 31
- Analyst → Workspace Shell: uses workspace
src/App.tsx - Workspace Shell → Email Ingestion: routes to
src/App.tsx - Analyst → Gmail Connection: connects inbox
- Email Ingestion → Analysis API: submits email
src/components/IngestionPipelineView.tsx - Email Ingestion → Email Parser: parses fallback
src/components/IngestionPipelineView.tsx - Analysis API → Client Supabase: uses credentials
src/lib/api.ts - Analysis API → API & Ingestion: calls API
- API & Ingestion → Threat Classifier: dispatches analysis
server.ts - API & Ingestion → Network Intelligence: queries intelligence
server.ts - API & Ingestion → Email Parser: uses decoding helpers
server.ts - Network Intelligence → RDAP Lookup: dispatches lookup
src/server/intelligence/index.ts - API & Ingestion → Domain Intelligence: queries domains
server.ts - Domain Intelligence → RDAP Lookup: uses lookup
src/server/domainService.ts - API & Ingestion → Live Threat Feed: fetches feed
server.ts - Gmail Connection → Analysis API: uses API client
src/components/GmailConnectionView.tsx - Gmail Connection → Email Parser: parses messages
src/components/GmailConnectionView.tsx - Gmail Connection → Gmail Pub/Sub: uses subscription
src/components/GmailConnectionView.tsx - Gmail Pub/Sub → Analysis API: calls API
src/services/gmailPubSub.ts - API & Ingestion → Gmail Service: fetches Gmail mail
server.ts - Workspace Shell → Cases & Investigation: presents cases
src/App.tsx - Workspace Shell → Alerts & Timeline: presents alerts
src/App.tsx - Alerts & Timeline → Realtime Alerts: subscribes alerts
- Realtime Alerts → Client Supabase: streams changes
src/hooks/useWebSocketAlerts.ts - API & Ingestion → Audit & Compliance: loads privacy config
server.ts - Authentication Routes → Audit & Compliance: audits actions
src/server/authRoutes.ts - Authentication Routes → User Profiles: saves profiles
src/server/authRoutes.ts - Authentication Routes → Organization Users: manages org users
src/server/authRoutes.ts - Audit & Compliance → User Profiles: resolves profiles
src/server/compliance.ts - Audit & Compliance → Supabase Store: persists compliance data
src/server/compliance.ts - User Profiles → Supabase Store: uses database
src/server/userProfileStore.ts - Organization Users → Supabase Store: uses database
src/server/orgUserStore.ts