252 lines
9.0 KiB
Python
252 lines
9.0 KiB
Python
"""
|
|
FastAPI Classrooms Router (/api/v1/classrooms)
|
|
Provides endpoints for listing, retrieving, creating, updating and toggling classrooms.
|
|
100% Native FastAPI - Zero Flask dependencies.
|
|
"""
|
|
from typing import Optional
|
|
from fastapi import APIRouter, Depends, HTTPException, Query, status
|
|
from sqlalchemy import or_
|
|
|
|
from app import db
|
|
from app.models.classroom import Classroom
|
|
from app.services.classroom_service import ClassroomService
|
|
from app.services.dashboard_service import DashboardService
|
|
from app.services.audit_service import AuditService
|
|
from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO
|
|
from dependencies import get_current_user, require_roles
|
|
from app.models.user import User
|
|
|
|
classrooms_router = APIRouter(prefix="/api/v1/classrooms", tags=["Classrooms"])
|
|
classroom_service = ClassroomService()
|
|
dashboard_service = DashboardService()
|
|
|
|
|
|
@classrooms_router.get("")
|
|
def list_classrooms(
|
|
building_id: Optional[str] = Query(None),
|
|
floor: Optional[str] = Query(None),
|
|
mode: Optional[str] = Query(None),
|
|
current_user: User = Depends(get_current_user)
|
|
):
|
|
"""Lista aulas físicas y virtuales con filtros opcionales."""
|
|
mode_str = (mode or '').lower()
|
|
only_virtual = mode_str == 'virtual'
|
|
only_physical = mode_str == 'physical'
|
|
parsed_building_id = int(building_id.strip()) if building_id and building_id.strip().isdigit() else None
|
|
|
|
classrooms = classroom_service.list_classrooms(
|
|
building_id=parsed_building_id,
|
|
floor=floor,
|
|
only_virtual=only_virtual,
|
|
only_physical=only_physical
|
|
)
|
|
|
|
result = []
|
|
for c in classrooms:
|
|
result.append({
|
|
'id': c.id,
|
|
'code': c.code,
|
|
'building': c.building_name,
|
|
'building_id': c.building_id,
|
|
'floor': c.floor,
|
|
'floor_display': c.floor_display,
|
|
'capacity': c.capacity,
|
|
'is_virtual': c.is_virtual,
|
|
'location_display': c.location_display,
|
|
'description': c.description,
|
|
'is_active': c.is_active
|
|
})
|
|
|
|
return {'total': len(result), 'classrooms': result}
|
|
|
|
|
|
@classrooms_router.get("/virtual-rooms")
|
|
def get_virtual_rooms(
|
|
teacher_id: Optional[int] = Query(None),
|
|
student_id: Optional[int] = Query(None),
|
|
mine: Optional[bool] = Query(None),
|
|
current_user: User = Depends(get_current_user)
|
|
):
|
|
"""Retorna el catálogo consolidado de salas virtuales operativas en el Campus Virtual con scoping por rol."""
|
|
user_role = (getattr(current_user, 'role', '') or '').lower()
|
|
user_id = getattr(current_user, 'id', None)
|
|
|
|
# Scoping automático por rol
|
|
target_teacher_id = teacher_id
|
|
target_student_id = student_id
|
|
if mine or (mine is None and user_role == 'docente'):
|
|
target_teacher_id = user_id
|
|
elif mine or (mine is None and user_role in ['alumno', 'estudiante']):
|
|
target_student_id = user_id
|
|
|
|
stats = dashboard_service.get_stats(current_user=current_user)
|
|
vrooms = stats.get('bedelia', {}).get('virtual_rooms', [])
|
|
|
|
if target_teacher_id:
|
|
from app.models.commission import Commission, CommissionTeacher
|
|
my_comm_ids = set(
|
|
c.id for c in Commission.query.filter(
|
|
or_(
|
|
Commission.teacher_id == target_teacher_id,
|
|
Commission.teachers_association.any(CommissionTeacher.user_id == target_teacher_id)
|
|
)
|
|
).all()
|
|
)
|
|
vrooms = [r for r in vrooms if r.get('commission_id') in my_comm_ids or r.get('id') in my_comm_ids]
|
|
elif target_student_id:
|
|
from app.models.enrollment import StudentEnrollment
|
|
enrolled_comm_ids = set(
|
|
e.commission_id for e in StudentEnrollment.query.filter(
|
|
StudentEnrollment.student_id == target_student_id,
|
|
StudentEnrollment.status.in_(['active', 'regular', 'enrolled', 'promoted'])
|
|
).all()
|
|
)
|
|
vrooms = [r for r in vrooms if r.get('commission_id') in enrolled_comm_ids or r.get('id') in enrolled_comm_ids]
|
|
|
|
today_cnt = sum(r.get('today_classes', 0) for r in vrooms)
|
|
week_cnt = sum(r.get('week_classes', 0) for r in vrooms)
|
|
month_cnt = sum(r.get('month_classes', 0) for r in vrooms)
|
|
total_cnt = sum(r.get('total_count', r.get('res_count', 0)) for r in vrooms)
|
|
|
|
return {
|
|
'total': len(vrooms),
|
|
'virtual_rooms': vrooms,
|
|
'virtual_classrooms_count': len(vrooms),
|
|
'metrics': {
|
|
'today_count': today_cnt,
|
|
'week_count': week_cnt,
|
|
'month_count': month_cnt,
|
|
'commissions_count': len(vrooms),
|
|
'total_count': total_cnt
|
|
}
|
|
}
|
|
|
|
|
|
@classrooms_router.get("/{classroom_id}")
|
|
def get_classroom(
|
|
classroom_id: int,
|
|
current_user: User = Depends(get_current_user)
|
|
):
|
|
"""Obtiene el detalle de un aula por ID."""
|
|
c = classroom_service.get_classroom(classroom_id)
|
|
if not c:
|
|
raise HTTPException(
|
|
status_code=status.HTTP_404_NOT_FOUND,
|
|
detail=f"Aula {classroom_id} no encontrada."
|
|
)
|
|
|
|
return {
|
|
'id': c.id,
|
|
'code': c.code,
|
|
'building': c.building_name,
|
|
'building_id': c.building_id,
|
|
'floor': c.floor,
|
|
'floor_display': c.floor_display,
|
|
'capacity': c.capacity,
|
|
'is_virtual': c.is_virtual,
|
|
'location_display': c.location_display,
|
|
'description': c.description,
|
|
'is_active': c.is_active
|
|
}
|
|
|
|
|
|
@classrooms_router.post("", status_code=status.HTTP_201_CREATED)
|
|
def create_classroom(
|
|
dto: ClassroomCreateDTO,
|
|
current_user: User = Depends(require_roles(['admin', 'administrador', 'bedelia']))
|
|
):
|
|
"""Crea una nueva aula validando con ClassroomCreateDTO."""
|
|
try:
|
|
classroom = classroom_service.create_classroom(dto)
|
|
AuditService.log(
|
|
action='CREATE',
|
|
module='classrooms',
|
|
entity_id=classroom.id,
|
|
user=current_user,
|
|
details=f"Nueva aula creada: {classroom.code} en {classroom.building} (Piso {classroom.floor}, Capacidad: {classroom.capacity})"
|
|
)
|
|
return {
|
|
'message': 'Aula creada exitosamente.',
|
|
'id': classroom.id,
|
|
'code': classroom.code,
|
|
'location_display': classroom.location_display
|
|
}
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
|
|
|
|
|
|
@classrooms_router.put("/{classroom_id}")
|
|
def update_classroom(
|
|
classroom_id: int,
|
|
dto: ClassroomUpdateDTO,
|
|
current_user: User = Depends(require_roles(['admin', 'administrador', 'bedelia']))
|
|
):
|
|
"""Actualiza los datos de un aula."""
|
|
try:
|
|
classroom = classroom_service.update_classroom(classroom_id, dto)
|
|
if not classroom:
|
|
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Aula {classroom_id} no encontrada.")
|
|
|
|
AuditService.log(
|
|
action='UPDATE',
|
|
module='classrooms',
|
|
entity_id=classroom.id,
|
|
user=current_user,
|
|
details=f"Aula #{classroom.id} ({classroom.code}) actualizada. Capacidad: {classroom.capacity}, Piso: {classroom.floor}"
|
|
)
|
|
return {
|
|
'message': 'Aula actualizada exitosamente.',
|
|
'id': classroom.id,
|
|
'code': classroom.code,
|
|
'capacity': classroom.capacity
|
|
}
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
|
|
|
|
|
|
@classrooms_router.delete("/{classroom_id}")
|
|
def delete_classroom(
|
|
classroom_id: int,
|
|
current_user: User = Depends(require_roles(['admin', 'administrador']))
|
|
):
|
|
"""Elimina o desactiva un aula."""
|
|
deleted = classroom_service.delete_classroom(classroom_id)
|
|
if not deleted:
|
|
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Aula {classroom_id} no encontrada.")
|
|
|
|
AuditService.log(
|
|
action='DELETE',
|
|
module='classrooms',
|
|
entity_id=classroom_id,
|
|
user=current_user,
|
|
details=f"Aula #{classroom_id} eliminada/desactivada del sistema"
|
|
)
|
|
return {'message': f'Aula {classroom_id} eliminada/desactivada correctamente.'}
|
|
|
|
|
|
@classrooms_router.post("/{classroom_id}/toggle")
|
|
def toggle_classroom(
|
|
classroom_id: int,
|
|
current_user: User = Depends(require_roles(['admin', 'administrador', 'bedelia']))
|
|
):
|
|
"""Alterna el estado activo/inactivo de un aula."""
|
|
classroom = Classroom.query.get(classroom_id)
|
|
if not classroom:
|
|
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Aula {classroom_id} no encontrada.")
|
|
|
|
classroom.is_active = not classroom.is_active
|
|
db.session.commit()
|
|
AuditService.log(
|
|
action='TOGGLE',
|
|
module='classrooms',
|
|
entity_id=classroom.id,
|
|
user=current_user,
|
|
details=f"Aula {classroom.code} {'activada' if classroom.is_active else 'desactivada'}"
|
|
)
|
|
return {
|
|
'status': 'success',
|
|
'id': classroom.id,
|
|
'is_active': classroom.is_active,
|
|
'message': f'Aula {"activada" if classroom.is_active else "desactivada"} correctamente.'
|
|
}
|