Struct AuditInfo 

pub struct AuditInfo {
    pub created_at: DateTime<Utc>,
    pub created_machine: String,
    pub mastered_at: Option<DateTime<Utc>>,
    pub mastered_for: Option<String>,
    pub generation_count: u64,
    pub last_generated_at: Option<DateTime<Utc>>,
    pub history: History,
    pub generation_log: Vec<GenerationLogEntry>,
}

Audit trail information stored in .bin files.

Tracks the complete lifecycle of a promotional code configuration:

• When and where it was created
• When and to which machine it was mastered
• How many codes have been generated

Fields

created_at: DateTime<Utc>

When the .bin file was created

created_machine: String

Machine ID (hex) where the file was created

mastered_at: Option<DateTime<Utc>>

When the file was last mastered (bound to a machine)

mastered_for: Option<String>

Machine ID (hex) the file is currently bound to

generation_count: u64

Total number of codes generated

last_generated_at: Option<DateTime<Utc>>

Timestamp of last code generation

history: History

History of changes

generation_log: Vec<GenerationLogEntry>

Generation log entries

Implementations

impl AuditInfo

pub fn new(machine_id: &[u8; 32]) -> Self

Create new audit info for a newly created .bin file.

Arguments

• machine_id - The 32-byte machine ID where creation occurs

pub fn with_timestamp(machine_id: &[u8; 32], created_at: DateTime<Utc>) -> Self

Create audit info with a specific creation timestamp.

Useful for testing or restoring from backup.

pub fn record_master(&mut self, target_machine: &[u8; 32])

Record a mastering event.

Called when the .bin file is bound to a new machine.

Arguments

• target_machine - The 32-byte machine ID being mastered to

pub fn record_master_with_history( &mut self, from_machine: &[u8; 32], target_machine: &[u8; 32], mastered_by: &[u8; 32], )

Record a mastering event with history tracking.

pub fn record_generation(&mut self, count: u64)

Record code generation.

Called after successfully generating codes.

Arguments

• count - Number of codes generated

pub fn record_generation_with_log( &mut self, machine_id: &[u8; 32], count: u64, counter_start: u64, )

Record code generation with log entry.

pub fn is_mastered(&self) -> bool

Check if the file has been mastered (bound to a machine).

pub fn bound_machine(&self) -> Option<&str>

Get the machine ID this file is bound to, if any.

pub fn created_machine_bytes(&self) -> Option<[u8; 32]>

Get creation machine ID as bytes.

pub fn mastered_machine_bytes(&self) -> Option<[u8; 32]>

Get mastered machine ID as bytes.

pub fn total_codes_from_log(&self) -> u64

Get total codes generated from generation log.

pub fn get_generation_log(&self) -> &[GenerationLogEntry]

Get generation log.

pub fn get_history(&self) -> &History

Get history.

pub fn clear_generation_log(&mut self, keep_last: Option<usize>)

Clear generation log, optionally keeping the last N entries.

pub fn clear_history(&mut self, keep_last: Option<usize>)

Clear history.

pub fn export_generation_log(&self) -> String

Export generation log as JSON.

pub fn export_history(&self) -> String

Export history as JSON.

pub fn summary(&self) -> String

Create a human-readable summary of the audit info.

Trait Implementations

impl Clone for AuditInfo

fn clone(&self) -> AuditInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditInfo

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

Formats the value using the given formatter.

impl Default for AuditInfo

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AuditInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AuditInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.