""" FastAPI Classrooms Router (/api/v1/classrooms) Provides endpoints for listing, retrieving, creating, updating and toggling classrooms. """ from typing import Optional from fastapi import APIRouter, Depends, HTTPException, Query, status from app import db from app.models.classroom import Classroom from app.services.classroom_service import ClassroomService 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 from database import get_flask_app classrooms_router = APIRouter(prefix="/api/v1/classrooms", tags=["Classrooms"]) classroom_service = ClassroomService() flask_app = get_flask_app() @classrooms_router.get("") def list_classrooms( building_id: Optional[int] = 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.""" with flask_app.app_context(): mode_str = (mode or '').lower() only_virtual = mode_str == 'virtual' only_physical = mode_str == 'physical' classrooms = classroom_service.list_classrooms( building_id=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("/{classroom_id}") def get_classroom( classroom_id: int, current_user: User = Depends(get_current_user) ): """Obtiene el detalle de un aula por ID.""" with flask_app.app_context(): 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.""" with flask_app.app_context(): 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.""" with flask_app.app_context(): 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.""" with flask_app.app_context(): 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.""" with flask_app.app_context(): 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.' }