"""
app/utils/mailer.py – Envío de correos electrónicos con Flask-Mail.
Se usa principalmente al liberar un cambio a producción.
"""
import logging
from io import BytesIO
from flask import current_app, render_template_string
from flask_mail import Message
from app import mail
logger = logging.getLogger(__name__)
# Plantilla HTML del correo de liberación
PLANTILLA_LIBERACION = """
Cambio Liberado
Control de Cambios – Notificación de Liberación
Se informa que el cambio #{{ cambio.id }} ha sido liberado a producción.
Datos de la Solicitud
| Sistema: |
{{ cambio.sistema.nombre }} |
| Solicitante: |
{{ cambio.solicitante.nombre_completo }} ({{ cambio.solicitante.correo }}) |
| Núm. Incidencia: |
{{ cambio.numero_incidencia }} |
| Descripción Breve: |
{{ cambio.descripcion_breve }} |
| Fecha de Pruebas: |
{{ cambio.fecha_pruebas.strftime('%d/%m/%Y') }} |
Datos Técnicos
| Desarrollador: |
{{ cambio.desarrollador.nombre_completo if cambio.desarrollador else '-' }} |
| Descripción Técnica: |
{{ cambio.descripcion_tecnica or '-' }} |
| Fecha Propuesta Producción: |
{{ cambio.fecha_propuesta_produccion.strftime('%d/%m/%Y') if cambio.fecha_propuesta_produccion else '-' }} |
Datos de Liberación
| Fecha Real de Aplicación: |
{{ cambio.fecha_real_aplicacion.strftime('%d/%m/%Y') if cambio.fecha_real_aplicacion else '-' }} |
| Usuario que Validó: |
{{ cambio.usuario_valido.nombre_completo if cambio.usuario_valido else '-' }} |
| Estado del Cambio: |
{{ cambio.estado_cambio or '-' }} |
| Observaciones: |
{{ cambio.observaciones or '-' }} |
| Administrador que Liberó: |
{{ cambio.admin_libero.nombre_completo if cambio.admin_libero else '-' }} |
Estatus final: LIBERADO
Se adjunta el PDF completo del registro de cambio.
Sistema de Control de Cambios Empresariales – Mensaje generado automáticamente.
"""
def enviar_correo_liberacion(cambio, pdf_buffer: BytesIO):
"""
Envía el correo de notificación de liberación a producción.
Incluye el PDF adjunto generado con ReportLab.
Destinatarios: solicitante, desarrollador y administrador que liberó.
Retorna (True, destinatarios_str) o (False, motivo_str).
"""
try:
destinatarios = []
# Solicitante
if cambio.solicitante and cambio.solicitante.correo:
destinatarios.append(cambio.solicitante.correo)
# Desarrollador (puede ser None)
if cambio.desarrollador and cambio.desarrollador.correo:
if cambio.desarrollador.correo not in destinatarios:
destinatarios.append(cambio.desarrollador.correo)
# Administrador que liberó
if cambio.admin_libero and cambio.admin_libero.correo:
if cambio.admin_libero.correo not in destinatarios:
destinatarios.append(cambio.admin_libero.correo)
if not destinatarios:
motivo = 'ningún usuario involucrado tiene correo registrado en el sistema'
logger.warning('Cambio #%s: sin destinatarios de correo.', cambio.id)
return False, motivo
asunto = (
f'[Control de Cambios] Cambio #{cambio.id} liberado a producción'
f' – {cambio.sistema.nombre}'
)
cuerpo_html = render_template_string(PLANTILLA_LIBERACION, cambio=cambio)
msg = Message(
subject=asunto,
recipients=destinatarios,
html=cuerpo_html,
)
# Adjuntar PDF
pdf_buffer.seek(0)
nombre_pdf = f'Cambio_{cambio.id}.pdf'
msg.attach(nombre_pdf, 'application/pdf', pdf_buffer.read())
mail.send(msg)
lista = ', '.join(destinatarios)
logger.info('Correo de liberación enviado para cambio #%s a: %s',
cambio.id, lista)
return True, lista
except Exception as exc:
logger.error('Error al enviar correo para cambio #%s: %s', cambio.id, exc)
return False, str(exc)