Saltar al contenido principal

Crear notificación manual (solo admin)

POST 
/notifications

Propósito​

Crear una notificación manual dirigida a un usuario desde contexto administrativo.

Objetivo​

Permitir alertas manuales del sistema cuando no provienen de flujos automáticos (ECMR, pagos, etc.).

Casos de uso​

  • Comunicar incidencias operativas.
  • Enviar avisos administrativos puntuales.
  • Notificar ventanas de mantenimiento.

Detalles técnicos​

  • Ruta protegida por userMiddleware.isLoged.
  • Requiere rol admin en req.company.role; si no, devuelve 403 ADMIN_ACCESS_REQUIRED.
  • Middleware validateNotificationCreation valida type, title, message, recipientType, recipientId.
  • El middleware normaliza el destinatario: recipientType=company_user|trucker_cia + recipientId se mapea automáticamente a company_user o trucker_cia.
  • Middleware rateLimitNotifications aplica máximo 10 creaciones/minuto por usuario (429 RATE_LIMIT_EXCEEDED).
  • El controlador exige además company_user o trucker_cia (uno solo).
  • Respuesta de éxito en envelope tools.returnOK: { status, data, 0 }.

Autenticación​

Requiere JWT (bearerAuth) o API key (apiKeyAuth) con contexto admin válido.

Request​

Responses​

Notificación creada correctamente.