Struct CheckAlert 

pub struct CheckAlert {
    pub on: Vec<CheckAlertStatus>,
    pub notify_user: bool,
    pub notify_groups: Vec<String>,
    pub priority: NotificationPriority,
    pub require_ack: bool,
    pub toast: bool,
    pub email: bool,
    pub title: String,
    pub body: Option<String>,
}

Auto-notification rule for a CheckHint (compliance alerting). When a check’s status transitions into one of on, the backend publishes a notification to the failing PC’s user (notify_user) and/or operator groups (notify_groups). Deliberately config-driven: who gets told, how loud, and the wording all live in the manifest, not hardcoded in the backend.

Fields

on: Vec<CheckAlertStatus>

Statuses that fire the alert on transition into them (a check that stays failing doesn’t re-alert every poll). Defaults to [fail]. ok is not representable — CheckAlertStatus has no Ok variant, so a YAML on: [ok] fails to deserialize (before validate() is even reached); “recovered” notifications are out of scope.

notify_user: bool

Notify the user(s) on the failing PC (notifications.pc.<pc_id>).

notify_groups: Vec<String>

Notify these operator groups (notifications.group.<name>).

priority: NotificationPriority

Notification priority (colour/label only — toasting is the separate toast flag). Defaults to warn.

require_ack: bool

Require the recipient to click 確認 to dismiss.

toast: bool

Surface an OS toast (launches a closed Client App, Action Center while locked). Recommended true for notify_user so a non-emergency “your PC is non-compliant” nudge still reaches a user whose app is closed.

email: bool

Also send the alert by email, to every address mapped to the notify_groups (via the group_contacts KV, edited on the SPA Groups page). Opt-in: defaults to false, so an existing alert never starts emailing on its own. Requires notify_groups to be non-empty (there is no per-PC user email) and the backend’s [mail] config to be present; otherwise the email is a logged no-op while the in-app/toast notification still fires.

title: String

Notification title (required). May use the same {…} placeholders as body.

body: Option<String>

Notification body template. Placeholders: {pc_id}, {name} (check slug), {label} (check label, falls back to slug), {status}, {detail} (the check’s one-line summary), {last_logon} (the PC’s last sign-in account). Absent → empty body.

Trait Implementations

impl Clone for CheckAlert

fn clone(&self) -> CheckAlert

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CheckAlert

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CheckAlert

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for CheckAlert

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for CheckAlert

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.