Skip to content

pushkar8723/aurora

Repository files navigation

Aurora v2

Web Docker Judge Docker

Aurora is an open-source OJ inspired by SPOJ. Derived from Aurora-Online-Judge, this version improves the scalability and security of the application to meet the requirements for a small scale organization. Its web interface is redesigned from scratch to make it look more SPOJ like. So that users find it comfortable to adjust. It can also serve as a platform to practice as well as compete with other teams. Few features were added so that the administrators find it easy to maintain. It was designed to meet the requirement specific to CQM matches hosted at BIT Mesra, but most of its components can be easily updated to meet the requirement of any other educational organization.

Getting Started

Aurora uses docker for development as well as for running the application. Images for each module is automatically generated and uploaded here. There are docker-compose files sepecific to following usecases.

Run Locally

docker-compose.yml can be used to simple run and test out Aurora on a local environment.

Simply run docker-compose up to pull all the images and run it.

Then visit localhost to test the application.

Note: Since we are using Github packages, you would need to configure docker for use with Github token or docker won't be able to pull the images and docker may start building the image instead. You can follow our Docker Setup Guide to mitigate this build step.

Dev Setup

docker-compose.dev.yml can be used to build, run and test out Aurora on a local environment.

Simply run docker-compose -f docker-compose.dev.yml build to build.

Run docker-compose -f docker-compose.dev.yml up to run it on localhost.

Prod Setup

docker-compose.prod.yml is meant to be used as template for prod configuration.

Check our guidelines on how to use this template.

Documentation

We are using Aurora Wiki to maintain our documentations.

Facing an issue

See if our FAQ Page has solution to your problem.

Still have problems? Then raise an issue here. I will try my best to solve it as soon as possible (no promises though).

Contribution Guilelines

Just create a PR on a seprate branch with appropriate name and describe the changes thoroughly. Also make sure you have full ownership of the code you submit.

Acknowledgement

  • Kaustubh Karkare, creator of Aurora Online Judge from which this version was derived.
  • Siddhartha Sahu, created functions.php which is extensively used for database interaction.

License

Released under the MIT License.