Foxxy09/namibian-scam-shield

Build a single web app where the public-facing site (HTML, CSS, JavaScript) lets anyone quickly search a company or investment offer to see if it appears in the licensed-entity database, and — if it’s unclear or unlisted — submit a detailed report with text, contact info and uploaded evidence (screenshots, PDFs); those actions call a RESTful backend (for example, Flask) that validates input, stores records in a relational database (Postgres/SQLite), and exposes APIs for the frontend and the admin tools. On the administration side a secure, authenticated dashboard lets Bank of Namibia staff log in, triage incoming reports, view full submission histories, mark items as “verified scam,” “legitimate,” or “under review,” update the official licensed-entities table, and publish public alerts; the dashboard also includes analytics (time-series charts and regional heatmaps using Chart.js, Plotly or Leaflet/Google Maps) so regulators can spot trends by region, type and time, filter reports, and export data for investigations. The system supports role-based access, file storage for evidence, moderation workflows (pending → verified → published), basic anti-spam and input validation, and a public alerts feed and education page so citizens see verified warnings and learn how to protect themselves — a design that crowdsources early detection from users while giving regulators the tools to validate, act, and communicate in one secure platform.

Please include this as well:

The app is a web-based fraud detection and consumer protection platform that helps Namibians verify, report, and stay informed about fraudulent financial schemes. On the user side, people can search for a company or investment offer to check if it’s registered or licensed, submit a report about suspicious activity with details or evidence, and browse verified scam alerts or educational content about safe financial practices. The frontend, built with React or standard HTML/CSS/JS, connects to a Flask backend through REST APIs. The backend handles user submissions, processes verification requests, and manages all stored data in a relational database like PostgreSQL. For administration, there’s a secure dashboard where verified officials or moderators can log in to review incoming reports, mark them as verified scams or legitimate businesses, update the licensed-entity database, publish public alerts, and view analytics that visualize scam trends across time or region using Chart.js or a similar library. The system’s architecture is designed so the public interacts with the user interface, while regulators access the dashboard to manage and analyze data. Over time, this setup allows the Bank of Namibia or other regulators to crowdsource early fraud detection, respond faster to new schemes, and educate the public — combining transparency, data insights, and user participation into one centralized digital platform.

initial commit