# Бэкенд Videts. Базовый образ с Python 3.14 и uv.
FROM ghcr.io/astral-sh/uv:python3.14-bookworm-slim

ENV PYTHONUNBUFFERED=1 \
    PYTHONDONTWRITEBYTECODE=1 \
    UV_COMPILE_BYTECODE=1 \
    UV_LINK_MODE=copy \
    # Большие wheel'ы (numpy/opencv) не успевают за дефолтные 30с.
    UV_HTTP_TIMEOUT=300 \
    # Ставим зависимости прямо в системный python — gunicorn/celery/manage.py
    # доступны в PATH без `uv run`.
    UV_PROJECT_ENVIRONMENT=/usr/local

# Версия приложения → Sentry release (#67). CI передаёт semver/SHA через
# --build-arg APP_VERSION=...; по умолчанию пусто (release не проставляется).
ARG APP_VERSION=""
ENV APP_VERSION=$APP_VERSION

# Пути данных в образе заданы явно (#388): с версии с VIDETS_DATA_DIR дефолты
# выводятся из каталога данных (/var/lib/videts и т.п.), а в контейнере они
# другие и менять их нельзя — том записей смонтирован в /recordings и общий с
# MediaMTX, у которого recordPath зашит на /recordings/... (docker/mediamtx.yml).
# EXPORTS_DIR при явном RECORDINGS_DIR остаётся прежним /recordings/_exports.
ENV RECORDINGS_DIR=/recordings \
    MEDIA_ROOT=/app/media

# DJANGO_SETTINGS_MODULE дефолта не имеет намеренно (#62): забытая переменная
# при деплое поднимала бы прод на settings.local (DEBUG, CORS allow-all).
# Значение задаёт compose/оркестратор; без него entrypoint падает сразу.

# Системные библиотеки для opencv-headless / pillow;
# procps — pgrep для healthcheck'а celery-beat;
# ffmpeg — бинарь для превью/снапшотов (services/mediamtx/snapshot.py, FFMPEG_BIN, #251):
# opencv-python-headless его не даёт, без него фича молча мертва.
RUN apt-get update && apt-get install -y --no-install-recommends \
        ffmpeg \
        libglib2.0-0 \
        procps \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app

# Слой зависимостей кешируется отдельно от кода — пересобирается только при
# изменении манифестов.
COPY pyproject.toml uv.lock ./
RUN uv sync --frozen --no-dev --no-install-project

# Код приложения.
COPY . .
RUN uv sync --frozen --no-dev

COPY docker/entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

# Всё приложение работает под непривилегированным пользователем (#62).
# /recordings создаётся в образе: первый смонтировавший том контейнер передаст
# ему владельца app (MediaMTX в compose работает тем же uid 1000). /app/media —
# так же (#252): пустой именованный том получает владельца из образа, а без
# каталога в образе он был бы root-овым и превью не записались бы. /app/data —
# корень данных в контейнере: compose-стенды не задают VIDETS_DATA_DIR, и
# путь выводится из BASE_DIR (core/paths.py). Без каталога в образе том был бы
# root-овым, и выпуск сертификата удалённого доступа (#803) падал с PermissionError.
RUN useradd --create-home --uid 1000 app \
    && mkdir -p /recordings /app/staticfiles /app/media /app/data \
    && chown app:app /recordings /app/staticfiles /app/media /app/data
USER app

ENTRYPOINT ["/entrypoint.sh"]
# Потоки (gthread), а не sync-воркеры (#381): sync-воркер, занятый ответом дольше
# --timeout (30 с), gunicorn убивает — а файл сегмента или экспорта медленному
# клиенту отдаётся минутами. У gthread «я жив» шлёт главный поток воркера, долгий
# ответ его не губит и занимает один поток, а не весь воркер.
#
# Порт — из VIDETS_WEB_PORT (#410): в host-сети 8000 бывает занят чужой
# службой, и тогда стек не поднимается вовсе. Значение подставляет шелл, поэтому
# команда идёт через `sh -c`; `exec` обязателен — иначе PID 1 остался бы шеллом,
# и SIGTERM от `docker stop` не дошёл бы до gunicorn (останов по таймауту).
# Та же переменная называет порт у nginx образа фронта и у супервизора
# нативной установки (`videts run`).
#
# Адрес — из VIDETS_WEB_HOST (#522), как у супервизора, и дефолт тот же —
# 127.0.0.1: в host-сети (compose.prod.yaml) 0.0.0.0 открыл бы Django всей LAN
# мимо nginx. Дефолт в образе, а не только в compose, — чтобы исправление дошло
# и до установок со старым compose.prod.yaml (скрипт обновления до #682 его не менял).
# Bridge-стенды (compose.yaml) и стенд без nginx (docker/dev/host.yaml) задают
# 0.0.0.0 явно.
CMD ["sh", "-c", "exec gunicorn config.wsgi:application --bind ${VIDETS_WEB_HOST:-127.0.0.1}:${VIDETS_WEB_PORT:-8000} --workers 3 --threads 8"]
