Merge branch 'main' into feature/personagens

Author: RodrigoDevBack

.gitignore

@@ -1,6 +1,6 @@
 # ignorar pasta de saves (não deve ir pro GitHub)
 saves/**
-
+logs/**
 # ignorar pycache do Python
 __pycache__/
 /models/__pycache__

docs/checklist.md

@@ -1,20 +1,20 @@
 ## **SEMANA 1 — Fundamentos de POO**
 
-- [x] Classes básicas criadas;
-- [x] Construtores;
-- [x] Menu inicial;
-- [x] Fluxo principal funcionando;
-- [x] Versão jogável simples;
+- [X] Classes básicas criadas;
+- [X] Construtores;
+- [X] Menu inicial;
+- [X] Fluxo principal funcionando;
+- [X] Versão jogável simples;
 
 ## **SEMANA 2 — Regras, Coleções e Funções**
 
-- [x] Uso de listas e dicionários (Invetário ainda não está totalmente integrado)
+- [X] Uso de listas e dicionários (Invetário ainda não está totalmente integrado)
 - [ ] Módulo random (Existe pacialmente nas missões, isso é sorteio de inimigos, itens e missões)
   - [ ] Combate completo com turnos detalhados
-        Está **incompleto / sem detalhamento. Falta: Turnos (Detalha mais quem está recebendo o dando e quem está recebendo), implementa a recompensa, randomizar melhor o combate e itens recebidos.**
-- [ ] Inventário funcional (Escolhe itens do invetário);
-  - [ ] Sistema de cura/mana (através do inventário com itens de cura);
-- [x] Validações no menu;
+    Está **incompleto / sem detalhamento. Falta: Turnos (Detalha mais quem está recebendo o dando e quem está recebendo), implementa a recompensa, randomizar melhor o combate e itens recebidos.**
+- [X] Inventário funcional (Escolhe itens do invetário);
+  - [X] Sistema de cura/mana (através do inventário com itens de cura);
+- [X] Validações no menu;
 
 ##### **Entregável:**
 
@@ -23,12 +23,12 @@ logs de turnos de batalha.
 
 ## **SEMANA 3 — Polimorfismo, Herança e Persistência**
 
-- [x] Subclasses (Guerreiro e Mago);
-- [x] Arqueiro / Chefão / Outros (Existe **parcialmente**)
+- [X] Subclasses (Guerreiro e Mago);
+- [X] Arqueiro / Chefão / Outros (Existe **parcialmente**)
 - [ ] Métodos sobrescritos avançados (Guerreiro e Mago possuem habilidades diferentes, mas ainda muito simples) (**Junto do Modulo de Random, vocês diversificam os ataques**).
-- [x] Persistência JSON (100% Funcional, salvar e carregar).
-- [ ] Logger (ainda não existe; ou está funcional).
-- [x] Polimorfismo básico (Parte do Guerreiro e mago, ataque).
+- [X] Persistência JSON (100% Funcional, salvar e carregar).
+- [X] Logger (ainda não existe; ou está funcional).
+- [X] Polimorfismo básico (Parte do Guerreiro e mago, ataque).
 
 ##### **Entregável:**
 
@@ -40,27 +40,27 @@ Versão final do jogo com hierarquia OO, logs e persistência de dados.
 
 **Requisito obrigatório.**
 
-- [x] Existe combate básico.
-- [ ] Exibe turnos.
-- [ ] Exibe HP restante por turno.
-- [ ] Mostra dano aplicado.
-- [ ] Imprime resultado completo.
+- [X] Existe combate básico.
+- [X] Exibe turnos.
+- [X] Exibe HP restante por turno.
+- [X] Mostra dano aplicado.
+- [X] Imprime resultado completo.
 - [ ] Dá loot completo.
 
 ---
 
 ### **O que falta Menu?**
 
-- [ ] Repositorio (**Não estamos usando "Repositorio"** , e sim apenas salvamento.py procedural.)
-- [ ] Logger. (**Não existe ainda.)**
+- [X] Repositorio (**Não estamos usando "Repositorio"** , e sim apenas salvamento.py procedural.)
+- [X] Logger. (**Não existe ainda.)**
 
 ---
 
 ### O que falta Personagem e Missão?
 
-- [x] Criar personagem.
-- [x] Escolher classe (Guerreiro e Mago).
-- [ ] Inventário funcional completo.
-- [x] Missão básica (fluxo existe, mas ainda quebrado).
+- [X] Criar personagem.
+- [X] Escolher classe (Guerreiro e Mago).
+- [X] Inventário funcional completo.
+- [X] Missão básica (fluxo existe, mas ainda quebrado).
 - [ ] XP, nível, evolução.
 - [ ] Recompensas (loot) completas.

main.py

@@ -1,36 +1,42 @@
 from __future__ import annotations
 from models.jogo import Jogo
+from models.controle_logs import menu_logs
 
 
 def menu() -> None:
-    """Exibe o menu principal do jogo e gerencia a navegação entre opções.
+    """Exibe o menu principal do jogo e gerencia a navegação.
 
-    Cria uma instância da classe `Jogo` e permite que o jogador interaja
-    com as principais funcionalidades do sistema, como criação de personagem,
-    seleção de missões e simulação de salvamento/carregamento.
+    Cria uma instância da classe `Jogo` e permite ao jogador acessar:
+    - criação de personagem,
+    - missões,
+    - salvamento,
+    - carregamento.
 
-    Loop contínuo até que o usuário opte por encerrar o programa.
+    Loop contínuo até que o usuário escolha sair.
     """
     jogo = Jogo()
 
     while True:
         print("\n=== RPG OO — Menu Principal ===")
-        print("[1] Menu do personagem")
-        print("[2] Encarar missão")
+        print("[1] Criar personagem")
+        print("[2] Missão")
         print("[3] Salvar")
         print("[4] Carregar")
+        print("[5] Visualizar logs")
         print("[0] Sair")
 
         op = input("> ").strip()
 
         if op == "1":
-            jogo.menu_personagem()
+            jogo.criar_personagem()
         elif op == "2":
             jogo.menu_missao()
         elif op == "3":
             jogo.menu_salvar()
         elif op == "4":
             jogo.menu_carregar()
+        elif op == "5":
+            menu_logs(jogo)
         elif op == "0":
             print("Até logo!")
             break
@@ -41,7 +47,6 @@ def menu() -> None:
 if __name__ == "__main__":
     """Ponto de entrada principal do programa.
 
-    Executa a função `menu()` caso o script seja chamado diretamente,
-    inicializando o fluxo principal do jogo.
+    Executa `menu()` caso o arquivo seja executado diretamente.
     """
-    menu()
+    menu()

models/aventura_classes.py

@@ -0,0 +1,83 @@
+# models/controle_logs.py
+
+
+def menu_logs(jogo):
+    if not hasattr(jogo, "logger") or jogo.logger is None:
+        print("⚠ Logger não inicializado.")
+        return
+
+    while True:
+        print("\n=== LOGS DO JOGO ===")
+        print("[1] Ver todos os logs")
+        print("[5] Limpar logs")
+        print("[0] Voltar")
+
+        op = input("> ").strip()
+
+        if op == "1":
+            exibir_logs(jogo.logger.eventos)
+
+        elif op == "5":
+            confirmar_limpar_logs(jogo)
+
+        elif op == "0":
+            break
+        else:
+            print("Opção inválida.")
+
+
+# -----------------------------------------------------
+#          EXIBIÇÃO E PAGINAÇÃO DE LOGS
+# -----------------------------------------------------
+
+
+def exibir_logs(lista_logs):
+    if not lista_logs:
+        print("\n(sem registros)")
+        return
+
+    tamanho = len(lista_logs)
+    pagina = 0
+    por_pagina = 10
+
+    while True:
+        inicio = pagina * por_pagina
+        fim = inicio + por_pagina
+
+        print("\n=== LOGS ===")
+        for linha in lista_logs[inicio:fim]:
+            print("- " + linha)
+
+        print(f"\nPágina {pagina + 1} / {((tamanho - 1) // por_pagina) + 1}")
+        print("[N] próxima página  |  [P] página anterior  |  [0] voltar")
+
+        op = input("> ").strip().lower()
+
+        if op == "n":
+            if fim < tamanho:
+                pagina += 1
+        elif op == "p":
+            if pagina > 0:
+                pagina -= 1
+        elif op == "0":
+            break
+        else:
+            print("Opção inválida.")
+
+
+# -----------------------------------------------------
+#                LIMPAR LOGS
+# -----------------------------------------------------
+
+
+def confirmar_limpar_logs(jogo):
+    print("\nTem certeza que deseja APAGAR todos os logs?")
+    print("[1] Sim")
+    print("[0] Não")
+    op = input("> ").strip()
+
+    if op == "1":
+        jogo.logger.eventos.clear()
+        print("✔ Todos os logs foram apagados.")
+    else:
+        print("Operação cancelada.")

models/controle_logs.py

@@ -0,0 +1,48 @@
+# =====================================================
+# CLASSE ITEM
+# =====================================================
+class Item:
+    """
+    Representa um item do jogo, por enquanto apenas poções de cura.
+    """
+
+    def __init__(self, nome: str, valor: int):
+        """
+        Args:
+            nome (str): Nome do item.
+            valor (int): Valor do efeito (ex: quantidade de HP que recupera).
+        """
+        self.nome = nome
+        self.valor = valor
+
+    def __repr__(self):
+        return f"<Item: {self.nome}, Valor: {self.valor}>"
+
+
+# =====================================================
+# CLASSE INVENTÁRIO
+# =====================================================
+class Inventario:
+    """
+    Inventário de um personagem. Guarda itens e permite adicionar/remover.
+    """
+
+    def __init__(self):
+        self.itens: list[Item] = []
+
+    def adicionar_item(self, item: Item):
+        """Adiciona um item ao inventário."""
+        self.itens.append(item)
+
+    def remover_item(self, item: Item):
+        """Remove um item do inventário, se existir."""
+        if item in self.itens:
+            self.itens.remove(item)
+
+    def listar_itens(self) -> list[Item]:
+        """Retorna a lista de itens atuais."""
+        return self.itens
+
+    def esta_vazio(self) -> bool:
+        """Retorna True se o inventário estiver vazio."""
+        return len(self.itens) == 0

models/inventario.py

@@ -0,0 +1,7 @@
+# models/itens.py
+
+ITENS = {
+    "pocao_pequena": {"nome": "Poção Pequena", "cura": 20},
+    "pocao_media": {"nome": "Poção Média", "cura": 40},
+    "pocao_grande": {"nome": "Poção Grande", "cura": 80},
+}