Traducción. Autoritativo: fs-core-0012-event-taxonomies.md.
Contexto
Lo más difícil de adoptar una plataforma de engagement no es la integración: es decidir qué enviar. Un schema de eventos en blanco significa que cada tenant inventa su propio vocabulario, de forma inconsistente, y luego sus segmentos y reglas heredan esa inconsistencia para siempre. DEC-H7 hace de las taxonomías datos instalables, nunca código. Eso es lo que permite que el producto aplique a cualquier industria y a la vez dé a cada una un punto de partida, y lo que convierte un vertical nuevo en un ejercicio de contenido y no en un release. La primera es suscripciones y servicios, porque ahí está el design partner (DEC-I6). Las plantillas RFM que acompañan a una taxonomía importan tanto como los nombres de eventos: convierten “ahora recolectamos eventos” en “estos son tus clientes en riesgo” desde el primer día.Alcance (normativo)
core.event_taxonomies: conjuntos nombrados, versionados e instalables.core.event_definitions: nombre de evento, descripción, propiedades esperadas con sus tipos.- Instalación por tenant, aditiva y no destructiva.
- Validación de las propiedades de eventos entrantes contra la definición instalada.
- Plantillas de segmentos RFM preconstruidas por taxonomía.
- La taxonomía de suscripciones y servicios como primer conjunto entregado.
Fuera de alcance (normativo)
- Rechazar eventos que no estén en la taxonomía. La validación advierte; nunca bloquea la ingesta. Una integración que se rompe porque alguien envió un evento no declarado es peor que un schema laxo.
- La UI del asistente de onboarding —
frontend/console. - Taxonomías creadas por un tenant y publicadas a otros. No es un marketplace.
Comportamiento (normativo)
- Una taxonomía es versionada e inmutable una vez publicada. Instalar la versión 2 es un acto explícito, nunca automático, porque puede cambiar lo que la validación espera.
- La instalación es aditiva: agrega las definiciones que el tenant no tiene y nunca sobreescribe una que él haya personalizado.
- Un tenant puede extender una taxonomía instalada con sus propias definiciones, y puede partir en blanco sin ninguna taxonomía.
- La validación de propiedades contra una definición advierte, nunca bloquea. Una discrepancia se muestra en la consola y se registra, y el evento igual se ingiere y sigue siendo utilizable.
- Quitar una definición nunca quita los eventos ya recolectados bajo ella.
- Las plantillas RFM se instalan junto a su taxonomía como definiciones de segmento normales que el tenant puede leer y editar — son un punto de partida, no una caja negra.
- Una taxonomía es dato: agregar un vertical significa agregar filas, y no requiere deploy.
- Los nombres de eventos siguen la convención de la plataforma sin importar el origen: minúsculas, snake_case, tiempo pasado cuando describen algo que ocurrió.
Datos (normativo)
API (normativo)
Eventos (normativo)
Ninguno. La instalación es administrativa y queda cubierta por la auditoría.Criterios de aceptación (normativo)
- Instalar la taxonomía de suscripciones y servicios crea sus definiciones y sus plantillas de segmento RFM en una sola operación.
- Reinstalar es idempotente y no sobreescribe una definición personalizada por el tenant.
- Un evento cuyas propiedades no calzan con su definición igual se ingiere, y la discrepancia queda registrada y visible.
- Un tenant puede operar sin ninguna taxonomía instalada y definir eventos por su cuenta.
- Quitar una definición deja consultables los eventos históricos.
- Agregar una taxonomía vertical nueva requiere solo filas — probado agregando una en un test sin cambio de código.
- Negativo: la instalación nunca borra ni sobreescribe una definición existente del tenant.