Skip to content
parduscPublic

About

Teknofest Pardus Yarışması için Yarışmacı ve Jürilerin kullanacağı sistem

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

97 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pardus Teknofest Application Platform

A web application for running the application and evaluation process of the Pardus Teknofest Competition (Pardus Hata Yakalama ve Geliştirme Yarışması).

Applicants apply to the competition through T3KYS. This platform covers the competition's own process: collecting category-specific applications, reviewing uploaded files, and scoring them with a jury.

Tech stack

  • Python 3.15
  • Django 6.1
  • SQLite
  • Keycloak for authentication and role management

Competition forms

Competition years, categories and form definitions are managed from the Django admin. Each FormDefinition belongs to one year and category and is built from ordered FormField definitions. The same definitions generate the applicant form and its validation through main.dynamic_forms.

Forms can be opened, put in review or closed manually from the admin, and each field can be hidden from reviewers. Staff members can preview a form before opening it.

Attachments and previews

Each form has an attachment profile. The default profile keeps JPEG/PNG images with the historical 2 MB per-file and 10 MB total limits. The webp_webm profile is intended for the bug/suggestion form: it accepts WebP images up to 5 MB and WebM videos up to 40 MB, with at most 2 videos, 10 files and 80 MB total per application.

Applicants and jury members see image thumbnails and video cards in a gallery. Clicking a card opens an in-page preview dialog (images are shown full size, videos play with controls) with a download action. Attachment previews are permission-checked; the original files are never served directly from MEDIA_ROOT.

When deploying, configure the reverse proxy to accept request bodies up to the total attachment limit (80 MB for the webp_webm profile).

Getting started

Requirements: Python 3.15 and uv (or plain venv + pip).

uv venv --python 3.15 .venv
source .venv/bin/activate
uv pip install -r requirements.txt

python teknofest/manage.py migrate
python teknofest/manage.py compilemessages -l tr
python teknofest/manage.py createsuperuser
python teknofest/manage.py runserver

The development server runs at http://127.0.0.1:8000/.

compilemessages requires gettext (msgfmt). It is only needed after editing locale/tr/LC_MESSAGES/django.po; the compiled .mo file is committed.

If you prefer plain venv:

python3.15 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Configuration

Settings are read from environment variables with development-friendly defaults:

Variable Default Description
DJANGO_SECRET_KEY insecure development key Secret key; must be set in production.
DJANGO_DEBUG 1 Set to 0 to disable debug mode.
DJANGO_ALLOWED_HOSTS localhost,127.0.0.1 Comma-separated list of allowed hosts.

Uploaded files are served through /media/<path> with permission checks. Do not configure the web server to serve MEDIA_ROOT directly.

Localization

Backend messages use Django's standard gettext catalogs. Turkish is the default language (LANGUAGE_CODE = "tr"); untranslated strings fall back to their English msgid.

  • Translations live in teknofest/locale/tr/LC_MESSAGES/django.po
  • After adding or changing strings, regenerate and compile the catalog:
cd teknofest
../.venv/bin/python manage.py makemessages -l tr --no-wrap
../.venv/bin/python manage.py compilemessages -l tr

Commit both django.po and django.mo.

Jury API

Jury members can create personal API keys from /jury/api-keys/ and use them with the JSON API. See docs/api.md for authentication, endpoints and examples.

License

This project is licensed under the GNU General Public License v3.0. See LICENSE.

About

Teknofest Pardus Yarışması için Yarışmacı ve Jürilerin kullanacağı sistem

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages