PutongOJ

Putong OJ

Putong OJ is an online judge system designed for competitive programming and algorithmic problem-solving. A live instance is available at acm.cjlu.edu.cn.

[!IMPORTANT]

The development of Putong OJ is closely tailored to the practical needs of the ACM Lab at CJLU, incorporating numerous customized features.

If you wish to deploy your own instance, we recommend forking the repository and modifying the code according to your requirements. Currently, Putong OJ does not support configuration options for these customized features.

[!CAUTION]

The current branch may contain untested changes after dependency upgrades and a project structure refactor. For production use, we strongly recommend using the last stable version: backend at commit 6c7b68c and frontend at commit ce13bf1.

Some features might be unstable until comprehensive testing is completed. Proceed with caution when deploying this version.

Features ✨

• One-Click Deployment – Easily deploy with Docker.
• Modern Web Interface – Built as a single-page application (SPA) using Vue.js.
• Scalable Architecture – Backed by Koa.js, MongoDB, and Redis for optimal performance.
• Multiple Testcases Support – Run and evaluate submissions with multiple testcases.
• Flexible Judging System – Supports various programming languages.
• Real-Time Status Updates – Monitor submissions and results dynamically.
• Contest Mode – Conduct coding contests with live rankings and scoreboard.
• Submission History – Track past submissions with insights.
• Code Execution Sandbox – Secure environment to prevent malicious execution.
• RESTful API Support – Extend functionality with API integrations.
• And much more...

Getting Started

Prerequisites

Before proceeding, ensure that you have the following installed:

• Docker
• MongoDB
• Redis

Build and Run

Build Docker Image

Run the following command to build the Docker image:

docker build -t ptoj-app .

Run the Application

Replace and with your actual database connection URLs:

docker run -d --name ptoj-app \
    -p 3000:3000 \
    -e NODE_ENV=production \
    -e PTOJ_MONGODB_URL= \
    -e PTOJ_REDIS_URL= \
    ptoj-app

This will start the application on port 3000.

Persistent Data Storage

To retain data across container restarts, mount the following volumes:

/app/data
/app/logs
/app/public/uploads

Setting Up the Judger

To configure the judging system, refer to ptoj-judger.

License

This project is licensed under the MIT License. See the LICENSE file for more details.