# ThreatWatch Nigeria π³π¬
### Real-Time Security Incident Reporting & Monitoring Platform
---
## Overview
ThreatWatch Nigeria is a civic-tech platform for tracking and reporting security incidents across all 36 states and the FCT. It provides public incident feeds, an interactive heatmap, user reporting, comment moderation, emergency helplines, and a full admin panel.
---
## Tech Stack
| Layer | Technology |
|-------------|-------------------------------------|
| Backend | Laravel 11 Β· PHP 8.3+ |
| Database | MySQL 8.0+ |
| Frontend | Blade Templates Β· TailwindCSS (CDN) |
| Interactivity | Alpine.js v3 |
| Maps | Leaflet.js Β· OpenStreetMap |
| Heatmap | leaflet-heat plugin |
| Charts | Chart.js v4 |
---
## Features
### Public
- π Homepage with live stats, recent incidents, heatmap preview
- π Incident listing with filters (state, type, severity, date, search)
- π Incident detail pages with comments, map pin, related incidents
- πΊοΈ Interactive heatmap with filter panel (heatmap + marker modes)
- π Emergency helplines directory (national + state-specific)
- π Threat report submission form (with evidence upload, anonymous option)
### Authenticated Users
- Submit threat reports
- Track report status
- Comment on incidents (with replies)
- Delete own comments
### Admin / Moderator
- π Dashboard with charts (monthly trend, severity breakdown, attack types)
- β
Approve / reject / feature incidents
- π Convert user reports β verified incidents
- π₯ User management (role, status, profile view)
- π¬ Comment moderation
- π Helpline CRUD
- π Soft-delete with full audit trail
---
## User Roles
| Role | Capabilities |
|--------------|-----------------------------------------------------------|
| `super_admin`| Full access including user management and de β¦