Struct JournalEntryGenerator 

pub struct JournalEntryGenerator { /* private fields */ }

Generator for realistic journal entries.

Implementations

impl JournalEntryGenerator

pub fn new_with_params( config: TransactionConfig, coa: Arc<ChartOfAccounts>, companies: Vec<String>, start_date: NaiveDate, end_date: NaiveDate, seed: u64, ) -> Self

Create a new journal entry generator.

pub fn new_with_full_config( config: TransactionConfig, coa: Arc<ChartOfAccounts>, companies: Vec<String>, start_date: NaiveDate, end_date: NaiveDate, seed: u64, template_config: TemplateConfig, user_pool: Option<UserPool>, ) -> Self

Create a new journal entry generator with full configuration.

pub fn from_generator_config( full_config: &GeneratorConfig, coa: Arc<ChartOfAccounts>, start_date: NaiveDate, end_date: NaiveDate, seed: u64, ) -> Self

Create from a full GeneratorConfig.

This constructor uses the volume_weight from company configs for weighted company selection, and fraud config from GeneratorConfig.

pub fn set_company_selector(&mut self, selector: WeightedCompanySelector)

Set a custom company selector.

pub fn company_selector(&self) -> &WeightedCompanySelector

Get the current company selector.

pub fn set_fraud_config(&mut self, config: FraudConfig)

Set fraud configuration.

pub fn with_vendors(self, vendors: &[Vendor]) -> Self

Set vendors from generated master data.

This replaces the default vendor pool with actual generated vendors, ensuring JEs reference real master data entities.

pub fn with_customers(self, customers: &[Customer]) -> Self

Set customers from generated master data.

This replaces the default customer pool with actual generated customers, ensuring JEs reference real master data entities.

pub fn with_materials(self, materials: &[Material]) -> Self

Set materials from generated master data.

This provides material references for JEs that involve inventory movements.

pub fn with_master_data( self, vendors: &[Vendor], customers: &[Customer], materials: &[Material], ) -> Self

Set all master data at once for convenience.

This is the recommended way to configure the JE generator with generated master data to ensure data coherence.

pub fn is_using_real_master_data(&self) -> bool

Check if the generator is using real master data.

pub fn generate(&mut self) -> JournalEntry

Generate a single journal entry.

pub fn with_persona_errors(self, enabled: bool) -> Self

Enable or disable persona-based error injection.

When enabled, entries created by human personas have a chance to contain realistic human errors based on their experience level.

pub fn with_fraud_config(self, config: FraudConfig) -> Self

Set fraud configuration for fraud injection.

When fraud is enabled in the config, transactions have a chance to be marked as fraudulent based on the configured fraud rate.

pub fn persona_errors_enabled(&self) -> bool

Check if persona errors are enabled.

pub fn with_batching(self, enabled: bool) -> Self

Enable or disable batch processing behavior.

When enabled (default), the generator will occasionally produce batches of similar entries, simulating how humans batch similar work together.

pub fn batching_enabled(&self) -> bool

Check if batch processing is enabled.

pub fn with_approval(self, enabled: bool) -> Self

Enable or disable approval workflow.

pub fn with_approval_threshold(self, threshold: Decimal) -> Self

Set the approval threshold amount.

Trait Implementations

impl Generator for JournalEntryGenerator

type Item = JournalEntry

The type of items this generator produces.

type Config = (TransactionConfig, Arc<ChartOfAccounts>, Vec<String>, NaiveDate, NaiveDate)

The configuration type for this generator.

fn new(config: Self::Config, seed: u64) -> Self

Initialize the generator with configuration and seed.

fn generate_one(&mut self) -> Self::Item

Generate a single item.

fn reset(&mut self)

Reset the generator to initial state (same seed).

fn count(&self) -> u64

Get the current generation count.

fn seed(&self) -> u64

Get the seed used by this generator.

fn generate_batch(&mut self, count: usize) -> Vec<Self::Item>

Generate a batch of items.

fn generate_iter(&mut self, count: usize) -> GeneratorIterator<'_, Self>

where Self: Sized,

Generate items into an iterator.