docs: Translate comments and logging messages to Spanish across various modules and the scheduler.

app/calendar.py

@@ -1,4 +1,6 @@
 # app/calendar.py
+# Este script maneja la integración con Google Calendar (Calendario de Google).
+# Permite buscar espacios libres y crear eventos.
 
 import datetime
 from google.oauth2 import service_account
@@ -6,11 +8,15 @@ from googleapiclient.discovery import build
 from googleapiclient.errors import HttpError
 from config import GOOGLE_SERVICE_ACCOUNT_FILE, CALENDAR_ID
 
-# Set up the Calendar API
+# Configuración de los permisos (SCOPES) para acceder al calendario
 SCOPES = ["https://www.googleapis.com/auth/calendar"]
+
+# Autenticación usando el archivo de cuenta de servicio (Service Account)
 creds = service_account.Credentials.from_service_account_file(
     GOOGLE_SERVICE_ACCOUNT_FILE, scopes=SCOPES
 )
+
+# Construcción del objeto 'service' que nos permite interactuar con la API de Google Calendar
 service = build("calendar", "v3", credentials=creds)
 
 
@@ -18,12 +24,20 @@ def get_available_slots(
     start_time, end_time, duration_minutes=30, calendar_id=CALENDAR_ID
 ):
     """
-    Fetches available calendar slots within a given time range.
+    Busca espacios disponibles en el calendario dentro de un rango de tiempo.
+    
+    Parámetros:
+    - start_time: Hora de inicio de la búsqueda.
+    - end_time: Hora de fin de la búsqueda.
+    - duration_minutes: Cuánto dura cada cita (por defecto 30 min).
+    - calendar_id: El ID del calendario donde buscar.
     """
     try:
+        # Convertimos las fechas a formato ISO (el que entiende Google)
         time_min = start_time.isoformat()
         time_max = end_time.isoformat()
 
+        # Consultamos a Google qué horas están ocupadas (freebusy)
         freebusy_query = {
             "timeMin": time_min,
             "timeMax": time_max,
@@ -34,7 +48,7 @@ def get_available_slots(
         freebusy_result = service.freebusy().query(body=freebusy_query).execute()
         busy_slots = freebusy_result["calendars"][calendar_id]["busy"]
 
-        # Create a list of all potential slots
+        # Creamos una lista de todos los posibles espacios (slots)
         potential_slots = []
         current_time = start_time
         while current_time + datetime.timedelta(minutes=duration_minutes) <= end_time:
@@ -44,15 +58,17 @@ def get_available_slots(
                     current_time + datetime.timedelta(minutes=duration_minutes),
                 )
             )
+            # Avanzamos el tiempo para el siguiente espacio
             current_time += datetime.timedelta(minutes=duration_minutes)
 
-        # Filter out busy slots
+        # Filtramos los espacios que chocan con horas ocupadas
         available_slots = []
         for slot_start, slot_end in potential_slots:
             is_busy = False
             for busy in busy_slots:
                 busy_start = datetime.datetime.fromisoformat(busy["start"])
                 busy_end = datetime.datetime.fromisoformat(busy["end"])
+                # Si el espacio propuesto se cruza con uno ocupado, lo marcamos como ocupado
                 if max(slot_start, busy_start) < min(slot_end, busy_end):
                     is_busy = True
                     break
@@ -61,14 +77,21 @@ def get_available_slots(
 
         return available_slots
     except HttpError as error:
-        print(f"An error occurred: {error}")
+        print(f"Ocurrió un error con la API de Google: {error}")
         return []
 
 
 def create_event(summary, start_time, end_time, attendees, calendar_id=CALENDAR_ID):
     """
-    Creates a new event in the calendar.
+    Crea un nuevo evento (cita) en el calendario.
+    
+    Parámetros:
+    - summary: Título del evento.
+    - start_time: Hora de inicio.
+    - end_time: Hora de fin.
+    - attendees: Lista de correos electrónicos de los asistentes.
     """
+    # Definimos la estructura del evento según pide Google
     event = {
         "summary": summary,
         "start": {
@@ -82,10 +105,11 @@ def create_event(summary, start_time, end_time, attendees, calendar_id=CALENDAR_
         "attendees": [{"email": email} for email in attendees],
     }
     try:
+        # Insertamos el evento en el calendario
         created_event = (
             service.events().insert(calendarId=calendar_id, body=event).execute()
         )
         return created_event
     except HttpError as error:
-        print(f"An error occurred: {error}")
+        print(f"Ocurrió un error al crear el evento: {error}")
         return None