nettown_backend/routes/Dispatcher.php

<?php

namespace Routes;

use FrameworkX\App;
use Middlewares\JwtAuthMiddleware;
use Middlewares\RoleMiddleware;
use Libs\Roles;

/**
 * Registro central de rotas da API.
 *
 * Mantém a definição das rotas fora do bootstrap (public/index.php),
 * concentrando aqui a tabela de endpoints, a autenticação (JWT) e a
 * autorização por papel (RBAC).
 *
 * Convenção de middlewares por rota (a ordem importa):
 *   1) JwtAuthMiddleware  -> autentica e popula "user_role" a partir do banco;
 *   2) RoleMiddleware     -> autoriza conforme os papéis permitidos.
 */
final class Dispatcher
{
    public static function register(App $app): void
    {
        $auth = new JwtAuthMiddleware();

        // ---- Público (sem autenticação) -------------------------------------
        // Login é protegido contra brute-force via RateLimiter no controller.
        $app->post('/v1/login', \Controllers\LoginController::class);

        // ---- Somente admin --------------------------------------------------
        // Cadastro de usuários: o novo usuário herda o company_id do solicitante.
        $app->post('/v1/register', $auth, new RoleMiddleware(Roles::ADMIN), \Controllers\RegisterController::class);

        // ---- Autenticado (qualquer papel válido) ----------------------------
        self::registerAuthenticated($app, $auth);
    }

    /**
     * Rotas que exigem apenas um usuário autenticado, sem restrição de papel.
     * Para restringir uma destas no futuro, basta inserir um RoleMiddleware
     * entre $auth e o controller (ex.: new RoleMiddleware(Roles::ADMIN, Roles::MANAGER)).
     */
    private static function registerAuthenticated(App $app, JwtAuthMiddleware $auth): void
    {
        // Perfil do usuário autenticado.
        $app->get('/v1/me', $auth, \Controllers\MeController::class);
        $app->post('/v1/me/change-password', $auth, \Controllers\MeChangePasswordController::class);

        // Dashboards e analytics (leitura).
        $app->get('/v1/dashboard/overview', $auth, \Controllers\DashboardOverviewController::class);
        $app->get('/v1/interactions', $auth, \Controllers\InteractionsController::class);
        $app->get('/v1/interactions/details', $auth, \Controllers\InteractionDetailsController::class);
        $app->get('/v1/analytics/sentiment/dashboard', $auth, \Controllers\AnalyticsSentimentDashboardController::class);
        $app->get('/v1/personas/overview', $auth, \Controllers\PersonasOverviewController::class);
        $app->get('/v1/evolution/overview', $auth, \Controllers\EvolutionOverviewController::class);
        $app->get('/v1/executive/dashboard', $auth, \Controllers\ExecutiveDashboardController::class);

        // SLA.
        $app->get('/v1/sla/configs', $auth, \Controllers\SlaConfigsController::class);
        $app->get('/v1/sla/live-status', $auth, \Controllers\SlaLiveStatusController::class);
        $app->post('/v1/sla/configs', $auth, \Controllers\SlaSaveConfigController::class);

        // Agentes.
        $app->get('/v1/agents', $auth, \Controllers\AgentsController::class);
        $app->post('/v1/agents', $auth, \Controllers\AgentSaveController::class);
        $app->post('/v1/agents/status', $auth, \Controllers\AgentStatusController::class);
        $app->post('/v1/agents/escalation', $auth, \Controllers\AgentEscalationController::class);
    }
}