Struct AuditEvent 

pub struct AuditEvent {

    pub id: String,
    pub timestamp: String,
    pub event_type: String,
    pub user_id: String,
    pub username: String,
    pub ip_address: String,
    pub resource_type: String,
    pub resource_id: Option<String>,
    pub action: String,
    pub before_state: Option<Value>,
    pub after_state: Option<Value>,
    pub status: String,
    pub error_message: Option<String>,
    pub tenant_id: Option<String>,
    pub metadata: Value,
}

Audit event representing a security-relevant operation.

Captures detailed information about user actions, system events, and data mutations for compliance and security auditing.

Fields

id: String

Unique event identifier (UUID)

timestamp: String

ISO 8601 timestamp of the event

event_type: String

Event type (e.g., “user_login”, “data_modification”, “access_denied”)

user_id: String

User ID (None for system events)

username: String

Username for human readability

ip_address: String

IP address of the request origin

resource_type: String

Resource type affected (e.g., “users”, “posts”, “admin_config”)

resource_id: Option<String>

Resource ID (None for bulk operations or system events)

action: String

Action performed (e.g., “create”, “update”, “delete”, “read”)

before_state: Option<Value>

State before modification (None for read operations)

after_state: Option<Value>

State after modification (None for deletions or reads)

status: String

Event status: “success”, “failure”, or “denied”

error_message: Option<String>

Error message if status is “failure” or “denied”

tenant_id: Option<String>

Tenant ID for multi-tenant deployments

metadata: Value

Additional context as JSON (user_agent, correlation_id, etc.)

Implementations

impl AuditEvent

pub fn new_user_action( user_id: impl Into<String>, username: impl Into<String>, ip_address: impl Into<String>, resource_type: impl Into<String>, action: impl Into<String>, status: impl Into<String>, ) -> Self

Create a new audit event for a user action.

Arguments

• user_id - User performing the action
• username - User’s name for readability
• ip_address - Request origin IP
• resource_type - Type of resource affected
• action - Action performed
• status - Result status (success/failure/denied)

pub fn with_resource_id(self, id: impl Into<String>) -> Self

Add resource ID to the event.

pub fn with_before_state(self, state: JsonValue) -> Self

Add before state to track modifications.

pub fn with_after_state(self, state: JsonValue) -> Self

Add after state to track modifications.

pub fn with_error(self, message: impl Into<String>) -> Self

Add error message for failed operations.

pub fn with_tenant_id(self, tenant_id: impl Into<String>) -> Self

Set tenant ID for multi-tenant tracking.

pub fn with_metadata(self, key: impl Into<String>, value: JsonValue) -> Self

Add metadata (user agent, correlation ID, etc.).

pub fn validate(&self) -> AuditResult<()>

Validate the audit event.

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AuditEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.