Tebrihk/KADIRS-analysis-and-dashboard

This project focused on the design and implementation of a Tax Compliance Monitoring Dashboard for the Kaduna State Internal Revenue Service (KADIRS). # KADIRS Tax Compliance Monitoring Dashboard An interactive **Tax Compliance Monitoring Dashboard** built for the **Kaduna State Internal Revenue Service (KADIRS)**. The project covers the full analytics workflow — from raw tax-compliance data cleaning and validation, through exploratory data analysis and KPI engineering, to an interactive Streamlit dashboard for monitoring compliance, revenue, audit performance, and defaulters. --- ## 📌 Overview KADIRS is responsible for assessing, collecting, and accounting for internally generated revenue in Kaduna State. This project delivers a single, interactive view of tax-compliance health so that revenue officers can: - Track compliance and filing behaviour across LGAs and sectors. - Monitor revenue collection trends over time. - Identify top defaulters and high-risk taxpayers. - Follow audit progress and outcomes. - Drill into KPIs that summarise overall performance. The work is split into two parts: 1. **Analysis pipeline** — a set of Jupyter notebooks that load, clean, validate, explore, and compute KPIs from the raw compliance data, producing ready-to-use summary tables. 2. **Interactive dashboard** — a Streamlit app that visualises the cleaned data and summary tables with Plotly charts, filters, and KPI cards. --- ## ✨ Features The dashboard exposes the following views (see screenshots below): - 🏠 **Home / overview** — high-level summary and navigation. - 🧭 **Sidebar navigation** — switch between dashboard sections. - 📊 **Key Performance Indicators (KPIs)** — compliance rate, collection rate, filing rate, and other headline metrics. - ✅ **Compliance analysis** — compliance status distribution and trends. - 💰 **Revenue analysis** — revenue by LGA, sector, and month. - 🕵️ **Audit analysis** — audit coverage, findings, and outcomes. - 🔍 **Search bar** — look up specific taxpayers / records. - ⚠️ **Top defaulters** — ranked list of taxpayers with the highest outstanding liabilities. --- ## 🛠️ Tech Stack | A …