https://github.com/naeemmajumder/hackathon-hack_corruption_frontend
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.
https://github.com/naeemmajumder/hackathon-hack_corruption_frontend
express-js firebase firebase-auth flamer-motion javascript javascript-library jwt-authentication mongoose node-js reactjs swiper-js tailwindcss toastify
Last synced: 4 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/naeemmajumder/hackathon-hack_corruption_frontend
- Owner: NaeemMajumder
- Created: 2025-02-15T05:20:41.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-15T06:12:20.000Z (4 months ago)
- Last Synced: 2025-02-15T07:18:13.479Z (4 months ago)
- Topics: express-js, firebase, firebase-auth, flamer-motion, javascript, javascript-library, jwt-authentication, mongoose, node-js, reactjs, swiper-js, tailwindcss, toastify
- Language: JavaScript
- Homepage: https://nsu-hack-corruption.web.app/
- Size: 741 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛡️ Hack-Corruption - Anonymous Corruption Reporting Platform
## 📌 Project Overview
**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.
## 🌐 Live Links
- **Frontend:** [Hack-Corruption Frontend](https://nsu-hack-corruption.web.app/)
- **Backend:** [Hack-Corruption Backend](https://project-hack-backend.vercel.app/)
## 🔑 Admin & User Credentials
To access different features of the platform, use the following credentials:
### 🔹 Admin Credentials:
- **Email:** `[email protected]`
- **Password:** `123456`
### 🔹 User Credentials:
- **Email:** `[email protected]`
- **Password:** `123456`
### 🆔 NID & Passport Verification:
- **Sample NID Number:** `2004567890`
- **Sample Passport Number:** `J43210987`
> ⚠️ *Use these credentials for testing purposes only. Update them in the database for production use.*
## 🚀 Key Features
### 🔐 Strong User Authentication
- Users can sign up using **email verification**, **NID verification**, or **passport verification**.
- Ensures only legitimate users can access the platform.
### 🕵️ Anonymous Posting
- Users can **report corruption** anonymously without revealing their identity.
- AI **automatically generates a description** based on the uploaded image.
### 🤖 AI-Powered Spam Detection
- AI analyzes report images and descriptions to **detect spam**.
- Generates an **analysis report** and notifies admins via email.
### 🛡️ Admin Features
- **Ban or Unban Users**: Admins have control over platform access.
- **Success Action Reports**: Admins can post updates on successful actions taken against corruption reports and share them with users.
## 🛠️ Technologies Used
### **Frontend**
- ⚛️ **Framework**: React.js
- 🎨 **Styling**: Tailwind CSS
- 🔄 **State Management**: Context API
- 🔑 **Authentication**: Firebase
### **Backend**
- 🔧 **Framework**: Express.js
- 🗃 **Database**: MongoDB (Local for development, MongoDB Atlas for production)
- 🔗 **ODM**: Mongoose
- 🔑 **Authentication**: Firebase & Custom Verification
- 🤖 **AI Integration**: AI-powered image analysis & spam detection
- 🌟 **AI Model Used**: Gemini 1.5 Flash AI
## ⚠️ Challenges Faced
### 🏗️ Structuring the Project
- Designing a scalable **folder structure** for both frontend and backend.
### 🤝 Team Collaboration
- This was the **first team project**, so working with different ideas and coordination was challenging.
### 🚀 Deployment Issues
- Facing difficulties in deploying the **frontend on Firebase** and **backend on Vercel**.
### ☁️ Cloud Storage for Images
- Setting up **cloud storage** for securely hosting uploaded images.
## 👥 My Contributions
- Developed the **Home Page** and **Report Creation Form Page**.
- Integrated **AI-powered report descriptions** using uploaded images.
- Built **backend API routes** and connected them with the frontend.
- Designed the **frontend project structure and folder organization**.
## 🛠 Installation and Setup (Local Development)
### 📍 Prerequisites
- **Node.js**
- **MongoDB** (Local or MongoDB Atlas)
### 📂 Frontend Setup
```bash
git clone
cd frontend
npm install
npm start
```
### 📂 Backend Setup
```bash
git clone
cd backend
npm install
```
#### Set up environment variables in `.env` file:
```env
PORT=8080
MONGODB_URI=
FIREBASE_CONFIG=
```
#### Run the development server:
```bash
node index.js
```
## 📢 Future Enhancements
- 📊 **Detailed User Analytics**: Insights on reports and trends.
- 📱 **Mobile App**: Companion app for better accessibility.
- 🗣 **Community Engagement**: Users can discuss reported cases anonymously.
## 🤝 Contribution
We 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.
---
🚀 **Empowering users to report corruption safely and anonymously!**