MAS1-A/AMAN-Food-Price-Intelligence

Enterprise Real-Time Market Analytics & Machine Learning Food Price Forecasting Platform in Egypt. # 🇪🇬 AMAN: Egypt Food Price Intelligence Platform ### Enterprise Real-Time Market Analytics, Fair-Pricing Auditing & Machine Learning Forecasting An end-to-end academic machine learning capstone platform for monitoring, benchmarking, auditing, and forecasting food commodity prices across 23 Egyptian governorates. --- ## Table of Contents - Executive Summary - Academic Capstone Team - The Problem Statement - Platform Objectives - System Architecture - Dataset & Feature Pipeline - Comprehensive Model Benchmark (11 Models) - Production Deployment Rationale - Fair-Price Auditing Intelligence - Forward Forecasting Engine - Spatial & Geospatial Intelligence - Interactive Dashboard Architecture - Bilingual (Arabic / English) Engine - Technology Stack - Repository Structure - Getting Started & Local Deployment - Reproducibility & Serialization Artifacts - Monitoring & Production Reliability - Project Impact & Strategic Vision --- ## Executive Summary **AMAN** is an enterprise-grade food price intelligence platform built as an academic graduation capstone project. The system translates raw market transactions across **23 Egyptian governorates** and **22 core commodities** into actionable economic intelligence. By incorporating spatial logistics, seasonal surges, and macroeconomic inflation, the platform determines fair equilibrium commodity pricing. Following a rigorous empirical evaluation of **11 distinct machine learning architectures**, an optimized **Linear Regression pipeline with logarithmic target scaling** was selected for production deployment. It achieves an explanatory power of **Test R² = 98.93%**, an average error of **Test MAE = 6.67 EGP**, and an ultra-tight **Generalization Gap of +0.06%** with zero-latency inference. --- ## Academic Capstone Team This project was developed through a specialized division of responsibilities across the machine learning lifecycle: | Team Member | Project Role | Engineering Scope & Core Responsibilities | L …