Merge pull request #617 from nilsonLazarin/gabriel

Alterações realizadas entre os dias 20 e 27/06/2024

BD/wegia001.sql

@@ -664,7 +664,7 @@ CREATE TABLE IF NOT EXISTS `wegia`.`tabela_imagem_campo` (
     REFERENCES `wegia`.`imagem` (`id_imagem`))
 ENGINE = InnoDB;
 
-
+-- SERÁ REMOVIDO EM NOVA VERSÃO - Módulo contribuição está sendo refatorado... --
 -- -----------------------------------------------------
 -- Table `wegia`.`sistema_pagamento`
 -- -----------------------------------------------------
@@ -765,6 +765,64 @@ FOREIGN KEY (TIPO_CHAVE) REFERENCES doacao_pix_tipos(ID),
 FOREIGN KEY (ID_SISTEMA) REFERENCES sistema_pagamento(ID))
 ENGINE = InnoDB;
 
+-- Novas tabelas para o módulo contribuição --
+-- -----------------------------------------------------
+-- Table `wegia`.`contribuicao_gatewayPagamento`
+-- -----------------------------------------------------
+CREATE TABLE `wegia`.`contribuicao_gatewayPagamento` (
+    `id` INT NOT NULL AUTO_INCREMENT,
+    `plataforma` VARCHAR(50) NOT NULL,
+    `endPoint` VARCHAR(255) NOT NULL,
+    `token` VARCHAR(100) NOT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE = InnoDB;
+
+-- -----------------------------------------------------
+-- Table `wegia`.`contribuicao_regras`
+-- -----------------------------------------------------
+CREATE TABLE `wegia`.`contribuicao_regras` (
+    `id` INT NOT NULL AUTO_INCREMENT,
+    `regra` VARCHAR(128) NOT NULL,
+    PRIMARY KEY (`id`),
+    UNIQUE INDEX `regra_UNIQUE` (`regra` ASC) VISIBLE
+) ENGINE = InnoDB;
+
+-- -----------------------------------------------------
+-- Table `wegia`.`contribuicao_meioPagamento`
+-- -----------------------------------------------------
+CREATE TABLE `wegia`.`contribuicao_meioPagamento` (
+    `id` INT NOT NULL AUTO_INCREMENT,
+    `meio` VARCHAR(45) NOT NULL,
+    `id_plataforma` INT NOT NULL,
+    PRIMARY KEY (`id`),
+    UNIQUE INDEX `meio_UNIQUE` (`meio` ASC) VISIBLE,
+    CONSTRAINT `fk_contribuicao_gatewayPagamento_plataforma`
+        FOREIGN KEY (`id_plataforma`)
+        REFERENCES `wegia`.`contribuicao_gatewayPagamento` (`id`)
+        ON DELETE NO ACTION
+        ON UPDATE NO ACTION
+) ENGINE = InnoDB;
+
+-- -----------------------------------------------------
+-- Table `wegia`.`contribuicao_conjuntoRegras`
+-- -----------------------------------------------------
+CREATE TABLE `wegia`.`contribuicao_conjuntoRegras` (
+    `id_meio` INT NOT NULL,
+    `id_regra` INT NOT NULL,
+    `value` VARCHAR(45) NULL,
+    PRIMARY KEY (`id_meio`, `id_regra`),
+    CONSTRAINT `fk_contribuicao_meioPagamento_meio`
+        FOREIGN KEY (`id_meio`)
+        REFERENCES `wegia`.`contribuicao_meioPagamento` (`id`)
+        ON DELETE NO ACTION
+        ON UPDATE NO ACTION,
+    CONSTRAINT `fk_contribuicao_regras_regra`
+        FOREIGN KEY (`id_regra`)
+        REFERENCES `wegia`.`contribuicao_regras` (`id`)
+        ON DELETE NO ACTION
+        ON UPDATE NO ACTION
+) ENGINE = InnoDB;
+
 
 -- -----------------------------------------------------
 -- Table `wegia`.`socio_status`

BD/wegia002.sql

@@ -268,3 +268,8 @@ WHERE `descricao` IS NOT NULL;*/
 INSERT INTO `saude_medicacao_status` (`descricao`) VALUES ('Em tratamento'), ('Concluído') , ('Substituído'), ('Cancelado');
 
 INSERT INTO `saude_tabelacid` (`CID`, `descricao`) VALUES ('B34.2', 'Infecção por coronavírus de localização não especificada');
+
+-- 240621: Refatoração do módulo Contribuição, dados para as novas tabelas --
+INSERT INTO `contribuicao_regras` (`regra`) VALUES 
+('MIN_VALUE'), 
+('MAX_VALUE');

classes/Beneficiados.php

@@ -2,82 +2,154 @@
 
 class Beneficiados
 {
-	private $id_beneficiados;
-	private $id_pessoa;
-	private $id_beneficios;
+    //Atributos
+    private $id_beneficiados;
+    private $id_pessoa;
+    private $id_beneficios;
     private $data_inicio;
     private $data_fim;
     private $beneficios_status;
     private $valor;
 
+    /**
+     * Retorna o id de um beneficiado
+     */
     public function getId_Beneficiados()
     {
         return $this->id_beneficiados;
     }
 
+    /**
+     * Retorna o id de uma pessoa
+     */
     public function getId_pessoa()
     {
         return $this->id_pessoa;
     }
 
-	public function getId_beneficios()
+    /**
+     * Retorna o id de um benefício
+     */
+    public function getId_beneficios()
     {
         return $this->id_beneficios;
     }
 
+    /**
+     * Retorna a data de início de um benefício
+     */
     public function getData_inicio()
     {
         return $this->data_inicio;
     }
 
+    /**
+     * Retorna a data final de um benefício
+     */
     public function getData_fim()
     {
         return $this->data_fim;
     }
 
+    /**
+     * Retorna o status de um benefício
+     */
     public function getBeneficios_status()
     {
         return $this->beneficios_status;
     }
 
+    /**
+     * Retorna o valor de um benefício
+     */
     public function getValor()
     {
         return $this->valor;
     }
 
+    /**
+     * Define o id de um beneficiado
+     */
     public function setId_beneficiados($id_beneficiados)
     {
+        if (!$id_beneficiados || !is_numeric($id_beneficiados) || $id_beneficiados < 1) {
+            throw new InvalidArgumentException('O id de um beneficiado deve ser um inteiro positivo maior ou igual a 1.');
+        }
         $this->id_beneficiados = $id_beneficiados;
     }
 
+    /**
+     * Define o id de uma pessoa
+     */
     public function setId_pessoa($id_pessoa)
     {
+        if (!$id_pessoa || !is_numeric($id_pessoa) || $id_pessoa < 1) {
+            throw new InvalidArgumentException('O id de uma pessoa deve ser um inteiro positivo maior ou igual a 1.');
+        }
         $this->id_pessoa = $id_pessoa;
     }
 
+    /**
+     * Define o id de um benefício
+     */
     public function setId_beneficios($id_beneficios)
     {
+        if (!$id_beneficios || !is_numeric($id_beneficios) || $id_beneficios < 1) {
+            throw new InvalidArgumentException('O id de um benefício deve ser um inteiro positivo maior ou igual a 1.');
+        }
         $this->id_beneficios = $id_beneficios;
     }
 
+    /**
+     * Define a data de início de um benefício
+     */
     public function setData_inicio($data_inicio)
     {
+        if (!$this->validarData($data_inicio)) {
+            throw new InvalidArgumentException('A data informada não está no formato correto: YYYY-MM-DD');
+        }
         $this->data_inicio = $data_inicio;
     }
 
+    /**
+     * Define a data final de um benefício
+     */
     public function setData_fim($data_fim)
     {
+        if (!$this->validarData($data_fim)) {
+            throw new InvalidArgumentException('A data informada não está no formato correto: YYYY-MM-DD');
+        }
         $this->data_fim = $data_fim;
     }
 
+    /**
+     * Define o status de um benefício
+     */
     public function setBeneficios_status($beneficios_status)
     {
+        if (!$beneficios_status || !is_numeric($beneficios_status) || $beneficios_status < 0) {
+            throw new InvalidArgumentException('O status fornecido deve ser um inteiro não negativo.');
+        }
         $this->beneficios_status = $beneficios_status;
     }
 
+    /**
+     * Define o valor de um benefício
+     */
     public function setValor($valor)
     {
+        if (!$valor || !is_numeric($valor) || $valor <= 0) {
+            throw new InvalidArgumentException('O valor de um benefício deve ser um número maior que zero.');
+        }
         $this->valor = $valor;
     }
 
-}
+    /**
+     * Função para validar o formato de uma data
+     */
+    private function validarData(string $data, string $formato = 'Y-m-d')
+    {
+        $d = DateTime::createFromFormat($formato, $data);
+        return $d && $d->format($formato) === $data;
+    }
+}

classes/Categoria.php

@@ -2,30 +2,52 @@
 
 class Categoria
 {
-
+    //Atributos
     private $id_categoria_produto;
     private $descricao_categoria;
 
-    public function __construct($descricao_categoria){
-        $this->descricao_categoria=$descricao_categoria;
+    public function __construct(string $descricao_categoria, int $id_categoria_produto = null){
+        $this->setDescricao_categoria($descricao_categoria);
+        if($id_categoria_produto){
+            $this->setId_categoria_produto($id_categoria_produto);
+        }
     }
+
+    /**
+     * Retorna o id de uma categoria de produto
+     */
     public function getId_categoria_produto()
     {
         return $this->id_categoria_produto;
     }
 
+    /**
+     * Retorna a descrição de uma categoria de produto
+     */
     public function getDescricaoCategoria()
     {
         return $this->descricao_categoria;
     }
 
-    public function setId_categoria_produto($id_categoria_produto)
+    /**
+     * Define o id de uma categoria de produto
+     */
+    public function setId_categoria_produto(int $id_categoria_produto)
     {
+        if($id_categoria_produto < 1){
+            throw new InvalidArgumentException('O id de uma categoria de produto não pode ser menor que 1.');
+        }
         $this->id_categoria_produto = $id_categoria_produto;
     }
 
-    public function setDescricao_categoria($descricao_categoria)
+    /**
+     * Define a descrição de uma categoria
+     */
+    public function setDescricao_categoria(string $descricao_categoria)
     {
+        if(empty($descricao_categoria)){
+            throw new InvalidArgumentException('A descrição de uma categoria não pode ser vazia.');
+        }
         $this->descricao_categoria = $descricao_categoria;
     }
 

classes/Estoque.php

@@ -2,44 +2,70 @@
 
 class Estoque
 {
+    //Atributos
    private $id_produto;
    private $id_almoxarifado;
    private $qtd;
 
-    public function __construct($qtd)
+    public function __construct(int $qtd)
     {
-        $this->qtd=$qtd;
+        $this->setQtd($qtd);
     }
 
+    /**
+     * Retorna o id de um produto do estoque
+     */
     public function getId_produto()
     {
         return $this->id_produto;
     }
 
+    /**
+     * Retorna o id de um produto do almoxarifado
+     */
     public function getId_almoxarifado()
     {
         return $this->id_almoxarifado;
     }
 
+    /**
+     * Retorna a quantidade de um estoque
+     */
     public function getQtd()
     {
         return $this->qtd;
     }
 
-    public function setId_produto($id_produto)
+    /**
+     * Define o id de um produto do estoque
+     */
+    public function setId_produto(int $id_produto)
     {
+        if($id_produto < 1){
+            throw new InvalidArgumentException('O valor do id de um produto não pode ser menor que 1.');
+        }
         $this->id_produto = $id_produto;
     }
 
-    public function setId_almoxarifado($id_almoxarifado)
+    /**
+     * Define o id de um almoxarifado do estoque
+     */
+    public function setId_almoxarifado(int $id_almoxarifado)
     {
+        if($id_almoxarifado < 1){
+            throw new InvalidArgumentException('O valor do id de um almoxarifado não pode ser menor que 1.');
+        }
         $this->id_almoxarifado = $id_almoxarifado;
     }
 
-    public function setQtd($qtd)
+    /**
+     * Define a quantidade de um estoque
+     */
+    public function setQtd(int $qtd)
     {
+        if($qtd < 0){
+            throw new InvalidArgumentException('A quantidade de um estoque não pode ser negativa.');
+        }
         $this->qtd = $qtd;
-    }
-
-
+    }   
 }