# 🌐 Мрежа PanelSIX


**Официално разширение за PanelSIX**

**PanelSIX Network** превръща стандартната инсталация на PanelSIX в платформа за управление на мрежата. Тя добавя две основни системи: **управление на администраторите по отделни сървъри** и **контрол на достъпа въз основа на роли (RBAC)** за персонала, работещ с панелите.

---

## ✨ Основни характеристики

### 1. Административно управление на всеки сървър поотделно
Управлявайте множество игрови сървъри от една база данни и определяйте кои администратори да се зареждат на кой сървър.

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

### 2. Контрол на достъпа въз основа на роли (RBAC)
Организирайте работата на панелите по безопасен начин.

- **Персонализирани роли:** изберете точно кои административни страници може да отваря дадена роля, групирани по области (Забрани, Ограничения, Новини и актуализации, Сървъри и др.), с възможност за избор на всички елементи в дадена група.
- При първото стартиране се създават **готови роли:** „Пълен достъп“, „Модератор на сървъра“, „Мениджър на съдържанието“ и „Само за четене“.
- **Ролята „Пълен достъп“** винаги позволява достъп до всички страници, включително и тези, добавени при бъдещи актуализации на PanelSIX.
- **Присвойте роли на потребителите на панела** от *„Потребители на панела“ → „Добавяне/Редактиране*“.
- **Панел, съобразен с ролята:** менюто и таблото за управление показват само това, което потребителят има право да отваря; блокираните страници пренасочват към най-близката разрешена страница.
- **Настройките на сайта** могат да се променят само от потребители с пълен достъп.
- **Интелигентни пренасочвания при вход:** потребителите се пренасочват към таблото за управление, ако им е разрешено, а в противен случай – към първата страница, достъпна за тяхната роля. Потребителите, чиято роля не им дава достъп до никакви страници, не могат да влязат в системата.
- **Безопасно изтриване:** роля, която все още е присвоена на потребител от панела, не може да бъде изтрита.

### 3. Общ преглед на мрежата
Една страница с информация за състоянието на мрежата ви:

- Регистрирани сървъри и колко от тях са били активни през последните 15 минути
- Администратори с глобални права („Всички сървъри“)
- Роли и потребители по роли, потребители без роля
- Всеки регистриран сървър с информация за последното му включване и броя на администраторите, които се зареждат при него

---

## 💻 Изисквания

- **PanelSIX 2.0 или по-нова версия** (разширението използва дизайна на v2 и менюто, съобразено с ролята)
- 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 Network,** както и в списъка със сървъри в раздела *„Добавяне/Редактиране на администратор*“.

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

---

## ❓ Как работи

| Ситуация | Резултат |
|---|---|
| Администраторът е настроил параметъра на **„Всички сървъри“** | Инсталира се на всеки сървър, включително и на сървърите, добавени по-късно |
| Администраторът е настроен за конкретни сървъри | Зарежда се само на тези сървъри |
| Потребител на панела **без роля** | Пълен достъп (така че съществуващите потребители да продължат да работят след инсталирането) |
| Потребител на панела с роля **„Пълен достъп**“ | Всяка страница, винаги |
| Потребител на панела с друга роля | Само страниците, избрани за тази роля |
| Потребител на панела с ID 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**