# 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 …