ashirushehu2015-stack/zitda-sentinelflow

zitda-sentinelflow is a result of MIT 800 Capstone Project of Masters students at Iconic Open University, Sokoto # ZITDA SentinelFlow | cPanel Cloud Traffic Forensics & Audit Console ZITDA SentinelFlow is a lightweight, high-performance, client-side web application designed for the **Zamfara State ICT Regulatory Agency (ZITDA)**. It serves as a specialized network traffic forensics tool to audit cPanel host configurations, inspect binary packet captures (`.pcap`), detect cyber threats, and compile regulatory compliance reports conforming to Nigerian government cybersecurity frameworks. --- ## Table of Contents 1. Core Features 2. Technology Stack 3. Architecture & Code walkthrough 4. Threat Detection Capabilities 5. Getting Started (Local Development) 6. Deployment Guide 7. User Credentials Reference --- ## Core Features ### 1. Secure Operator Portal * Role-based simulated authentication for audit validation. * Preconfigured accounts mapping to regulatory levels: **Lead Forensics Auditor**, **Security Operations Analyst**, and **External Compliance Auditor**. ### 2. Interactive Audit Dashboard * **Real-time Statistics:** Track total packets, total network volume (Bytes/KB/MB), triggered security alerts, and an automated **ZITDA Compliance Security Score** (automatically drops based on severity of detected threats). * **Dynamic Charting:** Visualize network capture characteristics using Chart.js: * **cPanel Cloud Services Protocol Distribution** (TCP, UDP, DNS, HTTP, FTP, SMTP, cPanel, WHM). * **Bandwidth Consumption** by State Government MDA Subdomains. * **Network Traffic Rate** (Packets over Time). * **Security Threat Category Distribution**. ### 3. Forensic Examiner (Packet Inspector) * **Master-Detail Split Pane:** Combines a paginated, filterable packet list with double inspectors. * **Advanced Filters:** Search and filter by keyword, IP addresses, protocols, target government MDA subdomains, and threat severity levels (Critical, Warning, Clean). * **Deep Packet Inspection (DPI) Tree:** Decodes structured field-level details of Ethernet II, IPv4, TCP, UDP, ICMP, A …