Merge branch 'CodeChefVIT:prod' into prod

karannfr · web-flow · commit 4ea8746fe32d · 2025-09-29T19:14:27.000+05:30
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,72 +1,57 @@
-## Contribution Guidelines
+# Contribute to the Papers Repository
 
-Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
+We appreciate your interest in contributing to the `papers-codechef` repository! Please follow these guidelines to ensure a smooth and effective contribution process.
 
-## How to contribute
 
-- Decide which repository to contribute
-- Decide what to contribute
-- Fork the repo then clone it locally
-- Commit your work (You should create a new branch when you're doing development work that is somewhat experimental in nature.)
-- Create a **Pull Request**
-- Congrats 🎉 you have just contributed towards open source!
+## Getting started
 
-## What to contribute
+- If you're looking for ideas about what to work on, check out our [issues](https://github.com/CodeChefVIT/papers-codechef/issues) 
+- If you have a bugfix to report ensure that you are on the latest pkull and no similar issue exists. You can then [create an bug report](https://github.com/CodeChefVIT/papers-codechef/issues/new?template=bug_report.md)
+- You can also propose a [feature request](https://github.com/CodeChefVIT/papers-codechef/issues/new?template=feature_request.md). Begin by filling out the template, write a brief problem statement that clearly explains the issue you want to address, without tying it to any specific solution. It doesn’t need to be long or formal; just provide enough context to clearly understand the problem before discussing possible solutions. 
 
-- Find an open issue to tackle
-- Ask if you can help write a new feature
-- Add / Improve Unit Testing
-- Write tutorials for how a project can be used and add to the readme
-- Review code on other people’s submissions and help improving / finding vulnerabilities
+## Setting up
+- **Fork** the repository. All the PRs would be made from this fork.
+- **Clone** the repository.
 
-## Making a PR
-- Provide all the appropriate details asked in PR template
-- A pull request doesn’t have to represent finished work. It’s usually better to open a pull request early on, so others can watch or give feedback on your progress. Just mark it as a “WIP” (Work in Progress) in the subject line. You can always add more commits later.
+To get the project running, you need to set up your local environment:
 
-## Opening an Issue
-- Make use of an appropriate Issue Template
-- We welcome Feature request, Bug Report, Documentation fix and others
-- Do not open critical security issues here, report them directly at [our email](mailto:contact@codechefvit.com).
+- **Create a `.env` file:** Create a new file named `.env` and use the .env.example file to create your own .env file and put in your your own environment variables to make the project functional.
+- **Install dependencies:** Run `pnpm i` in your terminal to install all necessary dependencies.
+- **Checkout staging branch**: Run `git checkout staging` to switch branches.
+- **Run the project:** Run `pnpm dev` to start the project.
 
-## Communicating effectively
-**Give context.** Help others get quickly up to speed. If you’re running into an error, explain what you’re trying to do and how to reproduce it. If you’re suggesting a new idea, explain why you think it’d be useful to the project (not just to you!).
+## How to Contribute
 
-```
-✔️ “X doesn’t happen when I do Y”
-❌ “X is broken! Please fix it.”
-```
+Once your environment is set up, you're ready to start coding.
 
-**Do your homework beforehand.** It’s OK not to know things, but show that you tried. Before asking for help, be sure to check a project’s README, documentation, issues (open or closed), mailing list, and search the internet for an answer. People will appreciate when you demonstrate that you’re trying to learn.
+- **Create a new branch:** Use the command `git checkout -b yourName/featureName` to create a new branch for your work.
+- **Make your changes:** Write the code to address the issue you were assigned.
+- **Add changed files:** After making your changes, use `git add .` to add the modified files to Git tracking.
+- **Commit your changes:** Please follow standard conventional commit guidelines as outlined here: https://www.conventionalcommits.org/en/v1.0.0/
+- **Push your changes:** Push your commits to your forked repository using `git push`.
 
-```
-✔️ ““I’m not sure how to implement X. I checked the help docs and didn’t find any mentions.””
-❌ “How do I X?”
-```
+## Submit a Pull Request
 
-**Keep requests short and direct.**
+- **[Submit your pull request](https://github.com/CodeChefVIT/papers-codechef/compare):** Please, fill in the Pull Request template - it will help us better understand the PR and increase the chances of it getting merged quickly.
 
-```
-✔️ “I’d like to write an API tutorial.”
-❌ “I was driving down the highway the other day and stopped for gas, and then I had this amazing idea for something we should be doing, but before I explain that, let me show you…“
-```
+An organization member will review the PR and discuss changes you might have to make before merging it. Any new changes you push to your branch will be automatically attached to the PR.
 
-**It’s okay to ask questions (but be patient!).**
+---
 
-```
-✔️ “Thanks for looking into this error. I followed your suggestions. Here’s the output.”
-❌ “Why can’t you fix my problem? Isn’t this your project?”
-```
+### Mandatory PR contents
 
-**Respect community decisions.**
+Please ensure that any Pull Request you make contains these things -
 
-```
-✔️ “I’m disappointed you can’t support my use case, but as you’ve explained it only affects a minor portion of users, I understand why. Thanks for listening.”
-❌ “Why won’t you support my use case? This is unacceptable!”
-```
+- Purpose and issue which the PR is made for.
+- Before & after screenshots if your changes involve any visual adjustments (e.g. UI changes, layout tweaks).
+- List of the major changes made in this PR.
+- Mention of any bug fixes, known issues or follow-ups needed.
 
-## Misc
-- You are welcome to Propose a new feature by creating an **Issue**.
-- You may Discuss a high-level topic or idea (for example, community, vision or policies) by writing to us at our [Email](mailto:contact@codechefvit.com).
+**Important:** Ensure no merge conflicts exist before making a PR and run `pnpm build` to check for build errors.
 
-## Attribution
-- [Open Source Guide](https://opensource.guide/how-to-contribute/)
+
+### Tips to improve the chances of your PR getting reviewed and merged
+
+- Small, focused & incremental pull requests are much easier to review.
+- Spend time explaining your changes in the pull request body.
+- Low effort PRs, such as those that just re-arrange syntax, won't be merged without a compelling justification.
diff --git a/README.md b/README.md
@@ -27,6 +27,7 @@
 - Stay updated with any new additions to the repository
 
 ## 🏁 Get Started
+Note: To get started with contributing to the repo visit [CONTRIBUTE.md](CONTRIBUTING.md)
 
 The repository has two branches, 'prod' and 'staging'.
 
@@ -63,27 +64,6 @@ To start your development server run:
 pnpm dev
 ```
 
-## 🐳 Using Docker
-
-To run the application using Docker, follow these steps:
-
-1. **Build the Docker Image**:
-
-   ```bash
-   docker build -t papers-codechef .
-   ```
-
-2. **Run the Docker Container**:
-
-   ```bash
-   docker run -p 3000:3000 --env-file .env papers-codechef
-   ```
-
-3. **Using Docker Compose**:
-   If you prefer `docker-compose`, ensure the `docker-compose.yml` file is configured, then run:
-   ```bash
-   docker-compose up
-   ```
 
 Before getting started, please ensure that the .env file is properly configured. The .env.example file has been provided for your reference, with examples of environment variables to be listed.
 
diff --git a/public/cookoff.png b/public/cookoff.png
diff --git a/pull_request_template.md b/pull_request_template.md
@@ -0,0 +1,31 @@
+## 📌 Purpose
+Explain the goal of this PR.  
+What problem does it solve, or what feature does it add?
+
+---
+
+## Corresponding issue: #[Issue number]
+
+---
+
+## 🖼️ Showcase
+(Add screenshots, screen recordings, or terminal outputs if the PR affects the UI or workflows.)
+
+---
+
+## 🔧 Changes
+- List the major changes made in this PR.
+- Example:
+  - Added upcoming subjects section
+  - Fixed search bug in bulk approve
+
+---
+
+## ➕ Additional Notes
+- Mention any bug fixes, known issues, or follow-ups needed.
+- Add any extra context or considerations for reviewers.
+
+
+Examples of a good PR - 
+
+https://github.com/CodeChefVIT/papers-codechef/pull/247
diff --git a/src/assets/DEVSOC.svg b/src/assets/DEVSOC.svg
diff --git a/src/components/CookoffBanner.tsx b/src/components/CookoffBanner.tsx
@@ -0,0 +1,60 @@
+import { Button } from "./ui/button";
+
+import Image from "next/image";
+
+import Link from "next/link";
+
+export default function CookoffBanner() {
+  return (
+    <>
+      <div className="z-50 flex h-fit w-full items-center justify-center bg-[#626bd2] px-6 py-3 text-center text-white sm:h-14 sm:py-0 md:sticky md:top-0 md:justify-between md:text-left">
+        <div className="flex items-center gap-x-2">
+          <Image
+            src="/cookoff.png"
+            alt="cookofflogo"
+            height={40}
+            width={40}
+            className="md:hidden"
+          />
+
+            <span className="hidden md:block">
+            10 Years. Hundreds of Coders. One Champion.
+            CookOff, the biggest competitive coding challenge of graVITas is back!
+            </span>
+
+          <Link
+            href="https://gravitas.vit.ac.in/events/bdfcebea-c141-4a61-ac73-61dec96c08f4"
+            className="block md:hidden"
+            rel="noopener noreferrer"
+            target="_blank"
+            
+          >
+            Register for CookOff 10.0
+          </Link>
+        </div>
+
+        <div className="hidden md:block">
+          <Button className="bg-[#5c34e7] hover:bg-[#a6b0ff] focus:ring-2 focus:ring-offset-2 focus:ring-[#b2b8ff]">
+            <Link
+              className="flex items-center gap-x-2"
+              href="https://gravitas.vit.ac.in/events/bdfcebea-c141-4a61-ac73-61dec96c08f4"
+              rel="noopener noreferrer"
+              target="_blank"
+            >
+              <span>
+                <Image
+                  src="/cookoff.png" 
+                  alt="cookofflogo"
+                  height={20}
+                  width={20}
+                />
+              </span>
+
+              <span className="font-yerk text-xs text-gray-100">Register</span>
+            </Link>
+          </Button>
+        </div>
+      </div>
+    </>
+  );
+}
diff --git a/src/components/Navbar.tsx b/src/components/Navbar.tsx
@@ -24,6 +24,7 @@ import {
   DropdownMenuItem,
 } from "@/components/ui/dropdown-menu";
 import { useCourses } from "@/context/courseContext";
+import CookoffBanner from "./CookoffBanner";
 
 function Navbar() {
   const pathname: string = usePathname() ?? "/";
@@ -55,15 +56,16 @@ function Navbar() {
 
   return (
     <div className="sticky top-0 z-[50] w-full bg-[#B2B8FF] dark:bg-[#130E1F]">
-      <Banner
+      {/* <Banner
         bannerId="freshers"
         bgColor="#fef3c7"
         textColor="#5a3000"
         iconColor="#d97706"
         accentColor="#78350f"
         title="Attention Freshers!"
         message="If papers for your subject are not yet available, click on your subject and explore related subjects until papers become available, as these are newly introduced courses."
-      />
+      /> */}
+      <CookoffBanner />
       <div className="flex items-center justify-between bg-inherit px-4 py-4 md:px-8 md:py-5">
         {}
         <div className="relative flex items-center gap-4">
diff --git a/src/components/SideBar.tsx b/src/components/SideBar.tsx
@@ -48,9 +48,13 @@ function SideBar({
   const exams =
     filterOptions?.unique_exams.map((exam) => ({ label: exam, value: exam })) ?? [];
   const slots =
-    filterOptions?.unique_slots.map((slot) => ({ label: slot, value: slot })) ?? [];
+    filterOptions?.unique_slots
+      .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))
+      .map((slot) => ({ label: slot, value: slot })) ?? [];
   const years =
-    filterOptions?.unique_years.map((year) => ({ label: year, value: year })) ?? [];
+    filterOptions?.unique_years
+      .sort((a, b) => b.localeCompare(a)) 
+      .map((year) => ({ label: year, value: year })) ?? [];
   const semesters =
     filterOptions?.unique_semesters.map((semester) => ({
       label: semester,
