""" FastAPI Reservations Router (/api/v1/reservations) Handles creation, listing, updating, cancelling, confirmation and full conflict matrix validation. """ from typing import Optional, Any, Dict from datetime import datetime, timedelta from fastapi import APIRouter, Depends, HTTPException, Query, status, Request from app import db from app.models.reservation import Reservation from app.services.reservation_service import ReservationService from app.services.audit_service import AuditService from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO from dependencies import get_current_user from app.models.user import User from database import get_flask_app reservations_router = APIRouter(prefix="/api/v1/reservations", tags=["Reservations"]) reservation_service = ReservationService() flask_app = get_flask_app() @reservations_router.get("") def list_reservations( start_date: Optional[str] = Query(None), end_date: Optional[str] = Query(None), classroom_id: Optional[int] = Query(None), hide_virtual: Optional[str] = Query(None), floor: Optional[str] = Query(None), shift: Optional[str] = Query(None), search: Optional[str] = Query(None), current_user: User = Depends(get_current_user) ): """Consulta de reservas por rango de fechas y/o aula.""" with flask_app.app_context(): now = datetime.utcnow() try: start_dt = datetime.strptime(start_date, '%Y-%m-%d') if start_date else now.replace(hour=0, minute=0, second=0) except ValueError: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de start_date (debe ser YYYY-MM-DD).") try: end_dt = datetime.strptime(end_date, '%Y-%m-%d').replace(hour=23, minute=59, second=59) if end_date else start_dt + timedelta(days=7) except ValueError: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de end_date (debe ser YYYY-MM-DD).") is_hide_virtual = str(hide_virtual).lower() in ['1', 'true'] reservations = reservation_service.list_reservations(start_dt, end_dt, classroom_id=classroom_id) result = [] for r in reservations: is_virt = bool(r.is_virtual or (r.classroom and r.classroom.is_virtual)) if is_hide_virtual and is_virt: continue if floor and r.classroom and str(r.classroom.floor).strip().lower() != str(floor).strip().lower(): continue if shift and r.shift and shift.lower() not in r.shift.lower(): continue if search: s_lower = search.lower() subj_n = (r.subject_name or '').lower() subj_c = (r.subject_code or '').lower() c_name = (r.classroom.code if r.classroom else '').lower() u_name = (r.user.name if r.user else '').lower() if s_lower not in subj_n and s_lower not in subj_c and s_lower not in c_name and s_lower not in u_name: continue result.append({ 'id': r.id, 'classroom_id': r.classroom_id, 'classroom_name': r.classroom.code if r.classroom else None, 'classroom': { 'id': r.classroom.id, 'code': r.classroom.code, 'code_display': getattr(r.classroom, 'code_display', r.classroom.code), 'floor': r.classroom.floor, 'floor_display': getattr(r.classroom, 'floor_display', f"Piso {r.classroom.floor}"), 'building': getattr(r.classroom, 'building_name', r.classroom.building), 'is_virtual': getattr(r.classroom, 'is_virtual', False), 'location_display': getattr(r.classroom, 'location_display', r.classroom.code) } if r.classroom else None, 'commission_id': r.commission_id, 'commission': { 'id': r.commission.id, 'code': r.commission.code, 'virtual_link': r.commission.virtual_link, 'max_students': r.commission.max_students } if r.commission else None, 'teacher_name': r.user.name if r.user else None, 'user': { 'id': r.user.id, 'name': r.user.name, 'email': r.user.email } if r.user else None, 'start_time': r.start_time.isoformat(), 'end_time': r.end_time.isoformat(), 'purpose': r.purpose, 'subject_name': r.subject_name, 'subject_code': r.subject_code, 'career_name': r.commission.career_name if (r.commission and hasattr(r.commission, 'career_name')) else '', 'career_names': r.commission.career_names if (r.commission and hasattr(r.commission, 'career_names')) else '', 'commission_code': r.commission.code if r.commission else '', 'status': str(r.status.value if hasattr(r.status, 'value') else r.status), 'shift': r.shift or 'Mañana', 'virtual_link': r.virtual_link, 'effective_virtual_link': r.effective_virtual_link, 'is_virtual': is_virt, 'expected_attendees': r.expected_attendees or 30, 'notes': r.notes or '' }) return { 'total': len(result), 'start_date': start_dt.strftime('%Y-%m-%d'), 'end_date': end_dt.strftime('%Y-%m-%d'), 'reservations': result } @reservations_router.get("/{reservation_id}") def get_reservation(reservation_id: int, current_user: User = Depends(get_current_user)): """Obtiene el detalle de una reserva específica.""" with flask_app.app_context(): r = reservation_service.get_reservation(reservation_id) if not r: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Reserva {reservation_id} no encontrada.") duration_min = int((r.end_time - r.start_time).total_seconds() / 60) if (r.start_time and r.end_time) else 120 is_virt = bool(r.is_virtual or (r.classroom and r.classroom.is_virtual)) return { 'id': r.id, 'classroom_id': r.classroom_id, 'classroom_name': r.classroom.code if r.classroom else None, 'location_display': getattr(r.classroom, 'location_display', r.classroom.code if r.classroom else None), 'classroom': { 'id': r.classroom.id, 'code': r.classroom.code, 'code_display': getattr(r.classroom, 'code_display', r.classroom.code), 'building_name': getattr(r.classroom, 'building_name', getattr(r.classroom, 'building', 'Edificio Central')), 'floor': r.classroom.floor, 'floor_display': getattr(r.classroom, 'floor_display', f"Piso {r.classroom.floor}"), 'capacity': r.classroom.capacity, 'capacity_display': getattr(r.classroom, 'capacity_display', str(r.classroom.capacity)), 'description': getattr(r.classroom, 'description', '') or '', 'is_virtual': getattr(r.classroom, 'is_virtual', False) } if r.classroom else None, 'commission_id': r.commission_id, 'commission': { 'id': r.commission.id, 'code': r.commission.code, 'full_code': r.commission.get_full_code() if hasattr(r.commission, 'get_full_code') else r.commission.code, 'virtual_link': r.commission.virtual_link, 'max_students': r.commission.max_students, 'current_students': getattr(r.commission, 'current_students', 0), 'subject': { 'id': r.commission.subject.id, 'name': r.commission.subject.name, 'code': r.commission.subject.code } if (r.commission and r.commission.subject) else None } if r.commission else None, 'teacher_id': r.user_id, 'teacher_name': r.user.name if r.user else None, 'user': { 'id': r.user.id, 'name': r.user.name, 'first_name': getattr(r.user, 'first_name', r.user.name.split()[0] if r.user.name else 'Usuario'), 'last_name': getattr(r.user, 'last_name', ' '.join(r.user.name.split()[1:]) if r.user.name and len(r.user.name.split()) > 1 else ''), 'email': r.user.email } if r.user else None, 'start_time': r.start_time.isoformat(), 'end_time': r.end_time.isoformat(), 'duration': duration_min, 'purpose': r.purpose, 'status': str(r.status.value if hasattr(r.status, 'value') else r.status), 'shift': r.shift or 'Mañana', 'virtual_link': r.virtual_link, 'effective_virtual_link': r.effective_virtual_link, 'is_virtual': is_virt, 'expected_attendees': r.expected_attendees or 30, 'notes': r.notes or '', 'can_be_cancelled': r.can_be_cancelled() if hasattr(r, 'can_be_cancelled') else True } @reservations_router.post("", status_code=status.HTTP_201_CREATED) def create_reservation( payload: Dict[str, Any], current_user: User = Depends(get_current_user) ): """Crea una reserva aplicando validación DTO y detección de colisiones.""" with flask_app.app_context(): if 'user_id' not in payload: payload['user_id'] = current_user.id try: dto = ReservationCreateDTO(**payload) except Exception as e: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e)) try: reservation = reservation_service.create_reservation(dto) AuditService.log( action='CREATE', module='reservations', entity_id=reservation.id, user=current_user, details=f"Nueva reserva creada #{reservation.id} en aula ID {reservation.classroom_id} ({reservation.start_time.strftime('%Y-%m-%d %H:%M')} a {reservation.end_time.strftime('%H:%M')}) - Motivo: {reservation.purpose}" ) return { 'message': 'Reserva creada exitosamente.', 'id': reservation.id, 'classroom_id': reservation.classroom_id, 'start_time': reservation.start_time.isoformat(), 'end_time': reservation.end_time.isoformat(), 'status': str(reservation.status) } except ValueError as e: raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=str(e)) @reservations_router.put("/{reservation_id}") def update_reservation( reservation_id: int, dto: ReservationUpdateDTO, current_user: User = Depends(get_current_user) ): """Modifica una reserva existente.""" with flask_app.app_context(): try: reservation = reservation_service.update_reservation(reservation_id, dto) AuditService.log( action='UPDATE', module='reservations', entity_id=reservation.id, user=current_user, details=f"Reserva #{reservation.id} modificada ({reservation.start_time.strftime('%Y-%m-%d %H:%M')} a {reservation.end_time.strftime('%H:%M')}) - Estado: {reservation.status}" ) return { 'message': 'Reserva actualizada exitosamente.', 'id': reservation.id, 'start_time': reservation.start_time.isoformat(), 'end_time': reservation.end_time.isoformat(), 'status': str(reservation.status) } except ValueError as e: raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=str(e)) @reservations_router.delete("/{reservation_id}") def cancel_reservation( reservation_id: int, hard: Optional[str] = Query(None), current_user: User = Depends(get_current_user) ): """Cancela o elimina una reserva según el parámetro hard.""" with flask_app.app_context(): hard_delete = str(hard).lower() in ['true', '1'] if hard_delete: res = Reservation.query.get(reservation_id) if not res: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Reserva {reservation_id} no encontrada.") db.session.delete(res) db.session.commit() AuditService.log( action='DELETE', module='reservations', entity_id=reservation_id, user=current_user, details=f"Reserva #{reservation_id} eliminada permanentemente" ) return {'message': f'Reserva {reservation_id} eliminada permanentemente.'} cancelled = reservation_service.cancel_reservation(reservation_id) if not cancelled: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Reserva {reservation_id} no encontrada.") AuditService.log( action='CANCEL', module='reservations', entity_id=reservation_id, user=current_user, details=f"Reserva #{reservation_id} cancelada" ) return {'message': f'Reserva {reservation_id} cancelada correctamente.'} @reservations_router.post("/{reservation_id}/delete") def delete_reservation_post(reservation_id: int, current_user: User = Depends(get_current_user)): """Elimina permanentemente una reserva (POST).""" with flask_app.app_context(): res = Reservation.query.get(reservation_id) if not res: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Reserva {reservation_id} no encontrada.") db.session.delete(res) db.session.commit() AuditService.log( action='DELETE', module='reservations', entity_id=reservation_id, user=current_user, details=f"Reserva #{reservation_id} eliminada permanentemente" ) return {'message': f'Reserva {reservation_id} eliminada permanentemente.'} @reservations_router.post("/{reservation_id}/cancel") def cancel_reservation_post(reservation_id: int, current_user: User = Depends(get_current_user)): """Cancela una reserva (POST).""" with flask_app.app_context(): cancelled = reservation_service.cancel_reservation(reservation_id) if not cancelled: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Reserva {reservation_id} no encontrada.") AuditService.log( action='CANCEL', module='reservations', entity_id=reservation_id, user=current_user, details=f"Reserva #{reservation_id} cancelada" ) return {'message': f'Reserva {reservation_id} cancelada correctamente.'} @reservations_router.post("/{reservation_id}/confirm") def confirm_reservation(reservation_id: int, current_user: User = Depends(get_current_user)): """Confirma una reserva cambiando su estado a CONFIRMED.""" with flask_app.app_context(): confirmed = reservation_service.confirm_reservation(reservation_id) if not confirmed: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Reserva {reservation_id} no encontrada.") AuditService.log( action='CONFIRM', module='reservations', entity_id=reservation_id, user=current_user, details=f"Reserva #{reservation_id} confirmada oficialmente" ) return {'message': f'Reserva {reservation_id} confirmada correctamente.'} @reservations_router.post("/check-conflicts") def check_conflicts_endpoint(payload: Dict[str, Any], current_user: User = Depends(get_current_user)): """Evalúa la matriz completa de conflictos (físico, docente y aforo) en tiempo real.""" with flask_app.app_context(): classroom_id = payload.get('classroom_id') start_str = payload.get('start_time') end_str = payload.get('end_time') if not classroom_id or not start_str or not end_str: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="classroom_id, start_time y end_time son obligatorios.") try: start_time = datetime.fromisoformat(str(start_str).replace('Z', '+00:00')) end_time = datetime.fromisoformat(str(end_str).replace('Z', '+00:00')) except ValueError: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de fecha/hora (ISO 8601 esperado).") teacher_id = payload.get('teacher_id') commission_id = payload.get('commission_id') expected_attendees = payload.get('expected_attendees') allow_co_teaching = bool(payload.get('allow_co_teaching_exception', False)) exclude_id = payload.get('exclude_id') try: matrix = reservation_service.check_full_conflicts_matrix( classroom_id=int(classroom_id), start_time=start_time, end_time=end_time, teacher_id=int(teacher_id) if teacher_id else None, commission_id=int(commission_id) if commission_id else None, expected_attendees=int(expected_attendees) if expected_attendees is not None else None, allow_co_teaching_exception=allow_co_teaching, exclude_id=int(exclude_id) if exclude_id else None ) return matrix except ValueError as e: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))