Arquitectura de email · MediNodo

La ruta de un correo, documentada de punta a punta

Cómo una campaña viaja desde listmonk hasta la bandeja de entrada, cómo se rastrean los clicks, se registra el interés y se gestionan rebotes y reclamos.

Comenzar Ver los flujos 
flowchart TB
  subgraph delivery[Entrega del correo]
    direction LR
    L[listmonk] -->|SMTP| S[Amazon SES]
    S -->|Entrega| M[Proveedor de correo]
    M --> U[Destinatario]
  end
  subgraph interest[Registro del interés]
    direction LR
    T[trk.medinodo.com] --> LP[Landing en Vercel]
    LP -->|/api/interest| F[FastAPI]
    F --> DB[(PostgreSQL)]
  end
  U -->|Click| T
Camino feliz: envío → entrega → click → interés

Resumen ejecutivo

MediNodo envía campañas de correo con listmonk, que entrega los mensajes a través de Amazon SES por SMTP autenticado. Cada CTA se reescribe como un enlace individual bajo trk.medinodo.com: al pulsarlo, listmonk registra el click y redirige a la landing en Vercel. Si la persona confirma su interés, FastAPI valida y lo persiste en PostgreSQL. Los rebotes y reclamos llegan por Amazon SNS a un webhook de listmonk, que aplica blocklist. Cloudflare enruta y protege los hostnames públicos; los datos de negocio viven en PostgreSQL.

Panel de la plataforma

Una vista de un vistazo de todo lo que compone el sistema.

Componentes
15

Servicios

8 principales y 7 complementarios que orquestan cada campaña.
Procesos
6

Flujos

Envío, tracking, clicks, interés, bounce y complaint.
Red
5

Dominios

Institucional, landing, tracking, API y MAIL FROM.
Señales
4

Eventos

Click, interés, hard bounce y complaint.
Externas
7

Integraciones

Turnstile, Upstash, Google, Squarespace, Docker, Restic, IAM.
Persistencia
1

Base de datos

PostgreSQL con el esquema propio med_tracking.

Explorar la documentación

Cada sección arranca con un resumen y termina con buenas prácticas y consideraciones.

Arquitectura

Visión general del sistema y matriz de responsabilidades entre componentes.

Tracking

Cómo se registra el click y se redirige con los identificadores opacos.

Landing e interés

El Route Handler /api/interest y la validación previa a FastAPI.

Seguridad

Turnstile, rate limit, Cloudflare Tunnel, blocklist y backups cifrados.

Base de datos

Entidades, relaciones y quién es responsable de cada dato.

FAQ

Respuestas rápidas a las dudas más comunes del sistema.