AdNova/solution/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

In dev mode

Apply migrations:

uv run python manage.py migrate

Start project:

uv run python manage.py runserver

In prod mode

Apply migrations:

uv run python manage.py migrate

Start project:

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

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

Backend will be available on localhost:8080.