From 6855f3e4dfb62e09e3a98bfaec0efad335267330 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 25 Sep 2026 13:46:03 +0300 Subject: [PATCH] Add AGENTS.md + infrastructure locator (reliable) --- AGENTS.md | 50 ++++++++++++++++++++++++++++++++++++ ops/locate-infrastructure.sh | 13 ++++++++++ 2 files changed, 63 insertions(+) create mode 100644 AGENTS.md create mode 100755 ops/locate-infrastructure.sh diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..1110d19 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,50 @@ +# 🤖 Agent Guide — buryan-hub Infrastructure + +**Точка входа для любого AI-агента.** Обновлено: 2026-09-25 + +## 🏗️ Архитектура +- **Proxmox VE (PVE):** 192.168.1.10, 29 LXC контейнеров +- **VPS (публичный):** 193.233.210.184 (nginx, Let's Encrypt) +- **Домены:** *.buryans.ru (n8n, vault, finance, music, ...) + +## 🔌 Подключение + + ssh root@192.168.1.10 # PVE + pct exec -- # внутри CT + ssh root@193.233.210.184 # VPS + +## 📂 Ключевые файлы +- `AGENTS.md` — этот файл +- `ops/inventory-YYYYMMDD/` — снимок инфраструктуры +- `ops/data-registry.md` — реестр БД +- `ops/sprint1/`, `ops/sprintA/` — скрипты спринтов + +## 🔐 Секреты (локально на PVE, НЕ в git!) + + /root/secrets-master-catalog.sh # главный каталог (права 600) + /root/.gitea_api # Gitea API token + /root/.n8n_api # N8N API key + /root/.bw-secrets # Bitwarden credentials + +## 🎯 Ключевые сервисы + +| Сервис | Порт | CT | +|---|---|---| +| Uptime Kuma | 3001 | 107 | +| Gitea | 3000 | 140 | +| n8n | 5680 | 108 | +| Postgres | 5432 | 151 | +| Authentik | 9000/9443 | 114 | +| Matrix Synapse | 8008 | 155 | +| Vaultwarden | 8080 | 109 | + +## 🚧 Активные спринты +- **Sprint 1:** monitoring pipeline (DONE) +- **Sprint A:** 15 monitors (DONE) +- **Sprint B:** secrets + standardization (WIP) +- **Matrix Sprint:** 19 задач в Gitea (NEXT) + +## 🆘 Быстрый контекст + + /root/buryan-infra/ops/locate-infrastructure.sh + diff --git a/ops/locate-infrastructure.sh b/ops/locate-infrastructure.sh new file mode 100755 index 0000000..a76298e --- /dev/null +++ b/ops/locate-infrastructure.sh @@ -0,0 +1,13 @@ +#!/bin/bash +echo "🤖 INFRASTRUCTURE LOCATOR ($(date '+%H:%M:%S'))" +echo "📂 AGENTS.md: $(wc -l < /root/buryan-infra/AGENTS.md 2>/dev/null || echo 0) строк" +echo "📊 Running CT: $(pct list 2>/dev/null | grep running | wc -l)" +KUMA=$(curl -s -o /dev/null -w '%{http_code}' -m 2 http://192.168.1.107:3001/ 2>/dev/null) +GITEA=$(curl -s -o /dev/null -w '%{http_code}' -m 2 http://192.168.1.140:3000/ 2>/dev/null) +N8N=$(curl -s -o /dev/null -w '%{http_code}' -m 2 http://192.168.1.108:5680/healthz 2>/dev/null) +echo "🎯 Kuma: ${KUMA:-DOWN}" +echo "🎯 Gitea: ${GITEA:-DOWN}" +echo "🎯 n8n: ${N8N:-DOWN}" +cd /root/buryan-infra && git log --oneline -3 2>/dev/null +echo "💡 Следующий шаг: cat /root/buryan-infra/AGENTS.md" +