{"id":20053027,"url":"https://github.com/xaralis/ksicht","last_synced_at":"2025-05-05T12:30:26.682Z","repository":{"id":41924669,"uuid":"220009917","full_name":"xaralis/ksicht","owner":"xaralis","description":"This is the KSICHT annual chemistry competition website that allows elementary and high schools students to show off theirs skills on a challenging tasks.","archived":false,"fork":false,"pushed_at":"2024-11-04T12:33:12.000Z","size":2373,"stargazers_count":3,"open_issues_count":20,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-08T22:51:12.043Z","etag":null,"topics":["chemistry","django","website"],"latest_commit_sha":null,"homepage":"https://ksicht.natur.cuni.cz/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xaralis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-06T14:01:26.000Z","updated_at":"2024-11-04T12:31:16.000Z","dependencies_parsed_at":"2023-09-22T21:09:55.492Z","dependency_job_id":"729e015d-1e84-44c1-b939-a07c908c1982","html_url":"https://github.com/xaralis/ksicht","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xaralis%2Fksicht","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xaralis%2Fksicht/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xaralis%2Fksicht/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xaralis%2Fksicht/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xaralis","download_url":"https://codeload.github.com/xaralis/ksicht/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252497388,"owners_count":21757603,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chemistry","django","website"],"created_at":"2024-11-13T12:21:24.132Z","updated_at":"2025-05-05T12:30:26.024Z","avatar_url":"https://github.com/xaralis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# What is this?\n\nThis is the KSICHT [chemistry competition website](https://ksicht.natur.cuni.cz/)\nthat allows elementary and high schools students to show off theirs skills on\na series of challenging tasks.\n\nThe competition takes place annually and consist of 4 quaterly series that\nloosely follow the general school year, e.g. starts on autumn and finishes at\nlate spring. Each series has approx. 5 tasks to complete and contenders\nwill receive points for each task separately. They can also receive bonus\nbadges for various acheievements. The contestant to receive the most\npoints in total, wins.\n\n## Tech details\n\nThis app is built with Python powered by [Django](https://www.djangoproject.com/)\nwith the usual bells and whitles. Styling is based on\nthe [Bulma CSS framework](https://bulma.io/). We use PostgreSQL as the database.\n\n## Development\n\nPlease make sure you have [NVM](https://github.com/nvm-sh/nvm) installed first.\n\n### Installing\n\nActivate NVM:\n\n```bash\nnvm use\n```\n\nThere is a `Makefile` to simplify tasks. Start by creating your Python virtual\nenv:\n\n```bash\nmake init-env \u0026\u0026 source .env/bin/activate\n```\n\nNext, install dependencies including the dev and test stuff:\n\n```bash\n\nmake install \u0026\u0026 make install-dev \u0026\u0026 make install-test\n```\n\nYou will also need to boostrap your database. By default, a PostgreSQL database named\n`ksicht` is expected to exist on your local machine. This can be modified by\noverriding the `DATABASE_DSN` env variable when running the app.\n\nFirst though, you'll need the database to exist:\n\n```bash\ncreatedb ksicht\n```\n\nOnce there, initialize the database by issuing:\n\n```bash\nmake migrate\n```\n\nThis will run Django migrations \u0026 will create all the necessary tables.\n\n### Running the app\n\nJust run this:\n\n```bash\nmake run\n```\n\n### Running tests\n\nAgain, use the `Makefile`:\n\n```bash\nmake test\n```\n\n### Building \u0026 deploying\n\nThis app is distributed as a Docker container\nand [hosted on Docker Hub](https://hub.docker.com/r/xaralis/ksicht).\nMakefile provides all the necessary commands:\n\n```bash\nmake build \u0026\u0026 make push\n\n# Shortcut to the above:\nmake release\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxaralis%2Fksicht","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxaralis%2Fksicht","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxaralis%2Fksicht/lists"}