Spec de módulo — messaging (schema messaging) - Softcrum Suite

Traducción. Autoritativo: ../../../modules/messaging/spec.md.

Entidades e invariantes

Tabla	Invariantes clave
message_templates	React Email; versionadas; variables validadas contra `attribute_definitions`
campaigns	blast (segmento, una vez) \| automation (disparador permanente); categoría transactional\|marketing\|product
campaign_triggers	evento \| propiedad de fecha (con zona horaria: cumpleaños, aniversario; tz del contacto o del tenant) \| segment_entered \| segment_exited \| points_expiring_soon
sends	`correlation_id` + `origin_event_id` + `channel_code`; se crean solo después de que `resolveChannels` pasa TODAS las compuertas
send_status_history	particionada; estados paramétricos queued→sent→delivered→opened→clicked / bounced / complained / failed; alimentada por adaptadores de estado del proveedor
suppressions	global por tenant; escritura automática ante rebote duro, queja o baja; verificada en CADA envío
sender_domains	flujo de verificación SPF/DKIM por tenant; por defecto subdominio compartido; dominio propio = add-on (DEC-F4)
platform_channel_status / tenant_channel_settings / module_channel_settings / event_channel_routing	niveles 0–3 de la cascada

Reglas de comportamiento

Blasts: solo endpoints batch, carril de marketing, token bucket por tenant; un blast NUNCA degrada la latencia transaccional (ADR-015).
Los disparadores por propiedad de fecha corren con fan-out de cron en la ventana de envío local del tenant; los duplicados son imposibles por la clave de idempotencia (campaña, contacto, fecha).
Enlace de baja obligatorio en marketing; centro de preferencias por canal × categoría; transaccional sin opt-out.

Eventos emitidos

campaign.triggered · message.sent|delivered|opened|clicked|bounced|complained

⌘I