42 lines
4.2 KiB
Markdown
42 lines
4.2 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, почтовый архив).
|
|
|
|
---
|
|
|
|
## 📦 Реестр ключевых проектов в 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/` (или доменное имя)
|