# cms-dev/cms architecture

> Architecture diagram of the GitHub repository cms-dev/cms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cms-dev/cms
- Repository: https://github.com/cms-dev/cms

## Overview

CMS is a distributed programming-contest management system. Contestants use the contest web app to register, submit solutions, and view contest information; administrators manage contest data and operations. Submissions are evaluated by language/task-specific grading components, with results and scores coordinated by services and persisted in the database. The README also describes configurable task and scoring types. The graph emphasizes documented entry points and service connections; some implementation links remain uncertain because many source files were not sampled.

Main entry points: [`cms/service/EvaluationService.py`](https://github.com/cms-dev/cms/blob/main/cms/service/EvaluationService.py) (Evaluation Service), [`cms/server/contest/server.py`](https://github.com/cms-dev/cms/blob/main/cms/server/contest/server.py) (Contest Server), [`cms/server/contest/handlers`](https://github.com/cms-dev/cms/tree/main/cms/server/contest/handlers) (Contest Handlers), [`cms/server/admin/server.py`](https://github.com/cms-dev/cms/blob/main/cms/server/admin/server.py) (Admin Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Contest Web"]
  node_contest_server["Contest Server<br/>[server.py]"]
  node_contest_handlers["Contest Handlers"]
  node_submission_handler["Submission Handler<br/>[tasksubmission.py]"]
  node_admin_server["Admin Server<br/>[server.py]"]
  node_admin_handlers["Admin Handlers"]
  node_phase_management["Phase Management"]
  node_ranking["Ranking Web App"]
end

subgraph group_grading["Grading"]
  node_grading_job["Grading Job<br/>[Job.py]"]
  node_language_manager["Language Manager<br/>[languagemanager.py]"]
  node_task_types["Task Types"]
  node_grading_steps["Grading Steps"]
  node_scoring["Scoring<br/>[scoring.py]"]
end

subgraph group_services["Distributed Services"]
  node_evaluation_service["Evaluation Service"]
  node_scoring_service["Scoring Service<br/>[ScoringService.py]"]
  node_proxy_service["Proxy Service<br/>[ProxyService.py]"]
  node_service_rpc["Service RPC<br/>[rpc.py]"]
end

subgraph group_data["Contest Data"]
  node_database[("Contest Database")]
  node_file_cache[("File Cache<br/>[filecacher.py]")]
end

node_contestant(("Contestant"))
node_administrator(("Administrator"))

node_contestant -.->|"uses"| node_contest_server
node_administrator -.->|"uses"| node_admin_server
node_contest_server -->|"routes"| node_contest_handlers
node_contest_server -->|"connects"| node_evaluation_service
node_contest_server -->|"connects"| node_scoring_service
node_contest_server -->|"connects"| node_proxy_service
node_admin_server -->|"connects"| node_evaluation_service
node_admin_server -->|"connects"| node_scoring_service
node_submission_handler -->|"uses"| node_language_manager
node_submission_handler -->|"uses"| node_scoring
node_evaluation_service -->|"connects"| node_scoring_service
node_evaluation_service -->|"writes results"| node_database
node_evaluation_service -->|"uses"| node_grading_job
node_grading_job -->|"uses"| node_language_manager
node_grading_job -->|"uses"| node_database
node_evaluation_service -->|"uses"| node_service_rpc
node_contest_handlers -->|"uses"| node_phase_management
node_contest_handlers -->|"uses"| node_database

click node_contest_server "https://github.com/cms-dev/cms/blob/main/cms/server/contest/server.py"
click node_contest_handlers "https://github.com/cms-dev/cms/tree/main/cms/server/contest/handlers"
click node_submission_handler "https://github.com/cms-dev/cms/blob/main/cms/server/contest/handlers/tasksubmission.py"
click node_admin_server "https://github.com/cms-dev/cms/blob/main/cms/server/admin/server.py"
click node_admin_handlers "https://github.com/cms-dev/cms/tree/main/cms/server/admin/handlers"
click node_phase_management "https://github.com/cms-dev/cms/blob/main/cms/server/contest/phase_management.py"
click node_grading_job "https://github.com/cms-dev/cms/blob/main/cms/grading/Job.py"
click node_language_manager "https://github.com/cms-dev/cms/blob/main/cms/grading/languagemanager.py"
click node_task_types "https://github.com/cms-dev/cms/tree/main/cms/grading/tasktypes"
click node_grading_steps "https://github.com/cms-dev/cms/tree/main/cms/grading/steps"
click node_scoring "https://github.com/cms-dev/cms/blob/main/cms/grading/scoring.py"
click node_evaluation_service "https://github.com/cms-dev/cms/blob/main/cms/service/EvaluationService.py"
click node_scoring_service "https://github.com/cms-dev/cms/blob/main/cms/service/ScoringService.py"
click node_proxy_service "https://github.com/cms-dev/cms/blob/main/cms/service/ProxyService.py"
click node_service_rpc "https://github.com/cms-dev/cms/blob/main/cms/io/rpc.py"
click node_database "https://github.com/cms-dev/cms/tree/main/cms/db"
click node_file_cache "https://github.com/cms-dev/cms/blob/main/cms/db/filecacher.py"
click node_ranking "https://github.com/cms-dev/cms/blob/main/cmsranking/RankingWebServer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_contest_server,node_contest_handlers,node_submission_handler,node_admin_server,node_admin_handlers,node_phase_management,node_ranking toneBlue
class node_grading_job,node_language_manager,node_task_types,node_grading_steps,node_scoring toneAmber
class node_evaluation_service,node_scoring_service,node_proxy_service,node_service_rpc toneMint
class node_database,node_file_cache toneRose
class node_contestant,node_administrator toneIndigo
```

## Components

### Contest Web

- [Contest Server](https://github.com/cms-dev/cms/blob/main/cms/server/contest/server.py): `cms/server/contest/server.py`
- [Contest Handlers](https://github.com/cms-dev/cms/tree/main/cms/server/contest/handlers): `cms/server/contest/handlers`
- [Submission Handler](https://github.com/cms-dev/cms/blob/main/cms/server/contest/handlers/tasksubmission.py): `cms/server/contest/handlers/tasksubmission.py`
- [Admin Server](https://github.com/cms-dev/cms/blob/main/cms/server/admin/server.py): `cms/server/admin/server.py`
- [Admin Handlers](https://github.com/cms-dev/cms/tree/main/cms/server/admin/handlers): `cms/server/admin/handlers`
- [Phase Management](https://github.com/cms-dev/cms/blob/main/cms/server/contest/phase_management.py): `cms/server/contest/phase_management.py`
- [Ranking Web App](https://github.com/cms-dev/cms/blob/main/cmsranking/RankingWebServer.py): `cmsranking/RankingWebServer.py`

### Grading

- [Grading Job](https://github.com/cms-dev/cms/blob/main/cms/grading/Job.py): `cms/grading/Job.py`
- [Language Manager](https://github.com/cms-dev/cms/blob/main/cms/grading/languagemanager.py): `cms/grading/languagemanager.py`
- [Task Types](https://github.com/cms-dev/cms/tree/main/cms/grading/tasktypes): `cms/grading/tasktypes`
- [Grading Steps](https://github.com/cms-dev/cms/tree/main/cms/grading/steps): `cms/grading/steps`
- [Scoring](https://github.com/cms-dev/cms/blob/main/cms/grading/scoring.py): `cms/grading/scoring.py`

### Distributed Services

- [Evaluation Service](https://github.com/cms-dev/cms/blob/main/cms/service/EvaluationService.py): `cms/service/EvaluationService.py`
- [Scoring Service](https://github.com/cms-dev/cms/blob/main/cms/service/ScoringService.py): `cms/service/ScoringService.py`
- [Proxy Service](https://github.com/cms-dev/cms/blob/main/cms/service/ProxyService.py): `cms/service/ProxyService.py`
- [Service RPC](https://github.com/cms-dev/cms/blob/main/cms/io/rpc.py): `cms/io/rpc.py`

### Contest Data

- [Contest Database](https://github.com/cms-dev/cms/tree/main/cms/db): `cms/db`
- [File Cache](https://github.com/cms-dev/cms/blob/main/cms/db/filecacher.py): `cms/db/filecacher.py`

### Other components

- **Contestant**
- **Administrator**

## Connections

- Contestant → Contest Server: uses
- Administrator → Admin Server: uses
- Contest Server → Contest Handlers: routes (evidence: `cms/server/contest/server.py`)
- Contest Server → Evaluation Service: connects (evidence: `cms/server/contest/server.py`)
- Contest Server → Scoring Service: connects (evidence: `cms/server/contest/server.py`)
- Contest Server → Proxy Service: connects (evidence: `cms/server/contest/server.py`)
- Admin Server → Evaluation Service: connects (evidence: `cms/server/admin/server.py`)
- Admin Server → Scoring Service: connects (evidence: `cms/server/admin/server.py`)
- Submission Handler → Language Manager: uses (evidence: `cms/server/contest/handlers/tasksubmission.py`)
- Submission Handler → Scoring: uses (evidence: `cms/server/contest/handlers/tasksubmission.py`)
- Evaluation Service → Scoring Service: connects (evidence: `cms/service/EvaluationService.py`)
- Evaluation Service → Contest Database: writes results (evidence: `cms/service/EvaluationService.py`)
- Evaluation Service → Grading Job: uses (evidence: `cms/service/EvaluationService.py`)
- Grading Job → Language Manager: uses (evidence: `cms/grading/Job.py`)
- Grading Job → Contest Database: uses (evidence: `cms/grading/Job.py`)
- Evaluation Service → Service RPC: uses (evidence: `cms/service/EvaluationService.py`)
- Contest Handlers → Phase Management: uses (evidence: `cms/server/contest/handlers/contest.py`)
- Contest Handlers → Contest Database: uses (evidence: `cms/server/contest/handlers/main.py`)
