E-KB-N/african-football-operations-portal

An interactive data analytics and tactical scouting web portal built with Python, Streamlit, and Plotly tracking multi-tournament African World Cup performance. # African World Cup Analytics & Scouting Portal A comprehensive, multi-tournament data analytics and tactical scouting web application built for performance analysts, scouts, and football operations teams. This portal tracks historical performance data, tactical profiles, and ground telemetry across qualified African national teams spanning multiple World Cup cycles. --- ## Key Features * **Multi-Tournament Performance Database:** Compare metrics like goals scored, match outcomes, pass accuracy, and possession percentages across multiple World Cup campaigns (2014–2026). * **Continental Tactical Evolution Matrix:** Interactive scatter analysis tracking the correlation between average possession metrics and defensive block density. * **Granular Scouting Reports:** Dual-selector interface allowing users to filter detailed tactical insights (base formations, build-up patterns, pressing triggers, and chance creation methods) by national team and specific tournament year. * **Field Operations & Ground Telemetry:** Operational log simulator for pitch quality checks, venue tracking, and matchday notes. * **Theme-Aware UI Design:** Built with custom Streamlit styling that dynamically adapts for seamless readability in both Light and Dark modes. --- ## Tech Stack * **Frontend & Framework:** Streamlit (Python) * **Data Manipulation & Analysis:** Pandas * **Data Visualization:** Plotly Express & Graph Objects --- ## Installation & Local Setup 1. **Clone the repository:** ```bash git clone github.com cd YOUR_REPOSITORY_NAME Create and activate a virtual environment (recommended): python -m venv venv source venv/bin/activate # On Windows use: venv\Scripts\activate Install dependencies: pip install streamlit pandas plotly Run the application locally: streamlit run app.py