CodeArena Manager

A desktop application for running coding competitions. It manages participants, groups, rounds, scores, and leaderboards through a Tkinter interface and stores event state in JSON.

Features

• participant and group management;
• competition rounds and score entry;
• automatic grouping and validation;
• live leaderboard views;
• Ukrainian and English localization support;
• JSON persistence without an external database;
• MVC-style separation between models, views, controllers, and services.

Requirements

• Python 3.11+
• Tkinter, included with standard Python distributions on Windows and macOS

Linux users may need to install the system python3-tk package.

Run

python main.py

Application data is stored under data/.

Project structure

• controllers/ — application and screen orchestration;
• models/ — participants, rounds, scores, and event state;
• repositories/ — JSON persistence;
• services/ — grouping, scoring, validation, themes, and localization;
• views/ — Tkinter screens and dialogs;
• docs/functional_requirements/ — detailed UI requirements.

License

MIT. See LICENSE.