---
name: oracle-bot-deployer
description: Постепенное развертывание и настройка Telegram-ботов на серверах Oracle Cloud (Ubuntu 1GB RAM). Используй этот навык, когда нужно: (1) Настроить новый сервер с нуля, (2) Оптимизировать RAM/Swap, (3) Установить системные лимиты для бота, (4) Настроить автоматический деплой через PowerShell.
---

# Oracle Bot Deployer (Senior Guide)

Этот навык предназначен для пошагового (gradual) развертывания бота. Не запускай всё сразу, иди по фазам.

## Phase 1: Подготовка (Local & Basic SSH)
1. Убедись, что у пользователя есть SSH-ключ.
2. Помоги настроить алиас `sv` в `~/.ssh/config` на локальной машине.
3. Проверь связь: `ssh sv "echo OK"`.

## Phase 2: Фундамент и Оптимизация
Используй справочник [full_setup_guide.md](references/full_setup_guide.md) для:
1. Обновления системы и настройки таймзоны (`Europe/Kyiv`).
2. Настройки **Swap (5GB)** и установки **EarlyOOM**. Это критично для выживания бота на 1GB RAM.
3. Установки `python3-venv`.

## Phase 3: Среда и Инструменты
1. Создай рабочую директорию `/home/ubuntu/FolderBot`.
2. Настрой "быстрые команды" и баннер в `.bashrc` (см. примеры в истории проекта).
3. Установи системные утилиты: `htop`, `ncdu`, `eza`, `btop`.

## Phase 4: Деплой и Автоматизация
1. Скопируй `scripts/setup_server.ps1` в папку бота пользователя и помоги запустить его через `pwsh`.
2. Этот скрипт создаст venv и установит зависимости.
3. Настрой `.env` файл на сервере (используй локальный как шаблон).

## Phase 5: Запуск и Лимиты
1. Используй шаблон [googlebot.service.template](assets/googlebot.service.template).
2. Размести его в `/etc/systemd/system/googlebot.service`.
3. **ВАЖНО:** Убедись, что секция `[Install]` на месте, и выполни `sudo systemctl enable googlebot`.
4. Настрой лимиты логов `journald`.

## Phase 6: Проверка (Health Check)
1. Перезагрузи сервер: `sudo reboot`.
2. После загрузки проверь:
   - Поднялся ли бот сам (`systemctl status`).
   - Отображается ли баннер при входе.
   - Сколько RAM свободно (`free -h`).