# subinj002/warehouse_layout_generator architecture

> Architecture diagram of the GitHub repository subinj002/warehouse_layout_generator, 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/subinj002/warehouse_layout_generator
- Repository: https://github.com/subinj002/warehouse_layout_generator

## Overview

This is an AI-powered warehouse layout generator. Users configure warehouse dimensions and requirements through the CLI or GUI, then generate or optimize a layout and export it for downstream use. The graph separates interaction/configuration, layout modeling and validation, AI/optimization, and CAD/export capabilities. README detail is minimal; several links reflect direct references in the source index, while unsampled subsystems are represented only at the supported module path.

Main entry points: [`ai/layout_generator.py`](https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/layout_generator.py) (AI layout generator), [`core/layout_engine.py`](https://github.com/subinj002/warehouse_layout_generator/blob/main/core/layout_engine.py) (Layout engine), [`ui/gui.py`](https://github.com/subinj002/warehouse_layout_generator/blob/main/ui/gui.py) (GUI), [`ui/cli.py`](https://github.com/subinj002/warehouse_layout_generator/blob/main/ui/cli.py) (CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User Interaction"]
  node_cli["CLI<br/>[cli.py]"]
  node_gui["GUI<br/>[gui.py]"]
end

subgraph group_layout["Layout Domain"]
  node_elements["Warehouse elements"]
  node_engine["Layout engine<br/>[layout_engine.py]"]
  node_constraints["Constraint checks<br/>[constraints.py]"]
end

subgraph group_intelligence["Generation And Optimization"]
  node_generator["AI layout generator"]
  node_models["AI models<br/>[models.py]"]
  node_space["Space optimizer<br/>[space_optimizer.py]"]
  node_optimization["Layout optimization<br/>[optimization.py]"]
end

subgraph group_output["Export And CAD"]
  node_export["Format export<br/>[export.py]"]
  node_cad["DXF interface<br/>[ezdxf_interface.py]"]
  node_drawing["Drawing utilities<br/>[drawing_utils.py]"]
end

subgraph group_foundation["Configuration And Geometry"]
  node_config["Config schema<br/>[config_schema.py]"]
  node_geometry["Geometry utilities<br/>[geometry.py]"]
  node_validators["Input validators<br/>[validators.py]"]
end

node_user(("Warehouse designer"))
node_files["Exported layout"]

node_user -->|"uses"| node_cli
node_user -->|"uses"| node_gui
node_cli -->|"validates"| node_config
node_gui -->|"validates"| node_config
node_cli -->|"runs"| node_engine
node_gui -->|"runs"| node_engine
node_cli -->|"optimizes with"| node_space
node_gui -->|"generates with"| node_generator
node_gui -->|"launches"| node_cli
node_engine -->|"manages"| node_elements
node_engine -->|"checks"| node_constraints
node_engine -->|"uses"| node_geometry
node_engine -->|"validates"| node_validators
node_generator -->|"generates via"| node_engine
node_generator -->|"places"| node_elements
node_generator -->|"checks"| node_constraints
node_generator -->|"uses"| node_geometry
node_generator -->|"uses"| node_models
node_generator -->|"uses"| node_space
node_space -->|"optimizes"| node_elements
node_space -->|"checks"| node_constraints
node_space -->|"uses"| node_optimization
node_space -->|"uses"| node_geometry
node_cli -->|"exports"| node_export
node_gui -->|"exports"| node_export
node_export -->|"serializes"| node_elements
node_export -->|"writes DXF"| node_cad
node_export -->|"draws layout"| node_drawing
node_export -->|"produces"| node_files

click node_cli "https://github.com/subinj002/warehouse_layout_generator/blob/main/ui/cli.py"
click node_gui "https://github.com/subinj002/warehouse_layout_generator/blob/main/ui/gui.py"
click node_config "https://github.com/subinj002/warehouse_layout_generator/blob/main/config/config_schema.py"
click node_elements "https://github.com/subinj002/warehouse_layout_generator/blob/main/core/warehouse_elements.py"
click node_engine "https://github.com/subinj002/warehouse_layout_generator/blob/main/core/layout_engine.py"
click node_constraints "https://github.com/subinj002/warehouse_layout_generator/blob/main/core/constraints.py"
click node_geometry "https://github.com/subinj002/warehouse_layout_generator/blob/main/utils/geometry.py"
click node_validators "https://github.com/subinj002/warehouse_layout_generator/blob/main/utils/validators.py"
click node_generator "https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/layout_generator.py"
click node_models "https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/models.py"
click node_space "https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/space_optimizer.py"
click node_optimization "https://github.com/subinj002/warehouse_layout_generator/blob/main/core/optimization.py"
click node_export "https://github.com/subinj002/warehouse_layout_generator/blob/main/cad/export.py"
click node_cad "https://github.com/subinj002/warehouse_layout_generator/blob/main/cad/ezdxf_interface.py"
click node_drawing "https://github.com/subinj002/warehouse_layout_generator/blob/main/cad/drawing_utils.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_cli,node_gui toneBlue
class node_elements,node_engine,node_constraints toneAmber
class node_generator,node_models,node_space,node_optimization toneMint
class node_export,node_cad,node_drawing toneRose
class node_config,node_geometry,node_validators,node_user,node_files toneIndigo
```

## Components

### User Interaction

- [CLI](https://github.com/subinj002/warehouse_layout_generator/blob/main/ui/cli.py): `ui/cli.py`
- [GUI](https://github.com/subinj002/warehouse_layout_generator/blob/main/ui/gui.py): `ui/gui.py`

### Layout Domain

- [Warehouse elements](https://github.com/subinj002/warehouse_layout_generator/blob/main/core/warehouse_elements.py): `core/warehouse_elements.py`
- [Layout engine](https://github.com/subinj002/warehouse_layout_generator/blob/main/core/layout_engine.py): `core/layout_engine.py`
- [Constraint checks](https://github.com/subinj002/warehouse_layout_generator/blob/main/core/constraints.py): `core/constraints.py`

### Generation And Optimization

- [AI layout generator](https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/layout_generator.py): `ai/layout_generator.py`
- [AI models](https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/models.py): `ai/models.py`
- [Space optimizer](https://github.com/subinj002/warehouse_layout_generator/blob/main/ai/space_optimizer.py): `ai/space_optimizer.py`
- [Layout optimization](https://github.com/subinj002/warehouse_layout_generator/blob/main/core/optimization.py): `core/optimization.py`

### Export And CAD

- [Format export](https://github.com/subinj002/warehouse_layout_generator/blob/main/cad/export.py): `cad/export.py`
- [DXF interface](https://github.com/subinj002/warehouse_layout_generator/blob/main/cad/ezdxf_interface.py): `cad/ezdxf_interface.py`
- [Drawing utilities](https://github.com/subinj002/warehouse_layout_generator/blob/main/cad/drawing_utils.py): `cad/drawing_utils.py`

### Configuration And Geometry

- [Config schema](https://github.com/subinj002/warehouse_layout_generator/blob/main/config/config_schema.py): `config/config_schema.py`
- [Geometry utilities](https://github.com/subinj002/warehouse_layout_generator/blob/main/utils/geometry.py): `utils/geometry.py`
- [Input validators](https://github.com/subinj002/warehouse_layout_generator/blob/main/utils/validators.py): `utils/validators.py`

### Other components

- **Warehouse designer**
- **Exported layout**

## Connections

- Warehouse designer → CLI: uses (evidence: `ui/cli.py`)
- Warehouse designer → GUI: uses (evidence: `ui/gui.py`)
- CLI → Config schema: validates (evidence: `ui/cli.py`)
- GUI → Config schema: validates (evidence: `ui/gui.py`)
- CLI → Layout engine: runs (evidence: `ui/cli.py`)
- GUI → Layout engine: runs (evidence: `ui/gui.py`)
- CLI → Space optimizer: optimizes with (evidence: `ui/cli.py`)
- GUI → AI layout generator: generates with (evidence: `ui/gui.py`)
- GUI → CLI: launches (evidence: `ui/gui.py`)
- Layout engine → Warehouse elements: manages (evidence: `core/layout_engine.py`)
- Layout engine → Constraint checks: checks (evidence: `core/layout_engine.py`)
- Layout engine → Geometry utilities: uses (evidence: `core/layout_engine.py`)
- Layout engine → Input validators: validates (evidence: `core/layout_engine.py`)
- AI layout generator → Layout engine: generates via (evidence: `ai/layout_generator.py`)
- AI layout generator → Warehouse elements: places (evidence: `ai/layout_generator.py`)
- AI layout generator → Constraint checks: checks (evidence: `ai/layout_generator.py`)
- AI layout generator → Geometry utilities: uses (evidence: `ai/layout_generator.py`)
- AI layout generator → AI models: uses (evidence: `ai/layout_generator.py`)
- AI layout generator → Space optimizer: uses (evidence: `ai/layout_generator.py`)
- Space optimizer → Warehouse elements: optimizes (evidence: `ai/space_optimizer.py`)
- Space optimizer → Constraint checks: checks (evidence: `ai/space_optimizer.py`)
- Space optimizer → Layout optimization: uses (evidence: `ai/space_optimizer.py`)
- Space optimizer → Geometry utilities: uses (evidence: `ai/space_optimizer.py`)
- CLI → Format export: exports (evidence: `ui/cli.py`)
- GUI → Format export: exports (evidence: `ui/gui.py`)
- Format export → Warehouse elements: serializes (evidence: `cad/export.py`)
- Format export → DXF interface: writes DXF (evidence: `cad/export.py`)
- Format export → Drawing utilities: draws layout (evidence: `cad/export.py`)
- Format export → Exported layout: produces (evidence: `cad/export.py`)
