# vishnupriyancode/jsonstudio architecture

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

- Interactive diagram: https://gitdiagram.com/vishnupriyancode/jsonstudio
- Repository: https://github.com/vishnupriyancode/jsonstudio

## Overview

This repository automates configuration-driven JSON payload renaming and produces Postman collections and Excel timing reports. The primary workflow is to discover or select test-suite models, process their source payloads, and generate outputs; optional branches support reference-database value replacement and syncing model configuration from an edits spreadsheet. The excerpts show key calls and responsibilities, but do not expose every connection in the processing path, so uncertain links are omitted.

Main entry points: [`rename_files.py`](https://github.com/vishnupriyancode/jsonstudio/blob/main/rename_files.py) (JSON renaming), [`main_processor.py`](https://github.com/vishnupriyancode/jsonstudio/blob/main/main_processor.py) (Processor CLI), [`postman_generator.py`](https://github.com/vishnupriyancode/jsonstudio/blob/main/postman_generator.py) (Collection generator), [`models_config.py`](https://github.com/vishnupriyancode/jsonstudio/blob/main/models_config.py) (Model config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Model configuration"]
  node_model_config["Model config<br/>[models_config.py]"]
  node_discovery["Folder discovery<br/>[dynamic_models.py]"]
end

subgraph group_processing["Payload processing"]
  node_main["Processor CLI<br/>[main_processor.py]"]
  node_renamer["JSON renaming<br/>[rename_files.py]"]
end

subgraph group_outputs["Generated outputs"]
  node_postman["Collection generator"]
  node_reporter["Timing reports<br/>[report_generate.py]"]
  node_postman_cli["Collection CLI<br/>[postman_cli.py]"]
end

subgraph group_integrations["Auxiliary workflows"]
  node_auto_edit["Config sync"]
  node_refdb["REFDB replacement<br/>[refdb_change.py]"]
end

node_operator(("Operator"))
node_source_payloads[("Source payloads")]
node_renamed_payloads[("Renamed payloads")]
node_collections["Postman collections"]
node_reports["Excel reports"]
node_edits_sheet["Edits spreadsheet"]
node_refdb_values["REFDB values<br/>[refdb_values.json]"]

node_operator -->|"selects models"| node_main
node_main -->|"loads configuration"| node_model_config
node_model_config -->|"discovers folders"| node_discovery
node_main -->|"processes models"| node_renamer
node_source_payloads -->|"provides JSON"| node_renamer
node_renamer -->|"renames and moves"| node_renamed_payloads
node_renamer -->|"generates collections"| node_postman
node_postman -->|"reads JSON"| node_renamed_payloads
node_postman -->|"writes collections"| node_collections
node_renamer -->|"records timing"| node_reporter
node_reporter -->|"writes reports"| node_reports
node_operator -->|"requests generation"| node_postman_cli
node_postman_cli -->|"delegates generation"| node_postman
node_edits_sheet -->|"supplies edits"| node_auto_edit
node_auto_edit -->|"updates config"| node_model_config
node_main -.->|"runs optional replacement"| node_refdb
node_refdb -->|"loads defaults"| node_refdb_values

click node_main "https://github.com/vishnupriyancode/jsonstudio/blob/main/main_processor.py"
click node_model_config "https://github.com/vishnupriyancode/jsonstudio/blob/main/models_config.py"
click node_discovery "https://github.com/vishnupriyancode/jsonstudio/blob/main/dynamic_models.py"
click node_renamer "https://github.com/vishnupriyancode/jsonstudio/blob/main/rename_files.py"
click node_postman "https://github.com/vishnupriyancode/jsonstudio/blob/main/postman_generator.py"
click node_reporter "https://github.com/vishnupriyancode/jsonstudio/blob/main/report_generate.py"
click node_postman_cli "https://github.com/vishnupriyancode/jsonstudio/blob/main/postman_cli.py"
click node_auto_edit "https://github.com/vishnupriyancode/jsonstudio/blob/main/auto_edit_processor.py"
click node_refdb "https://github.com/vishnupriyancode/jsonstudio/blob/main/refdb_change.py"
click node_refdb_values "https://github.com/vishnupriyancode/jsonstudio/blob/main/refdb_values.json"

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_model_config,node_discovery toneBlue
class node_main,node_renamer,node_source_payloads,node_renamed_payloads toneAmber
class node_postman,node_reporter,node_postman_cli toneMint
class node_auto_edit,node_refdb toneRose
class node_operator,node_collections,node_reports,node_edits_sheet toneIndigo
class node_refdb_values toneTeal
```

## Components

### Model configuration

- [Model config](https://github.com/vishnupriyancode/jsonstudio/blob/main/models_config.py): `models_config.py`
- [Folder discovery](https://github.com/vishnupriyancode/jsonstudio/blob/main/dynamic_models.py): `dynamic_models.py`

### Payload processing

- [Processor CLI](https://github.com/vishnupriyancode/jsonstudio/blob/main/main_processor.py): `main_processor.py`
- [JSON renaming](https://github.com/vishnupriyancode/jsonstudio/blob/main/rename_files.py): `rename_files.py`

### Generated outputs

- [Collection generator](https://github.com/vishnupriyancode/jsonstudio/blob/main/postman_generator.py): `postman_generator.py`
- [Timing reports](https://github.com/vishnupriyancode/jsonstudio/blob/main/report_generate.py): `report_generate.py`
- [Collection CLI](https://github.com/vishnupriyancode/jsonstudio/blob/main/postman_cli.py): `postman_cli.py`

### Auxiliary workflows

- [Config sync](https://github.com/vishnupriyancode/jsonstudio/blob/main/auto_edit_processor.py): `auto_edit_processor.py`
- [REFDB replacement](https://github.com/vishnupriyancode/jsonstudio/blob/main/refdb_change.py): `refdb_change.py`

### Other components

- **Operator**
- **Source payloads**
- **Renamed payloads**
- **Postman collections**
- **Excel reports**
- **Edits spreadsheet**
- [REFDB values](https://github.com/vishnupriyancode/jsonstudio/blob/main/refdb_values.json): `refdb_values.json`

## Connections

- Operator → Processor CLI: selects models (evidence: `main_processor.py`)
- Processor CLI → Model config: loads configuration (evidence: `main_processor.py`)
- Model config → Folder discovery: discovers folders (evidence: `models_config.py`)
- Processor CLI → JSON renaming: processes models (evidence: `main_processor.py`)
- Source payloads → JSON renaming: provides JSON (evidence: `rename_files.py`)
- JSON renaming → Renamed payloads: renames and moves (evidence: `rename_files.py`)
- JSON renaming → Collection generator: generates collections (evidence: `rename_files.py`)
- Collection generator → Renamed payloads: reads JSON (evidence: `postman_generator.py`)
- Collection generator → Postman collections: writes collections (evidence: `postman_generator.py`)
- JSON renaming → Timing reports: records timing (evidence: `rename_files.py`)
- Timing reports → Excel reports: writes reports (evidence: `report_generate.py`)
- Operator → Collection CLI: requests generation (evidence: `postman_cli.py`)
- Collection CLI → Collection generator: delegates generation (evidence: `postman_cli.py`)
- Edits spreadsheet → Config sync: supplies edits (evidence: `auto_edit_processor.py`)
- Config sync → Model config: updates config (evidence: `auto_edit_processor.py`)
- Processor CLI → REFDB replacement: runs optional replacement (evidence: `refdb_change.py`)
- REFDB replacement → REFDB values: loads defaults (evidence: `refdb_change.py`)
