The goal is to develop a platform for college students that allows them to interact with campus events, clubs, and activities. The platform will provide personalized event calendars, a social media space for clubs, ticket management using QR codes, and more.

'Initial commits for backend development was performed in another repository. "https://github.com/KisuZoid/happen_temp"'

A QR Code-based Event Attendance System with JWT authentication, role-based access, and email verification. Users can register, generate QR codes for events, and mark attendance by scanning them.

✔ JWT Authentication - Secure login/logout with tokens
✔ Role-Based Access Control - Admin, Organizer, and User roles
✔ Password Hashing - Uses bcrypt for encryption
✔ Email Verification - Users must verify email before login
✔ Password Reset - Secure OTP-based reset

✔ Create & Manage Events - Admin & organizers can create, update, and delete events
✔ QR Code Generation - Unique QR for every user-event pair
✔ One-Time QR Usage - Prevents multiple scans
✔ QR Code Validation - Tracks scanned status
✔ Event Ticketing - Users can generate tickets linked to QR

✔ Real-time Attendance Marking - Scan QR for check-in
✔ Duplicate Prevention - Stops multiple entries
✔ Attendance Logs - Admins can track who attended
✔ ObjectId Validation - Prevents invalid data input

✔ User Registration Confirmation
✔ Password Reset Emails
✔ Event Notifications

✔ RESTful API - Well-structured and documented
✔ MongoDB Integration - Scalable database
✔ Optimized Indexing - For faster query execution
✔ Error Handling Middleware - Centralized error management

📦 backend
 ┣ 📂 config
 ┃ ┗ 📄 db.js                  # Database connection setup
 ┣ 📂 controllers
 ┃ ┣ 📄 authController.js       # Handles authentication & JWT
 ┃ ┣ 📄 eventController.js      # Event management
 ┃ ┣ 📄 qrController.js         # QR Code generation & validation
 ┃ ┣ 📄 ticketController.js     # Ticket management
 ┃ ┣ 📄 userController.js       # User profile & role management
 ┃ ┗ 📄 attendanceController.js # Attendance tracking
 ┣ 📂 middleware
 ┃ ┣ 📄 authMiddleware.js       # JWT validation & role-based access
 ┃ ┣ 📄 roleMiddleware.js       # Role-based permissions
 ┃ ┗ 📄 errorHandler.js         # Centralized error handling
 ┣ 📂 models
 ┃ ┣ 📄 eventModel.js           # Event schema
 ┃ ┣ 📄 qrModel.js              # QR Code schema
 ┃ ┣ 📄 ticketModel.js          # Ticket schema
 ┃ ┣ 📄 userModel.js            # User schema
 ┃ ┗ 📄 attendanceModel.js      # Attendance schema
 ┣ 📂 routes
 ┃ ┣ 📄 authRoutes.js           # Auth routes
 ┃ ┣ 📄 eventRoutes.js          # Event routes
 ┃ ┣ 📄 qrRoutes.js             # QR & attendance routes
 ┃ ┣ 📄 ticketRoutes.js         # Ticket routes
 ┃ ┣ 📄 userRoutes.js           # User routes
 ┃ ┗ 📄 attendanceRoutes.js     # Attendance routes
 ┣ 📂 utils
 ┃ ┣ 📄 emailService.js         # Email verification & reset
 ┃ ┣ 📄 jwtUtils.js             # JWT token utilities
 ┃ ┣ 📄 hashUtils.js            # Password hashing
 ┃ ┗ 📄 qrUtils.js              # QR code generation helpers
 ┣ 📄 .env                      # Environment variables
 ┣ 📄 package.json              # Dependencies & scripts
 ┣ 📄 index.js                  # Main server file
 ┣ 📄 app.js                    # Part of server file
 ┗ 📄 README.md                 # Project documentation

✔ Node.js & Express.js
✔ MongoDB with Mongoose ORM
✔ JWT Authentication
✔ Bcrypt for Password Hashing
✔ QR Code Generation (qrcode package)
✔ Nodemailer for Emails
✔ Role-Based Access Control (RBAC)
✔ Multer (for file handling, if needed)

🔹 JWT Authentication - Ensures secure access
🔹 Password Hashing - Protects stored passwords
🔹 Role-Based Access Control - Restricts unauthorized access
🔹 Preventing QR Code Reuse - Stops multiple scans

1. Fork the repo
2. Create a new branch (feature-branch)
3. Commit changes & push
4. Create a Pull Request

This project is MIT Licensed.