Hackathon_Project_2025-26

Changes in project log:

format of the log:

Date: YYYY-MM-DD

Contributor:

• 🔧 Type of Change: [Feature / Bug Fix / Refactor / Docs / Setup]

Files Modified:

• <file_path_1>
• <file_path_2>

Description:

• Brief explanation of what was done
• Keep it concise but clear

Database / Schema Changes:

• [Yes / No]
• If Yes:
  • What changed:
  • Migration required: [Yes / No]

Notes / Dependencies:

• Any important info others should know
• Example: "Requires env update" or "Breaks previous API response"

LOG 1

Date: 25/03/2026 Contributor: Ojas

• Type of Change: Bug Fix Files Modified: modified: src/client/src/components/admin/HackathonCard.jsx modified: src/client/src/components/admin/RoleManagement.jsx modified: src/client/src/components/auth/AuthForm.jsx modified: src/client/src/pages/admin/AdminDashboard.jsx modified: src/client/src/pages/admin/CreateHackathon.jsx modified: src/client/src/pages/home/Home.jsx modified: src/client/src/pages/participant/JoinTeam.jsx modified: src/client/src/pages/participant/ManageTeam.jsx modified: src/client/src/pages/user/ApplyOrganizer.jsx modified: src/client/src/pages/user/Calendar.jsx modified: src/client/src/services/api.js modified: src/client/src/styles/admin.css modified: src/controllers/admin.controller.js modified: src/routes/admin.routes.js

Description: UI UX changes done:

1. search feature in admin dashboard now working
2. in homepage the hackathon boxes are now looking better
3. the organizer application removed
4. the role management feature is now working
5. create and edit hackathon form ui ux is now better way

Database / Schema Changes:

• NO

Notes / Dependencies: NA

LOG 2

Project Change Log Date: 2026-03-26

Contributor: Yash Wadhwani

🔧 Type of Change: [Feature / Bug Fix / Refactor]

Files Modified:

src/models/user.model.js

src/models/hackathon.model.js

src/controllers/profile.controller.js

src/client/src/pages/user/OrganizerDashboard.jsx

src/client/src/pages/home/Home.jsx

src/client/src/App.js (Routes)

src/routes/hackathon.routes.js

src/models/organizerApplication.model.js(removed)

src/routes/organizerApplication.routes.js(removed)

src/controller/organizerApplication.controller.js(removed)

Description:

Role Management Overhaul: Implemented a search-based assignment system allowing Admins to promote any user to 'Judge' or 'Organizer' directly, replacing the manual application process.

Backend Authorization Fix: Updated ProtectedRoute and backend policies to allow users with the "Organizer" role (even with a systemRole of 'user') to access management dashboards.

Schema Synchronization: Updated the User model to support both hackathonId and hId to ensure legacy data remains accessible while fixing the "undefined .toString()" crash in the Profile controller.

UI/UX Enhancements: Refined the Hackathon cards on the Homepage for better visual hierarchy and updated the Organizer Dashboard "Manage Event" navigation.

Cleanup: Removed redundant backend logic and frontend pages related to the old Organizer Application flow.

Database / Schema Changes:[Yes]

What changed: Added hId as an alias in hackathonRoles for backward compatibility; ensured organizerUserId is the standard key for hackathon ownership.

Migration required: [No] (Handled via model aliasing).

Notes / Dependencies:

Frontend Update Required: Ensure App.js routes for /admin/hackathons/... include "user" in the allowedRoles array to permit Organizer access.

Auth Sync: Users must logout and log back in if their roles were recently updated in the database to refresh the JWT/Context.

---

Date: 2026-03-26

Contributor: Prathmesh Toke

• 🔧 Type of Change: Feature / Bug Fix / Refactor

1. Profile Professionalization

• Added website, skills, interests, resumeUrl, degree, graduationYear fields to User model
• Updated profile.controller.js to return full user object instead of cherry-picked fields
• Added useEffect in SettingsTab.jsx to properly sync async profile data into form state (fixes blank fields bug)
• Added Edit Mode toggle to prevent accidental field modifications
• Redesigned PublicProfile.jsx with premium card-based layout, social links, and skill tags
• Updated OverviewTab.jsx to display skills and interests
• Added "View Public Profile" button to ProfileHeader
• Expanded profile.css with new utility styles

2. Team System & Join Flow Enhancements

• Added 'invited' status and message field to team.model.js members schema
• Implemented join request with custom message, withdraw request, and auto-withdrawal logic in team.controller.js
• Created TeamDetails.jsx page for full team exploration before joining
• Redesigned ManageTeam.jsx with roster cards, member skills, and "Find Members" button for leaders
• Updated JoinTeam.jsx with message modal, withdraw button, and "View Details" link
• Improved RegisterHackathon.jsx with profile prepopulation and search filtering
• Opened VIEW_TEAM_DETAILS policy to all authenticated users for team discovery
• Added 3 new API routes: discover members, invite member, respond to invite

3. Discover Members & Invitations System

• Created FindMembers.jsx page for team leaders to browse and invite available participants
• Created InvitationsTab.jsx component in Profile section for users to accept/decline team invites
• Added discoverMembers, inviteMember, respondToInvite to api.js service layer
• Updated participant.controller.js to include invitations in dashboard response
• Fixed respondToInvite query bug — was using implicit match instead of $elemMatch, blocking all acceptances

4. Dashboard & Navigation Improvements

• Gated "Go To Full Dashboard" button to only accepted team members and leaders
• Added isInvitedPending state to show "INVITE PENDING ACCEPTANCE" badge vs "PENDING APPROVAL"
• Hidden "Manage Team Members" button for pending/invited users
• Added FindMembers route to App.jsx
• Added "Invitations" tab with 🟡 notification dot to ProfileTabs when invites exist
• Wired InvitationsTab into Profile.jsx

Files Modified:

• src/models/user.model.js
• src/models/team.model.js
• src/controllers/profile.controller.js
• src/controllers/team.controller.js
• src/controllers/participant.controller.js
• src/controllers/hackathon.controller.js
• src/routes/team.routes.js
• src/policies/policy.js
• src/client/src/App.jsx
• src/client/src/services/api.js
• src/client/src/styles/profile.css
• src/client/src/components/user/ProfileHeader.jsx
• src/client/src/components/user/ProfileTabs.jsx
• src/client/src/components/user/tabs/OverviewTab.jsx
• src/client/src/components/user/tabs/SettingsTab.jsx
• src/client/src/components/user/tabs/InvitationsTab.jsx (NEW)
• src/client/src/pages/user/Profile.jsx
• src/client/src/pages/user/PublicProfile.jsx
• src/client/src/pages/participant/SingleHackathon.jsx
• src/client/src/pages/participant/JoinTeam.jsx
• src/client/src/pages/participant/ManageTeam.jsx
• src/client/src/pages/participant/RegisterHackathon.jsx
• src/client/src/pages/participant/ParticipantDashboard.jsx
• src/client/src/pages/participant/TeamDetails.jsx (NEW)
• src/client/src/pages/participant/FindMembers.jsx (NEW)

Notes / Dependencies:

• team.model.js schema updated — existing team documents may need the new status: 'invited' enum value
• profile.controller.js now returns the full user object — frontend components relying on specific fields will continue to work
• VIEW_TEAM_DETAILS policy is now open to all authenticated users — any logged-in user can view any team's details for discovery purposes
• respondToInvite fix uses $elemMatch — previous implicit Mongoose query was incorrectly matching and blocking all invitation acceptances

Date: 29/03/2026 Contributor: Ojas

• Type of Change: Feature Added Files Modified:

PROBLEM_STATEMENTS_DISPLAY_FIX.md PROBLEM_STATEMENTS_IMPLEMENTATION.md src/client/src/pages/admin/CreateHackathon.jsx src/client/src/pages/admin/HackathonDashboard.jsx src/client/src/pages/admin/ViewHackathon.jsx src/client/src/pages/judge/HackathonOverview.jsx src/client/src/pages/participant/SingleHackathon.jsx src/controllers/hackathon.controller.js src/models/hackathon.model.js src/routes/hackathon.routes.js

Description: UI/UX and Feature Enhancements:

1. Replaced the domain field with dynamic problem statements in hackathon creation

2. Admin can now add multiple problem statements with title and description

3. Improved create hackathon form with dynamic input fields for better usability

4. Implemented hackathon rounds feature with support for multiple rounds

5. Each round now includes name, description, and submission requirements

6. Added dynamic “Add Round” functionality similar to problem statements

7. Updated hackathon schema and backend to store problem statements and rounds

8. Ensured proper validation for problem statements and rounds

9. Display of problem statements and rounds added across:

   • Admin dashboard
   • View hackathon page
   • Participant and judge views

10. Improved overall UI/UX consistency across hackathon-related pages

Database / Schema Changes: YES

Notes / Dependencies: NA

LOG 5

Date: 29/03/2026 Contributor: Ojas

• Type of Change: Bug Fix Files Modified:

src/client/src/components/user/cards/HackathonCard.jsx src/client/src/components/user/tabs/SettingsTab.jsx src/client/src/pages/participant/FindMembers.jsx src/client/src/pages/participant/JoinTeam.jsx src/client/src/pages/participant/ManageTeam.jsx src/client/src/pages/participant/RegisterHackathon.jsx src/client/src/pages/participant/SingleHackathon.jsx

Description: UI UX changes done:

• Implemented working search functionality in admin dashboard
• Enhanced UI/UX of hackathon cards on homepage for better visual appeal
• Removed organizer application feature from the system
• Fixed and improved role management functionality
• Refined create/edit hackathon forms with better layout and user experience

Database / Schema Changes:

• NO Notes / Dependencies: NA

LOG 6

Date: 29/03/2026 Contributor: Ojas

• Type of Change: Feature Added Files Modified:

  shalvi ai feature added

A AI_IMPLEMENTATION_SUMMARY.md A AI_RECOMMENDATION_SYSTEM.md A QUICK_START_AI_RECOMMENDER.md M package.json M src/app.js M src/client/src/components/AdminDomainSelectForCreation.jsx M src/client/src/components/HackathonDomainsBadges.jsx M src/client/src/components/user/EventModal.jsx M src/client/src/components/user/tabs/SettingsTab.jsx M src/client/src/pages/admin/AdminDashboard.jsx M src/client/src/pages/participant/SingleHackathon.jsx M src/client/src/pages/participant/SubmitProject.jsx M src/client/src/pages/participant/TeamDetails.jsx M src/client/src/pages/user/Calendar.jsx M src/client/src/pages/user/Discovery.jsx M src/client/src/styles/SingleHackathon.css A src/controllers/recommendation.controller.js A src/models/ProblemEmbedding.js A src/models/ProblemMetadata.js A src/models/ProblemStatement.js A src/models/RecommendationResult.js A src/models/TeamSkillProfile.js M src/models/team.model.js A src/routes/recommendation.routes.js A src/services/embeddingService.js A src/services/recommendationEngine.js A src/services/teamSkillExtractor.js A src/utils/skillExtractor.js

Description: AI Feature Enhancements:

• Added AI-based problem recommendation feature
• Integrated backend services for skill extraction and matching
• Created necessary models and APIs for recommendations
• Connected AI feature with participant hackathon page
• removed useless emojis
• some basic important ui changes

Database / Schema Changes:

• YES Notes / Dependencies: YES (npm install natural)

LOG 7

Date: 30/03/2026 Contributor: Ojas

• Type of Change: Bug Fix Files Modified:

A BRANDING_VERIFICATION.md A NAVBAR_FOOTER_FIXES_SUMMARY.md D PROBLEM_STATEMENTS_DISPLAY_FIX.md D PROBLEM_STATEMENTS_IMPLEMENTATION.md D QUICK_START_AI_RECOMMENDER.md M src/client/src/components/auth/SocialButtons.jsx M src/client/src/components/common/DarkModeToggle.jsx M src/client/src/components/common/Footer.jsx M src/client/src/components/judge/Footer.jsx M src/client/src/components/user/CalendarListView.jsx M src/client/src/components/user/EventModal.jsx M src/client/src/components/user/ProfileHeader.jsx M src/client/src/components/user/cards/TeamCard.jsx M src/client/src/components/user/cards/TeamInfoCard.jsx M src/client/src/components/user/tabs/InvitationsTab.jsx M src/client/src/components/user/tabs/OverviewTab.jsx M src/client/src/components/user/tabs/SettingsTab.jsx M src/client/src/components/user/tabs/TeamsTab.jsx M src/client/src/context/AuthContext.jsx M src/client/src/pages/admin/AdminDashboard.jsx M src/client/src/pages/admin/CreateHackathon.jsx M src/client/src/pages/admin/HackathonDashboard.jsx M src/client/src/pages/admin/ViewHackathon.jsx M src/client/src/pages/home/Home.jsx M src/client/src/pages/judge/HackathonOverview.jsx M src/client/src/pages/participant/FindMembers.jsx M src/client/src/pages/participant/RegisterHackathon.jsx M src/client/src/pages/participant/SingleHackathon.jsx M src/client/src/pages/participant/TeamDetails.jsx M src/client/src/pages/user/Calendar.jsx M src/client/src/pages/user/Discovery.jsx M src/client/src/pages/user/Profile.jsx M src/client/src/pages/user/PublicProfile.jsx M src/client/src/services/socket.js M src/client/src/styles/admin.css M src/config/github.passport.js M src/controllers/hackathon.controller.js M src/controllers/oauth.controller.js M src/models/hackathon.model.js M src/policies/policy.js M src/routes/oauth.routes.js M src/utils/socket.js

Description: UI UX changes done:

1. prize distribution fixed
2. ui changes
3. navbar and footer fixeed
4. emojis removed

Database / Schema Changes:

• YES

Notes / Dependencies: NA

Date: YYYY-MM-DD

Contributor:

• 🔧 Type of Change: [Feature / Bug Fix / Refactor / Docs / Setup]

Files Modified:

• <file_path_1>
• <file_path_2>

Description:

• Brief explanation of what was done
• Keep it concise but clear

Database / Schema Changes:

• [Yes / No]
• If Yes:
  • What changed:
  • Migration required: [Yes / No]

Notes / Dependencies:

• Any important info others should know
• Example: "Requires env update" or "Breaks previous API response"

LOG 8

Date: 2/04/2026 Contributor: Ojas

• Type of Change: Bug Fix Files Modified:

D NAVBAR_FOOTER_FIXES_SUMMARY.md M src/client/src/pages/participant/SingleHackathon.jsx

Description:

1. bug in dated and registeration of hackthon

Database / Schema Changes:

• NO

Notes / Dependencies: NA

LOG 9

Changes in project log:

Date: 2026-04-13 Contributor: VEDANT

🔧 Type of Change: Refactor / Bug Fix Files Modified: src/client/src/utils/designSystem.js src/client/src/styles/admin.css src/client/src/pages/admin/AdminDashboard.jsx src/client/src/pages/admin/OrganizerDashboard.jsx src/client/src/components/admin/RoleManagement.jsx src/client/src/styles/design-system-colors.css

Description:

• Mapped exact project brand hex colors (#043873, #4F9CF9, #FFE492, #A7CEFC) across CSS configuration and React components.
• Fixed statistics card backgrounds to restore text readability in the Admin interfaces.
• Scrapped unprofessional emojis mapping across all files and replaced them with standard Lucide React icons.
• Enforced the target Inter Google font globally, overriding previous defaults.

Database / Schema Changes: No

Notes / Dependencies: NA

LOG 10

Changes in project log:

Date: 2026-04-17 Contributor: Sanika

🔧 Type of Change: Bug Fix in the judge dashboard Files Modified: src/client/src/styles/layout.css src/client/src/styles/dashboard.css src/client/src/pages/judge/JudgeDashboard.jsx src/client/src/components/common/Navbar.jsx src/client/src/components/common/Footer.jsx src/client/src/components/dashboard/TabsNavigation.jsx

Description:

1. Fixed navbar positioning and removed unwanted top spacing
2. Resolved tab (About, Timeline, etc.) overlap issue during scroll
3. Corrected sticky offsets and z-index layering
4. Improved alignment of back button, header, and content sections
5. Standardized layout using flexbox (Navbar → Content → Footer)
6. Fixed scrolling issues by removing nested scroll conflicts
7. Resolved footer positioning across all judge dashboard pages
8. Ensured consistent spacing and visual hierarchy throughout UI

Database / Schema Changes: No

Notes / Dependencies: NA

LOG 11

Changes in project log:

Date: 2026-04-25 Contributor: Sanika

🔧 Type of Change: added faqs Files Modified:

Description:

1. faq added for all types of user

Database / Schema Changes: No

Notes / Dependencies: NA

LOG 12

Changes in project log:

Date: 2026-04-25 Contributor: Ojas

🔧 Type of Change: admin page ui fixed in phone view

Files Modified: src/client/src/styles/admin.css src/client/src/styles/navbar.css

Description:In the latest update, I improved the admin dashboard UI. Fixed navbar alignment, made it responsive for mobile devices, and corrected role badge overflow issues. Also updated CSS to remove overlapping elements

Database / Schema Changes: No

Notes / Dependencies: NA

LOG 13

Changes in project log:

Date: 2026-04-25 Contributor: Ojas

🔧 Type of Change: user page ui fixed in phone view

Files Modified: src/client/src/components/auth/AuthLayout.jsx src/client/src/pages/participant/TeamDetails.jsx src/client/src/styles/SingleHackathon.css src/client/src/styles/TeamDetails.css src/client/src/styles/auth.css src/client/src/styles/discovery.css src/client/src/styles/footer.css src/client/src/styles/global.css src/client/src/styles/home.css src/client/src/styles/profile.css

Description:In the latest update, I improved the user dashboard UI. Fixed navbar alignment, made it responsive for mobile devices, and corrected role badge overflow issues. Also updated CSS to remove overlapping elements

Database / Schema Changes: No

Notes / Dependencies: NA

LOG 15

Changes in project log: otp integeration done

Date: 2026-04-25 Contributor: Ojas

🔧 Type of Change: new feature

Files Modified:

env.example package-lock.json package.json src/app.js src/client/src/App.jsx src/client/src/components/auth/AuthForm.jsx src/client/src/components/auth/ForgotPasswordForm.jsx src/client/src/components/auth/OTPSignupForm.jsx src/client/src/components/common/Input.jsx src/client/src/pages/auth/ForgotPassword.jsx src/client/src/pages/auth/Signup.jsx src/client/src/services/api.js src/client/src/styles/auth.css src/controllers/otp.controller.js src/models/otp.model.js src/routes/otp.routes.js src/utils/email.js src/utils/otp.js

Description: ## 🔐 Authentication System Implementation

Implemented a complete production-ready authentication system with OTP-based email verification and password reset.

🔹 Features Added

• OTP-based email verification for signup using Nodemailer (IEEE email SMTP)
• 6-digit numeric OTP with 5-minute expiry and MongoDB TTL auto-deletion
• Resend OTP functionality with 30-second cooldown
• Rate limiting (max 5 OTP requests/hour per email)
• Brute force protection (max 5 verification attempts)
• Single-use OTPs for enhanced security

🔹 Forgot Password System

• Implemented secure password reset via OTP
• Flow: Email → OTP → New Password → Reset
• Same security rules applied (expiry, attempts, rate limiting)
• Email enumeration protection (does not reveal user existence)

🔹 Security Enhancements

• Password hashing using bcrypt (10 salt rounds)
• OTP expiry and automatic cleanup via database TTL
• Protection against brute force and spam requests

🔹 Frontend Improvements

• Two-step authentication flows (Signup & Password Reset)
• Real-time OTP expiry countdown
• Resend OTP timer
• Proper error handling and user feedback
• Auto-redirect after successful actions

🔹 Final Outcome

The system now fully supports:

• Signup with OTP verification
• Secure login
• Password reset via OTP

All features are production-ready and follow standard authentication best practices.

Database / Schema Changes: yes

Notes / Dependencies: yes

LOG 16

Changes in project log: ui fixed

Date: 2026-04-25 Contributor: Ojas

🔧 Type of Change: error fix

Files Modified:

MOBILE_CARD_FIX_SUMMARY.md src/client/src/components/user/cards/HackathonCard.jsx src/client/src/components/user/tabs/InvitationsTab.jsx src/client/src/components/user/tabs/OverviewTab.jsx src/client/src/components/user/tabs/SettingsTab.jsx src/client/src/main.jsx src/client/src/pages/user/Discovery.jsx src/client/src/styles/buttons.css src/client/src/styles/discovery.css src/client/src/styles/profile.css

Description: Improved UI and responsiveness of the user dashboard and hackathon pages. Fixed layout issues including navbar alignment, card structure, button consistency, image fitting, and removed horizontal scrolling. Also corrected mobile view spacing and overall design consistency.

All features are production-ready and follow standard authentication best practices.

Database / Schema Changes: no

Notes / Dependencies: no