AdNova/services/backend/README.md

AdNova Backend

Prerequisites

Ensure you have the following installed on your system:

• Python (>=3.10,<3.12)
• uv
• Docker (for containerized setup)

Basic setup

Installation

Clone the project

git clone https://gitlab.prodcontest.ru/2025-final-projects-back/devitq.git

Go to the project directory

cd devitq/solution/services/backend

Customize environment

cp .env.template .env

And setup env vars according to your needs.

Install dependencies

For dev environment

uv sync --all-extras

For prod environment

uv sync --no-dev

Running

Apply migrations

uv run python manage.py migrate

Start celery worker

celery -A config worker -l INFO

Start server

In dev mode:

uv run python manage.py runserver

In prod mode:

uv run gunicorn config.wsgi

Containerized setup

Clone the project

git clone https://gitlab.prodcontest.ru/2025-final-projects-back/devitq.git

Go to the project directory

cd devitq/solution/services/backend

Build docker image

docker build -t adnova-backend .

Customize environment

Customize environment with docker run command (or bind .env file to container), for all environment vars and default values see .env.template.

Run docker image

Backend

docker run -p 8080:8080 --name adnova-backend adnova-backend

Celery worker

docker run --name adnova-celery-worker adnova-backend celery -A config worker -l INFO

Backend will be available on 127.0.0.1:8080.

Testing

Clone the project

git clone https://gitlab.prodcontest.ru/2025-final-projects-back/devitq.git

Go to the project directory

cd devitq/solution/services/backend

Install dependencies

uv sync --all-extras

Run tests

uv run coverage run --source="." manage.py test

Check coverage

uv run coverage report