AdNova Backend
Prerequisites
Ensure you have the following installed on your system:
- Python (>=3.10,<3.14)
- uv (latest version recommended)
- Docker (for containerized setup, latest version recommended)
Basic setup
Installation
Clone the project
Go to the project directory
cd AdNova/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
Go to the project directory
cd AdNova/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
Go to the project directory
cd AdNova/services/backend
Install dependencies
uv sync --all-extras
Run tests
uv run coverage run --source="." manage.py test
Check coverage
uv run coverage report