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.
- Python 3.15
- Django 6.1
- SQLite
- Keycloak for authentication and role management
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.
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).
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 runserverThe 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.txtSettings 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.
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 trCommit both django.po and django.mo.
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.
This project is licensed under the GNU General Public License v3.0. See LICENSE.