Leonojiaku/ScamShield

ScamShield AI is a state-of-the-art cybersecurity and threat intelligence platform designed to protect users across Africa from online scams before they lose money. The ecosystem integrates Artificial Intelligence, Cybersecurity heuristics, and Community threat reports to scan suspected, bank accounts, crypto wallets, and lookalike website links. # ScamShield AI — Premium AI-Powered Anti-Scam Platform ScamShield AI is a state-of-the-art cybersecurity and threat intelligence platform designed to protect users across Africa from online scams before they lose money. The ecosystem integrates **Artificial Intelligence**, **Cybersecurity heuristics**, and **Community threat reports** to scan suspected phone numbers, bank accounts, crypto wallets, and lookalike website links. --- ## 🚀 Key Features * **AI Message Scanner**: Specialized content parser analyzing WhatsApp, Telegram, SMS, or emails for social engineering cues, panic tactics, fake giveaways, and bank notification alerts using Google Gemini. * **Trust Intelligence Lookup**: Public directory check of banks, phones, wallets, and links. Features community logs, strict risk warning callouts, and built-in dispute appeals. * **Screenshot OCR Auditor**: Client-side Tesseract.js processing to parse text contents directly from uploaded photos of transaction slips or message captures. * **Secure Multi-Tier Accounts**: Built using high-performance Argon2 password hashes, session cookies, JWT keys, and TOTP Two-Factor Authentication (2FA). * **Interactive Learning Center**: Academy modules with progress logging and MCQs that award certificate badges upon achieving a 100% score. * **Admin Audit Control Panel**: Queue moderation tools for admins to approve/reject community reports, resolve dispute appeals, and assign moderator staff roles. --- ## 🛠️ Technology Stack * **Frontend**: React, TypeScript, Tailwind CSS, Chart.js, React Query, Framer Motion, Tesseract.js * **Backend**: Node.js, Express, TypeScript, Argon2 Hashing, JWT * **Database**: PostgreSQL * **Integrations**: Google Gemini API * **Orchestration & DevOps**: Docker, Docker Compose, GitHub Actions CI/CD --- ## ⚙️ Environment Configurations Create a `.env` file in the `backend/` directory or pass these during container runtime: ```ini PORT=3000 DATABASE_URL=postgres://scamsh …