Eventos del sistema
¿Qué son los eventos?
Cuando ocurre algo importante en el sistema (se crea un usuario, alguien acepta una invitación...), el módulo responsable emite un evento interno. Otros módulos pueden reaccionar a ese evento de forma independiente, sin que el módulo original sepa ni le importe quién escucha.
¿Para qué sirve esto?
Evita que los módulos estén acoplados entre sí. Por ejemplo:
- El módulo de Usuarios no sabe nada de emails ni de Jobs. Solo hace su trabajo y emite
"usuario creado". - El módulo de Jobs escucha ese evento y lanza el envío del email de bienvenida.
Si mañana se quiere hacer otra cosa cuando se crea un usuario (por ejemplo, crear un registro de facturación), solo hay que añadir un nuevo listener. El módulo de Usuarios no cambia.
Eventos activos en el sistema
| Evento | Cuándo se emite | Quién reacciona |
|---|---|---|
provider.usage-recorded | Tras uso exitoso de un proveedor resuelto (o degradado) | Observabilidad / facturación futura (este módulo no factura) |
user.created | Al crear un nuevo usuario | Jobs → envía email de bienvenida |
user.invited | Al crear una invitación | Jobs → envía email con enlace |
user.invitation-accepted | Al aceptar una invitación | Jobs → envía email de bienvenida a la empresa |
object-storage.operate-granted | OWNER concede permiso de operación del bucket tenant | Auditoría (log estructurado); sin consumidores de negocio |
object-storage.operate-revoked | OWNER revoca ese permiso (la fila de grant se borra) | Auditoría durable tras el delete de la fila |
Los eventos de Object Storage incluyen environmentId (null para el espacio administrativo histórico o plataforma). Los consumidores RAG filtran por ese scope además de la ruta para no cruzar preview y producción.
Flujo visual
UsersService.create()
│
▼
Emite: "user.created"
│
├──► UserCreatedJobListener → encola SendWelcomeEmailJob
│
└──► (cualquier otro listener futuro)Los listeners son independientes entre sí. Uno puede fallar sin afectar a los demás.