# 🌐 Rețeaua PanelSIX


**Extensie oficială pentru PanelSIX**

**Rețeaua PanelSIX** transformă o instalare standard PanelSIX într-o platformă de gestionare a rețelei. Aceasta adaugă două sisteme esențiale: **gestionarea administrativă pe server** și **controlul accesului bazat pe roluri (RBAC)** pentru personalul responsabil de panouri.

---

## ✨ Caracteristici principale

### 1. Gestionarea administrativă pe server
Rulați mai multe servere de jocuri dintr-o singură bază de date și decideți care administratori se conectează la fiecare server.

- **Înregistrare automată:** fiecare server se înregistrează automat în panoul de control imediat ce pornește. Nu este necesară nicio configurare manuală.
- **Tokenuri de server permanente:** fiecare server creează un fișier de identificare permanent (`configs/psn_server.id`). Dacă numele de gazdă sau adresa IP se modifică, panoul recunoaște în continuare serverul și păstrează toate alocările — fără duplicate.
- **Toate serverele sau anumite servere:** acordă acces de administrator peste tot sau doar pe serverele pe care le alegi.
- **„Toate serverele” înseamnă chiar toate** — acei administratori se încarcă și pe serverele care se înregistrează ulterior.
- **Pluginul Smart AMXX:** pluginul inclus își `admin.sma`citește tokenul și încarcă doar administratorii alocați acelui server, precum și administratorii din categoria „Toate serverele”.
- **Integrarea listei de administratori:** insigne pentru servere în tabelul administratorilor (verde = Toate serverele, violet = servere specifice) și un filtru pentru servere.

### 2. Controlul accesului bazat pe roluri (RBAC)
Asigurați-vă că lucrările din cadrul grupului de lucru se desfășoară în condiții de siguranță.

- **Roluri personalizate:** alege exact ce pagini de administrare poate accesa un rol, grupate pe categorii (Blocări, Restricții, Știri și noutăți, Servere, …) cu opțiunea de selectare a tuturor elementelor din fiecare grup.
- La prima rulare sunt create **rolurile prestabilite:** Acces complet, Moderator de server, Administrator de conținut și Doar citire.
- **Rolul „Acces complet”** permite întotdeauna accesul la toate paginile, inclusiv la cele adăugate prin viitoarele actualizări ale PanelSIX.
- **Atribuiți roluri utilizatorilor panoului** din secțiunea *„Utilizatori panou” → „Adăugare/Editare*”.
- **Panou adaptat rolului:** meniul și tabloul de bord afișează doar elementele pe care utilizatorul are dreptul să le deschidă; paginile blocate redirecționează către cea mai apropiată pagină accesibilă.
- **Setările site-ului** pot fi modificate numai de utilizatorii cu acces complet.
- **Redirecționări inteligente la autentificare:** utilizatorii sunt redirecționați către tabloul de bord dacă au permisiunea necesară; în caz contrar, sunt redirecționați către prima pagină la care au acces în funcție de rolul lor. Utilizatorii al căror rol nu le permite accesul la nicio pagină nu se pot autentifica.
- **Ștergeri sigure:** un rol care este încă atribuit utilizatorilor din panou nu poate fi șters.

### 3. Prezentare generală a rețelei
O pagină cu informații despre starea rețelei tale:

- Serverele înregistrate și numărul celor care au fost active în ultimele 15 minute
- Administratori globali („Toate serverele”)
- Roluri și utilizatori pe rol, utilizatori fără rol
- Fiecare server înregistrat, cu ora la care a fost văzut ultima dată și numărul de administratori pe care îi afișează

---

## 💻 Cerințe

- **PanelSIX 2.0 sau o versiune mai recentă** (extensia utilizează designul v2 și meniul adaptat rolului)
- PHP 7.4 sau o versiune ulterioară
- MySQL / MariaDB utilizat în comun de panoul de administrare web și de serverele de joc
- AMX Mod X 1.8.3 sau o versiune mai recentă pe serverele de joc (pentru `admin.sma`)

---

## 🛠️ Instalare

### 1. Instalați extensia
1. Încărcați `extensions/panelsix-network`folderul `extensions/`în instalarea PanelSIX:
```
panelsix/extensions/panelsix-network/
```
2. Deschideți **Panoul de administrare → Extensii**, apăsați pe **„Rescan”**, apoi **pe** **„Instalare”** și **„Activare”** în *PanelSIX Network*.

Tabelele bazei de date sunt create automat la prima încărcare a paginii după activare.

### 2. Actualizați serverele de joc
1. Compilați `plugin/admin.sma`în `admin.amxx`(compilatorul AMX Mod X sau compilatorul online).
2. Înlocuiți (`admin_sql.amxx`sau `admin.amxx`) din `cstrike/addons/amxmodx/plugins/`cu noul `admin.amxx`.
3. În `cstrike/addons/amxmodx/configs/sql.cfg`configurați aceeași bază de date ca și PanelSIX.
4. Reporniți serverul.

La pornire, serverul se creează`configs/psn_server.id`, se înregistrează și apare în **rețeaua PanelSIX,** precum și în lista de servere din secțiunea *„Adăugare/Editare administrator*”.

### 3. Configurare
1. Deschideți **„PanelSIX Network”** din meniul de administrare.
2. Creați sau editați roluri și selectați paginile pe care fiecare rol le poate accesa.
3. Atribuiți roluri utilizatorilor panoului dvs. în secțiunea **„Utilizatori ai panoului**”.
4. În **secțiunea „Admin”**, alegeți *„Toate serverele”* sau servere specifice pentru fiecare administrator de joc.

---

## ❓ Cum funcționează

| Situația | Rezultat |
|---|---|
| Setare administrator: **Toate serverele** | Se încarcă pe fiecare server, inclusiv pe cele adăugate ulterior |
| Administratorul este configurat pentru anumite servere | Se încarcă numai pe acele servere |
| Utilizator al panoului **fără rol** | Acces complet (astfel încât utilizatorii existenți să poată continua să lucreze după instalare) |
| Utilizator al panoului cu rolul **„Acces** **complet**” | Fiecare pagină, întotdeauna |
| Utilizator al panoului cu un alt rol | Doar paginile selectate pentru rolul respectiv |
| Utilizator al panoului cu ID-ul 1 (proprietar) | Acces nelimitat în orice moment |

„Toate serverele” sunt stocate *fără rânduri*`psn_admin_servers`; serverele specifice sunt stocate câte un rând pentru fiecare server.

---

## ⬆️ Actualizare de la versiunea 1.0

1. Încărcați noul `extensions/panelsix-network`folder peste cel vechi.
2. Deschideți orice pagină de administrare — opțiunile de administrare salvate cu toate serverele selectate sunt convertite automat la **„Toate serverele**”.
3. **Recompilați și`admin.sma` înlocuiți pluginul pe fiecare server.** Interogarea pluginului s-a modificat: fără noul plugin, administratorii din secțiunea „Toate serverele” nu vor putea accesa serverele.

---

## 🆕 Noutăți în versiunea 1.1.0

- **„Toate serverele” înseamnă acum cu adevărat toate serverele** — include și serverele care se înregistrează ulterior. Alocările anterioare sunt migrate automat.
- **Rolul „Acces complet”** permite întotdeauna accesul la toate paginile de administrare; lista paginilor sale nu poate fi restrânsă (se poate doar redenumi).
- **Prezentare generală** **a rețelei** cu serverele înregistrate și active, administratorii globali și utilizatorii pe roluri.
- **Pagină reproiectată** în stilul PanelSIX v2, cu teme întunecate și deschise, permisiuni grupate cu opțiunea „Selectează tot”.
- Rolurile care sunt încă atribuite utilizatorilor din grup nu pot fi șterse (în trecut, acești utilizatori erau blocați).
- Meniul de administrare și panoul de control afișează doar paginile pe care rolul utilizatorului le poate accesa.
- Doar utilizatorii cu acces complet pot modifica setările site-ului.
- În cazul numelor de roluri duplicate și al erorilor, se afișează un mesaj în locul unei pagini de eroare PHP.
- Tokenul formularului nu mai prezintă erori atunci când pagina este deschisă în două file.
- Numai paginile de administrare reale pot fi salvate într-un rol.
- Verificările de schemă se execută o singură dată pe versiune, nu la fiecare solicitare.
- Plugin: numele de gazdă sunt escapat cu `SQL_QuoteString`— un nume de gazdă care conține o bară oblică inversă poate provoca erori la înregistrarea serverului.

---

## 🗑️ Dezinstalare

**Panoul de administrare → Extensii → Dezinstalare** elimină `psn_*`tabelele și `role_id`coloana din `panelusers`. Alocările de roluri și de servere se pierd. După aceea, `admin_sql.amxx`reinstalați fișierul original pe servere.

---

## 📁 Fișiere

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

---

**Dezvoltat de illusion @ codestrike.store**