Real-time threat interception across Nigerian telecom networks. Protecting millions — silently, automatically, continuously.
# NaijaShield
**Real-time fraud intelligence platform for Nigerian telecom networks.**
NaijaShield intercepts, classifies, and scores SMS and voice threats across Nigerian carriers — protecting end users, supporting regulatory compliance, and exposing fraud patterns through a live operations dashboard.
---
## Overview
NaijaShield is a **B2B2C platform** built for telecom operators and financial institutions. It exposes a full internal operations surface for SOC analysts and compliance officers, alongside a public-facing number reputation tool that any Nigerian — or any bank app — can query before engaging with an unknown number.
```
Telecom intercept → AI classification → Risk scoring → SOC dashboard
→ Public reputation API
→ Compliance reports (CBN / NCC)
```
---
## Tech Stack
| Layer | Technology |
|-------|-----------|
| Framework | Next.js 16.2.4 (App Router) |
| Language | TypeScript 5 |
| UI | Tailwind CSS v4, shadcn/ui, Radix UI |
| Charts | Chart.js 4 + react-chartjs-2 |
| Maps | react-simple-maps (Nigeria choropleth) |
| Data fetching | SWR 2 |
| State | React 19 + Zustand |
| PDF generation | jsPDF + jsPDF-AutoTable |
| Auth | JWT (access + refresh tokens), cookie-based RBAC |
| Backend | REST API (Azure App Service — .NET / Kestrel) |
---
## Features
### Internal Dashboard (authenticated)
| Route | Roles | Description |
|-------|-------|-------------|
| `/overview` | All | Command Centre — KPI cards, Threat Velocity chart (Chart.js), live incident table, Nigeria threat heatmap |
| `/threat-feed` | SOC Analyst, Admin | Paginated incident table with search, detail panel with AI explanation and deepfake score |
| `/compliance` | Compliance Officer, Admin | Stats, channel breakdown, classification table, PDF report generator (CBN / NCC / General) |
| `/user-management` | Admin | Invite users, view roles and activity, remove users |
| `/lookup` | All | Internal number reputation search with score ring, breakdown bars, and incident history |
| `/set …