final-version

agents/analysis_phase/objectives.py

@@ -2,7 +2,7 @@ from crewai import Agent, Task, Crew, Process, LLM
 import os
 import json
 from modules import bloom_taxonomy_2, objectives_dimensions, llm_g
-from schemas import ObjectivesOutput
+from schemas import LearningObjectivesOutput
 
 
 def get_bloom_verb(level: str) -> str:
@@ -65,86 +65,15 @@ objectives_generator = Agent(
     ),
     llm=llm_g,
     verbose=True,
-    max_iter=100
+    max_iter=100,
 )
 
 
 objectives_task = Task(
     description=(
         "You have a complete and well-structured training curriculum provided in {outlines}. "
-        "### Input Structure Clarification\n"
-        "The input will contain a full structured outline in JSON format, where each **unit** includes several **axes**."
-        "Each `axis` represents one **subtopic**, containing the following keys:"
-        "- `axis_number`"
-        "- `title`"
-        "- `purpose`"
-        ""
-        "You must:"
-        "- Generate **exactly one Arabic learning objective** per `axis`."
-        "- Use only the content provided in `title` and `purpose`."
-        "- Do **not invent**, expand, or infer any additional topics or meanings beyond what exists."
-        "- Keep terminology and concepts consistent with the input text."
-        "- Maintain the relationship between the unit and its axes."
-        ""
-        "---"
-        ""
-        "### Output Format"
-        "The output must include all axes as separate entries, each with:"
-        "- `unit` (unit title)"
-        "- `unit_description` (the “focus” field)"
-        "- `subtopic` (axis title)"
-        "- `module_description` (axis purpose)"
-        "- `level` (Bloom’s level)"
-        "- `verbs` (three suggested verbs)"
-        "- `objective` (one clear Arabic measurable learning objective)"
-        ""
-        "---"
-        ""
-        "### Example (Simplified)"
-        "**Example Input:**"
-        "```json"
-        "{"
-        '  "units": ['
-        "    {"
-        '      "title": "الوحدة الأولى: مقدمة في التفكير التصميمي",'
-        '      "focus": "يتعرف المتعلم على مفهوم التفكير التصميمي وأهميته.",'
-        '      "axes": ['
-        "        {"
-        '          "title": "تعريف التفكير التصميمي",'
-        '          "purpose": "يفهم المتعلم معنى التفكير التصميمي ومكوناته."'
-        "        },"
-        "        {"
-        '          "title": "أهمية التفكير التصميمي",'
-        '          "purpose": "يشرح المتعلم كيف يساهم التفكير التصميمي في حل المشكلات."'
-        "        }"
-        "      ]"
-        "    }"
-        "  ]"
-        "}\n"
-        "**Example Output:**"
-        '  "objectives": [\n'
-        "    {\n"
-        '      "unit": "الوحدة الأولى: مقدمة في التفكير التصميمي",\n'
-        '      "unit_description": "يتعرف المتعلم على مفهوم التفكير التصميمي وأهميته.",\n'
-        '      "subtopic": "تعريف التفكير التصميمي",\n'
-        '      "module_description": "يفهم المتعلم معنى التفكير التصميمي ومكوناته.",\n'
-        '      "level": "Cognitive - Understand",\n'
-        '      "verbs": ["يفهم", "يصف", "يوضح"],\n'
-        '      "objective": "أن يفسّر المتعلم مفهوم التفكير التصميمي ومكوناته بدقة."\n'
-        "    },\n"
-        "    {\n"
-        '      "unit": "الوحدة الأولى: مقدمة في التفكير التصميمي",\n'
-        '      "unit_description": "يتعرف المتعلم على مفهوم التفكير التصميمي وأهميته.",\n'
-        '      "subtopic": "أهمية التفكير التصميمي",\n'
-        '      "module_description": "يشرح المتعلم كيف يساهم التفكير التصميمي في حل المشكلات.",\n'
-        '      "level": "Cognitive - Understand",\n'
-        '      "verbs": ["يشرح", "يستنتج", "يفسر"],\n'
-        '      "objective": "أن يشرح المتعلم دور التفكير التصميمي في حل المشكلات."\n'
-        "    }\n"
-        "  ]\n"
-        "}"
-        "```\n"
-        "The objectives should aligned with Bloom’s Taxonomy and the three learning domains, and consistent with the purpose of each subtopic.\n"
+        "Your task is to create one detailed, measurable learning objective in Arabic for each subtopic, "
+        "aligned with Bloom’s Taxonomy and the three learning domains, and consistent with the purpose of each subtopic.\n\n"
         "### Step-by-Step Process\n"
         "1. Read the curriculum overview to understand the full learning journey.\n"
         "2. **Before you begin, review the complete list of Bloom’s action verbs and the three domains for each level to plan maximum diversity.**\n"
@@ -334,22 +263,24 @@ objectives_task = Task(
         "- **Flexibility with precision:** Be flexible in verb choice but never compromise on accuracy.\n"
         "- **Continuous review:** Revisit objectives regularly for diversity and balance.\n"
         "- **Context matters:** Always choose the verb that best reflects what the learner should achieve in that specific subtopic.\n"
-        "Very Important:"
+        "### OUTPUT\n"
+        "Return the LearningObjectivesOutput structure in valid JSON format.\n\n"
     ),
-    expected_output="""{
-        "objectives": [
-            {
-            "unit": "Unit title",
-            "unit_description": "Brief summary of the unit scope",
-            "subtopic": "subtopic title",
-            "module_description": "Brief summary of what this subtopic covers",
-            "level": "Bloom's level assigned based on subtopic analysis",
-            "verbs": ["verb1", "verb2", "verb3"],
-            "objective": "One measurable Arabic objective derived from the subtopic purpose",
-            }
-        ],
+    expected_output="""JSON object with this structure:
+    {
+      "objectives": [
+        {
+          "unit": "Unit title",
+          "unit_description": "Brief summary of the unit scope",
+          "subtopic": "subtopic title",
+          "module_description": "Brief summary of what this subtopic covers",
+          "level": "Bloom's level assigned based on subtopic analysis",
+          "verbs": ["verb1", "verb2", "verb3"],
+          "objective": "One measurable Arabic objective"
+        }
+      ]
     }""",
-    output_json=ObjectivesOutput,
+    output_json=LearningObjectivesOutput,
     agent=objectives_generator,
     human_input=False,
 )

agents/analysis_phase/outcomes.py

@@ -288,14 +288,15 @@ outcomes_task = Task(
             "ensure the output in form of Json",
         ]
     ),
-    expected_output="""{
-      "outcomes": [
-        {
-          "unit": "Unit title",
-          "unit_description": "Brief summary of the unit scope",
-          "unit_outcome": "One measurable Arabic objective derived from the unit description and its subtopics and their purposes",
-        }
-      ],
+    expected_output="""JSON object with this structure:
+    {
+        "objectives": [
+            {
+            "unit": "Unit title",
+            "unit_description": "Brief summary of the unit scope",
+            "unit_outcome": "One measurable Arabic objective derived from the unit description and its subtopics and their purposes",
+            }
+        ],
     }""",
     agent=outcomes_generator,
     output_json=OutcomesOutput,

agents/final_outliners/validator.py

@@ -2,7 +2,7 @@ from crewai import Agent, Task, Crew, Process, LLM
 import os
 import json
 from modules import llm_5m
-from schemas import FullCurriculumStructure
+from schemas import ValidatedCurriculumOutput
 
 validator_agent = Agent(
     role="Arabic Educational Validator (Curriculum Quality & Integrity Specialist)",
@@ -225,7 +225,7 @@ validation_task = Task(
         "- Ensure titles are concise (4–8 words), contextually clear, and free from unnecessary punctuation.\n"
         "- Do not lose any important concept; prefer rephrasing over deletion.\n"
     ),
-    expected_output="A JSON object showing validated units and axes with detailed statuses and refinements.",
+    expected_output="A JSON object showing validated units and axes.",
     agent=validator_agent,
-    output_json=FullCurriculumStructure
+    output_json=ValidatedCurriculumOutput,
 )

routers/introduction_route.py

@@ -11,7 +11,7 @@ from modules import (
     inputs,
 )
 from schemas import (
-    FullCurriculumStructure,
+    ValidatedCurriculumOutput,
     OutcomesOutput,
     DNAMetadata,
     OutlineInput,
@@ -26,7 +26,9 @@ router = APIRouter(prefix="/analysis", tags=["Introduction"])
 
 
 @router.post("/introduction")
-def run_training(data: OutlineInput, outlines: FullCurriculumStructure, outcomes:OutcomesOutput):
+def run_training(
+    data: OutlineInput, outlines: ValidatedCurriculumOutput, outcomes: OutcomesOutput
+):
     training_crew = Crew(
         agents=[intro_agent],
         tasks=[intro_task],

routers/objective_route.py

@@ -11,13 +11,12 @@ from modules import (
     inputs,
 )
 from schemas import (
-    CurriculumStructure,
+    ValidatedCurriculumOutput,
     DNAMetadata,
     OutlineInput,
 )
 
 
-
 router = APIRouter(prefix="/analysis", tags=["Objectives"])
 
 
@@ -27,7 +26,7 @@ router = APIRouter(prefix="/analysis", tags=["Objectives"])
 
 
 @router.post("/objectives")
-def run_objectives(data: OutlineInput, outlines: CurriculumStructure):
+def run_objectives(data: OutlineInput, outlines: ValidatedCurriculumOutput):
     objectives_crew = Crew(
         agents=[objectives_generator],
         tasks=[objectives_task],

routers/outcome_route.py

@@ -27,7 +27,7 @@ router = APIRouter(prefix="/analysis", tags=["outcomes"])
 
 
 @router.post("/outcomes")
-def run_outcomes(data: OutlineInput, objectives: ObjectivesOutput):
+def run_outcomes(data: OutlineInput, objectives: LearningObjectivesOutput):
     outcomes_crew = Crew(
         agents=[outcomes_generator],
         tasks=[outcomes_task],

schemas/__init__.py

@@ -11,6 +11,7 @@ from .outliner_schema import (
     ExpandedTopicsList,
     CurriculumStructure,
     FullCurriculumStructure,
+    ValidatedCurriculumOutput,
 )
 from .source_schema import AllResults, SingleResult
 from .introduction_schema import IntroductionOutput

schemas/objectives_schema.py

@@ -33,23 +33,33 @@ from pydantic import BaseModel, Field
 from typing import List, Dict, Literal, Optional
 
 
-# نموذج يمثل كل هدف تعلم فردي (Learning Objective)
 class LearningObjective(BaseModel):
-    unit: str = Field(..., description="اسم الوحدة التعليمية (Unit name).")
-    module: str = Field(..., description="اسم الموديول داخل الوحدة.")
+    """Schema for a single learning objective"""
+
+    unit: str = Field(description="The title of the unit this objective belongs to")
+    unit_description: str = Field(
+        description="Brief summary of the unit scope and learning journey"
+    )
+    subtopic: str = Field(description="The title of the specific subtopic")
+    module_description: str = Field(
+        description="Brief summary of what this subtopic covers"
+    )
     level: str = Field(
-        ...,
-        description="مستوى Bloom’s Taxonomy (مثلاً: Remember, Understand, Apply, Analyze, Evaluate, Create).",
+        description="Bloom's Taxonomy level or learning domain level assigned based on subtopic analysis"
+    )
+    verbs: List[str] = Field(
+        description="List of three relevant Bloom's verbs suitable for the audience",
+        min_items=3,
+        max_items=3,
     )
-    verbs: List[str] = Field(..., description="قائمة بالأفعال المستخدمة من تصنيف بلوم.")
     objective: str = Field(
-        ...,
-        description="الناتج التعليمي القابل للقياس، مكتوب بصيغة 'أن + فعل مضارع + الأداء المطلوب'.",
+        description="One measurable learning objective in Arabic derived from the subtopic purpose"
     )
 
 
-# النموذج العام اللي يحتوي على القائمة الكاملة للأهداف
 class LearningObjectivesOutput(BaseModel):
+    """Schema for the complete learning objectives output"""
+
     objectives: List[LearningObjective] = Field(
-        ..., description="قائمة كاملة بالأهداف التعليمية المتولدة من التحليل."
+        description="Complete list of learning objectives for all subtopics in the curriculum"
     )

schemas/outliner_schema.py

@@ -129,6 +129,55 @@ class Axis(BaseModel):
     )
 
 
+######################Validator############################
+class ValidatedAxis(BaseModel):
+    """Schema for a validated subtopic (axis)"""
+
+    axis_number: int = Field(
+        description="Sequential number of the axis within the unit", ge=1
+    )
+
+    validated_title: str = Field(
+        description="The improved/validated axis title in Arabic (4-8 words, clear, focused)"
+    )
+
+    validated_purpose: str = Field(
+        description="The improved/validated axis purpose explaining its educational intent"
+    )
+    status: Literal["kept", "rephrased", "added", "removed"] = Field(
+        description="Validation status: 'kept' (unchanged), 'rephrased' (edited), 'added' (new), 'removed' (deleted/merged)"
+    )
+
+
+class ValidatedUnit(BaseModel):
+    """Schema for a validated educational unit"""
+
+    unit_number: int = Field(
+        description="Sequential number of the unit in the curriculum", ge=1
+    )
+    title: str = Field(description="The title of the unit in Arabic")
+    focus: str = Field(
+        description="Description of the unit's main educational focus and objectives"
+    )
+    validated_axes: List[ValidatedAxis] = Field(
+        description="List of validated subtopics (axes) for this unit", min_items=1
+    )
+
+
+class ValidatedCurriculumOutput(BaseModel):
+    """Schema for the complete validated curriculum output"""
+
+    main_concept: str = Field(
+        description="The main concept or topic of the entire curriculum"
+    )
+    related_concepts: List[str] = Field(
+        description="List of related concepts covered in the curriculum"
+    )
+    validated_units: List[ValidatedUnit] = Field(
+        description="List of all validated educational units with their axes"
+    )
+
+
 ############################################################################################################
 class UnitWithAxes(BaseModel):
     """