SchoolSettings + adminpanel filtrato per scuola

This commit is contained in:
2026-10-03 19:15:11 +02:00
parent 8441cc702c
commit e27413880a
9 changed files with 1460 additions and 194 deletions
+117 -36
View File
@@ -1,17 +1,18 @@
<?php
/**
* SchoolContext v2
* Determina la scuola corrente dell'utente loggato, il suo ruolo nella scuola
* e le scuole tra cui può passare (owner multi-scuola, superadmin).
* SchoolContext v3
* - Scuola corrente dell'utente loggato e ruolo nella scuola
* - Scuole tra cui può passare (owner multi-scuola, superadmin)
* - Vista attiva (superadmin | school | teacher | student): permette a chi ha
* permessi alti di vedere l'app come un livello inferiore. Mai superiore.
*
* Uso (nella headscript):
* Uso (headscript):
* $schoolData = SchoolContext::resolve((int)$iduserlogin);
* $idschool = SchoolContext::id();
*
* Ruoli scuola: owner | admin | teacher | student
* Il superadmin di piattaforma (auth_users.is_superadmin = 'Y') può entrare
* in qualsiasi scuola: se non ne è membro, il suo ruolo risulta 'superadmin'.
* I controlli isSuperadmin()/isSchoolAdmin()/isStaff() tengono conto della
* vista attiva. viewModes() e available() usano i permessi REALI.
*/
if (!class_exists('DBHandlerSelect')) {
@@ -29,13 +30,15 @@ class SchoolContext
/** @var int */
private static $userId = 0;
/** @var bool */
/** @var bool permesso REALE di superadmin */
private static $superadmin = false;
/** @var array scuole di cui l'utente è membro */
private static $memberships = [];
/* ------------------------------------------------------------------ */
/* ================================================================== */
/* RISOLUZIONE SCUOLA */
/* ================================================================== */
public static function resolve(int $userId): array
{
@@ -77,9 +80,7 @@ class SchoolContext
return self::$school;
}
/**
* Cambia scuola corrente. Ritorna false se l'utente non può accedervi.
*/
/** Cambia scuola corrente. False se l'utente non può accedervi. */
public static function switchTo(int $idschool): bool
{
if ($idschool <= 0) {
@@ -96,10 +97,7 @@ class SchoolContext
return false;
}
/**
* Scuole tra cui l'utente può scegliere (per il selettore in topbar).
* Superadmin: tutte le scuole. Altri: solo quelle di cui è membro.
*/
/** Scuole selezionabili (permessi reali). Superadmin: tutte. */
public static function available(): array
{
if (!self::$superadmin) {
@@ -119,7 +117,70 @@ class SchoolContext
return $all;
}
/* --------------------------- getter -------------------------------- */
/* ================================================================== */
/* VISTA ATTIVA */
/* ================================================================== */
/**
* Viste consentite in base ai permessi REALI, dalla più alta alla più bassa.
* @return array chiave => etichetta
*/
public static function viewModes(): array
{
$real = self::realRole();
$modes = [];
if (self::$superadmin) {
$modes['superadmin'] = 'Superadmin';
}
if (self::$superadmin || in_array($real, ['owner', 'admin'], true)) {
$modes['school'] = 'Scuola';
}
if ($real === 'teacher') {
$modes['teacher'] = 'Insegnante';
}
$modes['student'] = 'Allievo';
return $modes;
}
/** Vista attiva (se quella in sessione non è consentita: la più alta) */
public static function viewMode(): string
{
$modes = self::viewModes();
$req = $_SESSION['view_mode'] ?? '';
if (isset($modes[$req])) {
return $req;
}
return (string) array_key_first($modes);
}
public static function setViewMode(string $mode): bool
{
if (!isset(self::viewModes()[$mode])) {
return false;
}
$_SESSION['view_mode'] = $mode;
return true;
}
/** Pagina iniziale per la vista attiva */
public static function landingPage(): string
{
switch (self::viewMode()) {
case 'superadmin':
return 'sa-schools.php';
case 'school':
case 'teacher':
return 'adminpanel.php';
default:
return 'userpanel.php';
}
}
/* ================================================================== */
/* GETTER E CONTROLLI (tengono conto della vista) */
/* ================================================================== */
public static function id(): int
{
@@ -134,64 +195,85 @@ class SchoolContext
return self::$school;
}
/** owner | admin | teacher | student | superadmin */
public static function role(): string
/** Ruolo REALE nella scuola: owner|admin|teacher|student|superadmin */
public static function realRole(): string
{
return self::get()['school_role'];
}
public static function isSuperadmin(): bool
/** Alias storico di realRole() */
public static function role(): string
{
return self::realRole();
}
public static function isRealSuperadmin(): bool
{
return self::$superadmin;
}
public static function isSuperadmin(): bool
{
return self::viewMode() === 'superadmin';
}
public static function isOwner(): bool
{
return self::role() === 'owner';
return self::realRole() === 'owner' && self::isSchoolAdmin();
}
/** Può gestire la scuola: owner, admin o superadmin */
/** Gestisce la scuola (vista superadmin o scuola) */
public static function isSchoolAdmin(): bool
{
return self::$superadmin || in_array(self::role(), ['owner', 'admin'], true);
return in_array(self::viewMode(), ['superadmin', 'school'], true);
}
/** Staff della scuola: amministratori + insegnanti */
/** Staff: amministratori + insegnanti */
public static function isStaff(): bool
{
return self::isSchoolAdmin() || self::role() === 'teacher';
return self::isSchoolAdmin() || self::viewMode() === 'teacher';
}
/** Blocca la pagina se l'utente non è amministratore della scuola */
public static function requireSchoolAdmin(): void
{
if (!self::isSchoolAdmin()) {
http_response_code(403);
die('Accesso non autorizzato.');
self::deny();
}
}
public static function requireStaff(): void
{
if (!self::isStaff()) {
self::deny();
}
}
/** Blocca la pagina se l'utente non è superadmin */
public static function requireSuperadmin(): void
{
if (!self::$superadmin) {
http_response_code(403);
die('Accesso non autorizzato.');
if (!self::isSuperadmin()) {
self::deny();
}
}
/* --------------------------- interni ------------------------------- */
/* ================================================================== */
/* INTERNI */
/* ================================================================== */
private static function deny(): void
{
http_response_code(403);
$home = self::$school ? self::landingPage() : 'userpanel.php';
die('Accesso non autorizzato con la vista attuale. <a href="' . $home . '">Torna alla pagina iniziale</a>');
}
private static function pick(int $requested): ?array
{
// 1) scuola richiesta e l'utente ne è membro
foreach (self::$memberships as $m) {
if ((int) $m['idschool'] === $requested) {
return $m;
}
}
// 2) superadmin: può entrare in qualunque scuola esistente
if (self::$superadmin) {
$pdo = self::pdo();
if ($requested > 0) {
@@ -214,7 +296,6 @@ class SchoolContext
return null;
}
// 3) prima scuola di cui è membro
return self::$memberships[0] ?? null;
}
+106
View File
@@ -0,0 +1,106 @@
<?php
/**
* SchoolSettings
* Impostazioni della scuola (tabella `option`, una riga per scuola).
* Sostituisce tutti i "SELECT * FROM `option` LIMIT 1".
*
* Uso:
* $timetocancel = (int) SchoolSettings::get('maxbeforetimecancell', 24);
* $all = SchoolSettings::all();
* SchoolSettings::save(['show_teacher' => 'Y']);
*
* Nei cron (senza sessione) passare l'idschool esplicito:
* SchoolSettings::get('show_teacher', 'N', $idschool);
*/
if (!class_exists('DBHandlerSelect')) {
require_once __DIR__ . '/db-functions.php';
}
class SchoolSettings
{
/** @var array cache per scuola: idschool => riga option */
private static $cache = [];
/** Colonne che non si possono modificare con save() */
const PROTECTED_COLUMNS = ['idption', 'idschool'];
/** Tutte le impostazioni della scuola (riga creata se mancante) */
public static function all(?int $idschool = null): array
{
$idschool = self::schoolId($idschool);
if (!isset(self::$cache[$idschool])) {
$pdo = self::pdo();
$st = $pdo->prepare("SELECT * FROM `option` WHERE idschool = ? LIMIT 1");
$st->execute([$idschool]);
$row = $st->fetch();
if (!$row) {
// Nuova scuola: crea la riga con i default delle colonne
try {
$pdo->prepare("INSERT INTO `option` (idschool) VALUES (?)")->execute([$idschool]);
$st->execute([$idschool]);
$row = $st->fetch();
} catch (PDOException $e) {
error_log('SchoolSettings: impossibile creare option per scuola ' . $idschool . ': ' . $e->getMessage());
$row = [];
}
}
self::$cache[$idschool] = $row ?: [];
}
return self::$cache[$idschool];
}
/** Singola impostazione, con default se mancante o NULL */
public static function get(string $key, $default = null, ?int $idschool = null)
{
$all = self::all($idschool);
return (array_key_exists($key, $all) && $all[$key] !== null) ? $all[$key] : $default;
}
/**
* Salva una o più impostazioni. Accetta solo colonne esistenti in `option`
* (le altre chiavi vengono ignorate).
*/
public static function save(array $data, ?int $idschool = null): void
{
$idschool = self::schoolId($idschool);
$current = self::all($idschool);
$set = [];
$params = [];
foreach ($data as $col => $val) {
if (!array_key_exists($col, $current) || in_array($col, self::PROTECTED_COLUMNS, true)) {
continue;
}
$set[] = "`$col` = ?";
$params[] = $val;
}
if (empty($set)) {
return;
}
$params[] = $idschool;
self::pdo()->prepare("UPDATE `option` SET " . implode(', ', $set) . " WHERE idschool = ?")
->execute($params);
unset(self::$cache[$idschool]);
}
private static function schoolId(?int $idschool): int
{
if ($idschool !== null && $idschool > 0) {
return $idschool;
}
return SchoolContext::id();
}
private static function pdo(): PDO
{
return DBHandlerSelect::getInstance()->getConnection();
}
}