Initial commit

docs/deployment.md

@@ -0,0 +1,23 @@
+# Запуск и деплой
+
+## Локальный запуск (DEV)
+1. Заполните `.env.v1`, `.env.v2`, `.env.db` по образцам из [env-examples.md](./env-examples.md).
+2. Запустите: `docker compose up -d` в корне проекта.
+3. Проверьте:
+   - API v1: `http://localhost/api/v1/`
+   - API v2: `http://localhost/api/v2/`
+   - Nginx статус: `http://localhost/status`
+   - Prometheus: `http://localhost:9090`
+   - Alertmanager: `http://localhost:9093`
+
+## Продакшен (общие рекомендации)
+- Используйте секреты: Docker Swarm/K8s Secrets, Vault или SSM Parameter Store.
+- Ограничьте `/status` (Nginx stub_status) по IP/ACL.
+- Разнесите экспортеры и Prometheus на отдельные ноды.
+- Настройте резервное копирование для Postgres и ретеншен для Prometheus.
+- Добавьте Grafana для визуализации (рекомендуется).
+
+## Обновление стека
+- Обновить конфиги: `monitoring/*`, `nginx/nginx.conf`, `.env.*`.
+- Перезапуск: `docker compose up -d`.
+- Проверка таргетов: `http://localhost:9090/targets`.