How pavankumarreddy999/cyberpitch-fifa works
CyberPitch FIFA detects and monitors domains impersonating FIFA and World Cup brands. Users submit a domain through the dashboard; the backend validates and scans it, gathers threat-intelligence signals, scores and explains risk, and persists the result for history and dashboard views. Separate capabilities cover authentication, alerts, campaign analytics, recommendations, and scheduled domain discovery. README documentation describes concurrent OSINT collection, visual similarity, two-stage ML, and seven-day caching; unsampled implementation details are represented only where documented, so some links are dashed.
Main entry points: aggregator_service.py Scan Aggregator · scan.py Scan API · auth.py Authentication API · dashboard.ts Dashboard API
Components 24
Dashboard
- Threat Dashboard
src/app/dashboard/page.tsx - Domain Scan UI
src/app/dashboard/scan/page.tsx - Analyze Proxy
src/app/api/analyze/route.ts - Threat Views
src/app/dashboard/alerts/page.tsx - Dashboard API
src/services/api/dashboard.ts
API and Accounts
- Scan API
backend/app/api/scan.py - Authentication API
backend/app/api/auth.py - Password and JWT
backend/app/utils/auth.py
Intelligence and Scoring
- Scan Aggregator
backend/app/services/aggregator_service.py - WHOIS and RDAP
backend/app/services/whois_service.py - DNS Intelligence
backend/app/services/dns_service.py - Certificate Inspection
backend/app/services/ssl_service.py - Page Analysis
backend/app/services/html_service.py - Blacklist Check
backend/app/services/threat_service.py - ASN Lookup
backend/app/services/asn_service.py - Visual Similarity
backend/app/services/visual_service.py - Risk Models
backend/app/services/ml_service.py
Persistence
- Smart Cache
backend/app/services/cache_service.py - Scan History
backend/app/models/scan_history.py - User Records
backend/app/models/user.py - SQLite Access
backend/app/database/database.py
Domain Discovery
- 12-hour Scheduler
backend/app/main.py - Domain Discovery
backend/scripts/domain_discovery.py
Other components
- Analyst
Connections 24
- Analyst → Domain Scan UI: submits domain
- Domain Scan UI → Analyze Proxy: requests analysis
- Analyze Proxy → Scan API: forwards request
- Scan API → Scan Aggregator: collects signals
backend/app/api/scan.py - Scan Aggregator → WHOIS and RDAP: queries
backend/app/services/aggregator_service.py - Scan Aggregator → DNS Intelligence: queries
backend/app/services/aggregator_service.py - Scan Aggregator → Certificate Inspection: queries
backend/app/services/aggregator_service.py - Scan Aggregator → Page Analysis: analyzes pages
backend/app/services/aggregator_service.py - Scan Aggregator → Blacklist Check: checks blacklist
backend/app/services/aggregator_service.py - Scan Aggregator → ASN Lookup: looks up ASN
backend/app/services/aggregator_service.py - Scan Aggregator → Visual Similarity: checks similarity
backend/app/services/aggregator_service.py - Scan API → Risk Models: scores features
backend/app/api/scan.py - Scan API → Scan History: stores scans
backend/app/api/scan.py - Scan API → SQLite Access: uses sessions
backend/app/api/scan.py - Scan Aggregator → Smart Cache: reads and writes
backend/app/services/aggregator_service.py - Smart Cache → SQLite Access: persists cache
- Threat Dashboard → Dashboard API: loads metrics
- Threat Views → Dashboard API: loads threat data
- Dashboard API → Scan API: requests dashboard data
- Analyst → Authentication API: signs in
- Authentication API → Password and JWT: hashes and tokens
backend/app/api/auth.py - Authentication API → User Records: reads and writes
backend/app/api/auth.py - Authentication API → SQLite Access: uses sessions
backend/app/api/auth.py - 12-hour Scheduler → Domain Discovery: schedules
backend/app/main.py