Reglas y políticas

Una política decide quién debe saberlo, cuándo, con qué urgencia y con qué nivel de verificación. En un workspace, es una lista de reglas más algunos ajustes (zona horaria, acción por defecto, horario de silencio y resumen).

Acciones

Acción	Qué pasa
`notify`	La notificación se entrega ahora.
`digest`	El evento entra en un resumen enviado al final de la ventana del resumen.
`suppress`	El evento queda en el historial, pero no se avisa a nadie.
`escalate`	Avisa con prioridad alta y suma los destinatarios extra de la regla.

Una regla

Las reglas se evalúan en el orden de position; gana la primera que coincide. Si ninguna coincide, vale la default_action del workspace.

{
  "name": "dokploy-info-suppressed",
  "enabled": true,
  "position": 30,
  "match": {
    "source": ["dokploy"],
    "type": ["deploy.*"],
    "severity_max": "info"
  },
  "action": "suppress",
  "params": {}
}

Campo de `match`	Significado
`source`	Lista de orígenes.
`type`	Lista de tipos de evento; `deploy.*` coincide con todo tipo `deploy.`.
`severity`, `severity_min`, `severity_max`	Lista exacta o rango de severidades.
`hours`	Franja horaria: `{ "from": "09:00", "to": "18:00", "tz": "America/Sao_Paulo", "days": ["mon", "tue"] }`.

Campo de `params`	Significado
`priority`	`normal` o `high`.
`recipients`	Destinatarios extra (los usa `escalate`).
`channels`	Canales de entrega; hoy `app`.
`bypass_quiet`	`true` para entregar incluso en el horario de silencio.

El nombre de la regla va en minúsculas (^[a-z0-9][a-z0-9_.-]*$) y es único en el workspace.

Horario de silencio y resumen

Los ajustes del workspace definen la zona horaria, la acción por defecto, el horario de silencio y el resumen:

{
  "timezone": "America/Sao_Paulo",
  "default_action": "notify",
  "quiet_hours": { "from": "22:00", "to": "07:00", "days": ["mon", "tue", "wed", "thu", "fri"], "min_severity": "high", "action": "digest" },
  "digest": { "window": "30m", "max_events": 20 }
}

En el horario de silencio, los eventos por debajo de min_severity pasan a un resumen (o se suprimen), salvo que la regla tenga bypass_quiet: true.

De dónde vienen las reglas

Origen	Editable en la app
`api`	Sí: creada en Reglas de app.notific.me, por la API o por un agente vía MCP.
`yaml`	No: se mantiene en un archivo YAML en el repositorio de un servidor propio. Los cambios allí sobrescriben el workspace en el siguiente despliegue.
`default`	No: valores por defecto integrados.

Simula antes de guardar

La pantalla Reglas de app.notific.me tiene un simulador: “¿este evento se notificaría?”. Usa el mismo motor que producción, muestra la decisión (notify, digest, suppress, escalate), el motivo (rule, default o quiet_hours) y qué regla coincidió, y puede probar reglas aún no guardadas. Lo mismo está en POST /v0/workspaces/{handle}/rules/simulate.