feat: implementacion de dashboards por rol, soporte de clases virtuales concurrentes en importador de sheets y cartelera del dia

2026-09-18 23:04:48 -03:00
parent 47b50ede7e
commit 1080acd43a
240 changed files with 8354 additions and 8886 deletions
@@ -0,0 +1,16 @@
+"""Módulo de Data Transfer Objects (DTOs) y esquemas tipados con Pydantic."""
+from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO, ClassroomResponseDTO
+from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO, ReservationResponseDTO
+from app.schemas.auth_dto import LoginDTO, TokenResponseDTO, RefreshTokenDTO
+
+__all__ = [
+    'ClassroomCreateDTO',
+    'ClassroomUpdateDTO',
+    'ClassroomResponseDTO',
+    'ReservationCreateDTO',
+    'ReservationUpdateDTO',
+    'ReservationResponseDTO',
+    'LoginDTO',
+    'TokenResponseDTO',
+    'RefreshTokenDTO'
+]
@@ -0,0 +1,16 @@
+from typing import Optional, Dict, Any, List
+from pydantic import BaseModel, Field, EmailStr
+
+class LoginDTO(BaseModel):
+    email: str = Field(..., description="Correo electrónico institucional")
+    password: str = Field(..., min_length=1, description="Contraseña de acceso")
+
+class TokenResponseDTO(BaseModel):
+    access_token: str
+    refresh_token: str
+    token_type: str = "Bearer"
+    expires_in: int = 900  # 15 minutos en segundos
+    user: Dict[str, Any]
+
+class RefreshTokenDTO(BaseModel):
+    refresh_token: str = Field(..., description="Token de refresco válido")
@@ -0,0 +1,44 @@
+from typing import Optional
+from pydantic import BaseModel, Field, field_validator
+
+class ClassroomBaseDTO(BaseModel):
+    code: str = Field(..., min_length=1, max_length=50, description="Código o nombre del aula (ej: Aula 101, VIRTUAL-A)")
+    floor: str = Field(default="PB", max_length=50, description="Piso o nivel (PB, Piso 1, etc.)")
+    capacity: int = Field(default=30, ge=1, le=10000, description="Capacidad máxima de estudiantes")
+    description: Optional[str] = Field(default=None, max_length=500, description="Detalles o equipamiento")
+    is_active: bool = Field(default=True, description="Estado operativo del aula")
+
+    @field_validator('code')
+    @classmethod
+    def clean_code(cls, v: str) -> str:
+        v = v.strip()
+        if not v:
+            raise ValueError("El código del aula no puede estar vacío.")
+        return v
+
+    @field_validator('floor')
+    @classmethod
+    def clean_floor(cls, v: str) -> str:
+        return str(v).strip() or "PB"
+
+class ClassroomCreateDTO(ClassroomBaseDTO):
+    building_id: Optional[int] = Field(default=None, description="ID del edificio asignado")
+    building_name: Optional[str] = Field(default=None, description="Nombre de edificio (para creación dinámica)")
+
+class ClassroomUpdateDTO(BaseModel):
+    building_id: Optional[int] = None
+    code: Optional[str] = None
+    floor: Optional[str] = None
+    capacity: Optional[int] = None
+    description: Optional[str] = None
+    is_active: Optional[bool] = None
+
+class ClassroomResponseDTO(ClassroomBaseDTO):
+    id: int
+    building_id: Optional[int] = None
+    building_name: str
+    is_virtual: bool
+    location_display: str
+
+    class Config:
+        from_attributes = True
@@ -0,0 +1,49 @@
+from pydantic import BaseModel, Field, field_validator
+from typing import List, Optional, Dict, Any
+from datetime import datetime
+
+class OptimizerJobRequestDTO(BaseModel):
+    """Contrato de solicitud para iniciar una optimización heurística."""
+    commission_ids: List[int] = Field(..., min_length=1, description="Lista de IDs de comisiones a programar")
+    start_date: Optional[datetime] = Field(None, description="Fecha de inicio (ISO format)")
+    end_date: Optional[datetime] = Field(None, description="Fecha de fin (ISO format)")
+    generations: int = Field(default=80, ge=10, le=500, description="Cantidad de generaciones genéticas")
+    population_size: int = Field(default=40, ge=10, le=200, description="Tamaño de la población de cromosomas")
+    workers: int = Field(default=4, ge=1, le=16, description="Cantidad de hilos o workers concurrentes")
+
+    @field_validator('commission_ids')
+    @classmethod
+    def validate_ids(cls, v):
+        if not v or len(v) == 0:
+            raise ValueError("Debe suministrar al menos una comisión para optimizar.")
+        return list(set(v))
+
+
+class SpringBootCommissionDTO(BaseModel):
+    """Contrato de comisión en formato Spring Boot."""
+    commissionId: int
+    subjectCode: str
+    subjectName: str
+    expectedAttendees: int = Field(default=30, ge=1)
+    preferredShift: Optional[str] = "NOCHE"
+    preferredStart: datetime
+    preferredEnd: datetime
+
+
+class SpringBootClassroomDTO(BaseModel):
+    """Contrato de aula en formato Spring Boot."""
+    classroomId: int
+    roomNumber: str
+    capacity: int = Field(default=30, ge=1)
+    building: Optional[str] = "Edificio Central"
+    isVirtual: bool = False
+
+
+class SpringBootSyncPayloadDTO(BaseModel):
+    """Carga útil de sincronización interoperable con microservicios Spring Boot."""
+    requestId: str = Field(..., description="Identificador único de la petición externa")
+    campusCode: Optional[str] = "CENTRAL"
+    academicTerm: Optional[str] = "2026-1C"
+    commissions: List[SpringBootCommissionDTO] = Field(..., min_length=1)
+    classrooms: Optional[List[SpringBootClassroomDTO]] = None
+    options: Optional[Dict[str, Any]] = None
@@ -0,0 +1,43 @@
+from typing import Optional
+from datetime import datetime
+from pydantic import BaseModel, Field, model_validator
+
+class ReservationBaseDTO(BaseModel):
+    classroom_id: int = Field(..., description="ID del aula asignada")
+    commission_id: int = Field(..., description="ID de la comisión académica")
+    user_id: int = Field(..., description="ID del docente responsable")
+    start_time: datetime = Field(..., description="Fecha y hora de inicio")
+    end_time: datetime = Field(..., description="Fecha y hora de finalización")
+    purpose: str = Field(default="Clase regular", max_length=500, description="Motivo o título de la reserva")
+    expected_attendees: int = Field(default=20, ge=1, description="Cantidad estimada de asistentes")
+    shift: Optional[str] = Field(default=None, max_length=30, description="Turno (Mañana, Tarde, Vespertino, Noche)")
+    virtual_link: Optional[str] = Field(default=None, max_length=500, description="Enlace a sala virtual (Meet/Zoom)")
+    notes: Optional[str] = Field(default=None, description="Observaciones adicionales")
+    status: Optional[str] = Field(default="PENDING", description="Estado de la reserva")
+
+    @model_validator(mode='after')
+    def validate_time_range(self):
+        if self.end_time <= self.start_time:
+            raise ValueError("La hora de finalización debe ser posterior a la hora de inicio.")
+        return self
+
+class ReservationCreateDTO(ReservationBaseDTO):
+    pass
+
+class ReservationUpdateDTO(BaseModel):
+    classroom_id: Optional[int] = None
+    start_time: Optional[datetime] = None
+    end_time: Optional[datetime] = None
+    purpose: Optional[str] = None
+    expected_attendees: Optional[int] = None
+    shift: Optional[str] = None
+    virtual_link: Optional[str] = None
+    notes: Optional[str] = None
+    status: Optional[str] = None
+
+class ReservationResponseDTO(ReservationBaseDTO):
+    id: int
+    created_at: Optional[datetime] = None
+
+    class Config:
+        from_attributes = True