fix: PageHead header alignment, analytics proxy, and infra improvements (#64)

🤖 Pull request created from `various-fixes` containing PageHead
breadcrumbs and navigation alignment fixes, Umami analytics proxy, and
infrastructure updates.

services/docs/content/ru/quetza/troubleshooting/_index.md

@@ -3,10 +3,10 @@ title: Устранение неполадок
 weight: 5
 ---
 
-Устранение неполадок в **Quetza** фокусируется на диагностике структурных и концептуальных проблем. Из-за его природы, основанной на соглашениях (convention-based), большинство ошибок протекают бесшумно (отсутствующие файлы), а не с шумом (трассировка стека/stack traces).
+Диагностика неполадок в **Quetza** в основном касается структуры файлов и концептуальных ошибок. Поскольку фреймворк опирается на соглашения (convention-based), многие сбои происходят «молча» — например, модуль не загружается из-за неверного пути к файлу, не вызывая явных ошибок и трассировок стека.
 
 ## Основные категории проблем
 
 {{% cards %}}
-{{< card link="diagnostics" title="Руководство по диагностике" icon="exclamation" subtitle="Решения для обнаружения модулей, регистрации команд и утечек состояния." >}}
+{{< card link="diagnostics" title="Руководство по диагностике" icon="exclamation" subtitle="Решение проблем с загрузкой модулей, регистрацией команд и утечками состояния." >}}
 {{% /cards %}}

services/docs/content/ru/quetza/troubleshooting/diagnostics.md

@@ -3,39 +3,39 @@ title: Диагностика
 weight: 1
 ---
 
-**Цель:** Определить и устранить распространенные ловушки при разработке Quetza.
+**Цель:** выявить и устранить частые ошибки при разработке под Quetza.
 
 ## 1. Сбои при обнаружении модулей
 
-**Симптом:** Бот запускается, но ваш модуль игнорируется.
-**Причина:** Нарушение соглашений файловой системы.
+**Симптом:** бот запускается, но модуль не подхватывается.
+**Причина:** нарушена структура файлов или соглашения об именах.
 
 {{% details title="Чек-лист: Структура директорий" closed="false" %}}
 
-- [ ] Существует ли `src/modules/<name>/`?
-- [ ] Экспортирует ли `module.ts` переменную `name`?
-- [ ] Находятся ли команды в `commands/` (а не в `cmds/`)?
-- [ ] Запустили ли вы `pnpm build`? (Quetza запускается из `dist/`).
+- [ ] Каталог модуля существует: `src/modules/<name>/`.
+- [ ] Файл `module.ts` экспортирует переменную `name`.
+- [ ] Каталог команд называется именно `commands/` (а не `cmds/`).
+- [ ] Выполнена сборка `pnpm build` (Quetza работает из `dist/`).
       {{% /details %}}
 
 ## 2. Проблемы с регистрацией команд
 
-**Симптом:** Команда `/command` не появляется в Discord.
+**Симптом:** команда `/command` не появляется в Discord.
 
-### Глобальная регистрация против регистрации в тестовой гильдии (Guild)
+### Глобальная регистрация и регистрация на тестовом сервере
 
-- **Глобальная:** Команды, отправленные в приложение глобально, могут обновляться до 1 часа и подчиняются более строгим ограничениям скорости (rate limits).
-- **Тестовая гильдия:** Quetza автоматически отправляет команды в конкретную гильдию в режиме разработки для мгновенного обновления.
-  - **Требование:** Убедитесь, что `NODE_ENV=development` и `DEV_GUILD_ID` корректно установлены в вашем `.env`.
+- **Глобальная регистрация:** команды, зарегистрированные глобально, могут обновляться до 1 часа и подпадают под жёсткие лимиты Discord по частоте запросов (rate limits).
+- **Тестовый сервер (guild):** в режиме разработки Quetza публикует команды на указанном сервере мгновенно.
+  - **Настройка:** проверьте, что в `.env` установлены переменные `NODE_ENV=development` и `DEV_GUILD_ID`.
 
-### Ограничения скорости (Rate Limits)
+### Лимиты частоты запросов (Rate Limits)
 
-Частые обновления глобальных команд могут вызвать ограничения скорости со стороны Discord. Используйте тестовую гильдию для итеративной разработки.
+Частая повторная публикация глобальных команд приводит к превышению лимитов Discord. Для итеративной разработки всегда используйте тестовый сервер.
 
 ## 3. Ошибки взаимодействия (Interaction Failures)
 
-**Симптом:** «Приложение не отвечает».
-**Причина:** Выполнение команды заняло более 3 секунд без отложенного ответа (deferral).
+**Симптом:** сообщение «Приложение не отвечает».
+**Причина:** обработка команды длилась дольше 3 секунд без отложенного ответа (deferReply).
 
 **Решение:**
 
@@ -52,22 +52,22 @@ await interaction.editReply('Готово');
 
 ## 4. Утечки состояния
 
-**Симптом:** Потребление памяти ботом растет; странности во взаимодействии между серверами.
-**Причина:** Хранение состояния глобально вместо уровня гильдии.
+**Симптом:** потребление памяти растёт, данные перемешиваются между разными серверами.
+**Причина:** состояние хранится глобально, а не изолированно для каждого сервера.
 
 **Диагностика:**
-Проверьте ваш контроллер.
+Проверьте код контроллера:
 
-- ❌ `private player: AudioPlayer;` (Общий для всех!)
-- ✅ `private players = new Map<string, AudioPlayer>();` (Разделен по ID гильдии).
+- ❌ `private player: AudioPlayer;` (состояние общее для всех серверов)
+- ✅ `private players = new Map<string, AudioPlayer>();` (состояние изолировано по ID сервера)
 
 ## 5. Обработка событий
 
-**Симптом:** События срабатывают несколько раз или не срабатывают вовсе.
+**Симптом:** обработчик срабатывает несколько раз или не вызывается вовсе.
 
-- **Несколько раз:** События являются аддитивными. Не зарегистрировали ли вы один и тот же обработчик в двух модулях?
-- **Ни разу:** Правильно ли вы экспортировали `name` и `execute`?
+- **Срабатывает несколько раз:** слушатели событий суммируются. Проверьте, не зарегистрирован ли один и тот же обработчик в двух разных модулях.
+- **Не срабатывает:** убедитесь, что обработчик корректно экспортирует `name` и `execute`.
 
 > [!TIP]
-> **Debug Mode:**
-> Включите подробное логирование, чтобы точно увидеть, какие модули и команды загружаются при запуске.
+> **Режим отладки (Debug Mode):**
+> включите подробное логирование, чтобы видеть список всех модулей и команд, загружаемых на этапе старта бота.