{"id":25481660,"url":"https://github.com/naeemmajumder/hackathon-hack_corruption_frontend","last_synced_at":"2026-04-07T18:31:29.356Z","repository":{"id":277647996,"uuid":"933083353","full_name":"NaeemMajumder/hackathon-hack_corruption_frontend","owner":"NaeemMajumder","description":"Hack-Corruption is a secure corruption reporting platform built with the MERN stack, offering anonymous reporting, AI-driven analysis, and Firebase authentication. Admins can manage reports, ban users, and publish actions. Key challenges included implementing anonymous posting, AI for spam detection, and secure authentication.","archived":false,"fork":false,"pushed_at":"2025-02-15T06:12:20.000Z","size":759,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-15T07:18:13.479Z","etag":null,"topics":["express-js","firebase","firebase-auth","flamer-motion","javascript","javascript-library","jwt-authentication","mongoose","node-js","reactjs","swiper-js","tailwindcss","toastify"],"latest_commit_sha":null,"homepage":"https://nsu-hack-corruption.web.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NaeemMajumder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-15T05:20:41.000Z","updated_at":"2025-02-15T06:24:05.000Z","dependencies_parsed_at":"2025-02-15T07:18:18.527Z","dependency_job_id":"a965e273-0dd9-4cc8-ae3d-a8cd9d9d5cf7","html_url":"https://github.com/NaeemMajumder/hackathon-hack_corruption_frontend","commit_stats":null,"previous_names":["naeemmajumder/hackathon-hack_corruption_frontend"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NaeemMajumder%2Fhackathon-hack_corruption_frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NaeemMajumder%2Fhackathon-hack_corruption_frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NaeemMajumder%2Fhackathon-hack_corruption_frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NaeemMajumder%2Fhackathon-hack_corruption_frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NaeemMajumder","download_url":"https://codeload.github.com/NaeemMajumder/hackathon-hack_corruption_frontend/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239513379,"owners_count":19651322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["express-js","firebase","firebase-auth","flamer-motion","javascript","javascript-library","jwt-authentication","mongoose","node-js","reactjs","swiper-js","tailwindcss","toastify"],"created_at":"2025-02-18T16:49:53.511Z","updated_at":"2025-11-06T23:30:27.709Z","avatar_url":"https://github.com/NaeemMajumder.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛡️ Hack-Corruption - Anonymous Corruption Reporting Platform\n\n## 📌 Project Overview\n**Hack-Corruption** is a secure web application that enables users to report corruption anonymously while ensuring their safety and privacy. Built using the **MERN stack**, this platform leverages AI for automated report descriptions and spam detection, ensuring the authenticity of reports. The platform also allows administrators to manage reports effectively and take necessary actions against corruption cases.\n\n\u003c!-- ![Stop Corruption](https://media.istockphoto.com/id/486239989/photo/educational-and-creative-composition-with-the-message-stop-corruption.jpg?s=612x612\u0026w=0\u0026k=20\u0026c=azeOvbGua9G3ORDs_ujBTeGwpyHNIiHs2X1BXCev48o=) --\u003e\n\n\u003cimg src=\"./public/images/hack-corruption.jpg\" alt=\"Stop Corruption\"\u003e\n\n\n## 🌐 Live Links\n- **Frontend:** [Hack-Corruption Frontend](https://nsu-hack-corruption.web.app/)\n- **Backend:** [Hack-Corruption Backend](https://project-hack-backend.vercel.app/)\n\n\n\n## 🔑 Admin \u0026 User Credentials\n\nTo access different features of the platform, use the following credentials:\n\n### 🔹 Admin Credentials:\n- **Email:** `yaxiv61217@perceint.com`\n- **Password:** `123456`\n\n### 🔹 User Credentials:\n- **Email:** `naeemmajumder00@gmail.com`\n- **Password:** `123456`\n\n### 🆔 NID \u0026 Passport Verification:\n- **Sample NID Number:** `2004567890`\n- **Sample Passport Number:** `J43210987`\n\n\u003e ⚠️ *Use these credentials for testing purposes only. Update them in the database for production use.*\n\n\n## 🚀 Key Features\n### 🔐 Strong User Authentication\n- Users can sign up using **email verification**, **NID verification**, or **passport verification**.\n- Ensures only legitimate users can access the platform.\n\n### 🕵️ Anonymous Posting\n- Users can **report corruption** anonymously without revealing their identity.\n- AI **automatically generates a description** based on the uploaded image.\n\n### 🤖 AI-Powered Spam Detection\n- AI analyzes report images and descriptions to **detect spam**.\n- Generates an **analysis report** and notifies admins via email.\n\n### 🛡️ Admin Features\n- **Ban or Unban Users**: Admins have control over platform access.\n- **Success Action Reports**: Admins can post updates on successful actions taken against corruption reports and share them with users.\n\n## 🛠️ Technologies Used\n### **Frontend**\n- ⚛️ **Framework**: React.js\n- 🎨 **Styling**: Tailwind CSS\n- 🔄 **State Management**: Context API\n- 🔑 **Authentication**: Firebase\n\n### **Backend**\n- 🔧 **Framework**: Express.js\n- 🗃 **Database**: MongoDB (Local for development, MongoDB Atlas for production)\n- 🔗 **ODM**: Mongoose\n- 🔑 **Authentication**: Firebase \u0026 Custom Verification\n- 🤖 **AI Integration**: AI-powered image analysis \u0026 spam detection \n- 🌟 **AI Model Used**: Gemini 1.5 Flash AI\n\n## ⚠️ Challenges Faced\n### 🏗️ Structuring the Project\n- Designing a scalable **folder structure** for both frontend and backend.\n\n### 🤝 Team Collaboration\n- This was the **first team project**, so working with different ideas and coordination was challenging.\n\n### 🚀 Deployment Issues\n- Facing difficulties in deploying the **frontend on Firebase** and **backend on Vercel**.\n\n### ☁️ Cloud Storage for Images\n- Setting up **cloud storage** for securely hosting uploaded images.\n\n## 👥 My Contributions\n- Developed the **Home Page** and **Report Creation Form Page**.\n- Integrated **AI-powered report descriptions** using uploaded images.\n- Built **backend API routes** and connected them with the frontend.\n- Designed the **frontend project structure and folder organization**.\n\n## 🛠 Installation and Setup (Local Development)\n### 📍 Prerequisites\n- **Node.js**\n- **MongoDB** (Local or MongoDB Atlas)\n\n### 📂 Frontend Setup\n```bash\ngit clone \u003cfrontend-repo-link\u003e\ncd frontend\nnpm install\nnpm start\n```\n\n### 📂 Backend Setup\n```bash\ngit clone \u003cbackend-repo-link\u003e\ncd backend\nnpm install\n```\n#### Set up environment variables in `.env` file:\n```env\nPORT=8080\nMONGODB_URI=\u003cyour-mongodb-connection-string\u003e\nFIREBASE_CONFIG=\u003cyour-firebase-config\u003e\n```\n#### Run the development server:\n```bash\nnode index.js\n```\n\n## 📢 Future Enhancements\n- 📊 **Detailed User Analytics**: Insights on reports and trends.\n- 📱 **Mobile App**: Companion app for better accessibility.\n- 🗣 **Community Engagement**: Users can discuss reported cases anonymously.\n\n## 🤝 Contribution\nWe welcome contributions! Feel free to **fork** the repository and submit a **pull request**. If you have any suggestions, open an **issue** to discuss new features.\n\n---\n\n🚀 **Empowering users to report corruption safely and anonymously!**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaeemmajumder%2Fhackathon-hack_corruption_frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaeemmajumder%2Fhackathon-hack_corruption_frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaeemmajumder%2Fhackathon-hack_corruption_frontend/lists"}