Struct AuditRecord 

#[non_exhaustive]
pub struct AuditRecord {
    pub id: AuditRecordId,
    pub schema_version: u16,
    pub actor_json: Value,
    pub operation: String,
    pub target_ref: String,
    pub created_at: DateTime<Utc>,
    pub outcome: Outcome,
    pub correlation_id: Option<CorrelationId>,
}

Doctrine-compliant audit record.

Required fields are positional in AuditRecord::new. There is no Default and no public field-init shorthand outside this module’s tests. See module docs for the full doctrine and anti-criterion.

Field order matches the audit_records columns in BUILD_SPEC §10 where they overlap; doctrine-only fields (outcome, correlation_id) are added at the end so the wire shape is forward-compatible with the §10 table.

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.

id: AuditRecordId

Stable identifier.

schema_version: u16

Schema version this row was written under.

actor_json: Value

Free-form actor descriptor (e.g. {"kind": "operator", "username": "alice"}). Opaque at this layer; see module-level anti-criterion.

operation: String

Stable operation identifier (e.g. principle.promote, memory.accept).

target_ref: String

Free-form reference to the target of the operation (typically a prefix-ULID ID, but any stable string is allowed).

created_at: DateTime<Utc>

When the audit row was created, in UTC.

outcome: Outcome

Outcome of the operation.

correlation_id: Option<CorrelationId>

Optional cross-trace correlation identifier.

Implementations

impl AuditRecord

pub fn new( actor_json: Value, operation: String, target_ref: String, created_at: DateTime<Utc>, outcome: Outcome, ) -> Self

Construct a new audit record.

All doctrine-required fields are positional and required. This is the only public constructor: there is no Default::default() and no builder. Forgetting any required field is a compile error, not a runtime validation failure.

id is generated fresh; schema_version is set to crate::SCHEMA_VERSION.

pub fn with_correlation(self, correlation_id: CorrelationId) -> Self

Attach an optional correlation id (chainable).

Trait Implementations

impl Clone for AuditRecord

fn clone(&self) -> AuditRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AuditRecord

fn schema_name() -> String

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 is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for AuditRecord

fn eq(&self, other: &AuditRecord) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AuditRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AuditRecord

impl StructuralPartialEq for AuditRecord