nettown_backend/libs/Roles.php

<?php

namespace Libs;

/**
 * Catálogo central de papéis (roles) válidos do sistema.
 *
 * O papel é persistido em "user.user_role" (VARCHAR(10)) e embarcado no JWT.
 * Manter a lista num único lugar evita divergência entre validação de
 * cadastro (RegisterController) e checagem de acesso (RoleMiddleware).
 */
final class Roles
{
    public const ADMIN = 'admin';
    public const MANAGER = 'manager';
    public const OPERATOR = 'operator';

    /** @var string[] Todos os papéis aceitos pelo sistema. */
    public const ALL = [
        self::ADMIN,
        self::MANAGER,
        self::OPERATOR,
    ];

    public static function isValid(string $role): bool
    {
        return in_array($role, self::ALL, true);
    }
}