# 🏛️ 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, почтовый архив, мониторинг Zabbix/Grafana).

---

## 📦 Реестр ключевых проектов в 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/monitoring`**](http://172.16.8.8/KSP-Steel/monitoring) | Zabbix 7.0, Grafana, Prometheus, Loki, Portainer | `172.16.8.150` | Централизованный стек мониторинга и телеметрии завода: метрики серверов, дашборды, сбор логов, алерты на Synology. |
| [**`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`
* **Мониторинг Zabbix Web**: `http://172.16.8.150/`
* **Дашборды Grafana**: `http://172.16.8.150:3000/`
* **Метрики Prometheus**: `http://172.16.8.150:9090/`
* **Панель контейнеров Portainer**: `https://172.16.8.150:9443/` (HTTP: `:8000`)
* **Панель оркестрации задач (Semaphore UI)**: `http://172.16.8.8:3000/`
* **Почтовый архив ИБ (MailGuard)**: `http://172.16.8.151/`
* **Портал предприятия (Инфосистема 2.0)**: `http://172.16.8.75:8090/`
* **Корпоративная документация (Wiki.js)**: `http://172.16.8.23:3000/`