Ejyke90/nextier-nigeria-violent-conflicts-database

# Nextier Nigeria Violent Conflicts Database A **proactive, automated** conflict monitoring system using microservices, AI/ML analysis, and real-time alerting. The system autonomously scrapes news sources every 15 minutes, extracts conflict events, calculates risk scores, and triggers instant alerts for critical situations. ## Key Features - **🤖 Automated Scraping**: Background scheduler runs every 15 minutes (no manual intervention) - **🚨 Instant Alerts**: High-risk articles (score > 85) trigger immediate UI notifications - **💓 System Heartbeat**: Real-time monitoring of scheduler status and next scrape time - **📊 Proactive Intelligence**: Continuous monitoring with automated risk assessment - **🔄 Event-Driven**: Asynchronous processing pipeline via RabbitMQ - **📈 Real-Time Dashboard**: Live updates with automated state management ## Architecture Themes - **Proactive vs Reactive**: Automated background tasks replace manual button clicks - **Event-Driven Communication**: RabbitMQ for asynchronous service orchestration - **Clean Architecture**: Layered design with dependency injection - **Resilience Patterns**: Circuit breakers, retry mechanisms, connection pooling - **Observability**: Structured logging, health checks, automation logs - **Security**: Input validation, CORS, sanitized error handling ## Services This project consists of three microservices plus a React dashboard: 1. **Scraper Service** (Port 8000) - Automated news collection with 15-min scheduler 2. **Intelligence API Service** (Port 8001) - AI-powered event extraction using LLM 3. **Predictor Service** (Port 8002) - Risk scoring and economic data analysis 4. **UI Dashboard** (Port 8080) - Real-time monitoring with system heartbeat ## Infrastructure Services - **MongoDB** (Port 27017) - Document storage for articles, events, and risk signals - **RabbitMQ** (Port 5672/15672) - Message broker for service communication ## Project Structure ``` nextier-nigeria-violent-conflicts-database/ ├── d …