# thebryand/ajdmonogramautomation architecture

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

- Interactive diagram: https://gitdiagram.com/thebryand/ajdmonogramautomation
- Repository: https://github.com/thebryand/ajdmonogramautomation

## Overview

This is a Windows desktop order-import and sign-production automation tool. The main workflow imports marketplace orders into a consolidated JSON file, then uses Corel Draw automation to produce drawings and tracks completed orders. The graph preserves the GUI, manual entry, order review, analytics, and background scheduling capabilities visible in the repository. Several modules are only indexed or partially excerpted, so uncertain relationships are omitted rather than inferred.

Main entry points: [`apiManager.py`](https://github.com/thebryand/ajdmonogramautomation/blob/master/apiManager.py) (Marketplace import), [`gui.py`](https://github.com/thebryand/ajdmonogramautomation/blob/master/gui.py) (Desktop interface), [`main.py`](https://github.com/thebryand/ajdmonogramautomation/blob/master/main.py) (Workflow driver), [`TotalOrdersViewer.py`](https://github.com/thebryand/ajdmonogramautomation/blob/master/TotalOrdersViewer.py) (Completed orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application flow"]
  node_gui["Desktop interface<br/>[gui.py]"]
  node_main["Workflow driver<br/>[main.py]"]
end

subgraph group_orders["Order management"]
  node_marketplace["Marketplace import<br/>[apiManager.py]"]
  node_amazon["Amazon scraping<br/>[amazonScraper.py]"]
  node_orderdata[("Order JSON")]
  node_manual["Manual order entry"]
  node_viewer["Completed orders"]
end

subgraph group_production["Production automation"]
  node_nesting["Nesting selection<br/>[bysoftAutoTest.py]"]
  node_background["Background processing<br/>[bgProcess.py]"]
  node_corel["Corel Draw"]
  node_macro["Template macro"]
end

subgraph group_support["Integrations and reporting"]
  node_jsonmanager["JSON encryption<br/>[jsonManager.py]"]
  node_analytics["Order charts<br/>[plotter.py]"]
  node_etsyverify["Etsy verification<br/>[amazonScraper.py]"]
  node_shopify["Shopify API"]
  node_etsy["Etsy API"]
  node_ebay["eBay API"]
end

node_user(("Operator"))

node_user -->|"operates"| node_gui
node_gui -->|"starts workflow"| node_main
node_main -->|"imports orders"| node_marketplace
node_marketplace -->|"uses scraper"| node_amazon
node_marketplace -->|"writes consolidated data"| node_orderdata
node_main -->|"creates main file"| node_orderdata
node_gui -->|"opens entry"| node_manual
node_manual -->|"writes manual orders"| node_orderdata
node_gui -->|"opens viewer"| node_viewer
node_viewer -->|"reads completed orders"| node_orderdata
node_gui -->|"opens order chooser"| node_nesting
node_nesting -->|"loads orders"| node_orderdata
node_main -.->|"background workflow"| node_background
node_background -->|"runs macro"| node_corel
node_background -->|"invokes"| node_macro
node_corel -->|"reads order file"| node_orderdata
node_marketplace -->|"initializes"| node_jsonmanager
node_viewer -.->|"plots order statistics"| node_analytics
node_marketplace -->|"imports"| node_shopify
node_marketplace -->|"imports"| node_etsy
node_marketplace -.->|"manages API"| node_ebay
node_marketplace -->|"requests verifier"| node_etsyverify

click node_gui "https://github.com/thebryand/ajdmonogramautomation/blob/master/gui.py"
click node_main "https://github.com/thebryand/ajdmonogramautomation/blob/master/main.py"
click node_marketplace "https://github.com/thebryand/ajdmonogramautomation/blob/master/apiManager.py"
click node_amazon "https://github.com/thebryand/ajdmonogramautomation/blob/master/amazonScraper.py"
click node_manual "https://github.com/thebryand/ajdmonogramautomation/blob/master/manualOrderCreator.py"
click node_viewer "https://github.com/thebryand/ajdmonogramautomation/blob/master/TotalOrdersViewer.py"
click node_nesting "https://github.com/thebryand/ajdmonogramautomation/blob/master/bysoftAutoTest.py"
click node_background "https://github.com/thebryand/ajdmonogramautomation/blob/master/bgProcess.py"
click node_macro "https://github.com/thebryand/ajdmonogramautomation/blob/master/Necessarry%20Files/TemplateAutomation.gms"
click node_jsonmanager "https://github.com/thebryand/ajdmonogramautomation/blob/master/jsonManager.py"
click node_analytics "https://github.com/thebryand/ajdmonogramautomation/blob/master/plotter.py"
click node_etsyverify "https://github.com/thebryand/ajdmonogramautomation/blob/master/amazonScraper.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_gui,node_main toneBlue
class node_marketplace,node_amazon,node_orderdata,node_manual,node_viewer toneAmber
class node_nesting,node_background,node_corel,node_macro toneMint
class node_jsonmanager,node_analytics,node_etsyverify,node_shopify,node_etsy,node_ebay toneRose
class node_user toneIndigo
```

## Components

### Application flow

- [Desktop interface](https://github.com/thebryand/ajdmonogramautomation/blob/master/gui.py): `gui.py`
- [Workflow driver](https://github.com/thebryand/ajdmonogramautomation/blob/master/main.py): `main.py`

### Order management

- [Marketplace import](https://github.com/thebryand/ajdmonogramautomation/blob/master/apiManager.py): `apiManager.py`
- [Amazon scraping](https://github.com/thebryand/ajdmonogramautomation/blob/master/amazonScraper.py): `amazonScraper.py`
- **Order JSON**
- [Manual order entry](https://github.com/thebryand/ajdmonogramautomation/blob/master/manualOrderCreator.py): `manualOrderCreator.py`
- [Completed orders](https://github.com/thebryand/ajdmonogramautomation/blob/master/TotalOrdersViewer.py): `TotalOrdersViewer.py`

### Production automation

- [Nesting selection](https://github.com/thebryand/ajdmonogramautomation/blob/master/bysoftAutoTest.py): `bysoftAutoTest.py`
- [Background processing](https://github.com/thebryand/ajdmonogramautomation/blob/master/bgProcess.py): `bgProcess.py`
- **Corel Draw**
- [Template macro](https://github.com/thebryand/ajdmonogramautomation/blob/master/Necessarry%20Files/TemplateAutomation.gms): `Necessarry Files/TemplateAutomation.gms`

### Integrations and reporting

- [JSON encryption](https://github.com/thebryand/ajdmonogramautomation/blob/master/jsonManager.py): `jsonManager.py`
- [Order charts](https://github.com/thebryand/ajdmonogramautomation/blob/master/plotter.py): `plotter.py`
- [Etsy verification](https://github.com/thebryand/ajdmonogramautomation/blob/master/amazonScraper.py): `amazonScraper.py`
- **Shopify API**
- **Etsy API**
- **eBay API**

### Other components

- **Operator**

## Connections

- Operator → Desktop interface: operates (evidence: `gui.py`)
- Desktop interface → Workflow driver: starts workflow (evidence: `main.py`)
- Workflow driver → Marketplace import: imports orders (evidence: `main.py`)
- Marketplace import → Amazon scraping: uses scraper (evidence: `apiManager.py`)
- Marketplace import → Order JSON: writes consolidated data (evidence: `apiManager.py`)
- Workflow driver → Order JSON: creates main file (evidence: `main.py`)
- Desktop interface → Manual order entry: opens entry (evidence: `gui.py`)
- Manual order entry → Order JSON: writes manual orders (evidence: `manualOrderCreator.py`)
- Desktop interface → Completed orders: opens viewer (evidence: `gui.py`)
- Completed orders → Order JSON: reads completed orders (evidence: `TotalOrdersViewer.py`)
- Desktop interface → Nesting selection: opens order chooser (evidence: `gui.py`)
- Nesting selection → Order JSON: loads orders (evidence: `bysoftAutoTest.py`)
- Workflow driver → Background processing: background workflow
- Background processing → Corel Draw: runs macro (evidence: `bgProcess.py`)
- Background processing → Template macro: invokes (evidence: `bgProcess.py`)
- Corel Draw → Order JSON: reads order file
- Marketplace import → JSON encryption: initializes (evidence: `apiManager.py`)
- Completed orders → Order charts: plots order statistics (evidence: `TotalOrdersViewer.py`)
- Marketplace import → Shopify API: imports (evidence: `apiManager.py`)
- Marketplace import → Etsy API: imports (evidence: `apiManager.py`)
- Marketplace import → eBay API: manages API
- Marketplace import → Etsy verification: requests verifier (evidence: `apiManager.py`)
