https://github.com/ashrockzzz2003/slts-2024
Firebase powered app to view, analyze registrations and judge(grade) participants for different events of SLTS-2024.
https://github.com/ashrockzzz2003/slts-2024
firebase firebase-auth firebase-cli firestore hacktoberfest nextjs tailwindcss
Last synced: 8 months ago
JSON representation
Firebase powered app to view, analyze registrations and judge(grade) participants for different events of SLTS-2024.
- Host: GitHub
- URL: https://github.com/ashrockzzz2003/slts-2024
- Owner: Ashrockzzz2003
- License: gpl-3.0
- Created: 2024-11-26T08:35:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-07T06:34:14.000Z (8 months ago)
- Last Synced: 2025-10-07T08:34:32.202Z (8 months ago)
- Topics: firebase, firebase-auth, firebase-cli, firestore, hacktoberfest, nextjs, tailwindcss
- Language: JavaScript
- Homepage: https://slts-test.vercel.app
- Size: 2.53 MB
- Stars: 3
- Watchers: 1
- Forks: 3
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
> [!Important]
> The web app is deployed at https://slts-8e29d.web.app
> [!Note]
> This web app was used by 70+ judges concurrently to judge over 750 participants across 36 events, with each it’s unique criteria to grade!
# SLTS 2024
Firebase powered app to view, analyze registrations and judge(grade) participants for different events of SLTS-2024.
- [x] Firebase Auth with email password.
- [x] Dashboard for district wise DEC's and admin.
- [x] Filter by group, event name, district.
- [x] Search by student id and name.
- [x] Cached Login.
- [x] Data being read from Firestore.
- [x] Deployed using Firebase hosting.
- [x] Dashboards for event judges.
- [x] Judge can grade participants for individual events.
- [x] Admin can view events.
- [x] Admin can view leaderboard of individual events.
- [x] Admin can update the marking criteria of events.
- [x] Dynamic routes were optimized for cost through URL query parameters.
- [x] Admin dashboard, filter by needsPickup, needsDrop, arrivalDate, departureDate, checkInDate, checkOutDate.
- [x] Judge can grade participants for group events.
- [x] Judges can access curated-leaderboard.
- [x] Participants sorted in the judge view list to ensure that any student participating in 2 events gets more priority as the judges might be waiting for the student in other event.
- [x] On the day of actual event, registration desk can mark entry, report any corrections through corrections. Load optimized here by loading only one district data at a time as the participants are expected to arrive in a district-clustered manner.
- [x] Accomodation details well formatted and accessible where data is grouped by arrival time, and district wise count inside each arrival time for precise logistics preparation.
## Judging (a.k.a Grading)
Mobile View for Judge-related Pages
## Admin Dashboard
Laptop View for Dashboard Page
## Events Dashboard
### Event - Update Criteria
### Event - Leaderboard
## Accomodations Dashboard
## Registration Desk
### Select District
### Mark Entry/Add comments from Registration Desk
## Registration Entries/Comments View Live
# Setup Development
## Tech Setup
1. Fork the repo and clone the forked repo.
2. Install the latest LTS version of Node.js from https://nodejs.org/en in your machine.
## Initialize Firebase
3. Create a new project in [firebase](https://firebase.google.com) console.
4. Enable `Firestore(test mode)`, `Email/Password Authentication`, `Web App`.
5. Follow the steps in this [link](https://firebase.google.com/docs/admin/setup#initialize_the_sdk_in_non-google_environments) to setup Firebase Admin SDK which will be used to initially populate the Firestore database with test data.
6. Place the downloaded service account JSON file in the root directory of the project.
7. Rename the service account JSON file to `serviceAccountKey.json`.
## Run the app
8. Create a `.env` file in the root directory of the project in the below format and enter proper values. The values will be available in firebase console settings of the web app created.
```env
NEXT_PUBLIC_FIREBASE_API_KEY=""
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=""
NEXT_PUBLIC_FIREBASE_PROJECT_ID=""
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=""
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=""
NEXT_PUBLIC_APP_ID=""
```
9. In the root directory, run the below command to install dependencies.
```sh
npm i
```
10. In the root directory, run the below command to populate your Firestore database and auth with test data.
```sh
npm run firebase:init
```
11. In the root directory, to run the app in dev mode, run the below command.
```sh
npm run dev
```
12. Credentials
```
# Admin
admin@slts.cbe
password
# Judge Group Event Test Creds
judge1grag@slts.cbe
judge1grag
# Judge Individual Event Test Creds
judge4g3sg@slts.cbe
judge4g3sg
```
# Developers
`Ashwin Narayanan S`
`Gokula Krishnan`
`Vaibav V`
`Hari S K`
`Thilagan Iniyavan`