Skip to content

Database governance built for humans and agents — controlling changes and access across every major database.

docs(frontend): clarify custom approval rule matching (#20254)

p0ny40b23fcf8184
diff --git a/frontend/src/locales/en-US.json b/frontend/src/locales/en-US.json
index c3313648cb..f6beabf66f 100644
--- a/frontend/src/locales/en-US.json
+++ b/frontend/src/locales/en-US.json
@@ -456,7 +456,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "Fallback Rules",
- "fallback-rules-hint": "Fallback rules are evaluated only when no other rules match.",
+ "fallback-rules-hint": "Fallback rules are evaluated from top to bottom only when no source-specific rule matches.",
"node": {
"add": "Add node",
"approver": "Approver",
@@ -527,6 +527,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "Rules are evaluated in order. Source-specific rules run before Fallback Rules.",
+ "multi-target": "For a multi-target plan, a source-specific rule matches the whole plan if any target matches its condition, and the first matching rule selects the approval flow for the whole plan.",
+ "priority": "Place rules for higher risk changes before those for lower-risk changes. For similar risks, place stricter or more specific rules before broader rules."
+ },
"first-match-wins": "Rules are evaluated in order. First matching rule applies.",
"self": "Custom Approval Rule"
},
diff --git a/frontend/src/locales/es-ES.json b/frontend/src/locales/es-ES.json
index 8a6a3064b2..b361a8184b 100644
--- a/frontend/src/locales/es-ES.json
+++ b/frontend/src/locales/es-ES.json
@@ -456,7 +456,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "Reglas de respaldo",
- "fallback-rules-hint": "Las reglas de respaldo solo se evalúan cuando ninguna otra regla coincide.",
+ "fallback-rules-hint": "Las reglas de respaldo se evalúan de arriba abajo solo cuando ninguna regla específica de origen coincide.",
"node": {
"add": "Agregar nodo",
"approver": "Aprobador",
@@ -527,6 +527,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "Las reglas se evalúan en orden. Las reglas específicas de origen se ejecutan antes que las Reglas de respaldo.",
+ "multi-target": "En un plan con varios destinos, una regla específica de origen coincide con todo el plan si cualquier destino cumple su condición, y la primera regla coincidente selecciona el flujo de aprobación para todo el plan.",
+ "priority": "Coloca las reglas para cambios de mayor riesgo antes que las de menor riesgo. Para riesgos similares, coloca las reglas más estrictas o específicas antes de las más amplias."
+ },
"first-match-wins": "Las reglas se evalúan en orden. Se aplica la primera regla coincidente.",
"self": "Regla de aprobación personalizada"
},
diff --git a/frontend/src/locales/ja-JP.json b/frontend/src/locales/ja-JP.json
index 1efc035080..372033c12f 100644
--- a/frontend/src/locales/ja-JP.json
+++ b/frontend/src/locales/ja-JP.json
@@ -456,7 +456,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "フォールバックルール",
- "fallback-rules-hint": "フォールバックルールは、他のルールが一致しない場合にのみ評価されます。",
+ "fallback-rules-hint": "フォールバックルールは、ソース固有のルールが一致しない場合にのみ、上から順に評価されます。",
"node": {
"add": "ノードの追加",
"approver": "承認者",
@@ -527,6 +527,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "ルールは順番に評価されます。ソース固有のルールはフォールバックルールより先に実行されます。",
+ "multi-target": "複数ターゲットのプランでは、いずれかのターゲットがソース固有ルールの条件に一致すると、そのルールはプラン全体に一致し、最初に一致したルールがプラン全体の承認フローを決定します。",
+ "priority": "リスクが高い変更のルールを、リスクが低い変更のルールより上に配置してください。同程度のリスクでは、より厳格または具体的なルールを、より広いルールより上に配置してください。"
+ },
"first-match-wins": "ルールは順番に評価されます。最初に一致するルールが適用されます。",
"self": "カスタム承認ルール"
},
diff --git a/frontend/src/locales/vi-VN.json b/frontend/src/locales/vi-VN.json
index 8fedeabd85..8e3df9428f 100644
--- a/frontend/src/locales/vi-VN.json
+++ b/frontend/src/locales/vi-VN.json
@@ -456,7 +456,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "Quy tắc dự phòng",
- "fallback-rules-hint": "Quy tắc dự phòng chỉ được đánh giá khi không có quy tắc nào khác khớp.",
+ "fallback-rules-hint": "Quy tắc dự phòng được đánh giá từ trên xuống dưới chỉ khi không có quy tắc theo nguồn nào khớp.",
"node": {
"add": "Thêm nút",
"approver": "Người phê duyệt",
@@ -527,6 +527,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "Các quy tắc được đánh giá theo thứ tự. Quy tắc theo nguồn chạy trước Quy tắc dự phòng.",
+ "multi-target": "Với kế hoạch có nhiều mục tiêu, một quy tắc theo nguồn khớp với toàn bộ kế hoạch nếu bất kỳ mục tiêu nào khớp với điều kiện của quy tắc đó, và quy tắc khớp đầu tiên sẽ chọn luồng phê duyệt cho toàn bộ kế hoạch.",
+ "priority": "Đặt các quy tắc cho thay đổi có rủi ro cao hơn trước các quy tắc cho thay đổi có rủi ro thấp hơn. Với các rủi ro tương tự, đặt các quy tắc chặt chẽ hơn hoặc cụ thể hơn trước các quy tắc rộng hơn."
+ },
"first-match-wins": "Các quy tắc được đánh giá theo thứ tự. Quy tắc phù hợp đầu tiên sẽ được áp dụng.",
"self": "Quy tắc phê duyệt tùy chỉnh"
},
diff --git a/frontend/src/locales/zh-CN.json b/frontend/src/locales/zh-CN.json
index 0739202110..dfe43d52f1 100644
--- a/frontend/src/locales/zh-CN.json
+++ b/frontend/src/locales/zh-CN.json
@@ -456,7 +456,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "兜底规则",
- "fallback-rules-hint": "兜底规则仅在没有其他规则匹配时才会被评估。",
+ "fallback-rules-hint": "兜底规则仅在没有来源特定规则匹配时,才会按从上到下的顺序评估。",
"node": {
"add": "增加节点",
"approver": "审批人",
@@ -527,6 +527,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "规则按顺序评估。来源特定规则会先于兜底规则执行。",
+ "multi-target": "对于包含多个目标的计划,只要任一目标满足来源特定规则的条件,该规则就会匹配整个计划,且第一个匹配的规则会决定整个计划的审批流。",
+ "priority": "请将更高风险变更的规则放在较低风险变更的规则之前。对于相似风险,请将更严格或更具体的规则放在更宽泛的规则之前。"
+ },
"first-match-wins": "规则按顺序评估,第一个匹配的规则将被应用。",
"self": "自定义审批规则"
},
diff --git a/frontend/src/react/locales/en-US.json b/frontend/src/react/locales/en-US.json
index 286e040b46..5459bc2a88 100644
--- a/frontend/src/react/locales/en-US.json
+++ b/frontend/src/react/locales/en-US.json
@@ -533,7 +533,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "Fallback Rules",
- "fallback-rules-hint": "Fallback rules are evaluated only when no other rules match.",
+ "fallback-rules-hint": "Fallback rules are evaluated from top to bottom only when no source-specific rule matches.",
"node": {
"add": "Add node",
"approver": "Approver",
@@ -601,6 +601,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "Rules are evaluated in order. Source-specific rules run before Fallback Rules.",
+ "multi-target": "For a multi-target plan, a source-specific rule matches the whole plan if any target matches its condition, and the first matching rule selects the approval flow for the whole plan.",
+ "priority": "Place rules for higher risk changes before those for lower-risk changes. For similar risks, place stricter or more specific rules before broader rules."
+ },
"first-match-wins": "Rules are evaluated in order. First matching rule applies.",
"self": "Custom Approval Rule"
},
diff --git a/frontend/src/react/locales/es-ES.json b/frontend/src/react/locales/es-ES.json
index d5fd12af7a..5cdf29adc6 100644
--- a/frontend/src/react/locales/es-ES.json
+++ b/frontend/src/react/locales/es-ES.json
@@ -526,7 +526,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "Reglas de respaldo",
- "fallback-rules-hint": "Las reglas de respaldo solo se evalúan cuando ninguna otra regla coincide.",
+ "fallback-rules-hint": "Las reglas de respaldo se evalúan de arriba abajo solo cuando ninguna regla específica de origen coincide.",
"node": {
"add": "Agregar nodo",
"approver": "Aprobador",
@@ -594,6 +594,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "Las reglas se evalúan en orden. Las reglas específicas de origen se ejecutan antes que las Reglas de respaldo.",
+ "multi-target": "En un plan con varios destinos, una regla específica de origen coincide con todo el plan si cualquier destino cumple su condición, y la primera regla coincidente selecciona el flujo de aprobación para todo el plan.",
+ "priority": "Coloca las reglas para cambios de mayor riesgo antes que las de menor riesgo. Para riesgos similares, coloca las reglas más estrictas o específicas antes de las más amplias."
+ },
"first-match-wins": "Las reglas se evalúan en orden. Se aplica la primera regla coincidente.",
"self": "Regla de aprobación personalizada"
},
diff --git a/frontend/src/react/locales/ja-JP.json b/frontend/src/react/locales/ja-JP.json
index 20554a889e..57c19faa22 100644
--- a/frontend/src/react/locales/ja-JP.json
+++ b/frontend/src/react/locales/ja-JP.json
@@ -526,7 +526,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "フォールバックルール",
- "fallback-rules-hint": "フォールバックルールは、他のルールが一致しない場合にのみ評価されます。",
+ "fallback-rules-hint": "フォールバックルールは、ソース固有のルールが一致しない場合にのみ、上から順に評価されます。",
"node": {
"add": "ノードの追加",
"approver": "承認者",
@@ -594,6 +594,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "ルールは順番に評価されます。ソース固有のルールはフォールバックルールより先に実行されます。",
+ "multi-target": "複数ターゲットのプランでは、いずれかのターゲットがソース固有ルールの条件に一致すると、そのルールはプラン全体に一致し、最初に一致したルールがプラン全体の承認フローを決定します。",
+ "priority": "リスクが高い変更のルールを、リスクが低い変更のルールより上に配置してください。同程度のリスクでは、より厳格または具体的なルールを、より広いルールより上に配置してください。"
+ },
"first-match-wins": "ルールは順番に評価されます。最初に一致するルールが適用されます。",
"self": "カスタム承認ルール"
},
diff --git a/frontend/src/react/locales/vi-VN.json b/frontend/src/react/locales/vi-VN.json
index 8dda872880..33f3535461 100644
--- a/frontend/src/react/locales/vi-VN.json
+++ b/frontend/src/react/locales/vi-VN.json
@@ -526,7 +526,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "Quy tắc dự phòng",
- "fallback-rules-hint": "Quy tắc dự phòng chỉ được đánh giá khi không có quy tắc nào khác khớp.",
+ "fallback-rules-hint": "Quy tắc dự phòng được đánh giá từ trên xuống dưới chỉ khi không có quy tắc theo nguồn nào khớp.",
"node": {
"add": "Thêm nút",
"approver": "Người phê duyệt",
@@ -594,6 +594,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "Các quy tắc được đánh giá theo thứ tự. Quy tắc theo nguồn chạy trước Quy tắc dự phòng.",
+ "multi-target": "Với kế hoạch có nhiều mục tiêu, một quy tắc theo nguồn khớp với toàn bộ kế hoạch nếu bất kỳ mục tiêu nào khớp với điều kiện của quy tắc đó, và quy tắc khớp đầu tiên sẽ chọn luồng phê duyệt cho toàn bộ kế hoạch.",
+ "priority": "Đặt các quy tắc cho thay đổi có rủi ro cao hơn trước các quy tắc cho thay đổi có rủi ro thấp hơn. Với các rủi ro tương tự, đặt các quy tắc chặt chẽ hơn hoặc cụ thể hơn trước các quy tắc rộng hơn."
+ },
"first-match-wins": "Các quy tắc được đánh giá theo thứ tự. Quy tắc phù hợp đầu tiên sẽ được áp dụng.",
"self": "Quy tắc phê duyệt tùy chỉnh"
},
diff --git a/frontend/src/react/locales/zh-CN.json b/frontend/src/react/locales/zh-CN.json
index 553a62c626..9f3ff7b4fa 100644
--- a/frontend/src/react/locales/zh-CN.json
+++ b/frontend/src/react/locales/zh-CN.json
@@ -526,7 +526,7 @@
"custom-approval": {
"approval-flow": {
"fallback-rules": "兜底规则",
- "fallback-rules-hint": "兜底规则仅在没有其他规则匹配时才会被评估。",
+ "fallback-rules-hint": "兜底规则仅在没有来源特定规则匹配时,才会按从上到下的顺序评估。",
"node": {
"add": "增加节点",
"approver": "审批人",
@@ -594,6 +594,11 @@
}
},
"rule": {
+ "approval-rule-matching": {
+ "evaluation-order": "规则按顺序评估。来源特定规则会先于兜底规则执行。",
+ "multi-target": "对于包含多个目标的计划,只要任一目标满足来源特定规则的条件,该规则就会匹配整个计划,且第一个匹配的规则会决定整个计划的审批流。",
+ "priority": "请将更高风险变更的规则放在较低风险变更的规则之前。对于相似风险,请将更严格或更具体的规则放在更宽泛的规则之前。"
+ },
"first-match-wins": "规则按顺序评估,第一个匹配的规则将被应用。",
"self": "审批规则"
},
diff --git a/frontend/src/react/pages/settings/CustomApprovalPage.tsx b/frontend/src/react/pages/settings/CustomApprovalPage.tsx
index 59b56c8771..16023f11d2 100644
--- a/frontend/src/react/pages/settings/CustomApprovalPage.tsx
+++ b/frontend/src/react/pages/settings/CustomApprovalPage.tsx
@@ -4,6 +4,7 @@ import { useTranslation } from "react-i18next";
import { RulesSection } from "@/react/components/CustomApproval/RulesSection";
import { APPROVAL_SOURCES } from "@/react/components/CustomApproval/utils";
import { FeatureAttention } from "@/react/components/FeatureAttention";
+import { Alert } from "@/react/components/ui/alert";
import { useVueState } from "@/react/hooks/useVueState";
import {
useSubscriptionV1Store,
@@ -43,9 +44,19 @@ export function CustomApprovalPage() {
</div>
{hasFeature && (
- <div className="textinfolabel">
- {t("custom-approval.rule.first-match-wins")}
- </div>
+ <Alert variant="info">
+ <ul className="flex flex-col gap-y-1 list-disc pl-5">
+ <li>
+ {t(
+ "custom-approval.rule.approval-rule-matching.evaluation-order"
+ )}
+ </li>
+ <li>
+ {t("custom-approval.rule.approval-rule-matching.multi-target")}
+ </li>
+ <li>{t("custom-approval.rule.approval-rule-matching.priority")}</li>
+ </ul>
+ </Alert>
)}
{!ready ? (