🚀 Auto-deploy backend from GitHub (d39af4f)

main.py

@@ -75,6 +75,7 @@ from services.user_provisioning_service import (
     UserProvisioningService,
 )
 from routes.rag_routes import router as rag_router
+from routes.curriculum_routes import router as curriculum_router
 from rag.curriculum_rag import (
     build_analysis_curriculum_context,
     build_lesson_prompt,
@@ -974,6 +975,7 @@ class RequestMiddleware(BaseHTTPMiddleware):
 app.add_middleware(RequestMiddleware)
 app.add_middleware(AuthMiddleware)
 app.include_router(rag_router)
+app.include_router(curriculum_router)
 
 
 # ─── Global Exception Handler ─────────────────────────────────

routes/curriculum_routes.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from fastapi import APIRouter, HTTPException, Query
+from pydantic import BaseModel
+
+from services.curriculum_service import (
+    get_subject,
+    get_subjects,
+    get_topic,
+    get_topics,
+)
+
+logger = logging.getLogger("mathpulse.curriculum")
+router = APIRouter(prefix="/api/curriculum", tags=["curriculum"])
+
+
+class SubjectResponse(BaseModel):
+    id: str
+    code: str
+    name: str
+    gradeLevel: str
+    semester: str
+    color: str
+    pdfAvailable: bool
+    topics: list
+
+
+class TopicResponse(BaseModel):
+    id: str
+    name: str
+    unit: str
+
+
+@router.get("/subjects", response_model=list[SubjectResponse])
+async def list_subjects(grade_level: Optional[str] = Query(None, description="Filter by grade level (e.g., 'Grade 11', 'Grade 12')")):
+    """List all curriculum subjects, optionally filtered by grade level."""
+    subjects = get_subjects(grade_level)
+    return subjects
+
+
+@router.get("/subjects/{subject_id}", response_model=SubjectResponse)
+async def get_subject_by_id(subject_id: str):
+    """Get a specific subject by ID."""
+    subject = get_subject(subject_id)
+    if not subject:
+        raise HTTPException(status_code=404, detail=f"Subject not found: {subject_id}")
+    return subject
+
+
+@router.get("/subjects/{subject_id}/topics", response_model=list[TopicResponse])
+async def list_subject_topics(subject_id: str):
+    """List all topics for a subject."""
+    topics = get_topics(subject_id)
+    return topics
+
+
+@router.get("/subjects/{subject_id}/topics/{topic_id}", response_model=TopicResponse)
+async def get_topic_by_id(subject_id: str, topic_id: str):
+    """Get a specific topic."""
+    topic = get_topic(subject_id, topic_id)
+    if not topic:
+        raise HTTPException(status_code=404, detail=f"Topic not found: {subject_id}/{topic_id}")
+    return topic

services/curriculum_service.py

@@ -0,0 +1,232 @@
+"""
+Curriculum Service - Firestore-backed curriculum data.
+
+Fetches subjects, topics, and modules from Firestore.
+Falls back to static data if Firestore is unavailable.
+"""
+
+import logging
+import os
+from typing import Any, Dict, List, Optional
+
+logger = logging.getLogger(__name__)
+
+# Static curriculum data as fallback
+_STATIC_SUBJECTS = [
+    {
+        "id": "gen-math",
+        "code": "GEN MATH",
+        "name": "General Mathematics",
+        "gradeLevel": "Grade 11",
+        "semester": "1st Semester",
+        "color": "from-blue-500 to-cyan-500",
+        "pdfAvailable": True,
+        "topics": [
+            {"id": "gen-math-001", "name": "Patterns and Real-Life Relationships", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-002", "name": "Functions as Mathematical Models", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-003", "name": "Function Notation and Evaluation", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-004", "name": "Domain and Range of Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-005", "name": "Operations on Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-006", "name": "Composite Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-007", "name": "Inverse Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-008", "name": "Graphs of Rational Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-009", "name": "Graphs of Exponential Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-010", "name": "Graphs of Logarithmic Functions", "unit": "Patterns, Relations, and Functions"},
+            {"id": "gen-math-011", "name": "Simple and Compound Interest", "unit": "Financial Mathematics"},
+            {"id": "gen-math-012", "name": "Simple and General Annuities", "unit": "Financial Mathematics"},
+            {"id": "gen-math-013", "name": "Present and Future Value", "unit": "Financial Mathematics"},
+            {"id": "gen-math-014", "name": "Loans, Amortization, and Sinking Funds", "unit": "Financial Mathematics"},
+            {"id": "gen-math-015", "name": "Stocks, Bonds, and Market Indices", "unit": "Financial Mathematics"},
+            {"id": "gen-math-016", "name": "Business Decision-Making with Mathematical Models", "unit": "Financial Mathematics"},
+            {"id": "gen-math-017", "name": "Propositions and Logical Connectives", "unit": "Logic and Mathematical Reasoning"},
+            {"id": "gen-math-018", "name": "Truth Values and Truth Tables", "unit": "Logic and Mathematical Reasoning"},
+            {"id": "gen-math-019", "name": "Logical Equivalence and Implication", "unit": "Logic and Mathematical Reasoning"},
+            {"id": "gen-math-020", "name": "Quantifiers and Negation", "unit": "Logic and Mathematical Reasoning"},
+            {"id": "gen-math-021", "name": "Validity of Arguments", "unit": "Logic and Mathematical Reasoning"},
+        ]
+    },
+    {
+        "id": "stats-prob",
+        "code": "STAT&PROB",
+        "name": "Statistics and Probability",
+        "gradeLevel": "Grade 11",
+        "semester": "2nd Semester",
+        "color": "from-sky-500 to-cyan-500",
+        "pdfAvailable": True,
+        "topics": [
+            {"id": "stat-001", "name": "Random Variables", "unit": "Random Variables"},
+            {"id": "stat-002", "name": "Discrete Probability Distributions", "unit": "Random Variables"},
+            {"id": "stat-003", "name": "Mean and Variance of Discrete RV", "unit": "Random Variables"},
+            {"id": "stat-004", "name": "Normal Distribution", "unit": "Normal Distribution"},
+            {"id": "stat-005", "name": "Standard Normal Distribution and Z-scores", "unit": "Normal Distribution"},
+            {"id": "stat-006", "name": "Areas Under the Normal Curve", "unit": "Normal Distribution"},
+            {"id": "stat-007", "name": "Sampling Distributions", "unit": "Sampling and Estimation"},
+            {"id": "stat-008", "name": "Central Limit Theorem", "unit": "Sampling and Estimation"},
+            {"id": "stat-009", "name": "Point Estimation", "unit": "Sampling and Estimation"},
+            {"id": "stat-010", "name": "Confidence Intervals", "unit": "Sampling and Estimation"},
+            {"id": "stat-011", "name": "Hypothesis Testing Concepts", "unit": "Hypothesis Testing"},
+            {"id": "stat-012", "name": "T-test", "unit": "Hypothesis Testing"},
+            {"id": "stat-013", "name": "Z-test", "unit": "Hypothesis Testing"},
+            {"id": "stat-014", "name": "Correlation and Regression", "unit": "Correlation and Regression"},
+        ]
+    },
+    {
+        "id": "pre-calc",
+        "code": "PRE-CALC",
+        "name": "Pre-Calculus",
+        "gradeLevel": "Grade 12",
+        "semester": "1st Semester",
+        "color": "from-orange-500 to-red-500",
+        "pdfAvailable": False,
+        "topics": [
+            {"id": "pre-calc-001", "name": "Conic Sections - Parabola", "unit": "Analytic Geometry"},
+            {"id": "pre-calc-002", "name": "Conic Sections - Ellipse", "unit": "Analytic Geometry"},
+            {"id": "pre-calc-003", "name": "Conic Sections - Hyperbola", "unit": "Analytic Geometry"},
+            {"id": "pre-calc-004", "name": "Conic Sections - Circle", "unit": "Analytic Geometry"},
+            {"id": "pre-calc-005", "name": "Systems of Nonlinear Equations", "unit": "Analytic Geometry"},
+            {"id": "pre-calc-006", "name": "Sequences and Series", "unit": "Series and Induction"},
+            {"id": "pre-calc-007", "name": "Arithmetic Sequences", "unit": "Series and Induction"},
+            {"id": "pre-calc-008", "name": "Geometric Sequences", "unit": "Series and Induction"},
+            {"id": "pre-calc-009", "name": "Mathematical Induction", "unit": "Series and Induction"},
+            {"id": "pre-calc-010", "name": "Binomial Theorem", "unit": "Series and Induction"},
+            {"id": "pre-calc-011", "name": "Angles and Unit Circle", "unit": "Trigonometry"},
+            {"id": "pre-calc-012", "name": "Trigonometric Functions", "unit": "Trigonometry"},
+            {"id": "pre-calc-013", "name": "Trigonometric Identities", "unit": "Trigonometry"},
+            {"id": "pre-calc-014", "name": "Sum and Difference Formulas", "unit": "Trigonometry"},
+            {"id": "pre-calc-015", "name": "Inverse Trigonometric Functions", "unit": "Trigonometry"},
+            {"id": "pre-calc-016", "name": "Polar Coordinates", "unit": "Trigonometry"},
+        ]
+    },
+    {
+        "id": "basic-calc",
+        "code": "BASIC CALC",
+        "name": "Basic Calculus",
+        "gradeLevel": "Grade 12",
+        "semester": "2nd Semester",
+        "color": "from-green-500 to-teal-500",
+        "pdfAvailable": True,
+        "topics": [
+            {"id": "calc-001", "name": "Limits of Functions", "unit": "Limits"},
+            {"id": "calc-002", "name": "Limit Theorems", "unit": "Limits"},
+            {"id": "calc-003", "name": "One-Sided Limits", "unit": "Limits"},
+            {"id": "calc-004", "name": "Infinite Limits and Limits at Infinity", "unit": "Limits"},
+            {"id": "calc-005", "name": "Continuity of Functions", "unit": "Limits"},
+            {"id": "calc-006", "name": "Definition of the Derivative", "unit": "Derivatives"},
+            {"id": "calc-007", "name": "Differentiation Rules", "unit": "Derivatives"},
+            {"id": "calc-008", "name": "Chain Rule", "unit": "Derivatives"},
+            {"id": "calc-009", "name": "Implicit Differentiation", "unit": "Derivatives"},
+            {"id": "calc-010", "name": "Higher-Order Derivatives", "unit": "Derivatives"},
+            {"id": "calc-011", "name": "Related Rates", "unit": "Derivatives"},
+            {"id": "calc-012", "name": "Extrema and the First Derivative Test", "unit": "Derivatives"},
+            {"id": "calc-013", "name": "Concavity and the Second Derivative Test", "unit": "Derivatives"},
+            {"id": "calc-014", "name": "Optimization Problems", "unit": "Derivatives"},
+            {"id": "calc-015", "name": "Antiderivatives and Indefinite Integrals", "unit": "Integration"},
+            {"id": "calc-016", "name": "Definite Integrals and the FTC", "unit": "Integration"},
+            {"id": "calc-017", "name": "Integration by Substitution", "unit": "Integration"},
+            {"id": "calc-018", "name": "Area Under a Curve", "unit": "Integration"},
+        ]
+    },
+]
+
+_firestore_db = None
+
+
+def _get_firestore_db():
+    """Initialize Firestore client."""
+    global _firestore_db
+    if _firestore_db is not None:
+        return _firestore_db
+
+    try:
+        import firebase_admin
+        from firebase_admin import firestore
+        if not firebase_admin._apps:
+            # Try service account from env or default credentials
+            import json
+            svc_account = os.getenv("FIREBASE_SERVICE_ACCOUNT_JSON")
+            if svc_account:
+                sa_creds = json.loads(svc_account)
+                firebase_admin.initialize_app(firebase_admin.Certificate(sa_creds))
+            else:
+                firebase_admin.initialize_app()
+        _firestore_db = firestore.client()
+        return _firestore_db
+    except Exception as e:
+        logger.warning(f"Could not initialize Firestore: {e}")
+        return None
+
+
+def get_subjects(grade_level: Optional[str] = None) -> List[Dict[str, Any]]:
+    """
+    Fetch all subjects from Firestore.
+    Falls back to static data if Firestore unavailable.
+    Defaults to Grade 11 (SHS) if no grade specified.
+    """
+    # Default to Grade 11 (SHS) - only serve Grade 11 students for now
+    if grade_level is None:
+        grade_level = "Grade 11"
+
+    db = _get_firestore_db()
+
+    if db is not None:
+        try:
+            subjects_ref = db.collection("subjects")
+            if grade_level:
+                subjects_ref = subjects_ref.where("gradeLevel", "==", grade_level)
+
+            docs = subjects_ref.stream()
+            subjects = []
+            for doc in docs:
+                data = doc.to_dict()
+                if data:
+                    data["id"] = doc.id
+                    subjects.append(data)
+
+            if subjects:
+                logger.info(f"Loaded {len(subjects)} subjects from Firestore")
+                return subjects
+        except Exception as e:
+            logger.warning(f"Firestore fetch failed, using static data: {e}")
+
+    # Static fallback
+    if grade_level:
+        return [s for s in _STATIC_SUBJECTS if s.get("gradeLevel") == grade_level]
+    return list(_STATIC_SUBJECTS)
+
+
+def get_subject(subject_id: str) -> Optional[Dict[str, Any]]:
+    """Fetch a single subject by ID."""
+    db = _get_firestore_db()
+
+    if db is not None:
+        try:
+            doc = db.collection("subjects").document(subject_id).get()
+            if doc.exists:
+                data = doc.to_dict()
+                data["id"] = doc.id
+                return data
+        except Exception as e:
+            logger.warning(f"Firestore fetch failed for {subject_id}: {e}")
+
+    # Static fallback
+    for subject in _STATIC_SUBJECTS:
+        if subject["id"] == subject_id:
+            return dict(subject)
+    return None
+
+
+def get_topics(subject_id: str) -> List[Dict[str, Any]]:
+    """Fetch all topics for a subject."""
+    subject = get_subject(subject_id)
+    if subject:
+        return subject.get("topics", [])
+    return []
+
+
+def get_topic(subject_id: str, topic_id: str) -> Optional[Dict[str, Any]]:
+    """Fetch a single topic."""
+    topics = get_topics(subject_id)
+    for topic in topics:
+        if topic["id"] == topic_id:
+            return topic
+    return None