feat: valida unicidade das perguntas e aprimora validacoes do quiz

Author: wendellast

backend/app/schemas/quiz_schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 
 class CreateQuizSchema(BaseModel):
@@ -36,4 +36,17 @@ class QuizResponseSchema(BaseModel):
     model_config = ConfigDict(populate_by_name=True)
 
     questions: list[QuestionSchema] = Field(alias="perguntas")
+    
+    @field_validator('questions')
+    @classmethod
+    def validate_unique_questions(cls, v):
+        if not v:
+            raise ValueError("Lista de questões não pode estar vazia")
+        
+        # Verificar se há questões duplicadas
+        questions_text = [q.question.strip().lower() for q in v]
+        if len(questions_text) != len(set(questions_text)):
+            raise ValueError("Questões duplicadas detectadas")
+        
+        return v
 

backend/app/services/llm/agente_quiz.py

@@ -44,6 +44,37 @@ def create_quiz(self, num_questions: int = 5, num_alternatives: int = 4):
             response_text = response_text.split("```")[1].split("```")[0].strip()
 
         try:
-            return json.loads(response_text)
+            parsed_response = json.loads(response_text)
+            
+            # Validar estrutura básica
+            if "perguntas" not in parsed_response:
+                raise ValueError("Resposta não contém campo 'perguntas'")
+            
+            questions = parsed_response["perguntas"]
+            
+            # Validar número de questões
+            if len(questions) != num_questions:
+                raise ValueError(f"Esperado {num_questions} questões, mas recebeu {len(questions)}")
+            
+            # Validar questões únicas
+            questions_text = [q.get("pergunta", "").strip().lower() for q in questions]
+            if len(questions_text) != len(set(questions_text)):
+                raise ValueError("Questões duplicadas detectadas na resposta do LLM")
+            
+            # Validar número de alternativas por questão
+            for i, question in enumerate(questions):
+                if "alternativas" not in question:
+                    raise ValueError(f"Questão {i+1} não contém alternativas")
+                
+                alternatives = question["alternativas"]
+                if len(alternatives) != num_alternatives:
+                    raise ValueError(f"Questão {i+1}: esperado {num_alternatives} alternativas, mas recebeu {len(alternatives)}")
+                
+                # Verificar se há exatamente uma alternativa correta
+                correct_count = sum(1 for alt in alternatives if alt.get("correta", False))
+                if correct_count != 1:
+                    raise ValueError(f"Questão {i+1}: deve ter exatamente 1 alternativa correta, mas tem {correct_count}")
+            
+            return parsed_response
         except json.JSONDecodeError:
             raise ValueError(f"Error parsing response: {response_text}")

backend/app/services/llm/prompts/promtps.py

@@ -3,16 +3,18 @@
     TEXTO:
     {text}
 
-    INSTRUÇÕES:
-    1. Crie {num_questions} perguntas baseadas no texto acima.
-    2. Crie {num_alternatives} alternativas para cada pergunta.
+    INSTRUÇÕES CRÍTICAS:
+    1. Crie EXATAMENTE {num_questions} perguntas ÚNICAS e DIFERENTES baseadas no texto acima.
+    2. Crie EXATAMENTE {num_alternatives} alternativas para cada pergunta.
     3. Cada pergunta deve ter exatamente {num_alternatives} alternativas.
     4. Apenas uma alternativa deve estar correta para cada pergunta.
-    5. Indique qual alternativa é a correta para cada pergunta.
-    6. Para cada alternativa, inclua um campo "explicacao" que explique brevemente:
+    5. NUNCA repita perguntas - cada pergunta deve ser única e abordar aspectos diferentes do texto.
+    6. NUNCA duplique o conteúdo - retorne apenas uma vez cada pergunta.
+    7. Indique qual alternativa é a correta para cada pergunta.
+    8. Para cada alternativa, inclua um campo "explicacao" que explique brevemente:
        - Para a alternativa correta: por que ela está correta
        - Para as alternativas incorretas: por que estão incorretas
-    7. Retorne os dados em formato JSON exatamente como no exemplo a seguir, sem texto adicional:
+    9. Retorne os dados em formato JSON exatamente como no exemplo a seguir, sem texto adicional:
 
     ```json
     {{
@@ -51,6 +53,12 @@
     }}
     ```
 
-    Importante: As explicações devem ser concisas (curta) e baseadas nas informações do texto. Para alternativas corretas, explique por que estão certas; para incorretas, explique por que estão erradas seja curto mas detalhado ter uma boa explicação.
+    IMPORTANTE: 
+    - As explicações devem ser concisas e baseadas nas informações do texto
+    - Para alternativas corretas, explique por que estão certas
+    - Para incorretas, explique por que estão erradas
+    - RETORNE EXATAMENTE {num_questions} perguntas, nem mais nem menos
+    - NUNCA duplique perguntas ou conteúdo
+    - Cada pergunta deve ser única e diferente das outras
 
     """