kaphaaya/trustcheck-nigeria

# 🛡️ TrustCheck Nigeria ### Nigeria's Community-Powered Scam & Trust Database **🔗 Live Site:** 130.107.145.125 **🐳 Docker Hub:** hub.docker.com **📦 GitHub:** github.com --- ## The Problem Nigeria loses billions of naira every year to online scams — fake vendors on Instagram, investment fraud on WhatsApp, romance scams on Telegram, fake job offers, Ponzi schemes. There was no single place where Nigerians could search a phone number, business name, or social handle and instantly see if others had reported it as fraudulent. **TrustCheck Nigeria fills that gap.** --- ## What It Does **For the public (no login required):** - Search any phone number, business name, or social media handle - See a trust score (0–100) calculated from community reports - View all scam reports filed against a number or business — with proof - Submit a scam report with description, category, star rating, and screenshot **For businesses:** - Submit for verification using CAC number, NIN, BVN, or Driver's License - Receive a Verified ✅ badge visible in all search results - Build customer trust before they transact **Dashboard shows:** - Total reports in the database - Reports filed today - Number of verified businesses - Live feed of most recent community reports --- ## Architecture ``` USER'S BROWSER │ │ HTTP on Port 80 ▼ ┌─────────────────────────┐ │ NGINX (Frontend) │ — Serves index.html, proxies /api/ calls │ trustcheck-frontend │ └───────────┬─────────────┘ │ Internal Docker network ▼ ┌─────────────────────────┐ │ FLASK API (Backend) │ — All business logic, JWT auth, email, CAC verify │ trustcheck-backend │ └───────────┬─────────────┘ │ SQL queries ▼ ┌─────────────────────────┐ │ POSTGRESQL (Database) │ — Reports, users, businesses, votes, reviews │ trustcheck-db │ └─────────────────────────┘ All three containers run on a private Docker bridge network. Only port 80 is exposed to …