# jogeshrajiyan007/synthetic-data-generator architecture

> Architecture diagram of the GitHub repository jogeshrajiyan007/synthetic-data-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jogeshrajiyan007/synthetic-data-generator
- Repository: https://github.com/jogeshrajiyan007/synthetic-data-generator

## Overview

This repository’s main runtime is a synthetic-data generator: it loads generator definitions and a table schema, builds related tables with generated values, and writes each table as CSV. Its domain stages include configurable value generation, composite profiles, foreign-key values, and derived columns. The graph follows calls shown in the sampled source; helper implementations and some wiring were not shown, so those relationships are omitted.

Main entry points: [`synth-datagen-main.py`](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py) (Generation Runner), [`generators.json`](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/generators.json) (Generator Config), [`schema.json`](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/schema.json) (Table Schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_generator_config["Generator Config<br/>[generators.json]"]
node_table_schema["Table Schema<br/>[schema.json]"]
node_runner["Generation Runner"]
node_table_builder["Table Builder"]
node_value_generators["Value Generators"]
node_composite_profiles["Composite Profiles"]
node_foreign_keys["Foreign Key Helpers"]
node_table_dataframes["Generated Tables"]
node_csv_files["CSV Files"]

node_user -->|"runs"| node_runner
node_runner -->|"loads"| node_generator_config
node_runner -->|"loads"| node_table_schema
node_runner -->|"generates tables"| node_table_builder
node_table_builder -->|"generates profiles"| node_composite_profiles
node_table_builder -->|"applies generators"| node_value_generators
node_table_builder -->|"generates keys"| node_foreign_keys
node_table_builder -->|"builds DataFrame"| node_table_dataframes
node_runner -->|"writes CSV"| node_csv_files

click node_generator_config "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/generators.json"
click node_table_schema "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/schema.json"
click node_runner "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py"
click node_table_builder "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py"
click node_value_generators "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py"
click node_composite_profiles "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py"
click node_foreign_keys "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py"
click node_table_dataframes "https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user toneBlue
class node_generator_config,node_table_schema,node_runner,node_table_builder,node_value_generators,node_composite_profiles,node_foreign_keys,node_table_dataframes toneTeal
class node_csv_files toneIndigo
```

## Components

### Other components

- **User**
- [Generator Config](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/generators.json): `generators.json`
- [Table Schema](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/schema.json): `schema.json`
- [Generation Runner](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py): `synth-datagen-main.py`
- [Table Builder](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py): `synth-datagen-main.py`
- [Value Generators](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py): `synth-datagen-main.py`
- [Composite Profiles](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py): `synth-datagen-main.py`
- [Foreign Key Helpers](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py): `synth-datagen-main.py`
- [Generated Tables](https://github.com/jogeshrajiyan007/synthetic-data-generator/blob/main/synth-datagen-main.py): `synth-datagen-main.py`
- **CSV Files**

## Connections

- User → Generation Runner: runs (evidence: `synth-datagen-main.py`)
- Generation Runner → Generator Config: loads (evidence: `synth-datagen-main.py`)
- Generation Runner → Table Schema: loads (evidence: `synth-datagen-main.py`)
- Generation Runner → Table Builder: generates tables (evidence: `synth-datagen-main.py`)
- Table Builder → Composite Profiles: generates profiles (evidence: `synth-datagen-main.py`)
- Table Builder → Value Generators: applies generators (evidence: `synth-datagen-main.py`)
- Table Builder → Foreign Key Helpers: generates keys (evidence: `synth-datagen-main.py`)
- Table Builder → Generated Tables: builds DataFrame (evidence: `synth-datagen-main.py`)
- Generation Runner → CSV Files: writes CSV (evidence: `synth-datagen-main.py`)
