fraud detection platform
# π‘ SimGuard Kenya β SIM Fraud Detection & Alert Platform
A professional anti-fraud command centre for detecting, blocking, and reporting fraudulent SIM card registrations and stolen National ID usage across Kenya.
## π Features
### Real-Time Monitoring
- **Live Registration Feed** β Every SIM registration attempt streamed in real time with risk classification
- **Live Alert Ticker** β Scrolling ticker of active fraud events across the platform
- **KPI Dashboard** β Active threats, flagged registrations, blocked attempts, and protected IDs
### Fraud Detection
- **ID Theft Detection** β Flags when a National ID is used to register a SIM without owner consent
- **SIM Swap Fraud** β Detects and blocks unauthorized SIM swap requests
- **Multi-County Registration** β Flags physically impossible same-day registrations across counties
- **Agent-Level Fraud** β Monitors agent registration velocity and patterns
### π Nearby Agent Locator
- Interactive map showing all Safaricom agents near your location
- Color-coded pins: **green** (verified), **amber** (under watch), **red** (flagged/suspended)
- One-click **"Report Incident Here"** button per agent
- Flagged agents clearly marked with suspension status
### ID Watch (Owner Alerts)
- Enroll your National ID for monitoring across all Kenyan telecom operators
- Instant SMS + push alert when your ID is used to register any SIM
- Lock modes: Alert Only / OTP Approval Required / Full Block
- Covers: Safaricom, Airtel Kenya, Telkom Kenya
### Reporting System
- Submit stolen SIM / fraudulent ID use reports
- Auto-block on submission
- Case ID assigned and tracked
- CA Kenya notified on high-risk cases
### Blacklist Management
- Block National IDs, SIM numbers, and agents
- Reasons: Stolen ID, Confirmed Fraud, Court Order, CA Kenya Directive
- Shared flag across all operators
## π Project Structure
```
simguard-kenya/
βββ index.html # Main dashboard (single-file app)
βββ README.md # This file
```
## π Tech β¦