datasynth-generators 0.2.3

Data generators for journal entries, chart of accounts, and ACDOCA event logs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# datasynth-generators

Data generators for journal entries, master data, document flows, and anomalies.

## Overview

`datasynth-generators` contains all data generation logic for SyntheticData:

- **Core Generators**: Journal entries, chart of accounts, users
- **Master Data**: Vendors, customers, materials, assets, employees
- **Document Flows**: P2P (Procure-to-Pay), O2C (Order-to-Cash)
- **Financial**: Intercompany, balance tracking, subledgers, FX, period close
- **Quality**: Anomaly injection, data quality variations

## Generator Modules

### Core Generators

| Generator | Description |
|-----------|-------------|
| `je_generator` | Journal entry generation with statistical distributions |
| `coa_generator` | Chart of accounts with industry-specific structures |
| `company_selector` | Weighted company selection for transactions |
| `user_generator` | User/persona generation with roles |
| `control_generator` | Internal controls and SoD rules |

### Master Data (`master_data/`)

| Generator | Description |
|-----------|-------------|
| `vendor_generator` | Vendors with payment terms, bank accounts, behaviors |
| `customer_generator` | Customers with credit ratings, payment patterns |
| `material_generator` | Materials/products with BOM, valuations |
| `asset_generator` | Fixed assets with depreciation schedules |
| `employee_generator` | Employees with manager hierarchy |

### Document Flow (`document_flow/`)

| Generator | Description |
|-----------|-------------|
| `p2p_generator` | PO → GR → Invoice → Payment flow |
| `o2c_generator` | SO → Delivery → Invoice → Receipt flow |
| `document_chain_manager` | Reference chain management |
| `three_way_match` | PO/GR/Invoice matching validation |

### Financial (`intercompany/`, `balance/`, `subledger/`, `fx/`, `period_close/`)

| Generator | Description |
|-----------|-------------|
| `ic_generator` | Matched intercompany entry pairs |
| `balance_tracker` | Running balance validation |
| `ar_generator` / `ap_generator` | Subledger records |
| `fx_rate_service` | Ornstein-Uhlenbeck FX rates |
| `close_engine` | Period close orchestration |

### Quality (`anomaly/`, `data_quality/`)

| Generator | Description |
|-----------|-------------|
| `injector` | Anomaly injection engine |
| `missing_values` | MCAR, MAR, MNAR patterns |
| `typos` | Keyboard-aware typo generation |
| `duplicates` | Exact, near, fuzzy duplicates |

## Usage

```rust
use datasynth_generators::je_generator::JournalEntryGenerator;
use datasynth_generators::master_data::VendorGenerator;

let mut je_gen = JournalEntryGenerator::new(config, seed);
let entries = je_gen.generate_batch(1000)?;

let mut vendor_gen = VendorGenerator::new(seed);
let vendors = vendor_gen.generate(100);
```

## License

Apache-2.0 - See [LICENSE](../../LICENSE) for details.