feat: docker & startup

app/workers/arq_worker.py

@@ -24,8 +24,12 @@ async def shutdown(_ctx: dict[str, Any]) -> None:
     log.info("worker_shutdown")
 
 
+async def _noop(_ctx: dict[str, Any]) -> None:
+    pass
+
+
 class WorkerSettings:
-    functions: ClassVar[list[Any]] = []  # populated as tasks are implemented
+    functions: ClassVar[list[Any]] = [_noop]  # populated as tasks are implemented
     on_startup = startup
     on_shutdown = shutdown
     max_jobs = get_settings().max_parallel_downloads

dockerfiles/Dockerfile.dev

@@ -0,0 +1,34 @@
+# syntax=docker/dockerfile:1
+# DEV image: source is bind-mounted by compose, uvicorn runs with --reload.
+# Build context = mcma-backend/ (see docker-compose.yml).
+FROM python:3.14-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    UV_LINK_MODE=copy \
+    VIRTUAL_ENV=/app/.venv \
+    PATH="/app/.venv/bin:$PATH"
+
+# Runtime tools: ffmpeg (transcode/HLS), fpcalc (Chromaprint fingerprinting).
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends ffmpeg libchromaprint-tools \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=ghcr.io/astral-sh/uv:0.4 /uv /uvx /bin/
+
+WORKDIR /app
+
+# Dependency layer (incl. dev group for tooling) — cached unless lockfile changes.
+COPY pyproject.toml uv.lock* ./
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-install-project
+
+# Project layer. At runtime compose bind-mounts the live source over this.
+COPY . .
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen
+
+EXPOSE 8000
+
+# --reload watches /app (the bind mount) and restarts on edit.
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

dockerfiles/Dockerfile.prod

@@ -1,5 +1,7 @@
 # syntax=docker/dockerfile:1
-# Single image serves both `api` and `worker` (different commands in compose).
+# PROD image: self-contained, no dev deps, no source mount.
+# Single image serves both `api` and `worker` (different commands at runtime).
+# Build context = mcma-backend/.
 FROM python:3.14-slim AS base
 
 ENV PYTHONUNBUFFERED=1 \
@@ -18,7 +20,7 @@ COPY --from=ghcr.io/astral-sh/uv:0.4 /uv /uvx /bin/
 
 WORKDIR /app
 
-# Dependency layer — cached unless lockfile changes.
+# Dependency layer (prod only) — cached unless lockfile changes.
 COPY pyproject.toml uv.lock* ./
 RUN --mount=type=cache,target=/root/.cache/uv \
     uv sync --frozen --no-install-project --no-dev
@@ -30,5 +32,5 @@ RUN --mount=type=cache,target=/root/.cache/uv \
 
 EXPOSE 8000
 
-# Default: API server. Worker overrides command in docker-compose.
+# Default: API server. Worker overrides command (arq ...) at runtime.
 CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

pyproject.toml

@@ -2,7 +2,6 @@
 name = "mcma-backend"
 version = "0.1.0"
 description = "Self-hosted, offline-first music service — backend (hexagonal architecture)"
-readme = "README.md"
 requires-python = ">=3.14"
 dependencies = [
     # web