Atualiza estrutura MVC e integração com banco de dados

2026-08-30 22:18:31 -03:00
parent 6231cc46a8
commit 966f6b7587
26 changed files with 3265 additions and 8 deletions
@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Model responsável pelas operações relacionadas
+ * às tentativas de autenticação.
+ *
+ * Responsabilidades:
+ *
+ * - verificar tentativas inválidas por e-mail;
+ * - verificar tentativas inválidas por endereço IP;
+ * - registrar tentativas de autenticação;
+ * - centralizar o acesso à tabela tentativas_login.
+ */
+class LoginAttempt
+{
+    /**
+     * Conexão com o banco de dados.
+     */
+    private PDO $pdo;
+
+
+    /**
+     * Recebe a conexão PDO utilizada pelo Model.
+     */
+    public function __construct(PDO $pdo)
+    {
+        $this->pdo = $pdo;
+    }
+
+
+    /**
+     * Conta as tentativas inválidas de um endereço
+     * de e-mail dentro da janela de tempo informada.
+     */
+    public function contarFalhasPorEmail(
+        string $email,
+        int $janelaMinutos
+    ): int {
+
+        $janelaMinutos = max(
+            1,
+            $janelaMinutos
+        );
+
+        $sql = "
+            SELECT COUNT(*)
+            FROM tentativas_login
+            WHERE email = :email
+              AND sucesso = 0
+              AND criado_em >= DATE_SUB(
+                  NOW(),
+                  INTERVAL {$janelaMinutos} MINUTE
+              )
+        ";
+
+        $stmt = $this->pdo->prepare($sql);
+
+        $stmt->execute([
+            'email' => $email
+        ]);
+
+        return (int)$stmt->fetchColumn();
+    }
+
+
+    /**
+     * Conta as tentativas inválidas de um endereço
+     * IP dentro da janela de tempo informada.
+     */
+    public function contarFalhasPorIp(
+        string $ip,
+        int $janelaMinutos
+    ): int {
+
+        $janelaMinutos = max(
+            1,
+            $janelaMinutos
+        );
+
+        $sql = "
+            SELECT COUNT(*)
+            FROM tentativas_login
+            WHERE ip_address = :ip
+              AND sucesso = 0
+              AND criado_em >= DATE_SUB(
+                  NOW(),
+                  INTERVAL {$janelaMinutos} MINUTE
+              )
+        ";
+
+        $stmt = $this->pdo->prepare($sql);
+
+        $stmt->execute([
+            'ip' => $ip
+        ]);
+
+        return (int)$stmt->fetchColumn();
+    }
+
+
+    /**
+     * Registra uma tentativa de autenticação
+     * realizada pelo usuário.
+     */
+    public function registrar(
+        string $email,
+        string $ip,
+        bool $sucesso
+    ): bool {
+
+        $sql = "
+            INSERT INTO tentativas_login
+                (
+                    email,
+                    ip_address,
+                    sucesso
+                )
+            VALUES
+                (
+                    :email,
+                    :ip,
+                    :sucesso
+                )
+        ";
+
+        $stmt = $this->pdo->prepare($sql);
+
+        return $stmt->execute([
+            'email' => $email,
+            'ip' => $ip,
+            'sucesso' => $sucesso ? 1 : 0
+        ]);
+    }
+}
@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Model responsável pelas operações relacionadas
+ * aos usuários da aplicação.
+ *
+ * Responsabilidades:
+ *
+ * - localizar usuário pelo e-mail;
+ * - atualizar senha;
+ * - centralizar o acesso à tabela usuarios.
+ */
+class User
+{
+    /**
+     * Conexão com o banco de dados.
+     */
+    private PDO $pdo;
+
+
+    /**
+     * Recebe a conexão PDO utilizada pelo Model.
+     */
+    public function __construct(PDO $pdo)
+    {
+        $this->pdo = $pdo;
+    }
+
+
+    /**
+     * Localiza um usuário através do endereço de e-mail.
+     *
+     * Retorna os dados necessários para o processo
+     * de autenticação.
+     *
+     * Retorna null quando o usuário não existe.
+     */
+    public function buscarPorEmail(string $email): ?array
+    {
+        $sql = "
+            SELECT
+                id,
+                nome,
+                email,
+                senha,
+                perfil,
+                ativo
+            FROM usuarios
+            WHERE email = :email
+            LIMIT 1
+        ";
+
+        $stmt = $this->pdo->prepare($sql);
+
+        $stmt->execute([
+            'email' => $email
+        ]);
+
+        $usuario = $stmt->fetch();
+
+        if ($usuario === false) {
+            return null;
+        }
+
+        return $usuario;
+    }
+
+
+    /**
+     * Atualiza o hash da senha de um usuário.
+     *
+     * Utilizado quando password_needs_rehash()
+     * identificar que o algoritmo ou os parâmetros
+     * utilizados para criar o hash foram atualizados.
+     */
+    public function atualizarSenha(
+        int $id,
+        string $novoHash
+    ): bool {
+
+        $sql = "
+            UPDATE usuarios
+            SET senha = :senha
+            WHERE id = :id
+        ";
+
+        $stmt = $this->pdo->prepare($sql);
+
+        return $stmt->execute([
+            'senha' => $novoHash,
+            'id' => $id
+        ]);
+    }
+}