Struct AuditEntry 

#[non_exhaustive]
pub struct AuditEntry<'a> {
    pub actor_user_id: Option<i64>,
    pub actor_username: &'a str,
    pub action: &'a str,
    pub target_type: Option<&'a str>,
    pub target_id: Option<&'a str>,
    pub target_label: Option<&'a str>,
    pub detail: Option<&'a str>,
}

One append-only audit entry: who did what, to which target. Actions are dot-keyed (backend.role.update); the username is snapshotted so the entry stays legible after the actor’s account is removed.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

actor_user_id: Option<i64>

The acting operator’s id, or None for a system action.

actor_username: &'a str

The acting operator’s username, recorded verbatim.

action: &'a str

A dot-keyed action, e.g. backend.plugin.disable.

target_type: Option<&'a str>

What was acted on (e.g. backend_role) and its id; both optional.

target_id: Option<&'a str>

target_label: Option<&'a str>

The target’s name as operators know it (a username, a role name), snapshotted like the actor’s username.

detail: Option<&'a str>

Optional JSON describing the change.

Implementations

impl<'a> AuditEntry<'a>

pub fn new(actor: &'a Actor, action: &'a str) -> Self

An entry for action by actor, with no target yet.

pub fn target(self, kind: &'a str, id: &'a str, label: Option<&'a str>) -> Self

What was acted on: its type (backend_user), its id, and its name.

pub fn detail(self, detail: &'a str) -> Self

JSON describing the change.