final-version

agents/analysis_phase/objectives.py

@@ -127,8 +127,6 @@ objectives_task = Task(
         "}\n"
         "The output must be valid JSON, without markdown formatting or code blocks."
     ),
-    output_model=LearningObjectivesOutput,
+    output_json=LearningObjectivesOutput,
     agent=objectives_generator,
-    # context=[outline_task],
-    human_input=False,
 )

agents/final_outliners/__init__.py

@@ -0,0 +1,2 @@
+from .unit_generator import unit_generation_task, unit_generator_agent
+from .axis_generator import axis_generator_agent, axis_generation_task

agents/final_outliners/axis_generator.py

@@ -0,0 +1,198 @@
+from crewai import Agent, Task, Crew, Process, LLM
+import os
+import json
+from modules import output_dir, llm
+from schemas import FullCurriculumStructure
+
+axis_generator_agent = Agent(
+
+    role="Arabic Educational Subtopic Generator (Subtopic Developer)",
+
+    goal=(
+    "Analyze the provided metadata ({topic}, {domain}, {audience}, {content_type}, {material_type}) "
+    "along with the CurriculumStructure (main concept, related concepts, and units). "
+    # "Receive the output of the unit generator (which includes units titles and focuses). "
+    "For each unit — based on its title and focus — generate 5 coherent and progressive Arabic subtopics (axes). "
+    "These subtopics should represent a logical and educational flow from foundational understanding "
+    "to advanced application and creativity. "
+
+    # "Each axis should represent a specific stage of learning progression — starting from basic knowledge acquisition "
+    # "and moving toward critical thinking and creative application. "
+    "Each axis should correspond to a cognitive stage: remembering, understanding, applying, analyzing, evaluating, and creating. "
+
+    "Ensure that the axes are written as Arabic educational subheadings that align with the unit’s focus, "
+    "support conceptual growth, and maintain thematic coherence across the curriculum."
+    "Ensure all axes are contextually relevant to the unit's focus and contribute to the learner's comprehensive understanding."
+
+    "Additionally, before finalizing each axis, verify that it can be supported by available educational content such as articles, research papers, open educational resources, or online books. "
+    "Ensure that each axis represents a concept or topic that has sufficient publicly available Arabic or English educational materials that could be used for further learning content generation."
+
+    ),
+
+    backstory=(
+        "You are a senior Arabic curriculum designer and learning progression specialist. "
+        "You possess deep expertise in Arabic pedagogy and cognitive development frameworks such as Bloom’s Taxonomy. "
+        "You skillfully expand each educational unit into coherent Arabic subtopics (axes) that reflect a logical learning progression — "
+        "starting from basic understanding and moving toward higher-order thinking and creative application. "
+        "Each axis builds upon the previous one to form a cohesive and culturally relevant learning journey. "
+        "Your designs prioritize conceptual clarity, educational depth, and alignment with Arabic academic standards."
+        "You also ensure that each generated subtopic (axis) is research-backed and can be supported by credible educational materials available online, enabling later integration with content retrieval systems."
+
+    ),
+
+    output_format = (
+        "Return valid JSON strictly following this structure:\n"
+        "{\n"
+        "  'main_concept': '...',\n"
+        "  'related_concepts': ['...', '...'],\n"
+        "  'units': [\n"
+        "     {\n"
+        "        'unit_number': 1,\n"
+        "        'title': 'الوحدة الأولى: ...',\n"
+        "        'focus': '...',\n"
+        "        'axes': [\n"
+        "            {'axis_number': 1, 'title': '...', 'purpose': '...'},\n"
+        "            {'axis_number': 2, 'title': '...', 'purpose': '...'},\n"
+        "            {'axis_number': 3, 'title': '...', 'purpose': '...'},\n"
+        "            {'axis_number': 4, 'title': '...', 'purpose': '...'},\n"
+        "            {'axis_number': 5, 'title': '...', 'purpose': '...'}\n"
+        "        ]\n"
+        "     }, ...\n"
+        "  ]\n"
+        "}"
+    ),
+
+    examples = [
+        {
+            "input": {
+                "main_concept": "التفكير التصميمي",
+                "related_concepts": ["حل المشكلات", "اتخاذ القرار", "الإبداع", "تحسين العمليات"],
+                "units": [
+                    {
+                        "unit_number": 1,
+                        "title": "الوحدة الأولى: مدخل إلى التفكير التصميمي",
+                        "focus": "فهم المفهوم الجوهري وأبعاده الفكرية والنظرية"
+                    },
+                    {
+                        "unit_number": 2,
+                        "title": "الوحدة الثانية: الأدوات والمجالات العملية لتطبيق التفكير التصميمي",
+                        "focus": "تطبيق أدوات التفكير التصميمي في بيئات واقعية ومجالات مختلفة"
+                    },
+                    {
+                        "unit_number": 3,
+                        "title": "الوحدة الثالثة: التفكير التصميمي وحل المشكلات",
+                        "focus": "توظيف التفكير التصميمي كمنهج فعال في معالجة التحديات وإيجاد حلول مبت��رة"
+                    },
+                    {
+                        "unit_number": 4,
+                        "title": "الوحدة الرابعة: التفكير التصميمي مدخل لتطوير مهارات اتخاذ القرار",
+                        "focus": "استخدام التفكير التصميمي كأداة لتحسين جودة القرارات وتطوير مهارات المفكر التصميمي"
+                    }
+                ]
+            },
+            "output": {
+                "units": [
+                    {
+                        "unit_number": 1,
+                        "title": "الوحدة الأولى: مدخل إلى التفكير التصميمي",
+                        "focus": "فهم المفهوم الجوهري وأبعاده الفكرية والنظرية",
+                        "axes": [
+                            {"axis_number": 1, "title": "ما هو التفكير التصميمي؟", "purpose": "تعريف المفهوم وشرح جوهره الفلسفي والعملي"},
+                            {"axis_number": 2, "title": "أهمية التفكير التصميمي", "purpose": "إبراز الدور الحيوي للتفكير التصميمي في الإبداع والابتكار"},
+                            {"axis_number": 3, "title": "المبادئ الأساسية للتفكير التصميمي", "purpose": "توضيح الأسس التي يقوم عليها النهج التصميمي"},
+                            {"axis_number": 4, "title": "المراحل الخمس للتفكير التصميمي", "purpose": "شرح خطوات العملية التصميمية من التعاطف إلى الاختبار"},
+                            {"axis_number": 5, "title": "نماذج تطبيقية ناجحة للتفكير التصميمي", "purpose": "عرض أمثلة عملية من مؤسسات استخدمت التفكير التصميمي بفعالية"}
+                        ]
+                    },
+                    {
+                        "unit_number": 2,
+                        "title": "الوحدة الثانية: الأدوات والمجالات العملية لتطبيق التفكير التصميمي",
+                        "focus": "تطبيق أدوات التفكير التصميمي في بيئات واقعية ومجالات مختلفة",
+                        "axes": [
+                            {"axis_number": 1, "title": "استخدامات التفكير التصميمي", "purpose": "توضيح المجالات التي يمكن تطبيق التفكير التصميمي فيها"},
+                            {"axis_number": 2, "title": "ستة مجالات عملية يظهر فيها أثر التفكير التصميمي", "purpose": "عرض تطبيقات التفكير التصميمي في مجالات متنوعة"},
+                            {"axis_number": 3, "title": "أدوات التفكير التصميمي", "purpose": "تعريف المتعلم بأهم الأدوات والوسائل المستخدمة في العملية التصميمية"},
+                            {"axis_number": 4, "title": "عوامل يجب مراعاتها عند تنفيذ عملية التفكير التصميمي", "purpose": "توضيح الاعتبارات التي تضمن نجاح التطبيق"},
+                            {"axis_number": 5, "title": "التحديات الشائعة في التفكير التصميمي", "purpose": "تحليل العقبات التي تواجه الفرق عند تطبيق هذا النهج"}
+                        ]
+                    },
+                    {
+                        "unit_number": 3,
+                        "title": "الوحدة الثالثة: التفكير التصميمي وحل المشكلات",
+                        "focus": "توظيف التفكير التصميمي كمنهج فعال في معالجة التحديات وإيجاد حلول مبتكرة",
+                        "axes": [
+                            {"axis_number": 1, "title": "ماذا يعني حل المشكلة؟", "purpose": "توضيح المفهوم النظري والعملي لحل المشكلات"},
+                            {"axis_number": 2, "title": "أربع خطوات لحل المشكلة", "purpose": "شرح المراحل الأساسية في عملية حل المشكلات"},
+                            {"axis_number": 3, "title": "الفرق بين التفكير التحليلي والتصميمي في حل المشكلات", "purpose": "المقارنة بين نهجين مختلفين في معالجة القضايا"},
+                            {"axis_number": 4, "title": "نهج التفكير التصميمي لحل المشكلات", "purpose": "شرح كيفية استخدام التفكير التصميمي لإيجاد حلول مبتكرة"},
+                            {"axis_number": 5, "title": "نماذج تطبيقية ناجحة في حل المشكلات بالتفك��ر التصميمي", "purpose": "تقديم دراسات حالة توضح نجاح النهج التصميمي في معالجة قضايا واقعية"}
+                        ]
+                    },
+                    {
+                        "unit_number": 4,
+                        "title": "الوحدة الرابعة: التفكير التصميمي مدخل لتطوير مهارات اتخاذ القرار",
+                        "focus": "استخدام التفكير التصميمي كأداة لتحسين جودة القرارات وتطوير مهارات المفكر التصميمي",
+                        "axes": [
+                            {"axis_number": 1, "title": "ما هو اتخاذ القرار؟", "purpose": "تعريف عملية اتخاذ القرار وعناصرها الأساسية"},
+                            {"axis_number": 2, "title": "خصائص المفكر التصميمي ودوره في تحسين القرارات", "purpose": "توضيح السمات الشخصية والعقلية للمفكر التصميمي"},
+                            {"axis_number": 3, "title": "العلاقة بين التفكير التصميمي واتخاذ القرار", "purpose": "شرح كيفية مساهمة النهج التصميمي في اتخاذ قرارات فعالة"},
+                            {"axis_number": 4, "title": "سبع خطوات لعملية اتخاذ القرار باستخدام التفكير التصميمي", "purpose": "عرض مراحل متكاملة لاتخاذ القرار بأسلوب تصميمي"},
+                            {"axis_number": 5, "title": "كيف انعكس التفكير التصميمي في قرارات ناجحة؟", "purpose": "عرض أمثلة واقعية لنجاحات عملية في قرارات اتخذت عبر التفكير التصميمي"}
+                        ]
+                    }
+                ]
+            }
+        }
+    ],
+
+    llm=llm,
+    # llm=llm_5m,
+    allow_delegation=False,
+    verbose=True,
+    reasoning=True,
+    max_iter=100
+)
+
+# ============================================================
+# 🧩 3. Axis Generation Task
+# ============================================================
+
+axis_generation_task = Task(
+
+    description=(
+        "## GOAL\n"
+        "Expand each educational unit from the Unit Generator output into 5 structured Arabic subtopics (axes). "
+
+        # "Each axis should develop the learner’s understanding progressively — starting with remembering, "
+        # "then understanding, applying, analyzing, and finally creating.\n"
+        "Each axis should represent a cognitive development stage — moving from foundational understanding to applied mastery.\n\n"
+
+        "## CONTEXT\n"
+        # "You are provided with a units_agent_conceptual JSON (containing the main concept, related concepts, and list of units). "
+        "You are provided with a CurriculumStructure JSON (containing the main concept, related concepts, and list of units). "
+        "Each unit includes a title and conceptual focus.\n\n"
+        "## STEPS\n"
+        "1. Read the CurriculumStructure carefully to understand the hierarchy and conceptual logic.\n"
+        "2. For each unit:\n"
+        "   - Identify its conceptual focus.\n"
+        "   - Generate 5 progressive subtopics (axes) that unfold logically.\n"
+        "   - Each axis must include:\n"
+        "     • 'axis_number': numerical order from 1 to 5.\n"
+        "     • 'title': Arabic title that feels like a subheading in a textbook.\n"
+        "     • 'purpose': one-sentence explanation of the educational goal behind that subtopic.\n\n"
+
+        "3. For each generated axis, verify conceptually that it can be expanded using available online educational content (articles, academic papers, or open textbooks).\n"
+        "   - Prefer subtopics that are well-established in educational or academic literature.\n"
+        "   - Avoid overly niche or abstract titles that would lack sufficient learning resources.\n\n"
+
+        "## NOTES\n"
+        # "- Make sure the subtopics flow naturally, covering introduction, comprehension, practice, and innovation.\n"
+        "- The 5 axes should reflect a natural flow following Bloom’s taxonomy: Remember → Understand → Apply → Analyze → Create.\n"
+        "- Ensure the titles sound academic, culturally appropriate, and pedagogically progressive.\n"
+        "- Return the result as a valid FullCurriculumStructure JSON containing all units with their axes."
+    ),
+
+    expected_output="A FullCurriculumStructure JSON object containing all units and their respective 5 axes each.",
+    agent=axis_generator_agent,
+    output_json=FullCurriculumStructure,
+)

agents/final_outliners/unit_generator.py

@@ -0,0 +1,127 @@
+from crewai import Agent, Task, Crew, Process, LLM
+import os
+import json
+from modules import llm
+from schemas import CurriculumStructure
+
+
+unit_generator_agent = Agent(
+    role="Arabic Educational Unit Generator (Conceptual Curriculum Designer)",
+    goal=(
+        "Analyze the provided metadata ({topic}, {domain}, {audience}, {content_type}, {material_type}). "
+        "Understand the main concept and its related sub-concepts within the topic title. "
+        # "Generate 4 educational units that fully cover all the key aspects of the topic, "
+        "Design 4 coherent Arabic educational units that collectively cover the full conceptual scope of the topic. "
+        # "differentiate between the main and related concepts, and build meaningful learning flow. "
+        "Ensure that each unit builds upon the previous one — moving from conceptual understanding "
+        "to deeper analysis, differentiation, and application."
+        "Additionally, verify that each generated unit represents a concept or learning area that can be supported "
+        "by available educational materials such as online articles, academic papers, open courses, or textbooks. "
+        "Each unit should correspond to a topic that has sufficient real-world educational content, "
+        "so it can later be expanded into detailed axes and linked with web-based learning resources."
+    ),
+    backstory=(
+        # "You are an expert Arabic curriculum designer who understands how to transform conceptual topics "
+        # "into coherent learning structures. You design units that reflect deep comprehension of the main topic "
+        # "and its related ideas, ensuring logical flow from foundational understanding to practical application. "
+        # "You write unit titles in Arabic that sound like chapters of a book, ready to be expanded later into subtopics."
+        "You are an expert Arabic curriculum designer specializing in conceptual and competency-based education. "
+        "You transform topics into structured learning journeys that reflect progressive understanding — "
+        "starting from foundational ideas and moving toward advanced, practical, or reflective application. "
+        "Your writing style for unit titles follows the elegance of Arabic academic chapters, "
+        "while maintaining clarity and purpose. Each unit’s focus must capture the essential learning outcomes "
+        "and intellectual goals of that section."
+        "You also ensure that each generated unit can be reinforced by real and accessible educational materials — "
+        "such as books, articles, or open educational resources — enabling future integration with automated content retrieval and enrichment systems."
+    ),
+    output_format=(
+        "Return **valid JSON** matching the following structure:\n"
+        "{\n"
+        "  'main_concept': '...',\n"
+        "  'related_concepts': ['...', '...'],\n"
+        "  'units': [\n"
+        "    {'unit_number': 1, 'title': 'الوحدة الأولى: ...', 'focus': '...'},\n"
+        "    {'unit_number': 2, 'title': 'الوحدة الثانية: ...', 'focus': '...'},\n"
+        "    {'unit_number': 3, 'title': 'الوحدة الثالثة: ...', 'focus': '...'},\n"
+        "    {'unit_number': 4, 'title': 'الوحدة الرابعة: ...', 'focus': '...'}\n"
+        "  ]\n"
+        "}"
+    ),
+    examples=[
+        {
+            "input": {
+                "topic": "تقنيات التفكير التصميمي (Design Thinking) لحل المشكلات واتخاذ القرارات",
+                "domain": "الإدارة والتفكير الإبداعي",
+                "content_type": "تدريبي",
+                "audience": "القادة والمدربون والموظفون الإداريون",
+                "material_type": ["مفاهمية", "هيكلية", "إجرائية", "واقعية", "إبداعية"],
+            },
+            "output": {
+                "main_concept": "التفكير التصميمي",
+                "related_concepts": [
+                    "حل المشكلات",
+                    "اتخاذ القرار",
+                    "الإبداع",
+                    "تحسين العمليات",
+                ],
+                "units": [
+                    {
+                        "unit_number": 1,
+                        "title": "الوحدة الأولى: مدخل إلى التفكير التصميمي وفلسفته",
+                        "focus": "فهم الأسس الفكرية والنظرية للتفكير التصميمي وموقعه ضمن أنماط التفكير الإبداعي.",
+                    },
+                    {
+                        "unit_number": 2,
+                        "title": "الوحدة الثانية: مراحل وأدوات تطبيق التفكير التصميمي",
+                        "focus": "تعلّم الخطوات العملية وأهم الأدوات المنهجية لتطبيق التفكير التصميمي في المواقف الواقعية.",
+                    },
+                    {
+                        "unit_number": 3,
+                        "title": "الوحدة الثالثة: التفكير التصميمي كأداة لحل المشكلات المعقدة",
+                        "focus": "تحليل العلاقة بين التفكير التصميمي والتفكير التحليلي عند التعامل مع القضايا التنظيمية والمهنية.",
+                    },
+                    {
+                        "unit_number": 4,
+                        "title": "الوحدة الرابعة: التفكير التصميمي كمدخل لاتخاذ القرارات الإبداعية",
+                        "focus": "تطبيق التفكير التصميمي في اتخاذ قرارات استراتيجية مبتكرة وتحسين العمليات المؤسسية.",
+                    },
+                ],
+            },
+        }
+    ],
+    llm=llm,
+    # llm=llm_5m,
+    allow_delegation=False,
+    reasoning=True,
+    max_iter=100,
+    verbose=True,
+)
+
+
+# ============================================================
+# 🧠 4. Task Definition
+# ============================================================
+
+unit_generation_task = Task(
+    description=(
+        "## GOAL\n"
+        "Generate **4 comprehensive and logically structured Arabic educational units** that summarize all key aspects of the topic: {topic}.\n\n"
+        "## STEPS\n"
+        "1. Extract the **main concept** and its **related sub-concepts** from the topic title.\n"
+        "2. Divide the topic into **4 major units** that together form a complete conceptual narrative.\n"
+        "3. Ensure the units are **progressive** — starting from foundational understanding and moving toward practical or reflective application.\n"
+        "4. Phrase each unit title like an **Arabic book chapter**, clear, formal, and pedagogically meaningful.\n"
+        "5. Write each unit’s focus as a **short, outcome-oriented summary** describing the main skills, ideas, or insights learners will gain.\n\n"
+        "6. Ensure that each proposed unit corresponds to a topic that can be supported by available educational content on the web, "
+        "including Arabic or English articles, research papers, or learning materials. "
+        "Prefer units that align with well-documented or widely discussed educational themes.\n\n"
+        "## NOTE\n"
+        "- Each unit should represent a major conceptual pillar essential for fully understanding the topic.\n"
+        "- Titles should be phrased like Arabic book chapters, preparing readers for deeper exploration through future subtopics.\n"
+        "- Avoid overlap or repetition between units; instead, show logical and conceptual progression.\n"
+        "- Maintain an academic yet clear tone — precise, structured, and free from unnecessary jargon.\n"
+    ),
+    expected_output="A `CurriculumStructure` JSON object containing: `main_concept`, `related_concepts`, and `units`.",
+    agent=unit_generator_agent,
+    output_json=CurriculumStructure,
+)

app.py

@@ -1,4 +1,8 @@
 import os
+from crewai import Crew, Process
+import json
+from fastapi import FastAPI
+from routers import objective_route, outliner_route, outcome_route
 
 # Force HOME to /tmp so CrewAI doesn't try writing to /.local
 os.environ["HOME"] = "/tmp"
@@ -11,47 +15,12 @@ os.makedirs("/tmp/.local/share", exist_ok=True)
 os.makedirs("/tmp/crewai_data", exist_ok=True)
 os.makedirs("/tmp/crewai_home", exist_ok=True)
 
-from crewai import Crew, Process
-
-import json
-from fastapi import FastAPI
-from agents.outliner_phase import (  
-    research_agent,
-    research_task,
-    structure_agent,
-    structure_task,
-    design_task,
-    designer_agent,
-    review_agent,
-    review_task,
-)
-from agents.analysis_phase import (
-    outline_agent,
-    outline_task,
-    objectives_generator,
-    objectives_task,
-    outcomes_generator,
-    outcomes_task,
-)
-from modules import (
-    llm,
-    inputs,
-    # outlines,
-    # objectives,
-    init_firebase,
-    get_realtime_db,
-    get_firestore_db,
-)
-
-from schemas import OutlineInput, DNAMetadata, LearningObjectivesOutput, CurriculumOutline
-
 
 app = FastAPI(title="AI Agent Project", version="1.0.0")
 
-# Firebase
-init_firebase()
-realtime_db = get_realtime_db()
-firestore_db = get_firestore_db()
+app.include_router(outliner_route.router)
+app.include_router(objective_route.router)
+app.include_router(outcome_route.router)
 
 
 # Example root endpoint
@@ -60,130 +29,11 @@ def read_root():
     return {"message": "Welcome to AI Agent Project API 🚀"}
 
 
-# -----------------------------------------------
-# === Agent 1: Deep Semantic Topics Generator ===
-# === Agent 2: Expander to 20 Topics ===
-# === Agent 3: Module Organizer ===
-# === Agent 4: Final Reviewer (اختياري) ===
-# -----------------------------------------------
-@app.post("/run_outliner_agents")
-def run_outliner_agents(data: OutlineInput):
-    outline_crew = Crew(
-        agents=[research_agent, structure_agent, designer_agent, review_agent],
-        tasks=[research_task, structure_task, design_task, review_task],
-        process=Process.sequential,
-    )
-
-    inputs=data.dict()
-    user_inputs = DNAMetadata(
-        topic=inputs["topic"],
-        domain=inputs["domain"],
-        content_type=inputs["content_type"],
-        audience=inputs["audience"],
-        material_type=inputs["material_type"],
-    ).dict()
-
-    result = outline_crew.kickoff(inputs=user_inputs)
-
-    print(result.json_dict)
-    return {"message": "Deep Semantic Topics Generator works well 🚀","result":result}
-
-
-# ------------------------------------
-# === Agent 5:Objectives Generator ===
-# ------------------------------------
-
-
-@app.post("/objectives")
-def run_objectives(data: OutlineInput, outlines: CurriculumOutline):
-    objectives_crew = Crew(
-        agents=[objectives_generator],
-        tasks=[objectives_task],
-        process=Process.sequential,
-    )
-    inputs = data.dict()
-    user_inputs = DNAMetadata(
-        topic=inputs["topic"],
-        domain=inputs["domain"],
-        content_type=inputs["content_type"],
-        audience=inputs["audience"],
-        material_type=inputs["material_type"],
-    ).dict()
-    merged_inputs = {**user_inputs, "outlines": outlines.dict()}
-
-    result = objectives_crew.kickoff(inputs=merged_inputs)
-
-    print(result.json_dict)
-
-    return {"message": "Objectives Generated Well 🚀","result":result}
-
-
-# ------------------------------------
-# === Agent 6:Outcomes Generator ===
-# ------------------------------------
-
-
-@app.post("/outcomes")
-def run_outcomes(
-    data: OutlineInput, objectives: LearningObjectivesOutput):
-    outcomes_crew = Crew(
-        agents=[outcomes_generator],
-        tasks=[outcomes_task],
-        process=Process.sequential,
-    )
-
-    inputs = data.dict()
-    user_inputs = DNAMetadata(
-        topic=inputs["topic"],
-        domain=inputs["domain"],
-        content_type=inputs["content_type"],
-        audience=inputs["audience"],
-        material_type=inputs["material_type"],
-    ).dict()
-    merged_inputs = {**user_inputs, "objectives": objectives.dict()}
-
-    result = outcomes_crew.kickoff(inputs=merged_inputs)
-    print(result.json_dict)
-
-    return {"message": "Outcomes Generated Well 🚀", "result": result}
-
-
-###########################################################
-
-# ------------------------------------
-# === Agent 7:Outcomes Generator ===
-# ------------------------------------
-
-
-@app.get("/training")
-def run_training(data: OutlineInput, objectives: LearningObjectivesOutput):
-    training_crew = Crew(
-        agents=[outcomes_generator],
-        tasks=[outcomes_task],
-        process=Process.sequential,
-    )
-
-    inputs = data.dict()
-    user_inputs = DNAMetadata(
-        topic=inputs["topic"],
-        domain=inputs["domain"],
-        content_type=inputs["content_type"],
-        audience=inputs["audience"],
-        material_type=inputs["material_type"],
-    ).dict()
-
-    merged_inputs = {**user_inputs, "objectives": objectives.dict()}
-    result = training_crew.kickoff(inputs=merged_inputs)
-    print(result.json_dict)
-
-    return {"message": "Outcomes Generated Well 🚀", "result": result}
-
-
 # ------------------------
 # ✅ نقطة تشغيل السيرفر
 # ------------------------
 
-if __name__ == "__main__":
-    import uvicorn
+# if __name__ == "__main__":
+#     import uvicorn
 
-    uvicorn.run("main:app", host="127.0.0.1", port=8000, reload=True)
+#     uvicorn.run("main:app", host="127.0.0.1", port=8000, reload=True)

modules/__init__.py

@@ -15,5 +15,3 @@ from .directory import (
     scraper_dir,
     urls_dir
 )
-
-from .firebase_config import init_firebase, get_realtime_db, get_firestore_db

modules/firebase_config.py

@@ -1,44 +0,0 @@
-import os
-import json
-import firebase_admin
-from firebase_admin import credentials, db, firestore
-
-
-def init_firebase():
-    """
-    Initializes Firebase with credentials and database URL.
-    Works both locally (with firebase_credentials.json) and on Hugging Face Spaces (with FIREBASE_CREDENTIALS env variable).
-    """
-    try:
-        if not firebase_admin._apps:
-            # لو شغال على Hugging Face Space – اقرأ من المتغير السري
-            firebase_json_str = os.getenv("FIREBASE_CREDENTIALS")
-
-            if firebase_json_str:
-                firebase_credentials = json.loads(firebase_json_str)
-                cred = credentials.Certificate(firebase_credentials)
-            else:
-                # لو شغال محليًا – اقرأ من الملف
-                cred = credentials.Certificate("modules/firebase_credentials.json")
-
-            firebase_admin.initialize_app(
-                cred,
-                {"databaseURL": "https://contiai-cfbff-default-rtdb.firebaseio.com/"},
-            )
-            print("✅ Firebase initialized successfully.")
-    except Exception as e:
-        print(f"❌ Error initializing Firebase: {e}")
-
-
-def get_realtime_db():
-    """
-    Returns a reference to the Firebase Realtime Database.
-    """
-    return db.reference("/")
-
-
-def get_firestore_db():
-    """
-    Returns a reference to the Firestore client.
-    """
-    return firestore.client()

modules/firebase_credentials.json

@@ -1,13 +0,0 @@
-{
-  "type": "service_account",
-  "project_id": "contiai-cfbff",
-  "private_key_id": "586ff713c2ed3a1d61228378d01cc0bd6f4519ee",
-  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQC1zGqYIBTS5qM+\nAge3H5FRNwbCVPDCVdDvm44GuIdaQ5SrTQuk/D9PV5L6W0FkMXVhrL/ihU6DxfFw\nx+q8pYGvesdqbbn3wCsgSz0C4aUeMroAKeNYUQgYo6mohAstSswYMk8szfP/NHey\n4RcBASbU4b5+yEFBhWEihBi41wLoXkgS04OVIfGKVJD+tcdE/iKxQtsbA3M/LfHX\nCmpm/2/20l/ONhysXOdXDjR3jKxNTTbVuSE1vL5nYhlPejEFr8ROheo0HpdmDxR7\n2Qiblc4x7sll3KvRfbWnObBsUQU3TL5c//oYdJyeSQWWMNPVA2chPkJbEa8IxkLS\nbCvjd4ylAgMBAAECggEAC3eTLawWxCrKFzCXl5eewFAUb0ORhobuzX5MjUrGA6dW\narh9+70kqfa5jZ/qvJm/o3z7AxwqrkMl2vN+CfVcL1szCUwi7WhD3OvOzS5TqCQs\nLIB35Guc2bkEPyqwOpe7zrbo3MgGeo17rPia5w3q8VIzHg1RmGlqWnv/xAD3IC/F\nV00RMKWr8n/6rVt1G/dnsHAQUYcxPxta6AlcqaKt4FPNVp3Jy4tEysYCNROckiQm\nkzWs19/e+c5DUZwTq4L3mHrOt1HA+0TNUqALn7MYXkq4+QZ7BsLzPuz7MgcO2PHg\njSXk7L9km+iSGE7MrQ67hpSvvxrb4wWsytpLyxEiLQKBgQDpO7xSvQ7XCwp3pByk\n91WE0+/LDbKdOyCke7EpJYCn2LxV0Mtg64uT9DbhvpB+G5MtTT+S7VNCCxYkD/wG\ng5SjoLkqG35GZRtfzM8s5oxmP9flUPSTpGxTPTFQ4v2+hGJbcHW0enzCHi4Affxe\nYOKXZ2uDy3S+2czKoInDLICJbwKBgQDHi2BVyJOH+eZocMXK7uN7gQRK2PEx+Tbh\nUSBPy/u77fmlnXUDSOhkUJJ449nOpDmXIP08vRDc7VSx0Nba5/OGIJPv+9zAnB77\nYS8ZV4FFR2V/vGhSA8Arw4ez+0hlmd0tZDU6K4qzd3+tol+5Gcx6blG6IJ/cm+vk\n1ZSpQkV5KwKBgAqhUV0IBuQgObLoRPHz3+705eoATtLBviQhCxsP/YQo6bSTlqFt\nOuhcah/x2o4U3alj6vDcZj4NWU39eIQnfR/UFHxp0mCM/SlpoUuvmliSslleTjdo\neBN3J4dDQUNsrzrxrjuylXsXewtEsrrueYVjDlBsdn64WJAnrv+5SIZ7AoGABhoI\n9BaSDFJj7UWlhrMPWbN0QiWoGnMYboNgjZAbPn/kZmAON+9+y7J7CB9PhbYX3Lsx\ngy302gyXzmgoacE1/R/55hi5g1pCyEUMf6XhWhD41ZMZTYi3057DA4nniNPPo5ew\n2PqD30EEMncInkxfqE6/SQW+XayW5gRx60sPfMkCgYANJV3w6Torl/6gGhcTdK81\nm7UNSQ5TOWGoyknGJlV2dnPXQH+l9doPdqGu/TZdtp7uhNJRxRyOZxq6iI+vvyPP\nt+ZWbB4x1qR2lsUI/3vCDtNpdsanoYFglIJpNSkSgs+dILy4CulUhsCPnT/y7QTp\nGDRfPtyjdtOQSZLlwljUEQ==\n-----END PRIVATE KEY-----\n",
-  "client_email": "firebase-adminsdk-fbsvc@contiai-cfbff.iam.gserviceaccount.com",
-  "client_id": "105916337677880596734",
-  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
-  "token_uri": "https://oauth2.googleapis.com/token",
-  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
-  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-fbsvc%40contiai-cfbff.iam.gserviceaccount.com",
-  "universe_domain": "googleapis.com"
-}

requirements.txt

@@ -8,4 +8,4 @@ langchain_openai
 litellm
 openai
 fastapi
-firebase-admin
+crewai[anthropic]

routers/objective_route.py

@@ -0,0 +1,49 @@
+import os
+from crewai import Crew, Process
+import json
+from fastapi import APIRouter, HTTPException, Depends
+from agents.analysis_phase import (
+    objectives_generator,
+    objectives_task,
+)
+from modules import (
+    llm,
+    inputs,
+)
+from schemas import (
+    CurriculumStructure,
+    DNAMetadata,
+    OutlineInput,
+)
+
+
+router = APIRouter(prefix="/analysis", tags=["Objectives"])
+
+
+# ------------------------------------
+# === Agent 5:Objectives Generator ===
+# ------------------------------------
+
+
+@router.post("/objectives")
+def run_objectives(data: OutlineInput, outlines: CurriculumStructure):
+    objectives_crew = Crew(
+        agents=[objectives_generator],
+        tasks=[objectives_task],
+        process=Process.sequential,
+    )
+    inputs = data.dict()
+    user_inputs = DNAMetadata(
+        topic=inputs["topic"],
+        domain=inputs["domain"],
+        content_type=inputs["content_type"],
+        audience=inputs["audience"],
+        material_type=inputs["material_type"],
+    ).dict()
+    merged_inputs = {**user_inputs, "outlines": outlines.dict()}
+
+    result = objectives_crew.kickoff(inputs=merged_inputs)
+
+    print(result.json_dict)
+
+    return {"message": "Objectives Generated Well 🚀", "result": result}

routers/outcome_route.py

@@ -0,0 +1,49 @@
+import os
+from crewai import Crew, Process
+import json
+from fastapi import APIRouter, HTTPException, Depends
+from agents.analysis_phase import (
+    outcomes_generator,
+    outcomes_task,
+)
+from modules import (
+    llm,
+    inputs,
+)
+from schemas import (
+    LearningObjectivesOutput,
+    DNAMetadata,
+    OutlineInput,
+)
+
+
+router = APIRouter(prefix="/analysis", tags=["outcomes"])
+
+
+# ------------------------------------
+# === Agent 6:Outcomes Generator ===
+# ------------------------------------
+
+
+@router.post("/outcomes")
+def run_outcomes(data: OutlineInput, objectives: LearningObjectivesOutput):
+    outcomes_crew = Crew(
+        agents=[outcomes_generator],
+        tasks=[outcomes_task],
+        process=Process.sequential,
+    )
+
+    inputs = data.dict()
+    user_inputs = DNAMetadata(
+        topic=inputs["topic"],
+        domain=inputs["domain"],
+        content_type=inputs["content_type"],
+        audience=inputs["audience"],
+        material_type=inputs["material_type"],
+    ).dict()
+    merged_inputs = {**user_inputs, "objectives": objectives.dict()}
+
+    result = outcomes_crew.kickoff(inputs=merged_inputs)
+    print(result.json_dict)
+
+    return {"message": "Outcomes Generated Well 🚀", "result": result}

routers/outliner_route.py

@@ -0,0 +1,55 @@
+import os
+from crewai import Crew, Process
+import json
+from fastapi import APIRouter, HTTPException, Depends
+from agents.final_outliners import (
+    unit_generator_agent,
+    unit_generation_task,
+    axis_generator_agent,
+    axis_generation_task,
+)
+from modules import (
+    llm,
+    inputs,
+)
+from schemas import (
+    CurriculumStructure,
+    DNAMetadata,
+    OutlineInput,
+)
+
+router = APIRouter(prefix="/outliner", tags=["Authentication"])
+
+
+# === Agent 1: Deep Semantic Topics Generator ===
+# === Agent 2: Expander to 20 Topics ===
+# === Agent 3: Module Organizer ===
+# === Agent 4: Final Reviewer (اختياري) ===
+# -----------------------------------------------
+@router.post("/run_outliner_agents")
+def run_outliner_agents(data: OutlineInput):
+    outline_crew = Crew(
+        agents=[
+            unit_generator_agent,
+            axis_generator_agent,
+        ],
+        tasks=[
+            unit_generation_task,
+            axis_generation_task,
+        ],
+        process=Process.sequential,
+    )
+
+    inputs = data.dict()
+    user_inputs = DNAMetadata(
+        topic=inputs["topic"],
+        domain=inputs["domain"],
+        content_type=inputs["content_type"],
+        audience=inputs["audience"],
+        material_type=inputs["material_type"],
+    ).dict()
+
+    result = outline_crew.kickoff(inputs=user_inputs)
+
+    print(result.json_dict)
+    return {"message": "Deep Semantic Topics Generator works well 🚀", "result": result}

routers/training_route.py

@@ -0,0 +1,48 @@
+import os
+from crewai import Crew, Process
+import json
+from fastapi import APIRouter, HTTPException, Depends
+from agents.analysis_phase import (
+    training_agent,
+    training_task,
+)
+from modules import (
+    llm,
+    inputs,
+)
+from schemas import (
+    LearningObjectivesOutput,
+    DNAMetadata,
+    OutlineInput,
+)
+
+
+router = APIRouter(prefix="/analysis", tags=["training"])
+
+# ------------------------------------
+# === Agent 7:Training Generator ===
+# ------------------------------------
+
+
+@app.get("/training")
+def run_training(data: OutlineInput, objectives: LearningObjectivesOutput):
+    training_crew = Crew(
+        agents=[training_agent],
+        tasks=[training_task],
+        process=Process.sequential,
+    )
+
+    inputs = data.dict()
+    user_inputs = DNAMetadata(
+        topic=inputs["topic"],
+        domain=inputs["domain"],
+        content_type=inputs["content_type"],
+        audience=inputs["audience"],
+        material_type=inputs["material_type"],
+    ).dict()
+
+    merged_inputs = {**user_inputs, "objectives": objectives.dict()}
+    result = training_crew.kickoff(inputs=merged_inputs)
+    print(result.json_dict)
+
+    return {"message": "Outcomes Generated Well 🚀", "result": result}

schemas/__init__.py

@@ -4,7 +4,14 @@ from .extractor_schema import AllPartsOfContent, SinglePartOfContent, Section
 from .keywoard_schema import SuggestedSearchQueries
 from .objectives_schema import LearningObjectivesOutput
 from .outcomes_schema import BloomOutcomesOutput
-from .outliner_schema import CurriculumOutline, Unit, DeepSemanticTopicsOutput,ExpandedTopicsList
+from .outliner_schema import (
+    CurriculumOutline,
+    Unit,
+    DeepSemanticTopicsOutput,
+    ExpandedTopicsList,
+    CurriculumStructure,
+    FullCurriculumStructure,
+)
 from .source_schema import AllResults, SingleResult
 from .training_schema import TrainingProgramOutput
 from .inputs_schema import OutlineInput

schemas/outliner_schema.py

@@ -1,7 +1,225 @@
 from pydantic import BaseModel, Field
 from typing import List, Dict, Literal, Optional
+from .dna_schema import DNAMetadata
 
+################==NEW==################
 
+# Unit Generator Schema #
+class Unit(BaseModel):
+    """
+    Represents a single instructional unit within a curriculum.
+
+    Each unit is a focused section of the overall curriculum,
+    designed to teach a specific set of concepts or skills.
+    """
+
+    unit_number: int = Field(
+        ...,
+        title="The sequential number of this unit within the overall curriculum (e.g., 1, 2, 3).",
+    )
+    title: str = Field(
+        ...,
+        title="Unit Title",
+        description="The Arabic title or name of the educational unit, clearly representing its theme or purpose.",
+    )
+
+    # focus: str = Field(..., title="Unit Focus", description="Brief note on what this unit emphasizes conceptually")
+    focus: str = Field(
+        ...,
+        title="Unit Focus",
+        description=(
+            "A concise overview highlighting the main concepts, skills, and learning outcomes "
+            "covered in this unit. It describes what learners should understand or achieve after completing it."
+            "It sets the intellectual direction for the included axes."
+        ),
+    )
+
+
+class CurriculumStructure(BaseModel):
+    """
+    Represents the full structure of a curriculum for a specific topic or program.
+
+    This model combines both conceptual metadata (via DNAMetadata) and pedagogical structure (via Unit).
+    It provides all the necessary contextual and educational information the AI agent or system
+    needs to generate, evaluate, or organize learning content effectively.
+    """
+
+    # topic: str
+    # domain: str
+    # audience: str
+    # content_type: str
+    # material_type: List[str]
+
+    Metadata: List["DNAMetadata"] = Field(
+        ...,
+        title="List of DNA Metadata Objects",
+        description=(
+            "A list of DNAMetadata items, where each item represents a distinct topic or concept "
+            "along with its domain, audience, content type, and material nature.\n"
+            "This allows the agent to process multiple curriculum components or educational segments "
+            "within a single structured input."
+        ),
+    )
+
+    main_concept: str = Field(
+        ...,
+        title="Main Concept",
+        description=(
+            "The central or core idea around which the curriculum is built. "
+            "It defines the overarching theme that connects all units and topics together."
+        ),
+    )
+
+    related_concepts: List[str] = Field(
+        ...,
+        title="Related Concepts",
+        description=(
+            "A set of secondary or supporting ideas that complement or expand upon the main concept. "
+            "These help the agent establish conceptual links and subtopics within the curriculum."
+        ),
+    )
+
+    units: List[Unit] = Field(
+        ...,
+        title="Curriculum Units",
+        description=(
+            "A detailed list of instructional units included in this curriculum. "
+            "Each unit includes its number, title, and conceptual focus to define its role "
+            "within the overall learning journey."
+        ),
+    )
+
+
+# Axis Generator Schema #
+class Axis(BaseModel):
+    """
+    Represents a single 'axis' or subtopic within an educational unit.
+
+    Each axis embodies a progressive learning step that moves from
+    basic understanding toward higher-order thinking such as
+    application, analysis, or creative synthesis.
+    """
+
+    axis_number: int = Field(
+        ...,
+        title="Axis Number",
+        description="The sequential order of this axis within the unit (1 to 5).",
+    )
+
+    title: str = Field(
+        ...,
+        title="Axis Title",
+        description=(
+            "The Arabic title of the subtopic or 'axis' inside the unit. "
+            "Each axis defines a distinct conceptual or cognitive step "
+            "that contributes to the overall unit progression."
+        ),
+    )
+
+    purpose: str = Field(
+        ...,
+        title="Axis Purpose",
+        description=(
+            "A concise statement describing the educational intent of this axis — "
+            "what learners should achieve cognitively (e.g., understanding, applying, analyzing, creating)."
+        ),
+    )
+
+
+############################################################################################################
+class UnitWithAxes(BaseModel):
+    """
+    Represents a curriculum unit that contains multiple learning axes.
+
+    Each unit defines a coherent topic focus and consists of five axes,
+    each representing a structured subtopic or cognitive level that guides
+    the learner progressively from comprehension to advanced application.
+    """
+
+    unit_number: int = Field(
+        ...,
+        title="The sequential number of this unit within the overall curriculum (e.g., 1, 2, 3).",
+    )
+
+    title: str = Field(
+        ...,
+        title="Unit Title",
+        description="The Arabic title or name of the educational unit, clearly representing its theme or purpose.",
+    )
+
+    # focus: str = Field(..., title="Unit Focus", description="Brief note on what this unit emphasizes conceptually")
+    focus: str = Field(
+        ...,
+        title="Unit Focus",
+        description=(
+            "A concise overview highlighting the main concepts, skills, and learning outcomes "
+            "covered in this unit. It describes what learners should understand or achieve after completing it."
+            "It sets the intellectual direction for the included axes."
+        ),
+    )
+
+    axes: List[Axis] = Field(
+        ...,
+        title="Unit Axes",
+        description=(
+            "A list of five(5) coherent Arabic subtopics (axes) that make up the unit. "
+            "Each axis represents a progressive cognitive step — from foundational understanding "
+            "to creative synthesis — ensuring a balanced learning journey."
+        ),
+    )
+
+
+############################################################################################################
+class FullCurriculumStructure(BaseModel):
+    """
+    Represents the complete process of axis generation for an educational curriculum.
+
+    This model integrates educational metadata (via DNAMetadata), the conceptual hierarchy
+    (main and related concepts), and the pedagogical structure (units and axes).
+    It serves as the core structure for AI-driven generation, evaluation, and organization
+    of educational axes aligned with learner needs and content goals.
+    """
+
+    Metadata: List["DNAMetadata"] = Field(
+        ...,
+        title="List of DNA Metadata Objects",
+        description=(
+            "A list of DNAMetadata items, where each item represents a distinct topic or concept "
+            "along with its domain, audience, content type, and material nature.\n"
+            "This allows the agent to process multiple curriculum components or educational segments "
+            "within a single structured input."
+        ),
+    )
+
+    main_concept: str = Field(
+        ...,
+        title="Main Concept",
+        description=(
+            "The central or core idea around which the curriculum is built. "
+            "It defines the overarching theme that connects all units and topics together."
+        ),
+    )
+
+    related_concepts: List[str] = Field(
+        ...,
+        title="Related Concepts",
+        description=(
+            "A set of secondary or supporting ideas that complement or expand upon the main concept. "
+            "These help the agent establish conceptual links and subtopics within the curriculum."
+        ),
+    )
+
+    units: List[UnitWithAxes] = Field(
+        ...,
+        title="Units with Axes",
+        description=(
+            "A structured list of educational units. Each unit includes its title, "
+            "conceptual focus, and five (5) well-defined axes that progressively develop the learner’s understanding."
+        ),
+    )
+
+
+##############################--OLD--#####################################################
 # ========= 2. Schema for Units =========
 class Unit(BaseModel):
     module_title: str = Field(