Проект: Oleg Agent — портативный DevOps-агент с NetBird

projects/dttb/oleg-agent.md

@@ -0,0 +1,115 @@
+# Проект: Oleg Agent — Портативный DevOps-агент
+
+**Статус:** 🟡 Проектирование  
+**Дата:** 2026-02-26  
+**Приоритет:** Высокий
+
+## Идея
+Портативный агент, который можно быстро развернуть на любой машине (Windows/Linux). После установки NetBird + агента получаешь полный доступ к домашней инфраструктуре и базе знаний.
+
+## Сценарий использования
+1. Приходишь на новую машину (клиент, сервер, рабочее место)
+2. Устанавливаешь NetBird → авторизуешься → mesh VPN поднят
+3. Устанавливаешь агента одной командой
+4. Агент подтягивает knowledge-base, подключается к инфраструктуре
+5. Готов к работе: ИИ-помощник, скрипты, доступы, всё под рукой
+
+## Архитектура
+
+```
+┌─────────────────────────────────────────────┐
+│              Любая машина                   │
+│                                             │
+│  ┌──────────┐   ┌────────────────────────┐  │
+│  │ NetBird  │───│ Oleg Agent (Docker)    │  │
+│  │ VPN mesh │   │                        │  │
+│  └──────────┘   │ • Clawdbot (ИИ)       │  │
+│       │         │ • knowledge-base (Git) │  │
+│       │         │ • DevOps tools         │  │
+│       │         │ • SSH keys             │  │
+│       │         └────────────────────────┘  │
+└───────│─────────────────────────────────────┘
+        │ NetBird mesh VPN
+        │
+┌───────│─────────────────────────────────────┐
+│  Дом (Proxmox 10.0.0.250)                  │
+│       │                                     │
+│  ┌────┴─────┐                               │
+│  │ NetBird  │                               │
+│  │ peer     │                               │
+│  └──────────┘                               │
+│       │                                     │
+│  ┌────┴───┐ ┌────────┐ ┌──────┐ ┌───────┐  │
+│  │Proxmox │ │Nextcloud│ │Gitea │ │Максимка│ │
+│  │  .250  │ │  .230  │ │ .189 │ │  .206  │ │
+│  └────────┘ └────────┘ └──────┘ └────────┘  │
+└─────────────────────────────────────────────┘
+```
+
+## Компоненты агента
+
+### 1. Установщик
+- **Linux:** `curl -sSL https://agent.dttb.ru/install.sh | bash`
+- **Windows:** `irm https://agent.dttb.ru/install.ps1 | iex`
+- Проверяет наличие Docker, NetBird
+- Скачивает и запускает контейнер
+
+### 2. Docker-контейнер (oleg-agent)
+- **Base:** Debian/Alpine
+- **Clawdbot** — ИИ-ассистент с доступом ко всему
+- **Git** — клонирует knowledge-base при старте
+- **SSH** — ключи для доступа к Proxmox и серверам
+- **DevOps tools:** nmap, curl, ansible, terraform, docker-cli
+- **Конфиг:** подключение к Gitea, Nextcloud, Proxmox API
+
+### 3. Конфигурация
+```yaml
+# config.yml
+home:
+  proxmox: "https://10.0.0.250:8006"
+  gitea: "http://git.dttb.ru"
+  nextcloud: "https://dttb.ru"
+  netbird_network: "oleg-net"
+
+knowledge_base:
+  repo: "http://git.dttb.ru/oleg/knowledge-base.git"
+  auto_pull: true
+  auto_push: true
+
+ai:
+  provider: "anthropic"  # или openrouter
+  model: "claude-sonnet-4-20250514"
+```
+
+### 4. NetBird
+- Все машины в одной mesh-сети
+- Автоматическое обнаружение пиров
+- Шифрованный трафик
+- Не нужен VPN-сервер
+
+## Этапы разработки
+
+### Фаза 1 — Базовый агент
+1. [ ] Установить NetBird на Proxmox
+2. [ ] Создать NetBird аккаунт / self-hosted
+3. [ ] Docker-образ с базовыми инструментами
+4. [ ] Скрипт установки (Linux)
+5. [ ] Автоматическое клонирование knowledge-base
+
+### Фаза 2 — ИИ и автоматизация
+6. [ ] Интеграция Clawdbot в контейнер
+7. [ ] Подключение к Proxmox API через NetBird
+8. [ ] Скрипт установки (Windows)
+9. [ ] Веб-интерфейс (опционально)
+
+### Фаза 3 — Продвинутое
+10. [ ] Self-hosted NetBird на Proxmox
+11. [ ] Автообновление агента
+12. [ ] Мониторинг удалённых агентов
+13. [ ] Ansible playbooks из knowledge-base
+
+## Требования
+- Docker на целевой машине
+- NetBird аккаунт
+- Интернет для первоначальной установки
+- После установки — работает через mesh VPN