# 🌐 Сеть PanelSIX


**Официальное расширение для PanelSIX**

**PanelSIX Network** превращает стандартную установку PanelSIX в платформу для управления сетью. Она добавляет две ключевые системы: **систему администрирования на уровне отдельных серверов** и **систему контроля доступа на основе ролей (RBAC)** для персонала вашей панели управления.

---

## ✨ Основные особенности

### 1. Управление на уровне отдельных серверов
Запускайте множество игровых серверов из одной базы данных и определяйте, какие администраторы будут загружаться на какой сервер.

- **Автоматическая регистрация:** каждый сервер регистрируется в панели управления сразу после запуска. Настройка вручную не требуется.
- **Постоянные токены серверов:** каждый сервер создаёт файл с постоянным идентификатором (`configs/psn_server.id`). Даже если имя хоста или IP-адрес изменятся, панель по-прежнему распознает сервер и сохраняет все назначения — без дубликатов.
- **Все серверы или отдельные серверы:** предоставить права администратора повсеместно или только на выбранных вами серверах.
- **«Все серверы» действительно означает «все»** — эти администраторы также загружаются на серверах, которые регистрируются позже.
- **Плагин Smart AMXX:** входящий в комплект плагин считывает`admin.sma` свой токен и загружает только администраторов, назначенных на данный сервер, а также администраторов с правами доступа ко всем серверам.
- **Интеграция списка администраторов:** значки серверов в таблице администраторов (зелёный = все серверы, фиолетовый = конкретные серверы) и фильтр по серверам.

### 2. Управление доступом на основе ролей (RBAC)
Обеспечьте безопасность при выполнении работ на панели.

- **Пользовательские роли:** выберите, какие именно страницы админ-панели может открывать данная роль, сгруппированные по разделам («Блокировки», «Ограничения», «Новости и обновления», «Серверы» и т. д.), с возможностью выбора всех элементов в каждой группе.
- При первом запуске создаются **готовые роли:** «Полный доступ», «Модератор сервера», «Менеджер контента» и «Только для чтения».
- **Роль «Полный доступ»** всегда разрешает доступ ко всем страницам, включая страницы, которые будут добавлены в будущих обновлениях PanelSIX.
- **Назначьте роли пользователям панели** в разделе *«Пользователи панели» → «Добавить/Редактировать*».
- **Панель с учетом ролей:** в меню и на панели управления отображаются только те элементы, доступ к которым разрешен пользователю; заблокированные страницы перенаправляют на ближайшую разрешенную страницу.
- **Настройки сайта** могут изменять только пользователи с полным доступом.
- **Интеллектуальное перенаправление при входе в систему:** пользователи попадают на панель управления, если это разрешено, в противном случае — на первую страницу, доступ к которой разрешен для их роли. Пользователи, чья роль не предусматривает доступа к каким-либо страницам, не могут войти в систему.
- **Безопасное удаление:** роль, которая по-прежнему присвоена пользователям панели, удалить нельзя.

### 3. Обзор сети
Одна страница с информацией о состоянии вашей сети:

- Зарегистрированные серверы и количество активных за последние 15 минут
- Администраторы глобального уровня («Все серверы»)
- Роли и пользователи по ролям, пользователи без роли
- Все зарегистрированные серверы с указанием времени последнего посещения и количества загруженных администраторов

---

## 💻 Требования

- **PanelSIX 2.0 или более поздней версии** (расширение использует дизайн версии 2 и меню с учетом ролей)
- PHP 7.4 и выше
- MySQL / MariaDB, используемые как веб-панелью, так и игровыми серверами
- AMX Mod X версии 1.8.3 или более поздней на игровых серверах (для `admin.sma`)

---

## 🛠️ Установка

### 1. Установите расширение
1. Загрузите папку в `extensions/panelsix-network`папку в`extensions/` вашей установке PanelSIX:
```
panelsix/extensions/panelsix-network/
```
2. Откройте **панель администратора → «Расширения»**, нажмите **«Повторно сканировать»**, а затем **«Установить»** и **«Включить»** в *PanelSIX Network*.

Таблицы базы данных создаются автоматически при первой загрузке страницы после включения функции.

### 2. Обновите свои игровые серверы
1. Скомпилировать `plugin/admin.sma`в `admin.amxx`(компилятор AMX Mod X или онлайн-компилятор).
2. Замените (`admin_sql.amxx`или `admin.amxx`) в `cstrike/addons/amxmodx/plugins/`на новое `admin.amxx`.
3. В укажите`cstrike/addons/amxmodx/configs/sql.cfg` ту же базу данных, что и для PanelSIX.
4. Перезапустите сервер.

При запуске сервер создаётся`configs/psn_server.id`, регистрируется и появляется в **сети PanelSIX,** а также в списке серверов в разделе *«Добавить/Редактировать администратора*».

### 3. Настройка
1. Откройте **«PanelSIX Network»** в меню администратора.
2. Создавайте или редактируйте роли и указывайте страницы, доступ к которым будет предоставлен каждой роли.
3. Назначьте роли пользователям панели в разделе **«Пользователи панели**».
4. В разделе **«Администраторы»** выберите *«Все серверы*» или конкретные серверы для каждого администратора игры.

---

## ❓ Как это работает

| Ситуация | Результат |
|---|---|
| Параметр «Администратор» установлен на **«Все серверы»** | Устанавливается на каждый сервер, включая серверы, добавленные позже |
| Администратор настроен на определенные серверы | Загружается только на этих серверах |
| Пользователь панели **без роли** | Полный доступ (чтобы существующие пользователи могли продолжать работу после установки) |
| Пользователь панели с ролью **«Полный доступ**» | Каждая страница, всегда |
| Пользователь панели с другой ролью | Только страницы, выбранные для этой роли |
| Пользователь панели с идентификатором 1 (владелец) | Всегда полный доступ |

«Все серверы» хранятся как *отсутствие строк*`psn_admin_servers`; данные по конкретным серверам хранятся по одной строке на каждый сервер.

---

## ⬆️ Обновление с версии 1.0

1. Загрузите новую `extensions/panelsix-network`папку, заменив ею старую.
2. Откройте любую страницу администрирования — настройки, сохраненные с указанием отдельных серверов, автоматически преобразуются в **«Все серверы**».
3. **Перекомпилируйте `admin.sma`и замените плагин на каждом сервере.** В запросе плагина произошли изменения: без нового плагина страница «Все серверы» не будет загружаться на серверах.

---

## 🆕 Что нового в версии 1.1.0

- **Теперь выражение «Все серверы» действительно означает все серверы** — оно также распространяется на серверы, которые будут зарегистрированы позже. Старые назначения переносятся автоматически.
- **Роль «Полный доступ»** всегда предоставляет доступ ко всем страницам админ-панели; список страниц для этой роли нельзя сузить (возможно только переименование).
- **Обзор сети** с указанием зарегистрированных и активных серверов, глобальных администраторов и пользователей с разбивкой по ролям.
- **Переработанная страница** в стиле PanelSIX v2, с тёмной и светлой темами, сгруппированные права доступа с возможностью выбора всех.
- Роли, которые по-прежнему присвоены пользователям панели, удалить нельзя (ранее таких пользователей просто блокировали).
- В меню администратора и на панели управления отображаются только те страницы, доступ к которым разрешен для роли данного пользователя.
- Изменять настройки сайта могут только пользователи с полным доступом.
- При повторении названий ролей и возникновении ошибок вместо страницы ошибок PHP отображается сообщение.
- Токен формы больше не теряет работоспособность, когда страница открыта в двух вкладках.
- В роль можно сохранять только настоящие страницы администрирования.
- Проверка схемы выполняется один раз для каждой версии, а не при каждом запросе.
- Плагин: имена хостов подвергаются экранированию с помощью `SQL_QuoteString`— имя хоста, содержащее обратную косую черту, используется для сбоя регистрации сервера.

---

## 🗑️ Удалить

**«Панель администратора» → «Расширения» → «Удалить»** удаляет таблицы`psn_*` и `role_id`столбцы из `panelusers`. Назначения ролей и серверов теряются. После этого верните`admin_sql.amxx` исходные данные на ваши серверы.

---

## 📁 Файлы

```
PanelSIX Network/
├── extensions/
│ └── panelsix-network/
│ ├── admin/control_panelsix-network.php Network page (roles, servers, overview)
│ ├── assets/panelsix-network.css
│ ├── includes/roles.php Roles, access checks, server assignments
│ ├── extension.json
│ ├── main.php
│ └── uninstall.php
├── plugin/
│ └── admin.sma AMX Mod X admin plugin (compile to admin.amxx)
└── README.md
```

---

**Разработано illusion @ codestrike.store**