syncalert

const (
	// RuleSubmitFailed 是提交到引擎被明确拒绝，或者找不到可用的引擎端点（A1）。
	// RuleSubmitFailed fires when the engine definitely rejects a submit or no engine endpoint is usable (A1).
	RuleSubmitFailed = "sync_submit_failed"
	// RuleSubmitTimeout 是提交结果一直未知，过了截止时间被判失败（A2）。
	// RuleSubmitTimeout fires when an unknown submit outcome passes its deadline and is failed (A2).
	RuleSubmitTimeout = "sync_submit_timeout"
	// RuleJobFailed 是作业转为失败，包括引擎已无此作业（B1）。
	// RuleJobFailed fires when a job turns failed, including when the engine no longer has it (B1).
	RuleJobFailed = "sync_job_failed"
	// RuleStopTimeout 是停止请求过了截止时间作业仍未停下（C1）。
	// RuleStopTimeout fires when a job is still running after its stop deadline (C1).
	RuleStopTimeout = "sync_stop_timeout"
	// RuleCDCDelayHigh 是 CDC 实时作业读取延迟持续高于阈值（B4）；阈值与持续时间按任务配置，判定在 sync 里完成。
	// RuleCDCDelayHigh fires when a CDC streaming job's read delay stays above its threshold (B4); the threshold and
	// duration are configured per task and evaluated in sync.
	RuleCDCDelayHigh = "sync_cdc_delay_high"
)

const (
	// RuleStatusUnavailable 是集群的作业状态持续获取不到（D1）。
	// RuleStatusUnavailable fires when job status of a cluster keeps being unavailable (D1).
	RuleStatusUnavailable = "sync_status_unavailable"
	// RuleEventChannelDegraded 是集群事件通道从健康变为降级（D2）。
	// RuleEventChannelDegraded fires when the cluster event channel turns from healthy to degraded (D2).
	RuleEventChannelDegraded = "sync_event_channel_degraded"
)

const (
	ResolveReasonRecovered = "recovered"
	// ResolveReasonJobEnded 是作业已停止、失败或完成。
	// ResolveReasonJobEnded means the job stopped, failed or finished.
	ResolveReasonJobEnded = "job_ended"
	// ResolveReasonChannelOff 是事件通道已关闭、待重启，或集群不支持事件通道。
	// ResolveReasonChannelOff means the event channel is off, pending restart, or unsupported by the cluster.
	ResolveReasonChannelOff = "channel_unavailable"
	// ResolveReasonRuleRemoved 是任务告警配置去掉了 B4，或策略被停用。
	// ResolveReasonRuleRemoved means B4 was removed from the task alert config or the policy was disabled.
	ResolveReasonRuleRemoved = "rule_removed"
	// ResolveReasonRuleChanged 是告警中修改了阈值或持续时间、按新参数重新计时后延迟已不再超标；不算恢复，不发恢复通知。
	// ResolveReasonRuleChanged means the threshold or duration changed while alerting and, re-timed with the new
	// values, the delay is no longer above it; this is not a recovery and sends no recovery notification.
	ResolveReasonRuleChanged = "rule_changed"
)

const (
	// CDCDelayStateHigh 是本轮延迟高于阈值。
	// CDCDelayStateHigh means the delay of this round is above the threshold.
	CDCDelayStateHigh = "high"
	// CDCDelayStateUnknown 是收不到延迟数据，无法确认是否恢复。
	// CDCDelayStateUnknown means no delay data arrives and recovery cannot be confirmed.
	CDCDelayStateUnknown = "unknown"
	// CDCDelayStateRecovered 是延迟已回落。
	// CDCDelayStateRecovered means the delay dropped back.
	CDCDelayStateRecovered = "recovered"
	// CDCDelayStateRecovering 是告警中出现一轮低于阈值：还没连续两轮，阶段保留，只刷新为当前值。
	// CDCDelayStateRecovering means one round below the threshold while alerting: not yet two in a row, so the
	// episode stays open and is only refreshed with the current values.
	CDCDelayStateRecovering = "recovering"
	// CDCDelayStateClosed 是阶段因恢复以外的原因关闭（作业结束、去掉规则、改参数、事件通道不可用、配置删除、人工关闭），
	// 原因见明细的 resolve_reason；不再沿用关闭前的 high / recovering / unknown。
	// CDCDelayStateClosed means the episode closed for a reason other than recovery (job ended, rule removed, rule
	// changed, channel unavailable, config deleted, manual close); the reason is the detail's resolve_reason. The
	// pre-close high / recovering / unknown is no longer kept.
	CDCDelayStateClosed = "closed"
	// CDCDelayCloseManual 是人工关闭时明细 resolve_reason 的取值（阶段本身记为 closed）。closed 状态只存在于已关闭
	// 阶段的明细里，不会出现在 webhook 的 delay_state 中（静默关闭不发通知）。
	// CDCDelayCloseManual is the detail resolve_reason of a manual close (the episode itself records closed). The
	// closed state only lives in a closed episode's detail and never appears in a webhook delay_state (silent closes
	// send nothing).
	CDCDelayCloseManual = "manual"

	// CDCDelayUnknownNoProgress 是没有延迟数据、读取条数也没有增长。
	// CDCDelayUnknownNoProgress means no delay data and no growth in the read count.
	CDCDelayUnknownNoProgress = "no_progress"
	// CDCDelayUnknownChannelDegraded 是没有延迟数据、事件通道降级。
	// CDCDelayUnknownChannelDegraded means no delay data while the event channel is degraded.
	CDCDelayUnknownChannelDegraded = "channel_degraded"
	// CDCDelayUnknownStaleSamples 是收到了延迟样本，但全部按时间差判为重投的旧样本（例如引擎时钟回拨），没有可计入的数据。
	// CDCDelayUnknownStaleSamples means delay samples arrived but all were judged replayed old samples by their offset
	// (e.g. the engine clock stepped back), so there is no data to count.
	CDCDelayUnknownStaleSamples = "stale_samples"

	// CDCDelayRecoveryBySamples 是延迟样本连续两轮低于阈值。
	// CDCDelayRecoveryBySamples means delay samples stayed below the threshold for two rounds.
	CDCDelayRecoveryBySamples = "delay_samples"
	// CDCDelayRecoveryByReadCount 是没有延迟事件、读取条数在增长，据此推断延迟已低于 1 秒。
	// CDCDelayRecoveryByReadCount means no delay events while the read count grows, so the delay is inferred below 1s.
	CDCDelayRecoveryByReadCount = "read_count"
)

const (
	// DefaultCooldownMinutes 是未填写时的提醒间隔。
	// DefaultCooldownMinutes is the reminder interval when none is given.
	DefaultCooldownMinutes = 60
	// MaxCooldownMinutes 是提醒间隔上限（一天）。
	// MaxCooldownMinutes caps the reminder interval (one day).
	MaxCooldownMinutes = 1440

	// DefaultCDCDelayThresholdSeconds 是 B4 未填写阈值（或填 0）时的默认值。
	// DefaultCDCDelayThresholdSeconds is the B4 threshold when none (or 0) is given.
	DefaultCDCDelayThresholdSeconds = 60
	// MinCDCDelayThresholdSeconds 是阈值下限：引擎每 10 秒投递一批，数据库与 worker 的时钟差也会算进延迟。
	// MinCDCDelayThresholdSeconds is the lower bound: the engine delivers every 10s and DB/worker clock skew adds up.
	MinCDCDelayThresholdSeconds = 10
	// MaxCDCDelayThresholdSeconds 是阈值上限（24 小时）。
	// MaxCDCDelayThresholdSeconds is the upper bound (24 hours).
	MaxCDCDelayThresholdSeconds = 86400
	// DefaultCDCDelayDurationMinutes 是 B4 未填写持续时间（或填 0）时的默认值。
	// DefaultCDCDelayDurationMinutes is the B4 duration when none (or 0) is given.
	DefaultCDCDelayDurationMinutes = 5
	// MinCDCDelayDurationMinutes、MaxCDCDelayDurationMinutes 是持续时间范围。
	// MinCDCDelayDurationMinutes and MaxCDCDelayDurationMinutes bound the duration.
	MinCDCDelayDurationMinutes = 1
	MaxCDCDelayDurationMinutes = 60
)

const MaxMessageLength = 500