""" FastAPI Students Router (/api/v1/students) Provides academic milestone and gradebook queries for students. """ from typing import Optional from fastapi import APIRouter, Depends, HTTPException, Query, Request, status from app.services.gradebook_service import GradebookService from dependencies import get_current_user from app.models.user import User students_router = APIRouter(prefix="/api/v1/students", tags=["Students"]) @students_router.get("/my-grades") def get_my_grades( request: Request, current_user: User = Depends(get_current_user) ): """Consulta individual de calificaciones y estado académico del alumno logueado.""" try: user_id = int(getattr(current_user, 'id')) grades = GradebookService.get_student_grades(user_id) is_impersonating = bool(request.headers.get('X-Impersonate-User')) return { 'status': 'success', 'student_id': user_id, 'is_impersonating': is_impersonating, 'data': grades } except Exception as e: raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(e)) @students_router.get("/my-upcoming-milestones") def get_my_upcoming_milestones( limit: int = Query(5, ge=1, le=50), current_user: User = Depends(get_current_user) ): """Próximas evaluaciones e hitos académicos con cuenta regresiva para el dashboard.""" try: user_id = int(getattr(current_user, 'id')) milestones = GradebookService.get_student_upcoming_milestones(user_id, limit=limit) return {'status': 'success', 'data': milestones} except Exception as e: raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(e))