Bayaan بيان
Personal Project · Thesis
The Problem
Muslim investors in Nigeria had no reliable, automated way to determine whether NGX-listed equities are Shariah-compliant. Manual screening is slow, opaque, and inconsistent — leaving a significant gap in the Islamic finance market.
My Approach
I designed and built Bayaan — a commercial Shariah compliance screening platform for NGX equities. The platform implements a two-tier screening engine based on AAOIFI Standard No. 21: a qualitative business-activity classifier followed by four quantitative financial-ratio checks (debt, interest-bearing securities, non-permissible revenue, and tangible assets, each against its AAOIFI threshold) drawn from primary-source company filings. Two independent NLP classifiers back the qualitative tier — TF-IDF + Logistic Regression (95.35% held-out accuracy, F1: 0.9488) and a fine-tuned BERT model (ProsusAI/FinBERT, F1: 0.9222), both benchmarked against a rule-based baseline (F1: 0.8541) — with SHAP explainability so users can see exactly why a stock was classified Halal or Haram. The system fetches live NGX prices and shares-outstanding data directly from NGX's own infrastructure and presents verdicts through a React/Vite frontend.
Technical Depth
React/Vite frontend on Netlify; FastAPI backend on Railway; the fine-tuned BERT model hosted on Hugging Face Hub. Engineered a SharePoint REST API integration to enumerate NGX's document library for company filings, with a hardened PDF parser (conservative fallback recovery, monitoring, and webhook alerting) for shares-outstanding data. Every screened stock carries an explicit data-integrity tier — Verified against primary filings (18 stocks), Estimated pending re-verification (87), or Pending Review (46) — surfaced to users rather than presented as uniform confidence. Completed a full NDPA 2023 data-protection compliance review, currently "compliant by design" on the strength of collecting no personal data; a user-accounts and entitlements system is in active development (backend built and tested, frontend integration in progress), with its own compliance review gating launch before any signup goes live.
Screening 105 NGX-listed equities live (46 more tracked, pending review) at bayanngx.netlify.app — serving as both a commercial product and academic thesis deliverable.