Add "Deployment"

Deployment.md

@@ -0,0 +1,65 @@
+# Деплой на сервер
+
+## Сервер
+
+- **Хостинг:** Timeweb Cloud VPS
+- **ОС:** Ubuntu 24.04
+- **Домен:** va.aspekter.ru
+- **SSL:** Let's Encrypt (certbot, auto-renew)
+
+## Различия DEV vs PROD
+
+### DEV (docker-compose.yml, на маке):
+- `./z51-pug-builder/src` → `/app/src` — монтируется, **HMR работает**
+- `./z51-pug-builder/vite.config.js` → монтируется, **нужен restart**
+- Контейнеры: `vaaspekter-builder-1`, `vaaspekter-email-gen-api-1`
+
+### PROD (docker-compose.prod.yml, на VPS):
+- **НЕТ монтирования src/ и vite.config.js** — всё запечено в Docker-образ
+- Только `./data` и `./email-gen` монтируются как volumes
+- Контейнеры: `va-builder`, `va-email-gen-api`
+
+## Процедура деплоя
+
+⚠️ **ВАЖНО:** Сборка на Mac (ARM) для x86 сервера — обязательно `--platform linux/amd64`!
+
+```bash
+# 1. Собрать образ
+docker build --platform linux/amd64 -f z51-pug-builder/Dockerfile -t vaaspekter-builder .
+
+# 2. Экспортировать
+docker save vaaspekter-builder | gzip > /tmp/va-builder.tar.gz
+
+# 3. Загрузить на сервер
+scp /tmp/va-builder.tar.gz root@45.144.221.96:/opt/va/
+
+# 4. На сервере
+ssh root@45.144.221.96
+cd /opt/va
+docker load < va-builder.tar.gz
+docker compose -f docker-compose.prod.yml up -d builder
+```
+
+## Пути на сервере
+
+| Путь | Описание |
+|---|---|
+| `/opt/va/docker-compose.prod.yml` | Prod compose |
+| `/opt/va/data/` | Данные (letters, settings, sessions) |
+| `/opt/va/email-gen/` | Pug-шаблоны |
+| `/etc/nginx/sites-enabled/aspekter` | Nginx конфиг |
+
+## Nginx
+
+- `va.aspekter.ru` → proxy к `127.0.0.1:6001` (builder)
+- `aspekter.ru` → лендинг (для будущего проекта)
+- `git.aspekter.ru` → Gitea
+- Блокировка сканеров: `.env`, `.git`, `.php`, `passwd` и т.п. → 444
+
+## Очистка Docker-образов
+
+После нескольких деплоев накапливаются старые образы. Очистка:
+
+```bash
+docker image prune -a -f
+```