Files
Shelyagin Roman 015f98256d docs: enrich corporate server registry and add critical servers safety protocol
- Synchronized full physical & virtual server inventory from Wiki-Doc (172.16.8.23)
- Documented servers across 213 АБК-3, 214 АБК-3, ЧЛЦ and Casting locations
- Mapped hypervisors (vm-host01..05, bptp-srv3) and their VM workloads
- Enforced Rule 5: Critical systems (AD, routers, scales) require human-in-the-loop manual execution without AI password access
- Filtered out legacy backup instructions per policy
2026-09-28 16:08:07 +05:00

48 lines
4.9 KiB
Markdown

# 🏛️ 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/`