Initial commit

docs/README.md

@@ -0,0 +1,18 @@
+# Документация проекта
+
+Добро пожаловать! Этот раздел содержит полную документацию по проекту, навигацию по подсекциям, примеры конфигураций и инструкции по развёртыванию и публикации в Gitea.
+
+## Навигация
+- [Обзор и требования](./overview.md)
+- [Запуск и деплой](./deployment.md)
+- [Мониторинг: метрики и алёрты](./monitoring.md)
+- [Примеры .env файлов](./env-examples.md)
+- [Публикация в Gitea](./gitea.md)
+- [Диагностика и троблшутинг](./troubleshooting.md)
+
+## Быстрый старт
+- Скопируйте и заполните `.env.v1`, `.env.v2`, `.env.db` по образцам из [env-examples.md](./env-examples.md).
+- Запустите `docker compose up -d` из корня проекта.
+- Проверьте таргеты в Prometheus: `http://localhost:9090/targets`.
+- Проверьте метрики экспортеров: Nginx `http://localhost:9113/metrics`, PHP-FPM `http://localhost:9253/metrics`, Postgres `http://localhost:9187/metrics`, Memcached `http://localhost:9150/metrics`.
+- Alertmanager UI: `http://localhost:9093` (настройте получателей в `monitoring/alertmanager.yml`).