From 895dca3c728043d7bce0dd964c21a1b6f5685235 Mon Sep 17 00:00:00 2001
From: dududs8 <martins.silvadudu@gmail.com>
Date: Mon, 14 Jul 2025 16:03:18 -0300
Subject: [PATCH 1/2] =?UTF-8?q?JavaDoc=20da=20lista=20de=20exerc=C3=ADcios?=
 =?UTF-8?q?=20de=20Heran=C3=A7a?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/main/java/Automov\303\251l.java"      | 42 ++++++++++++++++-
 .../src/main/java/Avi\303\243o.java"          | 26 +++++++++++
 .../exercicio-01/src/main/java/Barco.java"    | 31 +++++++++++++
 .../src/main/java/Ve\303\255culo.java"        | 45 +++++++++++++++++++
 .../exercicio-02/src/main/java/BadFish.java"  | 27 +++++++++++
 .../exercicio-02/src/main/java/Kate.java"     | 42 +++++++++++++++++
 .../exercicio-02/src/main/java/MadCat.java"   | 27 +++++++++++
 .../exercicio-02/src/main/java/MegaBob.java"  | 27 +++++++++++
 .../src/main/java/Obst\303\241culos.java"     | 29 ++++++++++++
 .../src/main/java/Personagens.java"           | 26 +++++++++++
 .../exercicio-02/src/main/java/Poder.java"    | 30 +++++++++++++
 11 files changed, 351 insertions(+), 1 deletion(-)

diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java"
index fce6230..e3a54fa 100644
--- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java"
+++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java"
@@ -1,3 +1,6 @@
+/**
+ * Classe Automovél que herda da classe Veículo.
+ */
 public class Automovél extends Veículo{
     
     private String renavam;
@@ -5,15 +8,27 @@ public class Automovél extends Veículo{
     private boolean marcha;
     private int cont = 0;
     
-    
+    /**
+     * Construtor padrão da classe Automovél.
+     */
     public Automovél() {
     }
 
+    /**
+     * Construtor da classe Automovél.
+     * @param renavam O renavam do automóvel. 
+     * @param placa A placa do automóvel.
+     */
     public Automovél(String renavam, String placa) {
         this.renavam = renavam;
         this.placa = placa;
     }
 
+    /**
+     * Método para passar a marcha do veículo, se já passou o limite de marchas, não faz nada.
+     * Se o veículo estiver desligado, não é possível passar marcha.
+     * Se o veículo estiver parado, não é possível passar marcha. 
+     */
     public void passar_marcha(){
 
         if ((isOn() == true) && ((isFrente() == true) || (isRe() == true))){
@@ -38,6 +53,12 @@ else if (isOn() == false){
         }
     }
 
+    /**
+     * Método para frear o veículo, se estiver em ponto morto, não faz nada.
+     * Se o veículo estiver ligado e indo para frente ou de ré, reduz uma marcha.
+     * Se a marcha já estiver na primeira, não faz nada.
+     * Se o veículo estiver desligado, não é possível frear.
+     */
     public void frear(){
 
         if (isOn() == true) {
@@ -58,15 +79,34 @@ public void frear(){
     }
 
 
+    /**
+     * Método para obter o renavam do automóvel.
+     * @return o renavam do automóvel.
+     */
     public String getRenavam() {
         return renavam;
     }
+
+    /**
+     * Método para definir o renavam do automóvel.
+     * @param renavam o renavam do automóvel.
+     */
     public void setRenavam(String renavam) {
         this.renavam = renavam;
     }
+
+    /**
+     * Método para obter a placa do automóvel.
+     * @return placa do automóvel.
+     */
     public String getPlaca() {
         return placa;
     }
+
+    /**
+     * Método para definir a placa do automóvel.
+     * @param placa a placa do automóvel.
+     */
     public void setPlaca(String placa) {
         this.placa = placa;
     }
diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java"
index c6f556c..5d81214 100644
--- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java"
+++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java"
@@ -1,17 +1,31 @@
+/**
+ * Classe Avião que herda da classe Veículo.
+ */
 public class Avião extends Veículo{
 
     private String registro_aeronaútico;
     private boolean decolar;
     
     
+    /**
+     * Construtor padrão da classe Avião.
+     */
     public Avião() {
     }
 
+    /**
+     * Construtor da classe Avião.
+     * @param registro_aeronaútico O registro aeronaútico do avião.
+     */
     public Avião(String registro_aeronaútico) {
         this.registro_aeronaútico = registro_aeronaútico;
     }
 
 
+    /**
+     * Método para decolar o veículo, se já tiver decolado, não faz nada.
+     * Se o veículo estiver desligado, não é possível decolar.
+     */
     public void decolar(){
 
         if (isOn() == true) {
@@ -30,6 +44,10 @@ public void decolar(){
         
     }
 
+    /**
+     * Método para pousar o veículo, se já estiver em pouso, não faz nada.
+     * Se o veículo estiver desligado, não é possível pousar.
+     */
     public void pousar(){
 
         if (isOn() == true) {
@@ -48,10 +66,18 @@ public void pousar(){
     }
 
 
+    /**
+     * Método para obter o registro aeronaútico do avião.
+     * @return registro_aeronaútico do avião.
+     */
     public String getRegistro_aeronaútico() {
         return registro_aeronaútico;
     }
 
+    /**
+     * Método para definir o registro aeronaútico do avião.
+     * @param registro_aeronaútico o registro aeronaútico do avião.
+     */
     public void setRegistro_aeronaútico(String registro_aeronaútico) {
         this.registro_aeronaútico = registro_aeronaútico;
     }
diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java"
index 26a9d5c..7840d43 100644
--- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java"
+++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java"
@@ -1,16 +1,31 @@
+/**
+ * Classe Barco que herda da classe Veículo.
+ */
 public class Barco extends Veículo{
 
     private String registro_embarcação;
     private boolean navegar;
     private boolean ancorar = true;
     
+    /**
+     * Construtor padrão da classe Barco.
+     */
     public Barco() {
     }
 
+    /**
+     * Construtor da classe Barco.
+     * @param registro_embarcação O registro da embarcação.
+     */
     public Barco(String registro_embarcação) {
         this.registro_embarcação = registro_embarcação;
     }
 
+    /**
+     * Método para navegar com o veículo, se estiver ancorado, não faz nada.
+     * Se já estiver navegando, não faz nada.
+     * Se o veículo estiver desligado, não é possível navegar.
+     */
     public void navegar(){
 
         if (isOn() == true) {
@@ -32,6 +47,10 @@ else if (ancorar == true){
         
     }
 
+    /**
+     * Método para ancorar o veículo, se já estiver ancorado, não faz nada.
+     * Se o veículo estiver desligado, não é possível ancorar.
+     */
     public void ancorar(){
 
         if (isOn() == true) {
@@ -50,6 +69,10 @@ public void ancorar(){
         }
     }
 
+    /**
+     * Método para desancorar o veículo, se já estiver desancorado, não faz nada.
+     * Se o veículo estiver desligado, não é possível desancorar.
+     */
     public void desancorar(){
         if (isOn() == true) {
             if (ancorar == true){
@@ -66,10 +89,18 @@ public void desancorar(){
         }
     }
 
+    /**
+     * Método para pegar registro da embarcação.
+     * @return o registro da embarcação.
+     */
     public String getRegistro_embarcação() {
         return registro_embarcação;
     }
 
+    /**
+     * Método para definir o registro da embarcação.
+     * @param registro_embarcação o registro da embarcação.
+     */
     public void setRegistro_embarcação(String registro_embarcação) {
         this.registro_embarcação = registro_embarcação;
     }
diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java"
index 806453f..9c953a6 100644
--- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java"
+++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java"
@@ -1,9 +1,15 @@
+/**
+ * Classe Veículo que serve como base para outros tipos de veículos.
+ */
 public class Veículo {
 
     private boolean on;
     private boolean frente;
     private boolean re;
 
+    /**
+     * Método para ligar o veículo, se já estiver ligado, não faz nada.
+     */
     public void ligar(){
 
         if (on == false){
@@ -15,6 +21,9 @@ public void ligar(){
         }
     }
 
+    /**
+     * Método para desligar o veículo, se já estiver desligado, não faz nada.
+     */
     public void desligar(){
 
         if (on == true){
@@ -26,6 +35,10 @@ public void desligar(){
         }
     }
 
+    /**
+     * Método para movimentar o veículo para frente, se já estiver em movimento, não faz nada.
+     * Se o veículo estiver desligado, não é possível se locomover.
+     */
     public void mover_frente(){
 
         if (on == true) {
@@ -44,6 +57,10 @@ public void mover_frente(){
         
     }
 
+    /**
+     * Método para movimentar o veículo de ré, se já estiver em movimento de ré, não faz nada.
+     * Se o veículo estiver desligado, não é possível se locomover de ré.
+     */
     public void mover_re(){
 
         if (on == true) {
@@ -63,6 +80,10 @@ public void mover_re(){
         
     }
 
+    /**
+     * Método para parar o veículo, se já estiver parado, não faz nada.
+     * Se o veículo estiver desligado, não é possível parar.
+     */
     public void parar(){
 
         if (on == true) {
@@ -80,26 +101,50 @@ public void parar(){
         }
     }
 
+    /**
+     * Método para dizer se o veículo está ligado ou não. 
+     * @return true se o veículo estiver ligado, false caso contrário.
+     */
     public boolean isOn() {
         return on;
     }
 
+    /**
+     * Método para definir se o veículo está ligado ou não.
+     * @param on diz se o veículo está ligado ou não.
+     */
     public void setOn(boolean on) {
         this.on = on;
     }
 
+    /**
+     * Método para verificar se o veículo está em movimento para frente. 
+     * @return true se o veículo estiver em movimento para frente, false caso contrário.
+     */
     public boolean isFrente() {
         return frente;
     }
 
+    /**
+     * Método para definir se o veículo está em movimento para frente. 
+     * @param frente diz se o veículo está em movimento para frente ou não.
+     */
     public void setFrente(boolean frente) {
         this.frente = frente;
     }
 
+    /**
+     * Método para verificar se o veículo está em movimento de ré.
+     * @return true se o veículo estiver em movimento de ré, false caso contrário.
+     */
     public boolean isRe() {
         return re;
     }
 
+    /**
+     * Método para definir se o veículo está em movimento de ré.
+     * @param re diz se o veículo está em movimento de ré ou não.
+     */
     public void setRe(boolean re) {
         this.re = re;
     }
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java"
index 39239ed..a3637a2 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java"
@@ -1,28 +1,55 @@
+/**
+ * Classe BadFish que herda da classe Personagens.
+ */
 public class BadFish extends Personagens{
 
     private String nome;
     private float dano_recebido;
 
+    /**
+     * Construtor padrão da classe BadFish.
+     */
     public BadFish() {
     }
 
+    /**
+     * Construtor da classe BadFish.
+     * @param energia A energia do BadFish.
+     * @param cod O código do BadFish.
+     */
     public BadFish(float energia, String cod) {
         super(energia);
         this.nome = cod;
     }
 
+    /**
+     * Método para retornar o nome do BadFish.
+     * @return O nome do BadFish.
+     */
     public String getNome() {
         return nome;
     }
 
+    /**
+     * Método para definir o nome do BadFish.
+     * @param cod O nome do BadFish.
+     */
     public void setNome(String cod) {
         this.nome = cod;
     }
 
+    /**
+     * Método para retornar dano que o BadFish recebeu.
+     * @return O dano recebido pelo BadFish.
+     */
     public float getDano_recebido() {
         return dano_recebido;
     }
 
+    /**
+     * Método para definir o dano que o BadFish recebeu.
+     * @param dano_recebido O dano recebido pelo BadFish.
+     */
     public void setDano_recebido(float dano_recebido) {
         this.dano_recebido = dano_recebido;
     }
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java"
index d795161..85fb7b7 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java"
@@ -1,50 +1,92 @@
 import java.util.ArrayList;
 
+/**
+ * Classe Kate que herda da classe Personagens.
+ */
 public class Kate extends Personagens{
 
     private int qtd_vida;
     private ArrayList<Poder> poder;
     private int poder_atual = 0;
 
+    /**
+     * Construtor padrão da classe Kate.
+     */
     public Kate() {
         this.poder = new ArrayList<Poder>();
     }
 
+    /**
+     * Construtor da classe Kate.
+     * @param energia A energia da Kate.
+     * @param qtd_vida A quantidade de vida da Kate.
+     */
     public Kate(float energia, int qtd_vida) {
         super(energia);
         this.qtd_vida = qtd_vida;
     }
 
+    /**
+     * Método para pular, imprime uma mensagem indicando que a Kate pulou.
+     */
     public void pular() {
         System.out.println("\nA kate pulou!");
     }
 
+    /**
+     * Método para andar, imprime uma mensagem indicando que a Kate andou.
+     */
     public void andar() {
         System.out.println("\nA kate andou!");
     }
 
 
+    /**
+     * Método para alterar o poder atual da Kate.
+     * @param poder_atual O poder atual da Kate.
+     */
     public void alterarpoder(int poder_atual) {
         this.poder_atual = poder_atual;
     }
 
+    /**
+     * Método para retornar o dano causado pelo poder atual da Kate. 
+     * @param poder A lista de poderes da Kate.
+     * @return O dano causado pelo poder atual da Kate.
+     */
     public float poder(ArrayList<Poder> poder) {
         float dano = poder.get(poder_atual).getDano();;
         return dano;
     }
 
+    /**
+     * Método para retornar a quantidade de vida da Kate.
+     * @return A quantidade de vida da Kate.
+     */
     public int getQtd_vida() {
         return qtd_vida;
     }
 
+    /**
+     * Método para definir a quantidade de vida da Kate.
+     * @param qtd_vida A quantidade de vida da Kate.
+     */
     public void setQtd_vida(int qtd_vida) {
         this.qtd_vida = qtd_vida;
     }
 
+    /**
+     * Método para retornar a lista de poderes da Kate.
+     * @return A lista de poderes da Kate.
+     */
     public ArrayList<Poder> getPoder() {
         return poder;
     }
 
+    /**
+     * Método para definir a lista de poderes da Kate.
+     * @param poder A lista de poderes da Kate.
+     */
     public void setPoder(ArrayList<Poder> poder) {
         this.poder = poder;
     }  
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java"
index 8df2495..97eadd8 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java"
@@ -1,28 +1,55 @@
+/**
+ * Classe MadCat que herda da classe Personagens.
+ */
 public class MadCat extends Personagens{
     
     private String nome;
     private float dano_recebido;
 
+    /**
+     * Construtor padrão da classe MadCat.
+     */
     public MadCat() {
     }
 
+    /**
+     * Construtor da classe MadCat.
+     * @param energia A energia do MadCat.
+     * @param nome O nome do MadCat.
+     */
     public MadCat(float energia, String nome) {
         super(energia);
         this.nome = nome;
     }
 
+    /**
+     * Método para retornar o nome do MadCat.
+     * @return O nome do MadCat.
+     */
     public String getNome() {
         return nome;
     }
 
+    /**
+     * Método para definir o nome do MadCat.
+     * @param nome O nome do MadCat.
+     */
     public void setNome(String nome) {
         this.nome = nome;
     }
 
+    /**
+     * Método para retornar o dano que o MadCat recebeu.
+     * @return O dano recebido pelo MadCat.
+     */
     public float getDano_recebido() {
         return dano_recebido;
     }
 
+    /**
+     * Método para definir o dano que o MadCat recebeu.
+     * @param dano_recebido O dano recebido pelo MadCat.
+     */
     public void setDano_recebido(float dano_recebido) {
         this.dano_recebido = dano_recebido;
     }
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java"
index 0c4da91..a6f2cfd 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java"
@@ -1,28 +1,55 @@
+/**
+ * Classe MegaBob que herda da classe Personagens.
+ */
 public class MegaBob extends Personagens{
 
     private String nome;
     private float dano_recebido;
 
+    /**
+     * Construtor padrão da classe MegaBob.
+     */
     public MegaBob() {
     }
 
+    /**
+     * Construtor da classe MegaBob.
+     * @param energia A energia do MegaBob.
+     * @param nome O nome do MegaBob.
+     */
     public MegaBob(float energia, String nome) {
         super(energia);
         this.nome = nome;
     }
 
+    /**
+     * Método para retornar o nome do MegaBob.
+     * @return O nome do MegaBob.
+     */
     public String getNome() {
         return nome;
     }
 
+    /**
+     * Método para definir o nome do MegaBob.
+     * @param cod O nome do MegaBob.
+     */
     public void setNome(String cod) {
         this.nome = cod;
     }
 
+    /**
+     * Método para retornar o dano que o MegaBob recebeu.
+     * @return O dano recebido pelo MegaBob.
+     */
     public float getDano_recebido() {
         return dano_recebido;
     }
 
+    /**
+     * Método para definir o dano que o MegaBob recebeu.
+     * @param dano_recebido O dano recebido pelo MegaBob.
+     */
     public void setDano_recebido(float dano_recebido) {
         this.dano_recebido = dano_recebido;
     }
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java"
index 82e8c55..7a4625e 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java"
@@ -1,28 +1,57 @@
+/**
+ * Classe Obstáculos que herda da classe Personagens.
+ */
 public class Obstáculos extends Personagens{
 
     private String nome;
     private String material;
 
+    /**
+     * Construtor padrão da classe Obstáculos.
+     */
     public Obstáculos() {
     }
 
+    /**
+     * Construtor da classe Obstáculos.
+     * @param nome O nome do obstáculo.
+     * @param energia A energia do obstáculo.
+     * @param material O material do obstáculo.
+     */
     public Obstáculos(String nome, float energia, String material) {
         super(energia);
         this.nome = nome;
         this.material = material;
     }
     
+    /**
+     * Método para retornar o material do obstáculo.
+     * @return O material do obstáculo.
+     */
     public String getMaterial() {
         return material;
     }
+
+    /**
+     * Método para definir o material do obstáculo.
+     * @param material O material do obstáculo.
+     */
     public void setMaterial(String material) {
         this.material = material;
     }
 
+    /**
+     * Método para retornar o nome do obstáculo.
+     * @return O nome do obstáculo.
+     */
     public String getNome() {
         return nome;
     }
 
+    /**
+     * Método para definir o nome do obstáculo.
+     * @param nome O nome do obstáculo.
+     */
     public void setNome(String nome) {
         this.nome = nome;
     }
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java"
index 296b9e3..bcc67a8 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java"
@@ -1,16 +1,34 @@
 import java.util.ArrayList;
 
+/**
+ * Classe Personagens que serve como base para outros personagens.
+ */
 public class Personagens {
 
     private float energia;
 
+    /**
+     * Construtor padrão da classe Personagens.
+     */
     public Personagens() {
     }
 
+    /**
+     * Construtor da classe Personagens.
+     * @param energia A energia do personagem.
+     */
     public Personagens(float energia) {
         this.energia = energia;
     }
 
+    /**
+     * Método para verificar o status do personagem.
+     * @param poder Lista de poderes disponíveis.
+     * @param nome Nome do personagem.
+     * @param dano_recebido Dano recebido pelo personagem.
+     * @param energiainimigo Energia do inimigo.
+     * @return A energia restante do inimigo após o dano recebido.
+     */
     public float status(ArrayList<Poder> poder, String nome, float dano_recebido, float energiainimigo){
 
         if (dano_recebido != 0) {
@@ -45,10 +63,18 @@ else if (dano_recebido == poder.get(1).getDano()){
 
     }
 
+    /**
+     * Método para retornar a energia do personagem.
+     * @return A energia do personagem.
+     */
     public float getEnergia() {
         return energia;
     }
 
+    /**
+     * Método para definir a energia do personagem.
+     * @param energia A energia do personagem.
+     */
     public void setEnergia(float energia) {
         this.energia = energia;
     }
diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java"
index b34a9aa..532625f 100644
--- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java"
+++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java"
@@ -1,13 +1,24 @@
+/**
+ * Classe Poder que representa os poderes de um personagem.
+ */
 public class Poder {
 
     private String poder;
     private float dano;
     public static int qtd_instancia = 0;
 
+    /**
+     * Construtor padrão da classe Poder.
+     */
     public Poder() {
         qtd_instancia++;
     }
 
+    /**
+     * Construtor da classe Poder.
+     * @param poder O nome do poder.
+     * @param dano O dano causado pelo poder.
+     */
     public Poder(String poder, float dano) {
         if (qtd_instancia >= 4) {
             System.out.println("Erro de instância, a Kate só pode ter até 4 poderes! apartir do 4 poder, ele nao será instanciado! por favor remova");
@@ -19,15 +30,34 @@ public Poder(String poder, float dano) {
         }
     }
 
+    /**
+     * Método para retornar o nome do poder.
+     * @return O nome do poder.
+     */
     public String getPoder() {
         return poder;
     }
+
+    /**
+     * Método para definir o nome do poder.
+     * @param poder O nome do poder.
+     */
     public void setPoder(String poder) {
         this.poder = poder;
     }
+
+    /**
+     * Método para retornar o dano causado pelo poder.
+     * @return O dano causado pelo poder.
+     */
     public float getDano() {
         return dano;
     }
+
+    /**
+     * Método para definir o dano causado pelo poder.
+     * @param dano O dano causado pelo poder.
+     */
     public void setDano(float dano) {
         this.dano = dano;
     }

From bedd839de7040f863b01f3fc072527aee606ae61 Mon Sep 17 00:00:00 2001
From: dududs8 <martins.silvadudu@gmail.com>
Date: Tue, 15 Jul 2025 15:00:10 -0300
Subject: [PATCH 2/2] =?UTF-8?q?JavaDoc=20da=20lista=20de=20exerc=C3=ADcios?=
 =?UTF-8?q?=20de=20Classe=20Abstrata?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../exercicio-01/src/main/java/Animal.java    | 15 +++
 .../exercicio-01/src/main/java/Dog.java       | 18 ++++
 .../exercicio-01/src/main/java/Eagle.java     | 18 ++++
 .../exercicio-01/src/main/java/Lion.java      | 15 +++
 .../src/main/java/Ornitorrinco.java           | 15 +++
 .../exercicio-02/Automovel.java               | 42 +++++++++
 .../classes-abstratas/exercicio-02/Aviao.java | 30 ++++++
 .../classes-abstratas/exercicio-02/Barco.java | 30 ++++++
 .../exercicio-02/Veiculo.java                 | 22 +++++
 .../ArtigosRevista_Conferencias.java          | 64 +++++++++++++
 .../exercicio-03/Coordenador.java             | 61 ++++++++++++
 .../exercicio-03/Livros.java                  | 40 ++++++++
 .../Pesquisa_Publica\303\247\303\265es.java"  | 11 +++
 .../Publica\303\247\303\265es.java"           | 93 +++++++++++++++++++
 .../classes-abstratas/exercicio-03/Teses.java | 51 ++++++++++
 15 files changed, 525 insertions(+)

diff --git a/exercises/classes-abstratas/exercicio-01/src/main/java/Animal.java b/exercises/classes-abstratas/exercicio-01/src/main/java/Animal.java
index ba2f36f..7cfea6b 100644
--- a/exercises/classes-abstratas/exercicio-01/src/main/java/Animal.java
+++ b/exercises/classes-abstratas/exercicio-01/src/main/java/Animal.java
@@ -1,11 +1,26 @@
+/**
+ * Classe abstrata Animal que define os métodos que todos os animais devem implementar.
+ */
 public abstract class Animal {
 
+    /**
+     * Método abstrato para o animal respirar.
+     */
     public abstract void respirar(); 
 
+    /**
+     * Método abstrato para o animal dormir.
+     */
     public abstract void dormir();
 
+    /**
+     * Método abstrato para o animal comer.
+     */
     public abstract void comer();
 
+    /**
+     * Método abstrato para o animal andar.
+     */
     public abstract void andar();
     
 }
diff --git a/exercises/classes-abstratas/exercicio-01/src/main/java/Dog.java b/exercises/classes-abstratas/exercicio-01/src/main/java/Dog.java
index 5755882..994f106 100644
--- a/exercises/classes-abstratas/exercicio-01/src/main/java/Dog.java
+++ b/exercises/classes-abstratas/exercicio-01/src/main/java/Dog.java
@@ -1,21 +1,39 @@
+/**
+ * Classe Dog que estende a classe Animal e implementa os métodos abstratos.
+ */
 public class Dog extends Animal{
 
+    /**
+     * Método que implementa a respiração do cachorro.
+     */
     public void respirar(){
         System.out.println("O cachorro respirou!");
     }
 
+    /**
+     * Método que implementa a função de dormir do cachorro.
+     */
     public void dormir(){
         System.out.println("O cachorro dormiu!");
     }
 
+    /**
+     * Método que implementa a função de comer do cachorro.
+     */
     public void comer(){
         System.out.println("O cachorro comeu!");
     }
 
+    /**
+     * Método que implementa a função de andar do cachorro.
+     */
     public void andar(){
         System.out.println("O cachorro andou!");
     }
 
+    /**
+     * Método específico do cachorro para latir.
+     */
     public void latir(){
         System.out.println("O cachorro latiu!");
     }
diff --git a/exercises/classes-abstratas/exercicio-01/src/main/java/Eagle.java b/exercises/classes-abstratas/exercicio-01/src/main/java/Eagle.java
index 32bb96f..dbf5886 100644
--- a/exercises/classes-abstratas/exercicio-01/src/main/java/Eagle.java
+++ b/exercises/classes-abstratas/exercicio-01/src/main/java/Eagle.java
@@ -1,21 +1,39 @@
+/**
+ * Classe Eagle que estende a classe Animal e implementa os métodos abstratos.
+ */
 public class Eagle extends Animal{
 
+    /**
+     * Método que implementa a respiração da águia.
+     */
     public void respirar(){
         System.out.println("O eagle respirou!");
     }
 
+    /**
+     * Método que implementa a função de dormir da águia.
+     */
     public void dormir(){
         System.out.println("O eagle dormiu!");
     }
 
+    /**
+     * Método que implementa a função de comer da águia.
+     */
     public void comer(){
         System.out.println("O eagle comeu!");
     }
 
+    /**
+     * Método que implementa a função de andar da águia.
+     */
     public void andar(){
         System.out.println("O eagle andou!");
     }
 
+    /**
+     * Método específico da águia para voar.
+     */
     public void voar(){
         System.out.println("O eagle vuou!");
     }
diff --git a/exercises/classes-abstratas/exercicio-01/src/main/java/Lion.java b/exercises/classes-abstratas/exercicio-01/src/main/java/Lion.java
index f7e6528..126c44c 100644
--- a/exercises/classes-abstratas/exercicio-01/src/main/java/Lion.java
+++ b/exercises/classes-abstratas/exercicio-01/src/main/java/Lion.java
@@ -1,17 +1,32 @@
+/**
+ * Classe Lion que estende a classe Animal e implementa os métodos abstratos.
+ */
 public class Lion extends Animal{
 
+    /**
+     * Método que implementa a respiração do leão.
+     */
     public void respirar(){
         System.out.println("O Lion respirou!");
     }
 
+    /**
+     * Método que implementa a função de dormir do leão.
+     */
     public void dormir(){
         System.out.println("O Lion dormiu!");
     }
 
+    /**
+     * Método que implementa a função de comer do leão.
+     */
     public void comer(){
         System.out.println("O Lion comeu!");
     }
 
+    /**
+     * Método que implementa a função de andar do leão.
+     */
     public void andar(){
         System.out.println("O Lion andou!");
     }
diff --git a/exercises/classes-abstratas/exercicio-01/src/main/java/Ornitorrinco.java b/exercises/classes-abstratas/exercicio-01/src/main/java/Ornitorrinco.java
index 83574b5..31f8c9f 100644
--- a/exercises/classes-abstratas/exercicio-01/src/main/java/Ornitorrinco.java
+++ b/exercises/classes-abstratas/exercicio-01/src/main/java/Ornitorrinco.java
@@ -1,17 +1,32 @@
+/**
+ * Classe Ornitorrinco que estende a classe Animal e implementa os métodos abstratos.
+ */
 public class Ornitorrinco extends Animal{
 
+    /**
+     * Método que implementa a respiração do ornitorrinco.
+     */
     public void respirar(){
         System.out.println("O Ornitorrinco respirou!");
     }
 
+    /**
+     * Método que implementa a função de dormir do ornitorrinco.
+     */
     public void dormir(){
         System.out.println("O Ornitorrinco dormiu!");
     }
 
+    /**
+     * Método que implementa a função de comer do ornitorrinco.
+     */
     public void comer(){
         System.out.println("O Ornitorrinco comeu!");
     }
 
+    /**
+     * Método que implementa a função de andar do ornitorrinco.
+     */
     public void andar(){
         System.out.println("O Ornitorrinco andou!");
     }
diff --git a/exercises/classes-abstratas/exercicio-02/Automovel.java b/exercises/classes-abstratas/exercicio-02/Automovel.java
index 049326f..f8318f8 100644
--- a/exercises/classes-abstratas/exercicio-02/Automovel.java
+++ b/exercises/classes-abstratas/exercicio-02/Automovel.java
@@ -1,45 +1,87 @@
+/**
+ * Classe Automovel que estende a classe Veiculo e implementa os métodos abstratos.
+ */
 public class Automovel extends Veiculo{
 
     private String renavam;
     private String placa;
     
 
+    /**
+     * Construtor da classe Automovel.
+     * @param renavam Número de identificação do veículo.
+     * @param placa Placa do veículo.
+     */
     public Automovel(String renavam, String placa) {
         this.renavam = renavam;
         this.placa = placa;
     }
 
 
+    /**
+     * Método que implementa a função de ligar o carro.
+     */
     public void ligar(){
         System.out.println("O carro ligou!");
     }
 
+    /**
+     * Método que implementa a função de desligar o carro.
+     */
     public void desligar(){
         System.out.println("O carro desligou!");
     }
 
+    /**
+     * Método que implementa a função de acelerar o carro.
+     */
     public void frente(){
         System.out.println("O carro se moveu para frente!");
     }
 
+    /**
+     * Método que implementa a função de dar ré no carro.
+     */
     public void re(){
         System.out.println("O carro deu ré!");
     }
 
+    /**
+     * Método que implementa a função de parar o carro.
+     */
     public void parar(){
         System.out.println("O carro parou!");
     }
 
 
+    /**
+     * Método para obter o renavam do automóvel.
+     * @return Número do renavam do veículo.
+     */
     public String getRenavam() {
         return renavam;
     }
+
+    /**
+     * Método para definir o renavam do automóvel.
+     * @param renavam Número do renavam do veículo.
+     */
     public void setRenavam(String renavam) {
         this.renavam = renavam;
     }
+
+    /**
+     * Método para obter a placa do automóvel.
+     * @return Placa do veículo.
+     */
     public String getPlaca() {
         return placa;
     }
+
+    /**
+     * Método para definir a placa do automóvel.
+     * @param placa Placa do veículo.
+     */
     public void setPlaca(String placa) {
         this.placa = placa;
     }
diff --git a/exercises/classes-abstratas/exercicio-02/Aviao.java b/exercises/classes-abstratas/exercicio-02/Aviao.java
index deb0355..dc6fa90 100644
--- a/exercises/classes-abstratas/exercicio-02/Aviao.java
+++ b/exercises/classes-abstratas/exercicio-02/Aviao.java
@@ -1,38 +1,68 @@
+/**
+ * Classe Aviao que estende a classe Veiculo e implementa os métodos abstratos.
+ */
 public class Aviao extends Veiculo{
 
     private String reg_aeronautico;
     
 
+    /**
+     * Construtor da classe Aviao.
+     * @param reg_aeronautico Registro aeronautico do avião.
+     */
     public Aviao(String reg_aeronautico) {
         this.reg_aeronautico = reg_aeronautico;
     }
 
 
+    /**
+     * Método que implementa a função de ligar o avião.
+     */
     public void ligar(){
         System.out.println("O aviao ligou!");
     }
 
+    /**
+     * Método que implementa a função de desligar o avião.
+     */
     public void desligar(){
         System.out.println("O aviao desligou!");
     }
 
+    /**
+     * Método que implementa a função de acelerar o avião.
+     */
     public void frente(){
         System.out.println("O aviao se moveu para frente!");
     }
 
+    /**
+     * Método que implementa a função de dar ré no avião.
+     */
     public void re(){
         System.out.println("O aviao deu ré!");
     }
 
+    /**
+     * Método que implementa a função de parar o avião.
+     */
     public void parar(){
         System.out.println("O aviao parou!");
     }
 
 
+    /**
+     * Método para obter o registro aeronautico do avião.
+     * @return Registro aeronautico do avião.
+     */
     public String getReg_aeronautico() {
         return reg_aeronautico;
     }
 
+    /**
+     * Método para definir o registro aeronautico do avião.
+     * @param reg_aeronautico Registro aeronautico do avião.
+     */
     public void setReg_aeronautico(String reg_aeronautico) {
         this.reg_aeronautico = reg_aeronautico;
     }
diff --git a/exercises/classes-abstratas/exercicio-02/Barco.java b/exercises/classes-abstratas/exercicio-02/Barco.java
index a28c74d..475bfa9 100644
--- a/exercises/classes-abstratas/exercicio-02/Barco.java
+++ b/exercises/classes-abstratas/exercicio-02/Barco.java
@@ -1,38 +1,68 @@
+/**
+ * Classe Barco que estende a classe Veiculo.
+ */
 public class Barco extends Veiculo{
 
     private String reg_embarcação;
 
 
+    /**
+     * Construtor da classe Barco.
+     * @param reg_embarcação Registro da embarcação.
+     */
     public Barco(String reg_embarcação) {
         this.reg_embarcação = reg_embarcação;
     }
 
 
+    /**
+     * Método que implementa a função de ligar o barco.
+     */
     public void ligar(){
         System.out.println("O barco ligou!");
     }
 
+    /**
+     * Método que implementa a função de desligar o barco.
+     */
     public void desligar(){
         System.out.println("O barco desligou!");
     }
 
+    /**
+     * Método que implementa a função de acelerar o barco.
+     */
     public void frente(){
         System.out.println("O barco se moveu para frente!");
     }
 
+    /**
+     * Método que implementa a função de dar ré no barco.
+     */
     public void re(){
         System.out.println("O barco deu ré!");
     }
 
+    /**
+     * Método que implementa a função de parar o barco.
+     */
     public void parar(){
         System.out.println("O barco parou!");
     }
 
 
+    /**
+     * Método para obter o registro da embarcação.
+     * @return Registro da embarcação.
+     */
     public String getReg_embarcação() {
         return reg_embarcação;
     }
 
+    /**
+     * Método para definir o registro da embarcação.
+     * @param reg_embarcação Registro da embarcação.
+     */
     public void setReg_embarcação(String reg_embarcação) {
         this.reg_embarcação = reg_embarcação;
     }
diff --git a/exercises/classes-abstratas/exercicio-02/Veiculo.java b/exercises/classes-abstratas/exercicio-02/Veiculo.java
index f0e67f9..7a2c9ba 100644
--- a/exercises/classes-abstratas/exercicio-02/Veiculo.java
+++ b/exercises/classes-abstratas/exercicio-02/Veiculo.java
@@ -1,9 +1,31 @@
+/**
+ * Classe Veículo que define os métodos que todos os veículos devem implementar.
+ */
 public abstract class Veiculo {
 
+    /**
+     * Método abstrato para ligar o veículo.
+     */
     public abstract void ligar();
+
+    /**
+     * Método abstrato para desligar o veículo.
+     */
     public abstract void desligar();
+
+    /**
+     * Método abstrato para acelerar o veículo.
+     */
     public abstract void frente();
+
+    /**
+     * Método abstrato para dar ré no veículo.
+     */
     public abstract void re();
+
+    /**
+     * Método abstrato para parar o veículo.
+     */
     public abstract void parar();
     
 }
diff --git a/exercises/classes-abstratas/exercicio-03/ArtigosRevista_Conferencias.java b/exercises/classes-abstratas/exercicio-03/ArtigosRevista_Conferencias.java
index 725d9f5..f5d0362 100644
--- a/exercises/classes-abstratas/exercicio-03/ArtigosRevista_Conferencias.java
+++ b/exercises/classes-abstratas/exercicio-03/ArtigosRevista_Conferencias.java
@@ -1,5 +1,8 @@
 import java.time.LocalDate;
 
+/**
+ * Classe ArtigosRevista_Conferencias que estende a classe Publicações e implementa os métodos abstratos.
+ */
 public class ArtigosRevista_Conferencias extends Publicações{
 
     private String periódico;
@@ -8,10 +11,29 @@ public class ArtigosRevista_Conferencias extends Publicações{
     private Coordenador coordenador;
 
 
+    /**
+     * Construtor padrão da classe ArtigosRevista_Conferencias.
+     */
     public ArtigosRevista_Conferencias(){
     }
 
 
+    /**
+     * Construtor da classe ArtigosRevista_Conferencias.
+     * @param nome Nome do artigo.
+     * @param descrição Descrição do artigo.
+     * @param data_inicio Data de início do artigo.
+     * @param tipo_data_termino Tipo de data de término do artigo.
+     * @param data_termino Data de término do artigo.
+     * @param area_pesquisa Área de pesquisa do artigo.
+     * @param titulo Título do artigo.
+     * @param ano Ano de publicação do artigo.
+     * @param autores Autores do artigo.
+     * @param coordenador Coordenador responsável pelo artigo.
+     * @param periódico Periódico onde o artigo foi publicado.
+     * @param volume Volume do artigo.
+     * @param numero Número do artigo.
+     */
     public ArtigosRevista_Conferencias(String nome, String descrição, LocalDate data_inicio, Data_termino tipo_data_termino, LocalDate data_termino, Areas_pesquisas area_pesquisa, 
         String titulo, String ano, String autores, Coordenador coordenador, String periódico, String volume, String numero) {
         
@@ -23,6 +45,9 @@ public ArtigosRevista_Conferencias(String nome, String descrição, LocalDate da
     }
 
 
+    /**
+     * Método que implementa a função de imprimir as informações do artigo.
+     */
     public void imprimir_informações(){
         System.out.println("\n\n+------------------------------------------------------+");
         System.out.println("Nome da publicaçao: " + getNome() + "\nDescriçao: " + getDescrição() + "\n\nData início: " + getData_inicio()
@@ -33,27 +58,66 @@ public ArtigosRevista_Conferencias(String nome, String descrição, LocalDate da
         System.out.println("+------------------------------------------------------+\n\n");
     }
 
+    /**
+     * Método para obter o periódico do artigo.
+     * @return Periódico do artigo.
+     */
     public String getPeriódico() {
         return periódico;
     }
+
+    /**
+     * Método para definir o periódico do artigo.
+     * @param periódico Periódico do artigo.
+     */
     public void setPeriódico(String periódico) {
         this.periódico = periódico;
     }
+
+    /**
+     * Método para obter o volume do artigo.
+     * @return Volume do artigo.
+     */
     public String getVolume() {
         return volume;
     }
+
+    /**
+     * Método para definir o volume do artigo.
+     * @param volume Volume do artigo.
+     */
     public void setVolume(String volume) {
         this.volume = volume;
     }
+
+    /**
+     * Método para obter o número do artigo.
+     * @return Número do artigo.
+     */
     public String getNumero() {
         return numero;
     }
+
+    /**
+     * Método para definir o número do artigo.
+     * @param numero Número do artigo.
+     */
     public void setNumero(String numero) {
         this.numero = numero;
     }
+
+    /**
+     * Método para obter o coordenador responsável pela publicação.
+     * @return Coordenador responsável pela publicação.
+     */
     public Coordenador getCoordenador() {
         return coordenador;
     }
+
+    /**
+     * Método para definir o coordenador responsável pela publicação.
+     * @param coordenador Coordenador responsável pela publicação.
+     */
     public void setCoordenador(Coordenador coordenador) {
         this.coordenador = coordenador;
     }
diff --git a/exercises/classes-abstratas/exercicio-03/Coordenador.java b/exercises/classes-abstratas/exercicio-03/Coordenador.java
index e230802..b8117b7 100644
--- a/exercises/classes-abstratas/exercicio-03/Coordenador.java
+++ b/exercises/classes-abstratas/exercicio-03/Coordenador.java
@@ -1,3 +1,6 @@
+/**
+ * Classe Coordenador
+ */
 public class Coordenador {
 
     private String nome_cordenador;
@@ -6,6 +9,15 @@ public class Coordenador {
     private String endereço;
     private String função;
 
+
+    /**
+     * Construtor da classe Coordenador.
+     * @param nome_cordenador Nome do coordenador.
+     * @param email E-mail do coordenador.
+     * @param instituição_origem Instituição de origem do coordenador.
+     * @param endereço Endereço do coordenador.
+     * @param função Função do coordenador.
+     */
     public Coordenador(String nome_cordenador, String email, String instituição_origem, String endereço,
             String função) {
         this.nome_cordenador = nome_cordenador;
@@ -15,33 +27,82 @@ public Coordenador(String nome_cordenador, String email, String instituição_or
         this.função = função;
     }
 
+    /**
+     * Método para obter o nome do coordenador.
+     * @return Nome do coordenador.
+     */
     public String getNome_cordenador() {
         return nome_cordenador;
     }
+
+    /**
+     * Método para definir o nome do coordenador.
+     * @param nome_cordenador Nome do coordenador.
+     */
     public void setNome_cordenador(String nome_cordenador) {
         this.nome_cordenador = nome_cordenador;
     }
+
+    /**
+     * Método para exibir o Email do coordenador.
+     * @return Email do coordenador.
+     */
     public String getEmail() {
         return email;
     }
+
+    /**
+     * Método para definir o Email do coordenador.
+     * @param email Email do coordenador.
+     */
     public void setEmail(String email) {
         this.email = email;
     }
+
+    /**
+     * Método para obter a instituição de origem do coordenador.
+     * @return Instituição de origem do coordenador.
+     */
     public String getInstituição_origem() {
         return instituição_origem;
     }
+
+    /**
+     * Método para definir a instituição de origem do coordenador.
+     * @param instituição_origem Instituição de origem do coordenador.
+     */
     public void setInstituição_origem(String instituição_origem) {
         this.instituição_origem = instituição_origem;
     }
+
+    /**
+     * Método para obter o endereço do coordenador.
+     * @return Endereço do coordenador.
+     */
     public String getEndereço() {
         return endereço;
     }
+
+    /**
+     * Método para definir o endereço do coordenador.
+     * @param endereço Endereço do coordenador.
+     */
     public void setEndereço(String endereço) {
         this.endereço = endereço;
     }
+
+    /**
+     * Método para exibir a função do coordenador.
+     * @return Função do coordenador.
+     */
     public String getFunção() {
         return função;
     }
+
+    /**
+     * Método para definir a função do coordenador.
+     * @param função Função do coordenador.
+     */
     public void setFunção(String função) {
         this.função = função;
     }
diff --git a/exercises/classes-abstratas/exercicio-03/Livros.java b/exercises/classes-abstratas/exercicio-03/Livros.java
index dbc357a..87c8d1f 100644
--- a/exercises/classes-abstratas/exercicio-03/Livros.java
+++ b/exercises/classes-abstratas/exercicio-03/Livros.java
@@ -1,5 +1,8 @@
 import java.time.LocalDate;
 
+/**
+ * Classe Livros que estende a classe Publicações e implementa os métodos abstratos.
+ */
 public class Livros extends Publicações{
 
     private String editora;
@@ -7,10 +10,28 @@ public class Livros extends Publicações{
     private Coordenador coordenador;
 
 
+    /**
+     * Construtor padrão da classe Livros.
+     */
     public Livros(){
     }
 
 
+    /**
+     * Construtor da classe Livros.
+     * @param nome Nome do livro.
+     * @param descrição Descrição do livro.
+     * @param data_inicio Data de início do livro.
+     * @param tipo_data_termino Tipo de data de término do livro.
+     * @param data_termino Data de término do livro.
+     * @param area_pesquisa Área de pesquisa do livro.
+     * @param titulo Título do livro.
+     * @param ano Ano de publicação do livro.
+     * @param autores Autores do livro.
+     * @param coordenador Coordenador responsável pelo livro.
+     * @param editora Editora do livro.
+     * @param local_publicação Local de publicação do livro.
+     */
     public Livros(String nome, String descrição, LocalDate data_inicio, Data_termino tipo_data_termino, LocalDate data_termino, Areas_pesquisas area_pesquisa, 
         String titulo, String ano, String autores, Coordenador coordenador, String editora, String local_publicação) {
 
@@ -22,6 +43,9 @@ public Livros(String nome, String descrição, LocalDate data_inicio, Data_termi
     }
 
 
+    /**
+     * Método que implementa a função de imprimir as informações do livro.
+     */
     public void imprimir_informações(){
         System.out.println("\n\n+------------------------------------------------------+");
         System.out.println("Nome da publicaçao: " + getNome() + "\nDescriçao: " + getDescrição() + "\n\nData início: " + getData_inicio()
@@ -33,21 +57,37 @@ public Livros(String nome, String descrição, LocalDate data_inicio, Data_termi
     }
 
 
+    /**
+     * Método para obter a editora do livro.
+     * @return Editora do livro.
+     */
     public String getEditora() {
         return editora;
     }
 
 
+    /**
+     * Método para definir a editora do livro.
+     * @param editora Editora do livro.
+     */
     public void setEditora(String editora) {
         this.editora = editora;
     }
 
 
+    /**
+     * Método para obter o local de publicação do livro.
+     * @return Local de publicação do livro.
+     */
     public String getLocal_publicação() {
         return local_publicação;
     }
 
 
+    /**
+     * Método para definir o local de publicação do livro.
+     * @param local_publicação Local de publicação do livro.
+     */
     public void setLocal_publicação(String local_publicação) {
         this.local_publicação = local_publicação;
     }
diff --git "a/exercises/classes-abstratas/exercicio-03/Pesquisa_Publica\303\247\303\265es.java" "b/exercises/classes-abstratas/exercicio-03/Pesquisa_Publica\303\247\303\265es.java"
index 88b931b..97851c1 100644
--- "a/exercises/classes-abstratas/exercicio-03/Pesquisa_Publica\303\247\303\265es.java"
+++ "b/exercises/classes-abstratas/exercicio-03/Pesquisa_Publica\303\247\303\265es.java"
@@ -1,10 +1,21 @@
 import java.util.ArrayList;
 
+/**
+ * Classe Pesquisa_Publicações.
+ */
 public class Pesquisa_Publicações {
 
+    /**
+     * Método construtor padrão da classe Pesquisa_Publicações.
+     */
     public Pesquisa_Publicações() {
     }
     
+    /**
+     * Método que busca publicações por coordenador.
+     * @param publi Lista de publicações.
+     * @param ap Coordenador.
+     */
     public void buscar_publicações_areadepesquisa(ArrayList<Publicações> publi, Areas_pesquisas ap){
 
         int qtd = 0;
diff --git "a/exercises/classes-abstratas/exercicio-03/Publica\303\247\303\265es.java" "b/exercises/classes-abstratas/exercicio-03/Publica\303\247\303\265es.java"
index dd95a2b..05eedb5 100644
--- "a/exercises/classes-abstratas/exercicio-03/Publica\303\247\303\265es.java"
+++ "b/exercises/classes-abstratas/exercicio-03/Publica\303\247\303\265es.java"
@@ -1,5 +1,8 @@
 import java.time.LocalDate;
 
+/**
+ * Classe Publicações que é uma classe abstrata.
+ */
 public abstract class Publicações {
 
 
@@ -16,10 +19,25 @@ public abstract class Publicações {
 
 
 
+    /**
+     * Construtor padrão da classe Publicações.
+     */
     public Publicações() {
     }
 
 
+    /**
+     * Construtor da classe Publicações.
+     * @param nome Nome da publicação.
+     * @param descrição Descrição da publicação.
+     * @param data_inicio Data de início da publicação.
+     * @param tipo_data_termino Tipo de data de término da publicação.
+     * @param data_termino Data de término da publicação.
+     * @param area_pesquisa Área de pesquisa da publicação.
+     * @param titulo Título do artigo ou livro.
+     * @param ano Ano de publicação do artigo ou livro.
+     * @param autores Autores do artigo ou livro.
+     */
     public Publicações(String nome, String descrição, LocalDate data_inicio, Data_termino tipo_data_termino, LocalDate data_termino,
         Areas_pesquisas area_pesquisa, String titulo, String ano, String autores) {
 
@@ -36,78 +54,153 @@ public abstract class Publicações {
     }
 
 
+    /**
+     * Método abstrato para imprimir as informações da publicação.
+     */
     public abstract void imprimir_informações();
 
 
 
+    /**
+     * Método para obter o nome da publicação.
+     * @return Nome da publicação.
+     */
     public String getNome() {
         return nome;
     }
 
+    /**
+     * Método para definir o nome da publicação.
+     * @param nome Nome da publicação.
+     */
     public void setNome(String nome) {
         this.nome = nome;
     }
 
+    /**
+     * Método para obter a descrição da publicação.
+     * @return Descrição da publicação.
+     */
     public String getDescrição() {
         return descrição;
     }
 
+    /**
+     * Método para definir a descrição da publicação.
+     * @param descrição Descrição da publicação.
+     */
     public void setDescrição(String descrição) {
         this.descrição = descrição;
     }
 
+    /**
+     * Método para obter a data de início da publicação.
+     * @return Data de início da publicação.
+     */
     public LocalDate getData_inicio() {
         return data_inicio;
     }
 
+    /**
+     * Método para definir a data de início da publicação.
+     * @param data_inicio Data de início da publicação.
+     */
     public void setData_inicio(LocalDate data_inicio) {
         this.data_inicio = data_inicio;
     }
 
+    /**
+     * Método para obter a data de término da publicação.
+     * @return Data de término da publicação.
+     */
     public LocalDate getData_termino() {
         return data_termino;
     }
 
+    /**
+     * Método para definir a data de término da publicação.
+     * @param data_termino Data de término da publicação.
+     */
     public void setData_termino(LocalDate data_termino) {
         this.data_termino = data_termino;
     }
 
+    /**
+     * Método para obter a área de pesquisa da publicação.
+     * @return Área de pesquisa da publicação.
+     */
     public Areas_pesquisas getArea_pesquisa() {
         return area_pesquisa;
     }
 
+    /**
+     * Método para definir a área de pesquisa da publicação.
+     * @param area_pesquisa Área de pesquisa da publicação.
+     */
     public void setArea_pesquisa(Areas_pesquisas area_pesquisa) {
         this.area_pesquisa = area_pesquisa;
     }
 
+    /**
+     * Método para obter o título da publicação.
+     * @return Título da publicação.
+     */
     public String getTitulo() {
         return titulo;
     }
 
+    /**
+     * Método para definir o título da publicação.
+     * @param titulo Título da publicação.
+     */
     public void setTitulo(String titulo) {
         this.titulo = titulo;
     }
 
+    /**
+     * Método para obter o ano da publicação.
+     * @return Ano da publicação.
+     */
     public String getAno() {
         return ano;
     }
 
+    /**
+     * Método para definir o ano da publicação.
+     * @param ano Ano da publicação.
+     */
     public void setAno(String ano) {
         this.ano = ano;
     }
 
+    /**
+     * Método para obter os autores da publicação.
+     * @return Autores da publicação.
+     */
     public String getAutores() {
         return autores;
     }
 
+    /**
+     * Método para definir os autores da publicação.
+     * @param autores Autores da publicação.
+     */
     public void setAutores(String autores) {
         this.autores = autores;
     }
 
+    /**
+     * Método para obter o tipo de data de término da publicação.
+     * @return Tipo de data de término da publicação.
+     */
     public Data_termino getTipo_data_termino() {
         return tipo_data_termino;
     }
 
+    /**
+     * Método para definir o tipo de data de término da publicação.
+     * @param tipo_data_termino Tipo de data de término da publicação.
+     */
     public void setTipo_data_termino(Data_termino tipo_data_termino) {
         this.tipo_data_termino = tipo_data_termino;
     }
diff --git a/exercises/classes-abstratas/exercicio-03/Teses.java b/exercises/classes-abstratas/exercicio-03/Teses.java
index 2bec8d6..62f929e 100644
--- a/exercises/classes-abstratas/exercicio-03/Teses.java
+++ b/exercises/classes-abstratas/exercicio-03/Teses.java
@@ -1,5 +1,8 @@
 import java.time.LocalDate;
 
+/**
+ * Classe Teses que estende a classe Publicações e implementa os métodos abstratos.
+ */
 public class Teses extends Publicações{
 
     private String grau;
@@ -7,9 +10,27 @@ public class Teses extends Publicações{
     private Coordenador coordenador;
 
 
+    /**
+     * Construtor padrão da classe Teses.
+     */
     public Teses(){
     }
 
+    /**
+     * Construtor da classe Teses.
+     * @param nome Nome da tese.
+     * @param descrição Descrição da tese.
+     * @param data_inicio Data de início da tese.
+     * @param tipo_data_termino Tipo de data de término da tese.
+     * @param data_termino Data de término da tese.
+     * @param area_pesquisa Área de pesquisa da tese.
+     * @param titulo Título da tese.
+     * @param ano Ano da tese.
+     * @param autores Autores da tese.
+     * @param coordenador Coordenador responsável pela tese.
+     * @param grau Grau acadêmico da tese.
+     * @param instituição_defendimento Instituição onde a tese foi defendida.
+     */
     public Teses(String nome, String descrição, LocalDate data_inicio, Data_termino tipo_data_termino, LocalDate data_termino, Areas_pesquisas area_pesquisa, String titulo, String ano, String autores, Coordenador coordenador, String grau, String instituição_defendimento) {
 
         super(nome, descrição, data_inicio, tipo_data_termino, data_termino, area_pesquisa, titulo, ano, autores);
@@ -22,6 +43,9 @@ public Teses(String nome, String descrição, LocalDate data_inicio, Data_termin
     
 
 
+    /**
+     * Método que implementa a função de imprimir as informações da tese.
+     */
     public void imprimir_informações(){
         System.out.println("\n\n+------------------------------------------------------+");
         System.out.println("Nome da publicaçao: " + getNome() + "\nDescriçao: " + getDescrição() + "\n\nData início: " + getData_inicio()
@@ -34,23 +58,50 @@ public Teses(String nome, String descrição, LocalDate data_inicio, Data_termin
 
 
 
+    /**
+     * Método para obter o grau acadêmico da tese.
+     * @return Grau acadêmico da tese.
+     */
     public String getGrau() {
         return grau;
     }
+
+    /**
+     * Método para definir o grau acadêmico da tese.
+     * @param grau Grau acadêmico da tese.
+     */
     public void setGrau(String grau) {
         this.grau = grau;
     }
+
+    /**
+     * Método para obter a instituição onde a tese foi defendida.
+     * @return Instituição onde a tese foi defendida.
+     */
     public String getInstituição_defendimento() {
         return instituição_defendimento;
     }
+
+    /**
+     * Método para definir a instituição onde a tese foi defendida.
+     * @param instituição_defendimento Instituição onde a tese foi defendida.
+     */
     public void setInstituição_defendimento(String instituição_defendimento) {
         this.instituição_defendimento = instituição_defendimento;
     }
 
+    /**
+     * Método para obter o coordenador responsável pela tese.
+     * @return Coordenador responsável pela tese.
+     */
     public Coordenador getCoordenador() {
         return coordenador;
     }
 
+    /**
+     * Método para definir o coordenador responsável pela tese.
+     * @param coordenador Coordenador responsável pela tese.
+     */
     public void setCoordenador(Coordenador coordenador) {
         this.coordenador = coordenador;
     }