# 🌐 Sieć PanelSIX


**Oficjalne rozszerzenie dla PanelSIX**

**PanelSIX Network** przekształca standardową instalację PanelSIX w platformę do zarządzania siecią. Dodaje dwa kluczowe systemy: **zarządzanie administracyjne na poziomie poszczególnych serwerów** oraz **kontrolę dostępu opartą na rolach (RBAC)** dla personelu obsługi panelu.

---

## ✨ Najważniejsze cechy

### 1. Zarządzanie administracyjne na poziomie serwera
Uruchom wiele serwerów gier z jednej bazy danych i określ, którzy administratorzy mają dostęp do poszczególnych serwerów.

- **Automatyczna rejestracja:** każdy serwer rejestruje się w panelu w momencie uruchomienia. Nie wymaga ręcznej konfiguracji.
- **Trwałe tokeny serwerów:** każdy serwer tworzy plik z trwałym identyfikatorem (`configs/psn_server.id`). Nawet jeśli zmieni się nazwa hosta lub adres IP, panel nadal rozpoznaje serwer i zachowuje wszystkie przypisania — bez powtórzeń.
- **Wszystkie serwery lub wybrane serwery:** przyznaj uprawnienia administratora wszędzie lub tylko na wybranych serwerach.
- **„Wszystkie serwery” oznacza naprawdę wszystkie** — ci administratorzy są również przypisywani do serwerów, które zostaną zarejestrowane później.
- **Wtyczka Smart AMXX:** dołączony plik odczytuje`admin.sma` swój token i ładuje wyłącznie administratorów przypisanych do danego serwera oraz administratorów z grupy „Wszystkie serwery”.
- **Integracja listy administratorów:** oznaczenia serwerów w tabeli administratorów (zielone = wszystkie serwery, fioletowe = konkretne serwery) oraz filtr serwerów.

### 2. Kontrola dostępu oparta na rolach (RBAC)
Należy zapewnić bezpieczeństwo pracy w panelu delegatów.

- **Role niestandardowe:** wybierz dokładnie, które strony administracyjne dana rola może otwierać, pogrupowane według obszarów (Blokady, Ograniczenia, Aktualności i nowości, Serwery itp.), z opcją zaznaczenia wszystkich elementów w każdej grupie.
- Podczas pierwszego uruchomienia tworzone są **gotowe role:** „Pełny dostęp”, „Moderator serwera”, „Menedżer treści” oraz „Tylko do odczytu”.
- **Rola „Pełny dostęp”** zawsze zezwala na dostęp do wszystkich stron, w tym stron dodanych w przyszłych aktualizacjach PanelSIX.
- **Przypisz role użytkownikom panelu** w sekcji *„Użytkownicy panelu” → „Dodaj / Edytuj*”.
- **Panel dostosowany do roli:** menu i pulpit nawigacyjny wyświetlają wyłącznie te elementy, do których użytkownik ma dostęp; zablokowane strony przekierowują do najbliższej dozwolonej strony.
- **Ustawienia witryny** mogą zmieniać wyłącznie użytkownicy posiadający pełny dostęp.
- **Inteligentne przekierowania po zalogowaniu:** użytkownicy trafiają na pulpit nawigacyjny, jeśli mają do tego uprawnienia, w przeciwnym razie – na pierwszą stronę, do której mają dostęp w ramach swojej roli. Użytkownicy, których rola nie uprawnia do dostępu do żadnej strony, nie mogą się zalogować.
- **Bezpieczne usuwanie:** nie można usunąć roli, która jest nadal przypisana do użytkowników panelu.

### 3. Przegląd sieci
Jedna strona z informacjami o stanie Twojej sieci:

- Zarejestrowane serwery oraz liczba serwerów aktywnych w ciągu ostatnich 15 minut
- Administratorzy globalni („Wszystkie serwery”)
- Role i użytkownicy przypisani do poszczególnych ról, użytkownicy bez przypisanej roli
- Każdy zarejestrowany serwer wraz z informacją o czasie ostatniej aktywności oraz liczbą administratorów, których ładuje

---

## 💻 Wymagania

- **PanelSIX 2.0 lub nowszy** (rozszerzenie wykorzystuje układ v2 oraz menu dostosowane do ról)
- PHP 7.4 lub nowsze
- MySQL / MariaDB współużytkowane przez panel internetowy i serwery gry
- AMX Mod X w wersji 1.8.3 lub nowszej na serwerach gry (dla `admin.sma`)

---

## 🛠️ Instalacja

### 1. Zainstaluj rozszerzenie
1. Prześlij folder`extensions/panelsix-network` do w`extensions/` swojej instalacji PanelSIX:
```
panelsix/extensions/panelsix-network/
```
2. Otwórz **panel administracyjny → Rozszerzenia**, naciśnij **„Przeskanuj ponownie”**, a następnie **„Zainstaluj”** i **„Włącz”** w *sieci PanelSIX*.

Tabele bazy danych są tworzone automatycznie przy pierwszym załadowaniu strony po włączeniu tej funkcji.

### 2. Zaktualizuj serwery gry
1. Skompiluj `plugin/admin.sma`w `admin.amxx`(kompilatorze AMX Mod X lub kompilatorze internetowym).
2. Zastąp `admin_sql.amxx`(lub `admin.amxx`) `cstrike/addons/amxmodx/plugins/`w nowym `admin.amxx`.
3. W należy ustawić`cstrike/addons/amxmodx/configs/sql.cfg` tę samą bazę danych co w PanelSIX.
4. Uruchom ponownie serwer.

Po uruchomieniu serwer tworzy się`configs/psn_server.id`, rejestruje i pojawia się w **sieci PanelSIX** oraz na liście serwerów w sekcji *„Dodaj / Edytuj administratora*”.

### 3. Konfiguracja
1. W menu administracyjnym otwórz opcję **„PanelSIX Network**”.
2. Utwórz lub edytuj role i wybierz strony, do których każda z nich ma dostęp.
3. Przypisz role użytkownikom panelu w sekcji **„Użytkownicy panelu**”.
4. W sekcji **„Administratorzy”** wybierz opcję *„Wszystkie serwery”* lub konkretne serwery dla każdego administratora gry.

---

## ❓ Jak to działa

| Sytuacja | Wynik |
|---|---|
| Ustawienie administratora na **„Wszystkie serwery”** | Zainstalowane na każdym serwerze, w tym na serwerach dodanych później |
| Administrator przypisany do określonych serwerów | Zainstalowane wyłącznie na tych serwerach |
| Użytkownik panelu **bez** przypisanej **roli** | Pełny dostęp (aby dotychczasowi użytkownicy mogli nadal korzystać z programu po instalacji) |
| Użytkownik panelu z rolą **„Pełny dostęp**” | Każda strona, zawsze |
| Użytkownik panelu posiadający inną rolę | Tylko strony wybrane dla tej roli |
| Użytkownik panelu o identyfikatorze 1 (właściciel) | Zawsze pełny dostęp |

„Wszystkie serwery” są zapisane jako *brak wierszy*`psn_admin_servers`; poszczególne serwery są zapisane jako jeden wiersz na serwer.

---

## ⬆️ Aktualizacja z wersji 1.0

1. Przenieś nowy `extensions/panelsix-network`folder, zastępując nim stary.
2. Otwórz dowolną stronę administracyjną — ustawienia administratorów, które zostały zapisane z zaznaczonymi wszystkimi serwerami, są automatycznie przekształcane na **„Wszystkie serwery**”.
3. **Należy ponownie skompilować i`admin.sma` zastąpić wtyczkę na każdym serwerze.** Zmieniło się zapytanie wtyczki: bez nowej wtyczki administratorzy z uprawnieniami „Wszystkie serwery” nie będą się ładować na serwerach.

---

## 🆕 Co nowego w wersji 1.1.0

- **„Wszystkie serwery” oznacza teraz naprawdę wszystkie serwery** — obejmuje to również serwery zarejestrowane w późniejszym terminie. Dotychczasowe przypisania są przenoszone automatycznie.
- **Rola „Pełny dostęp”** zawsze zezwala na dostęp do wszystkich stron administracyjnych; listy tych stron nie można zawęzić (możliwa jest jedynie zmiana nazwy).
- **Przegląd sieci** zawierający zarejestrowane i aktywne serwery, administratorów globalnych oraz użytkowników w podziale na role.
- **Strona przeprojektowana** w stylu PanelSIX v2, z ciemnym i jasnym motywem oraz pogrupowanymi uprawnieniami z opcją zaznaczenia wszystkich.
- Ról, które nadal są przypisane do użytkowników panelu, nie można usunąć (wcześniej tacy użytkownicy byli blokowani).
- W menu administracyjnym i na pulpicie nawigacyjnym wyświetlane są wyłącznie strony, do których użytkownik ma dostęp w ramach swojej roli.
- Tylko użytkownicy z pełnym dostępem mogą zmieniać ustawienia witryny.
- W przypadku zduplikowanych nazw ról i błędów wyświetlany jest komunikat zamiast strony błędu PHP.
- Token formularza nie ulega już uszkodzeniu, gdy strona jest otwarta w dwóch kartach.
- W ramach roli można zapisać wyłącznie rzeczywiste strony administracyjne.
- Sprawdzanie schematu odbywa się raz na wersję, a nie przy każdym żądaniu.
- Wtyczka: nazwy hostów są poddawane eskapowaniu za pomocą znaku `SQL_QuoteString`— nazwa hosta zawierająca ukośnik odwrotny służy do uniemożliwienia rejestracji serwera.

---

## 🗑️ Odinstaluj

**Panel administracyjny → Rozszerzenia → Odinstaluj** powoduje usunięcie `psn_*`tabel i `role_id`kolumny z `panelusers`. Przypisania ról i serwerów zostaną utracone. Następnie `admin_sql.amxx`przywróć oryginalne na swoich serwerach.

---

## 📁 Pliki

```
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
```

---

**Opracowane przez illusion @ codestrike.store**