100 Días de Código en Python — Día 40: Proyecto Final (parte 2) — el Club de Vuelos

📝 Contenido original del curso#

Crear el formulario (Google Forms):

1. En Google Drive, crear un formulario nuevo.
2. Desactivar la recolección automática de correos y no limitar a una respuesta por persona (facilita las pruebas con datos ficticios).
3. Agregar 3 preguntas: nombre, apellido y correo.
4. Vincular el formulario con la hoja de ofertas de vuelos que ya existe.
5. Renombrar la hoja de respuestas a users.
6. Probar: enviar datos ficticios, copiar el enlace y abrirlo en una ventana de incógnito para enviar más respuestas. Deben aparecer en la hoja.

Configurar Sheety:

1. Sincronizar el proyecto: la hoja users debe aparecer debajo de prices (puede que haya que volver a iniciar sesión).
2. Habilitar GET (y POST y PUT) para el endpoint users.

📖 Del formulario a las claves de la API#

Sheety convierte los títulos de las columnas en claves camelCase (Día 38). Si tu pregunta del formulario dice "What is your email?", la clave será whatIsYourEmail? (así aparece en la solución del curso). Por eso el curso pide anotar el nombre exacto de la columna.

🏫 Para el aula#

• Si se usa Google Forms, que sea la cuenta del docente y con respuestas ficticias.
• Un formulario real debe incluir una casilla de autorización de tratamiento de datos y explicar para qué se usarán.

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: redacta el texto de autorización de datos que pondrías al inicio del formulario (máximo 4 líneas).
• 🟡 Reto 2: inscripción por texto (como en el video de objetivos): una función que pida nombre, apellido y correo por consola, pida el correo dos veces y solo continúe si coinciden.
• 🟠 Reto 3: guarda la inscripción del Reto 2 en users.csv (modo aula) o con un POST a Sheety (modo real), con la clave raíz en singular: {"user": {...}}.
• 🔴 Reto 4: valida que el correo tenga una forma razonable (un @, un punto después del @, sin espacios) y que no esté ya inscrito.

📝 Contenido original del curso#

El proyecto inicial de hoy es idéntico al proyecto terminado del Día 39. Puedes usar el tuyo, siempre que:

• lea los destinos de la hoja;
• busque vuelos para cada destino;
• imprima el precio más barato de cada ciudad;
• envíe una notificación si encuentra un precio menor.

El .env debe contener: SERPAPI_API_KEY, SHEETY_PRICES_ENDPOINT, SHEETY_USERNAME, SHEETY_PASSWORD y los datos de Twilio (TWILIO_SID, TWILIO_AUTH_TOKEN, TWILIO_VIRTUAL_NUMBER, TWILIO_VERIFIED_NUMBER, TWILIO_WHATSAPP_NUMBER).

Las tres mejoras de hoy: vuelos con escalas cuando no hay directos, lista de correos de clientes y envío de correos a todos.

💡 Reflexión: que el proyecto inicial de la parte 2 sea el final de la parte 1 muestra por qué valió la pena separar responsabilidades: cada mejora de hoy toca pocas clases.

🎯 Objetivo de aprendizaje#

Usar un parámetro con valor por defecto para cambiar el comportamiento de un método, y programar una búsqueda de respaldo.

📝 Ejercicio original del curso#

Muchos destinos populares no tienen vuelos directos (de Londres a Bali, por ejemplo, hay que hacer escala en Singapur). El programa debe:

1. Buscar primero solo vuelos directos.
2. Si no encuentra ninguno, buscar de nuevo permitiendo escalas.
3. Guardar el número de escalas (stops) para mostrarlo en la notificación.

Especificación del curso:

• check_flights(..., is_direct=True): un parámetro nuevo con valor por defecto True.
• En FlightData.__init__, un atributo nuevo stops.
• Cada opción de vuelo trae una lista flights con los tramos: un vuelo directo tiene 1 tramo; con una escala, 2. Por eso: nr_stops = len(flight["flights"]) - 1.
• En main.py: si cheapest_flight.price == "N/A", buscar otra vez con is_direct=False e imprimir un aviso.

📖 El parámetro stops de SerpAPI#

Según la documentación oficial de SerpAPI (verificada), stops no es "el número de escalas", sino una opción de filtro:

Es contraintuitivo: "stops": "1" significa "sin escalas". Otra razón para leer siempre la documentación en lugar de adivinar por el nombre.

🔎 La solución del curso#

flight_search.py:

    def check_flights(self, origin_city_code, destination_city_code, from_time, to_time, is_direct=True):
        query = {
            "engine": "google_flights",
            # ... los mismos parámetros del Día 39 ...
            "api_key": self._api_key,
        }
        if is_direct:
            query["stops"] = "1"     # solo vuelos directos
        # ... petición y manejo de errores iguales ...

flight_data.py: se agrega stops a FlightData y, en find_cheapest_flight, nr_stops = len(flight["flights"]) - 1 para el primer vuelo y para cada vuelo más barato.

main.py:

for destination in sheet_data:
    print(f"Getting direct flights for {destination['city']}...")
    flights = flight_search.check_flights(
        ORIGIN_CITY_IATA, destination["iataCode"],
        from_time=tomorrow, to_time=six_month_from_today
    )
    cheapest_flight = find_cheapest_flight(flights, return_date=six_month_from_today.strftime("%Y-%m-%d"))

    if cheapest_flight.price == "N/A":
        print(f"No direct flight to {destination['city']}. Looking for indirect flights...")
        stopover_flights = flight_search.check_flights(
            ORIGIN_CITY_IATA, destination["iataCode"],
            from_time=tomorrow, to_time=six_month_from_today,
            is_direct=False
        )
        cheapest_flight = find_cheapest_flight(stopover_flights, return_date=six_month_from_today.strftime("%Y-%m-%d"))

• Como is_direct vale True por defecto, las llamadas antiguas siguen funcionando sin cambios.
• La segunda búsqueda no envía stops, así que acepta cualquier número de escalas.

⚠️ Errores frecuentes#

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: con el flights.json de ejemplo del Día 39, imprime cuántas escalas tiene cada opción.
• 🟡 Reto 2: ¿cuántas búsquedas de SerpAPI gasta ahora una ejecución con 3 destinos en el peor caso? ¿Y en el mejor?
• 🟠 Reto 3: agrega a la hoja una columna "acepta escalas" (sí/no) por destino, y haz la segunda búsqueda solo si el destino lo permite.
• 🔴 Reto 4: en lugar de is_direct (verdadero/falso), usa un parámetro max_stops (0, 1 o 2) y conviértelo al valor correcto de stops según la tabla de la documentación.

📝 Ejercicio original del curso#

Objetivo: obtener los correos de la hoja users como una lista de Python en main.py.

Requisitos técnicos:

• Agregar al .env los endpoints de prices y de users.
• Crear DataManager.get_customer_emails(), que devuelva los datos de la hoja users.
• Leer todas las variables de entorno en un solo lugar: __init__.

🔎 La solución del curso#

class DataManager:

    def __init__(self):
        self._user = os.environ["SHEETY_USERNAME"]
        self._password = os.environ["SHEETY_PASSWORD"]
        self._authorization = HTTPBasicAuth(self._user, self._password)
        self.users_endpoint = os.environ["SHEETY_USERS_ENDPOINT"]
        self.destination_data = {}
        self.customer_data = {}

    def get_customer_emails(self):
        response = requests.get(url=self.users_endpoint, auth=self._authorization)
        data = response.json()
        self.customer_data = data["users"]
        return self.customer_data

Y en main.py, una comprensión de listas extrae solo los correos:

customer_data = data_manager.get_customer_emails()
customer_email_list = [row["whatIsYourEmail?"] for row in customer_data]

El curso advierte: el nombre de la columna depende de tu formulario; el tuyo puede ser distinto.

🛠️ Nota técnica: la solución publicada de este paso incluye en main.py la línea data_manager.update_destination_codes(), un método que no existe en el DataManager de esa misma solución: si la copias tal cual, obtendrás AttributeError: 'DataManager' object has no attribute 'update_destination_codes'. Su .env también trae AMADEUS_API_KEY y AMADEUS_SECRET. Son restos de una versión anterior del proyecto, que usaba la API de vuelos Amadeus en lugar de SerpAPI. Elimínalos. Moraleja: el código de las soluciones también se desactualiza; léelo antes de copiarlo.

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: en modo aula, lee users.csv con pandas y obtén la misma lista con una comprensión.
• 🟡 Reto 2: elimina correos duplicados y vacíos de la lista, conservando el orden.
• 🟠 Reto 3: en vez de una lista de correos, crea una lista de diccionarios {"nombre": ..., "correo": ...} para poder saludar a cada persona por su nombre.
• 🔴 Reto 4: agrega una columna activo (sí/no) y envía solo a los activos. Así implementas la baja de un usuario sin borrar su fila.

📝 Ejercicio original del curso#

Objetivo: enviar a todos los usuarios de la hoja un correo con la oferta.

Requisitos técnicos:

1. Agregar al .env la dirección SMTP, el correo y la contraseña de aplicación (Día 32).
2. En NotificationManager.__init__, leer todas las variables de entorno en un solo lugar.
3. Crear el método send_emails().
4. En main.py, redactar un mensaje distinto según si el vuelo es directo o tiene escalas.

Advertencia del curso: el símbolo £ produce un UnicodeEncodeError. Soluciones: escribir "GBP" en lugar del símbolo, o codificar el mensaje en UTF-8.

🔎 La solución del curso#

class NotificationManager:

    def __init__(self):
        self.smtp_address = os.environ["EMAIL_PROVIDER_SMTP_ADDRESS"]
        self.email = os.environ["MY_EMAIL"]
        self.email_password = os.environ["MY_EMAIL_PASSWORD"]
        # ... variables de Twilio ...
        self.client = Client(os.environ["TWILIO_SID"], os.environ["TWILIO_AUTH_TOKEN"])
        self.connection = smtplib.SMTP(os.environ["EMAIL_PROVIDER_SMTP_ADDRESS"])

    def send_emails(self, email_list, email_body):
        with self.connection:
            self.connection.starttls()
            self.connection.login(self.email, self.email_password)
            for email in email_list:
                self.connection.sendmail(
                    from_addr=self.email,
                    to_addrs=email,
                    msg=f"Subject:New Low Price Flight!\n\n{email_body}".encode("utf-8")
                )

El mensaje según las escalas (main.py):

if cheapest_flight.stops == 0:
    message = (f"Low price alert! Only GBP {cheapest_flight.price} to fly direct "
               f"from {cheapest_flight.origin_airport} to {cheapest_flight.destination_airport}, "
               f"on {cheapest_flight.out_date} until {cheapest_flight.return_date}.")
else:
    message = (f"Low price alert! Only GBP {cheapest_flight.price} to fly "
               f"from {cheapest_flight.origin_airport} to {cheapest_flight.destination_airport}, "
               f"with {cheapest_flight.stops} stop(s) "
               f"departing on {cheapest_flight.out_date} and returning on {cheapest_flight.return_date}.")

notification_manager.send_emails(email_list=customer_email_list, email_body=message)

• .encode("utf-8") convierte el mensaje en bytes; sendmail acepta bytes sin intentar convertirlos a ASCII. Es la solución del curso al problema que viste en el Día 32 con la ñ.
• Se envía un correo por persona (un sendmail por dirección). Así ningún cliente ve los correos de los demás. Poner a todos juntos en el campo "Para" revelaría la lista completa.

📖 Dos problemas del NotificationManager (análisis de esta adaptación)#

Se probó la clase de la solución contra el servidor local del Día 32 (verificado):

1. La conexión se usa una sola vez. La conexión se crea en __init__, pero send_emails la usa dentro de with self.connection:, que la cierra al terminar. La primera llamada funciona; la segunda falla con SMTPServerDisconnected: please run connect() first. En main.py, send_emails se llama dentro del for de destinos: si en una ejecución hay ofertas para dos destinos, los clientes no reciben la segunda. Solución: crear la conexión dentro de send_emails: with smtplib.SMTP(self.smtp_address, port=587) as connection:.
2. Falta el puerto. smtplib.SMTP(dirección) sin puerto usa el 25 (verificado: smtplib.SMTP_PORT es 25). La lección 244 del Día 32 explicaba que la mayoría de servidores lo bloquean y que se debe usar 587.

Además, .encode("utf-8") evita el error, pero el correo no declara que está en UTF-8, así que algunos programas de correo podrían mostrar mal los símbolos. La alternativa del Día 32, EmailMessage con send_message, declara la codificación correctamente.

⚠️ Errores frecuentes#

Retos adicionales (creados para esta adaptación)#

• 🟢 Reto 1: en modo aula, reescribe send_emails para el servidor local (sin starttls ni login) y envía a 3 correos ficticios.
• 🟡 Reto 2: corrige el problema de la conexión y demuestra, con el servidor local, que dos llamadas seguidas funcionan.
• 🟠 Reto 3: reescribe el envío con EmailMessage, un saludo con el nombre de cada persona y el precio en pesos colombianos con separador de miles.
• 🔴 Reto 4: agrega al final de cada correo una línea "Para dejar de recibir estos correos, responde BAJA". Explica qué tendría que hacer el programa para procesar esas respuestas (no hace falta implementarlo).

Problema#

Convertir el buscador personal de ofertas en un servicio que envía las ofertas a todos los inscritos.

Requisitos funcionales#

1. Inscripción de usuarios (Google Forms en modo real; consola o Tkinter con users.csv en modo aula).
2. Búsqueda de vuelos directos y, si no hay, con escalas.
3. Si hay oferta, un mensaje distinto para vuelos directos y con escalas.
4. Un correo por persona, a todos los usuarios activos.

Restricciones técnicas#

Arquitectura de cuatro clases del Día 39; todos los secretos en .env; EmailMessage o .encode("utf-8"); puerto 587 (o el servidor local en modo aula).

Pruebas#

🧪 Prueba y depuración#

1. Dos ofertas, un solo correo. Con el NotificationManager de la solución, la segunda llamada a send_emails falla (sección 5). Reprodúcelo con el servidor local y dos ofertas simuladas, y corrígelo.
2. Duplicados. Si alguien se inscribió dos veces, recibe dos correos. Elimina duplicados antes de enviar.
3. Un correo por oferta o un resumen. Con 3 ofertas y 50 usuarios, la solución envía 150 correos. Propón enviar un solo correo por usuario con todas las ofertas del día. ¿Qué cambias en main.py y en NotificationManager?
4. El AttributeError heredado. Si copiaste la solución del paso 4, revisa que no quede update_destination_codes() ni variables de Amadeus.

⭐ Extensión del proyecto#

• Cada usuario elige desde qué ciudad sale (columna nueva) y recibe solo las ofertas desde su ciudad.
• Página de inscripción con Tkinter (Días 27 a 31).
• Programación diaria con GitHub Actions y los secretos del .env como secretos del repositorio.

Situación#

La orientadora escolar recibe muchas convocatorias (becas, olimpiadas académicas, cursos gratuitos, concursos) y no sabe a quién le interesa cada una. Quiere un servicio donde cada estudiante se inscriba con sus intereses y reciba solo las convocatorias que le correspondan.

Requisitos#

1. Inscripción por consola o Tkinter: nombre, correo (ficticio), grado e intereses (elegidos de una lista: ciencias, arte, deporte, tecnología, idiomas…), con autorización de datos obligatoria.
2. inscritos.csv y convocatorias.csv (título, categoría, grado mínimo, fecha límite, enlace), con al menos 8 convocatorias ficticias.
3. Clases con responsabilidades separadas, como en el Club de Vuelos: GestorDatos, Convocatoria, Buscador (qué convocatorias le sirven a cada inscrito) y Notificador.
4. Cada inscrito recibe un solo correo con sus convocatorias vigentes (fecha límite posterior a hoy y grado adecuado), ordenadas por fecha límite.
5. Las convocatorias que vencen en menos de 7 días aparecen marcadas como "¡Última semana!".
6. Opción de baja (marcar como inactivo).
7. Envío al servidor local, con EmailMessage y la conexión abierta dentro del método de envío.
8. Registro en envios.csv para no enviar dos veces la misma convocatoria a la misma persona.

Decisiones que debes tomar#

• ¿Cada cuánto se envía el boletín? ¿Qué pasa si un estudiante no tiene convocatorias nuevas?
• ¿Cómo evitas que el correo sea tan largo que nadie lo lea?

Casos de prueba#

Situación problema#

El colegio quiere una plataforma de alertas a la que cada miembro de la comunidad (estudiantes, docentes, acudientes; todos ficticios en el ejercicio) se inscriba para recibir solo las alertas que le interesan: lluvia antes de la jornada, cambio fuerte de la TRM, paso visible de la ISS, pregunta de trivia del día y recordatorios de tareas.

Pregunta orientadora#

¿Cómo diseñar un servicio automatizado, seguro y respetuoso de los datos personales, que combine varias fuentes de datos y entregue a cada persona solo lo que eligió recibir?

Objetivo#

Construir la Plataforma de Alertas del Colegio: inscripción, fuentes de datos, reglas de alerta y envío diario personalizado.

Requerimientos#

1. Inscripción (consola o Tkinter) con: nombre, correo ficticio, rol, alertas elegidas y autorización de datos. Opción de baja.
2. Almacenamiento intercambiable (CSV local o Sheety con autenticación Bearer), elegido en config.json.
3. Fuentes (una clase por fuente, con la misma interfaz): Open-Meteo (lluvia), TRM (datos.gov.co), ISS y horas de sol, Open Trivia DB y un tareas.csv.
4. Reglas configurables en config.json (umbrales de lluvia y TRM, distancia de la ISS, etc.).
5. Un correo por persona y por día, con EmailMessage, solo con las alertas que eligió; las urgentes, al principio.
6. Caché con tiempos distintos por fuente (urls_expire_after) y reintentos con límite ante errores temporales.
7. Secretos en .env con .gitignore; el programa verifica al iniciar que existan los necesarios.
8. Registro de envíos para no repetir alertas; registro de fallas de cada fuente.
9. Programación: expresión cron para las 5:30 a. m. de Colombia y explicación de la hora UTC.
10. Documento de privacidad de una página: qué datos se recogen, para qué, dónde se guardan, cómo darse de baja y cómo se relaciona con la Ley 1581 de 2012.

Restricciones#

• Solo datos ficticios y el servidor de correo local.
• Ninguna fuente que exija cuentas personales de estudiantes.
• La lógica de reglas se prueba con datos simulados, sin internet.

Etapas de desarrollo#

Entregables#

• Código organizado en paquetes o módulos, config.json, .env.ejemplo (sin valores reales) y .gitignore.
• Diagrama de clases y documento de privacidad.
• Al menos 15 casos de prueba con resultados.
• Registro de errores con al menos 8 errores reales y su solución.
• Video corto de la demostración.

Casos de prueba mínimos#

Criterios técnicos de funcionamiento#

• Cada clase tiene una sola responsabilidad; main.py solo coordina.
• Ninguna URL, clave ni umbral está escrito dentro de las funciones de lógica.
• El programa termina en menos de 1 minuto aunque todas las fuentes fallen.

Posibles extensiones#

Panel Tkinter para la administración; estadísticas mensuales de alertas enviadas; análisis de datos de las lecturas con pandas y gráficas (se estudian en la parte avanzada del curso).

Conceptuales#

1. ¿Qué diferencia hay entre el proyecto del Día 39 y el del Día 40, desde el punto de vista del usuario?
2. ¿Por qué el parámetro is_direct=True no rompe las llamadas que ya existían?
3. ¿Qué significa "stops": "1" en SerpAPI? ¿Por qué es fácil equivocarse?
4. ¿Por qué se envía un correo por persona en lugar de uno con todos en el campo "Para"?
5. ¿Qué exige la Ley 1581 de 2012 para recoger correos de otras personas?

Análisis de código#

customer_email_list = [row["whatIsYourEmail?"] for row in customer_data]

¿De dónde sale el nombre whatIsYourEmail?? ¿Qué pasa si cambias el texto de la pregunta en el formulario?

Predicción#

1. Un vuelo con flights de 3 tramos, ¿cuántas escalas tiene?
2. ```python conexion = smtplib.SMTP("localhost", 8025) with conexion: conexion.sendmail(...) with conexion: conexion.sendmail(...)

   ¿Qué ocurre en el segundo `sendmail`?
3. ¿Qué puerto usa `smtplib.SMTP("smtp.gmail.com")`?

### Depuración

python class NotificationManager: def init(self): self.connection = smtplib.SMTP(os.environ["SMTP"]) def send_emails(self, email_list, body): with self.connection: self.connection.starttls() self.connection.login(os.environ["EMAIL"], os.environ["PASSWORD"]) self.connection.sendmail(os.environ["EMAIL"], email_list, f"Subject:Oferta £\n\n{body}") `` Encuentra **cuatro** problemas (piensa en el puerto, en elwith`, en el símbolo £ y en la privacidad de los destinatarios).

Modificación#

Cambia el mensaje para que diga "vuelo directo", "1 escala" o "2 escalas" en español, según stops, con una sola línea que use un diccionario.

Creación#

Escribe correos_para_enviar(usuarios: list[dict]) -> list[str] que devuelva los correos únicos de los usuarios activos, sin espacios sobrantes y en minúsculas. Pruébala con 6 usuarios simulados, incluidos duplicados y un inactivo.