feat(infra): контейнеризация и деплой за Caddy

infra/Caddyfile

@@ -0,0 +1,15 @@
+# Маршрутизация MedArchive за Caddy на Selectel KZ.
+# /api/* — бэкенд, /demo — презентация (reveal.js), остальное — приложение.
+# Reload только через stdin (sed -i ломает bind mount).
+med.secondbrain.tools {
+	handle_path /api/* {
+		reverse_proxy api:8000
+	}
+	handle /demo* {
+		root * /srv
+		file_server
+	}
+	handle {
+		reverse_proxy web:3000
+	}
+}

infra/deploy/Caddyfile

@@ -0,0 +1,23 @@
+{
+	email admin@secondbrain.tools
+	acme_ca https://acme-v02.api.letsencrypt.org/directory
+}
+
+med.secondbrain.tools {
+	handle_path /api/* {
+		reverse_proxy api:8000
+	}
+	handle /demo* {
+		root * /srv
+		file_server
+	}
+	handle /day1* {
+		root * /srv
+		file_server
+	}
+	handle {
+		root * /web
+		file_server
+		encode gzip
+	}
+}

infra/deploy/Dockerfile

@@ -0,0 +1,24 @@
+# Образ API MedArchive: зависимости ставятся один раз в слой образа, код проекта
+# монтируется томом (/root/medarchive:/app) — правки кода не требуют пересборки.
+# Тяжёлые зависимости (pdfplumber, pymupdf, google-genai) нужны для приёма ZIP через
+# интерфейс (/ingest): распаковка, распознавание и нормализация идут прямо на сервере.
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Зависимости рантайма. Версии — как в pyproject.toml.
+RUN pip install --no-cache-dir \
+    "fastapi>=0.115" \
+    "uvicorn[standard]>=0.32" \
+    "pydantic>=2.9" \
+    "python-multipart>=0.0.12" \
+    "openpyxl>=3.1" \
+    "xlrd>=2.0" \
+    "python-docx>=1.1" \
+    "pdfplumber>=0.11" \
+    "pymupdf>=1.24" \
+    "rapidfuzz>=3.10" \
+    "numpy>=2.0" \
+    "google-genai>=1.0"
+
+CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "8000"]

infra/deploy/README.md

@@ -0,0 +1,42 @@
+# Деплой MedArchive
+
+Контейнер API (FastAPI) за общим Caddy на Selectel KZ. Read-only поиск работает на
+готовой SQLite-базе; приём ZIP через интерфейс (`/ingest`) дораспаковывает и нормализует
+новые прайсы прямо на сервере, поэтому в образ включены тяжёлые зависимости (pdfplumber,
+pymupdf, google-genai), а контейнеру нужен ключ Gemini.
+
+## Раскладка на сервере
+
+- `/root/medarchive/` — код и данные, монтируется в контейнер как `/app`:
+  - `api/`, `contracts/`, `etl/` — код (правки кода не требуют пересборки образа);
+  - `web/` — статический фронт (его же отдаёт Caddy);
+  - `data/medarchive.db` — собранная база, `data/quality_report.json` — отчёт сборки;
+  - `data/dict_emb.npy` — кэш эмбеддингов справочника (чтобы догрузка не пересчитывала его);
+  - `data/reference/dictionary.xlsx` — эталонный справочник услуг для нормализации.
+- `/root/med-hackathon/` — каталог Caddy: `docker-compose.yml`, `Dockerfile`, `Caddyfile`,
+  `site/` (презентации) и `.env` с `GEMINI_API_KEY` (в публичный репозиторий не попадает).
+
+## Шаги
+
+1. Залить код и данные в `/root/medarchive/` (см. раскладку выше).
+2. Положить `docker-compose.yml`, `Dockerfile`, `Caddyfile` в `/root/med-hackathon/`.
+3. Создать `/root/med-hackathon/.env`:
+   ```
+   GEMINI_API_KEY=…
+   ```
+4. Собрать образ и поднять стек:
+   ```bash
+   cd /root/med-hackathon
+   docker compose build api
+   docker compose up -d
+   ```
+5. Маршруты Caddy: `/api/*` → контейнер API, `/` → фронт, `/demo` и `/day1` → презентации.
+
+## Проверка
+
+```bash
+curl https://med.secondbrain.tools/api/health
+curl https://med.secondbrain.tools/api/stats
+# приём архива через интерфейс:
+curl -X POST https://med.secondbrain.tools/api/ingest -F "file=@archive.zip"
+```

infra/deploy/docker-compose.yml

@@ -0,0 +1,35 @@
+services:
+  caddy:
+    image: caddy:2-alpine
+    container_name: caddy
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+      - ./site:/srv:ro
+      - /root/medarchive/web:/web:ro
+      - caddy_data:/data
+      - caddy_config:/config
+
+  api:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: medarchive-api:latest
+    container_name: medarchive-api
+    restart: unless-stopped
+    working_dir: /app
+    volumes:
+      - /root/medarchive:/app
+    environment:
+      MEDARCHIVE_DB: /app/data/medarchive.db
+      # Ключ Gemini для распознавания и эмбеддингов при загрузке архива (/ingest).
+      # Значение — из .env рядом с этим файлом (в публичный репозиторий не попадает).
+      GEMINI_API_KEY: ${GEMINI_API_KEY:-}
+    command: ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "8000"]
+
+volumes:
+  caddy_data:
+  caddy_config:

infra/docker-compose.yml

@@ -0,0 +1,48 @@
+# Стек MedArchive: PostgreSQL+pgvector, API (FastAPI), фронт (Next.js).
+# Деплой — на Selectel KZ за общим Caddy (см. Caddyfile). Dockerfile'ы api/web
+# добавляет агент F. Секреты — только из .env (в репозиторий не попадают).
+services:
+  db:
+    image: pgvector/pgvector:pg16
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: medarchive
+      POSTGRES_USER: medarchive
+      POSTGRES_PASSWORD: ${DB_PASSWORD}
+    volumes:
+      - db_data:/var/lib/postgresql/data
+      - ../db/migrations:/docker-entrypoint-initdb.d:ro   # схема накатывается при инициализации
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U medarchive -d medarchive"]
+      interval: 5s
+      timeout: 3s
+      retries: 12
+
+  api:
+    build:
+      context: ..
+      dockerfile: infra/api.Dockerfile
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: postgresql://medarchive:${DB_PASSWORD}@db:5432/medarchive
+      GEMINI_API_KEY: ${GEMINI_API_KEY}
+    depends_on:
+      db:
+        condition: service_healthy
+    ports:
+      - "8000:8000"
+
+  web:
+    build:
+      context: ../web
+      dockerfile: ../infra/web.Dockerfile
+    restart: unless-stopped
+    environment:
+      NEXT_PUBLIC_API_BASE: /api
+    depends_on:
+      - api
+    ports:
+      - "3000:3000"
+
+volumes:
+  db_data: