An all-in-one hackathon judging platform, created with modern technologies aimed at optimizing the user experience of hackers, judges, and organizers.
Home Page: https://jury.mikz.dev
License: MIT License
A project designed to create a new pairwise judging system using modern technologies, aimed at optimizing the user experience of judges, hackers, and organizers. See the inspiration for this project: Gavel by anishathalye. This project uses an individual ranking and rank aggregation system to automate the judging process and help organizers get more data from less judges to decide the winners of your hackathon.
To get started, check out the Jury documentation.
Check out our contributing docs.
No response
Page for adding projects. Should be within add-projects.tsx.
CRA is being deprecated.
Vite is the perfect drop-in replacement for CRA, and I want to replace it with the next generation of framework.
See this guide: https://www.robinwieruch.de/vite-create-react-app/
We are planning on sending out judging login codes using email. It would be a lot easier if judges could just click on a link and it auto log them in.
The form field for judging should be filled in automatically if a querystring is present. This querystring will be code and should be 6 alphanumeric digits. It should be ignored if not. An example URL will be: https://jury.hackutd.co/judge/login?code=AX5B2Q.
This should be filled in when the user loads the page.
Should we have it auto login (judge doesn't have to click the "login" button or should we just have it auto-fill and have judges click on the login button).
Sometimes we don't want to send emails or can't when creating judges.
Add a checkbox and perhaps a popup showing the judge code
checkbox above "Add"
Flags should be hidden eventually as the new flags get buried.
Add a "resolve flag" option for admins which hides it from the flags popup (also add a toggle in view flags that can show the resolved flags).
No response
No response
There should be an option to pause judging. This should just be a button somewhere on the main admin page, which lets admins pause the judging. This would pause the timer that will be implemented by #8.
Pausing judging will also show a message to judges once they finish judging the current project, basically saying that judging is paused by an administrator or something.
No response
Drag and drop should work normally on all devices
However, judges are reporting that the drag and drop feature does not work for all except the first 3 items. The "dropzone" does work when dropping stuff to the below items, but for some reason you can't drag any of the items starting from the 4th item...
No response
This issue is inconsistent across mobile devices (issue does not occur on PC)
Android Mobile Device, iOS Mobile Device
Chromium Mobile, Safari Mobile
No response
Generalize the popup.tsx component and use it for all the other custom popup components
The current popup.tsx component is BAD... well it's not that extensible and there's a lot of custom popups everywhere.
No response
The sliders for judge to rate projects don't have any CSS, so they are quite ugly. This should be fixed to match the design style more. See below.
Honestly this entire popup just needs to be improved UI-wise.
See the figma for an idea of how this should look TT
No response
Table view of projects; simply pull all projects from the database
The toggle switch is ugly as hell (but it technically works ig)
Match the figma design for the toggle switch. It should retain the same functionality; just look better. See the image below. Also add primaryLight to tailwind config as listed below if not already there. The ugly toggle switch was added in #11.
No response
Clicking "StoryStocks" in this case should link to the devpost page of that project (it should be stored in the project.url field)
No response
No response
Judges should be sent an email with their unique ID when they are added to the system. Ideally, we would have #10 done so we can just send a link to judges to click on. We would simply call an SMTP service to send emails. This would need to be added to the Dockerfile as env tokens.
No response
Currently, the GSL library requires us to use debian:bullseye-slim.
However, we can use a much smaller base image if we get rid of the GSL library dependency. We are LITERALLY only using it for rgsl::psi::diagamma::psi.
No response
It should show the average number of times an active judge has seen a project
It shows a big fat 0
No response
No response
No response
I don't know if this is because of the aggregation or something in the frontend but it should be a relatively easy fix...
It should just say "network connection issue" or smth of the sort.
It shows:
No response
Linux Computer
Firefox
No response
It should be scaled correctly to account for the screen width
No response
Android Mobile Device, iOS Mobile Device
Firefox Mobile, Chromium Mobile, Safari Mobile
No response
Users don't know to press the save button:
It should auto-save their rankings when they drag and drop items.
No response
CSVs should export
But there is a format error bc we changed the database so some properties just don't exist anymore.
No response
Linux Computer, Windows Computer
Firefox, Chromium (Chrome, Brave, Edge, Arc, Opera), Safari
Fix the export fields to match the correct fields
No response
This is a one line change lol; but basically don't change the lastUpdated field when we hide judges/projects
No response
You can't go back to the admin dashboard from the Add Judges or Add Projects page.
A simple "back" text button at the top; see figma ss below
When buttons are hovered, they expand. This is a BAD design choice and should be removed. This is bad on desktop and invisible anyways on mobile.
Linux Computer, Windows Computer, Mac Computer
Firefox Desktop, Chromium Desktop (Chrome, Brave, Edge, Arc, Opera), Safari Desktop
I believe we should replace this with an outline or change in background color.
Judging should continue with no time limit.
The "Start Judging" button persists during judging
No response
Mac Computer
Chromium (Chrome, Brave, Edge, Arc, Opera)
No response
No response
Page for adding judges. Should be within add-judges.tsx.
I would like to have custom alert popups instead of using the browser's default alert() feature.
Whenever we have a backend call, we need to send an alert to the user when it succeeds. I would love if we could have a nice-looking alert box!
I'm thinking this should be something that could be added to a page, with an alertOpen and alertText state variable.
<Alert text={alertText} open={alertOpen} setOpen={setAlertOpen} />Another option for implementation is to have this as a global component and use the zustand store which can update a global state variable and show the alert. (lowkey like this one better but it is harder)
See #73 - If no timer is set, the "start judging" button still shows up.
If there is no timer set, hide the whole timer component.
No response
Unsorted projects not very clear (that drag and drop line is hard to see), so many judges are judge sorting them under the line.
No response
It's a UX issue because judges don't know to put it above that line.
No response
No response
This has many different possible solutions, please discuss below before implementing.
No response
^ Literally just add this to a reasonable place in the README my branch is too messy and im lazy
No response
Using a database behind State could bottleneck use.
Instead, use the provided rocket_db_pools contrib library. It allows you guard requests with individual connections to the database rather than the connection pool. There is first class support for MongoDB.
MongoDB local container setup is jank sooooooo its prob a better idea to use Atlas by default.
Add a separate docker compose file for MongoDB Atlas and use it by default.
No response
The judging timer has a LOT of messy code within the live.tsx file (/judge/live). It's making the component REALLY big, and I would like for it to be split into its own component file.
No response
No response
We should have it filtered out. Could also add a checkbox to enable them
No response
No response
No response
No response
There is no info about whitelisting IPs in the README. Add that.
Add IP whitelist and a bit more detailed info in README about MongoDB setup.
No response
Oh boy. THIS CLOCK (see below) is the most janky thing I've ever implemented 😭 It doesn't tick correctly, it does weird stuff on resetting, and the database/client side just aren't synced. FIND A BETTER WAY TO IMPLEMENT THIS!!!!!!!!!1
No response
No response
No response
(also it happens on all devices lol)
Skipping a project should give you a completely different project.
But for some people it doesn't work. A temp fix (that works for SOME people) is to click "I want to take a break" and hope it reassigns you a new project.
No response
This is inconsistent to reproduce, but you would need multiple judges to be active at the same time. Have judges skip projects and eventually one of them should be unable to skip a project.
No response
No response
Uhhhh idk exactly what the best option is but I have a few ideas:
Also check the algorithm to make sure it's properly assigning projects to judges.
See what golang dependencies we're not using and get rid of them.
I noticed that the docker build was downloading the following, which I don't think we use:
jury-dev-backend | go: downloading golang.org/x/exp v0.0.0-20240409090435-93d18d7e34b8
jury-dev-backend | go: downloading golang.org/x/sync v0.7.0
No response
Right now it says this:
It should bring up an edit menu similar to judges, which allows you to edit the properties of projects -- this should NOT allow you to edit the location as that is autogenerated.
See the edit judges menu below:
No response
The script should wait for the database to accept connections before exiting.
Currently, the script is just closing after trying to connect after waiting for 10 seconds, which means the RS never gets initialized. Due to a certain person's slow computer, the MongoDB container takes more than 10 seconds to initialize and thus won't accept connections until afterwards.
Mac Computer
No response
It should loop in the bash script until the replica set initialization completes successfully
There's no good way to see what happened currently. Like when a judge votes for a project or when an admin changed.
I want all that logged somewhere admins can see in a nice UI.
No response
The MongoDB database name will always be "jury". This means that you can only have 1 copy of the db per cluster.
Create an environmental variable that the user can set for the database name. See the last line return client.Database("jury") in server/database/init.go.
Note that the env variable needs to be added to the following locations:
.env.templateREADME.mddocker-compose.ymlDockerfiledocker-compose.dev.ymldev.Dockerfiledocker-compose-mongo.ymldocker-compose-mongo.dev.yml.do/deploy.template.yamlAlso for reference, this is the "database" I am referring to in a MongoDB Atlas cluster:
It should be just stay at the top and not move when scrolled
It's set to position: fixed and so it scrolls with the screen :(
No response
No response
No response
Grouping the absent flag with the other flags actually doesn't make sense. The "skip" with the 2 options of busy/absent made a lot more sense and should be reverted from what is currently shown to the previous 3 options on flag and 2 options on skip popups respectively.
No response
See figma for reference:
No response
The timer should be fully functional and synced between multiple clients. It should start when judging starts and pause whenever judging stops. Since pausing and unpausing hasn't been implemented yet, just have it run whenever the server starts.
Don't worry about the time overflowing either lmao; it won't ever go over 99 hours. The design should already be implemented in AdminStatsPanel.tsx. See the image below for how it looks.
// Find next project
let next = match pick_next_project(db, &judge).await {
Ok(p) => p,
Err(_) => return (Status::InternalServerError, None),
};Errors messages are just... discarded :/
We should have some way for the end user to see error messages. This should also be logged in the server logs fs
No response
No response
Main table for judges
Emails should send normally through SMTP or the Sendgrid API.
Sometimes it just... doesn't work 😭 Idk what the root cause is but it's reported on multiple instances inconsistently.
No response
No response
No response
No response
https://tailwindcss.com/docs/content-configuration#dynamic-class-names
Because the popups use dynamic color class names, tailwind is not bundling the colors correctly!
No response
No response
Either:
I think the latter is probably better semantically but technically 1 works too -- depends on code complexity.
No response
Judging timer restarts on app restart
Save the judging time to the DB so if the app crashes we can just restart it from the same time. Also, we can add a feature to manually edit the judging time so if something goes wrong we can put in a correct time.
No response
No response
We should probably have indices for MongoDB queries. This would be for the judges/projects databases.
See https://www.mongodb.com/docs/manual/indexes/
Also note that these will have to be added to init-mongo.js for the local mongodb instance!
The "Busy" button should be clickable (see below)
Judges are confused bc how do you start judging if a project is busy??
No response
No response
No response
No response
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.