docs: complete enterprise architecture map, AI agent playbook and disaster recovery guides

2026-09-28 15:44:45 +05:00
commit b46a9c1dd2
8 changed files with 370 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 🏛️ KSP Steel: База знаний инфраструктуры и системный регламент
+
+Добро пожаловать в центральный репозиторий документации, системных регламентов и архитектурных карт цифровой инфраструктуры **ТОО «KSP Steel»**.
+
+Этот репозиторий создан как **единая точка входа (Single Source of Truth)** для системных инженеров, специалистов по информационной безопасности и **автономных AI-агентов**.
+
+---
+
+## 🧭 Навигация по документации
+
+1. 🤖 [**Руководство и протокол безопасности для AI-агентов (`AI_AGENT_PLAYBOOK.md`)**](./AI_AGENT_PLAYBOOK.md)  
+   *Обязательно к прочтению любым AI-ассистентом перед началом работ.*  
+   Правила безопасного внесения изменений («Не сломай ничего»), карта проектов, регламент извлечения секретов из HashiCorp Vault и чеклист валидации.
+
+2. 🗺️ [**Карта серверов и сетевая топология (`NETWORK_TOPOLOGY.md`)**](./NETWORK_TOPOLOGY.md)  
+   Полный реестр физических и виртуальных серверов, IP-адресов, открытых портов, ролей и операционных систем (`172.16.8.x`, `172.16.15.x`, `192.168.220.x`).
+
+3. 🛡️ [**Аварийное восстановление и регламент бэкапов (`DISASTER_RECOVERY.md`)**](./DISASTER_RECOVERY.md)  
+   Инструкции по восстановлению каждого сервиса при сбоях (распечатка Vault, базы данных, образы KVM, почтовый архив).
+
+---
+
+## 📦 Реестр ключевых проектов в Gitea
+
+| Репозиторий | Стек технологий | Сервер / IP | Назначение |
+| :--- | :--- | :--- | :--- |
+| [**`KSP-Steel/Infosystem`**](http://172.16.8.8/KSP-Steel/Infosystem) | Vue 3, Tailwind, FastAPI, MySQL, Docker | `172.16.8.75` | Главный корпоративный портал предприятия, телеметрия проходных PerCo, интеграция со штатом 1С и Active Directory, дашборды. |
+| [**`KSP-Steel/mailguard`**](http://172.16.8.8/KSP-Steel/mailguard) | Python 3, Meilisearch, PostgreSQL, Nginx, Docker | `172.16.8.151` | Платформа службы безопасности (SOC): полнотекстовый архив писем Exchange/Exim (700k+ сообщений), DLP-фильтрация, аудит рисков. |
+| [**`KSP-Steel/ansible`**](http://172.16.8.8/KSP-Steel/ansible) | Ansible Core, Semaphore, Python Telegram Bot, WinRM | `172.16.8.8` | Плейбуки регламентных процедур (аудит безопасности AD, онбординг, бэкапы KVM и MySQL, сброс паролей, ChatOps в Telegram). |
+| [**`KSP-Steel/hashicorp-vault`**](http://172.16.8.8/KSP-Steel/hashicorp-vault) | HashiCorp Vault, Gitea, PostgreSQL, Docker Compose | `172.16.8.8` | Центральное зашифрованное хранилище учетных данных и паролей серверов. Интегрировано с Ansible через lookup-плагин. |
+| [**`admin_ksp/Instruction`**](http://172.16.8.8/admin_ksp/Instruction) | Markdown, Mermaid | `172.16.8.8` | Настоящая центральная база знаний и инструкция для AI-агентов. |
+
+---
+
+## ⚡ Быстрый старт: ключевые точки входа
+
+* **Git-сервер (Gitea)**: `http://172.16.8.8/`
+* **Хранилище секретов (Vault UI)**: `http://172.16.8.8:8200/ui`
+* **Панель оркестрации задач (Semaphore UI)**: `http://172.16.8.8:3000/`
+* **Почтовый архив ИБ (MailGuard)**: `http://172.16.8.151/`
+* **Портал предприятия (Инфосистема 2.0)**: `http://172.16.8.75:8090/` (или доменное имя)