MiniSolver

MiniSolver is made with love by tonsi and later updated for Sp25 by plourde27 In Sp25 and later semesters, the DOMJudge event feed tool (not made by us) unfortunately stopped working, so I implemented an alternative method to directly pull from submission and judgement data.

Updated Setup

[NOTE: there are a lot of ways that we could make this setup process easier for future contests]

1. Find the contest ID. This will be "dj-[number]"
2. Go to https://calicojudge.com/api/v4/contests/[contest id]/submissions and paste the JSON into the "submissions.json" file
3. Go to https://calicojudge.com/api/v4/contests/[contest id]/judgements and paste the JSON into the "judgements.json" file
4. Go to https://calicojudge.com/api/v4/contests/[contest id]/teams and paste the JSON into the "teams.json" file
5. Go to the scoreboard and find all the teams that are in-person. Manually paste each of the team names into the "inperson" dict in minisolver2.py (yes, there is definitely a better way to do this lol but I can't remember how I did it last semester and since there's only ~50 in-person teams it should probably work to just do it manually)
6. In minisolver2.py, update the list of problems on line 9 to be the ordered list of problem names for the current contest
7. In a terminal window, cd into the minisolver directory and run "python minisolver2.py"
8. On lines 122 and 123 of index.html, update window.problemScores and window.nSubparts with the scores and number of subparts for each problem of the current contest, respectively
9. On lines 505-507 of index.html, update all of "window.gold", "window.silver", and "window.bronze" to equal the number of in-person teams
10. Run the frontend locally, i.e. run "python -m http.server 8000" and open "0.0.0.0:8000/index.html" and follow the instructions onscreen to play the resolver during the ceremony

Historical Setup [No longer works from sp25 onward due to the icpctools app breaking]

During (or even before) the contest, update the minisolver.py script and the index.html webpage by changing every line marked with TODO to match the details for the current contest. All the information should be available on DOMjudge without the contest having begun.

Once the contest is over, before running the resolver, you'll need to get the event feed. This should be done using the standard ICPC resolver (https://github.com/icpctools/icpctools/tree/main/Resolver), with the following steps:

1. Make sure you're logged into DOMjudge as admin.
2. Go to https://calicojudge.com/jury/contests/ and find the ID number for the current contest.
3. Open a terminal and navigate to the folder where you downloaded the ICPC resolver, then go into the scripts folder and run the awards script (awards.bat on Windows, awards.sh on Mac/Linux).
4. Click the REST tab in the window that pops up.
5. Fill out the credentials of the DOMjudge admin account, and in URL write https://calicojudge.com/api/contests/CONTEST-ID/
6. You should get a window with a list of all the teams, don't worry about anything else on screen, just hit Save and name the file event-feed.json
7. Put this file in the same folder as minisolver.py, and run it. You should get a new text file called resolver-output.txt; now you can run the site!

Just opening the index.html page in your browser may not be enough to get the JavaScript working. To be safe, start a server in the resolver directory. To do this, open a terminal and cd to that folder, then run python -m http.server 8080. You will now be able to run it by navigating to http://localhost:8080/

And one more thing - you should make a list in advance of all the college teams, and save it as college-teams.txt. Unless you now tag teams based on whether they're HS or college internally in DOMjudge - in that case, let me know and I'll change the code.

Leaderboard

Every row of the leaderboard while in resolution contains the team's rank, name, score, and a list of cells for each problem in the contest. The colors of the cells indicate the status:

• Grey: no attempt
• Red: incorrect
• Green: correct
• Amber: still to be resolved
• Blue: submission queued

The scores and penalty times listed do not include problems that are still to be resolved. They will increase as resolutions are completed.

Note that you may have to zoom out your browser a bit to fit everything.

Modes

The resolver has two modes which can be configured in the javascript. Mode 1, which takes longer time, will only mention Bronze teams by name, putting Silver and Gold teams in the resolution stage. Mode 2, which takes shorter time, will move Silver teams to the first section (just honoring them by name).

Control

The key to advancing in the site (pun intended) is to just press space. If you're ever stuck, give it a press.

Once you click the Start button, the first event will be to honor all the teams that achieved a lower ranking. There is no live resolution; only their name and score will show. The names will fill the table automatically; once it's full, press space to generate more names.

Once all the lower ranked teams have been honored, the resolver stage will begin, featuring all the higher ranked teams. This is the heart of it all.

The following is what you can expect with each space press during the resolver stage:

• While the leaderboard is in the idle state (i.e. no rows highlighted), on a space press, the team at the bottom place still to be resolved will have their row highlighted.
• On the next space press, the highlighted team's next pending submission will be queued up by changing the corresponding cell color from amber to blue. This will allow you to create a bit of suspense.
• On the next space press, if the submission is incorrect, then the cell will turn red. Pressing again will queue up the team's next pending submission. If a submission is correct, then the cell will turn green and the leaderboard will be re-sorted to reflect the team's score increasing. The leaderboard is now in the idle state again.
• If the highlighted team has no more pending submissions, then a space press will cause the highlight to be removed and the leaderboard to move up one place. The leaderboard is now in the idle state again. However, if this team is in a special placing, then the next space press after this step will show a special screen congratulating the team. Pressing again after that will return to the leaderboard.

If there are ever any issues, then feel free to ping me @tonsi.mu in the CALICO Team server. No guarantee I'll be awake during the contest depending on where I am in the world, but I'll do my best.