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

2026-06-27 10:30:00 +05:00
parent 969d958ec3
commit 8da6fa4d1d
6 changed files with 187 additions and 0 deletions
@@ -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
+	}
+}
@@ -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"]
@@ -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"
+```
@@ -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: