Skip to content

johnbrvc/ccs-specs

 
 

Repository files navigation

Contest Control System specifications

This repository contains a set of related specifications for interoperability between different contest control systems and tooling that interacts with it. These specifications have been designed and used in the contest of the ICPC World Finals, and have also been used at various (sub)regionals; they are meant to be useful outside an ICPC context as well.

The following specifications are present:

  • Contest Control System requirements for the ICPC World Finals
  • JSON Format: the shared data model defining the JSON objects used across these specifications.
  • Contest API: an API specification for accessing information provided by a CCS.
  • Contest Package Format: a format closely related to the Contest API for storing a contest on disk.

Furthermore, a tool and JSON schema specifications are available to validate an implementation of the Contest API. Run check-api.sh -h from the root of the repository for usage information.

There are multiple versions of the CCS specifications available on the documentation pages.

This is the draft of some future version of the CCS specification.

Changes compared to the 2026-01 version

  • Extracted a new JSON Format specification containing the shared data model (JSON property types, object definitions, and notification object format) previously embedded in the Contest API. The Contest API and Contest Package Format now reference this document for all shared object definitions.

References

About

Contest Control System specifications

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Shell 64.9%
  • PHP 35.1%