# hakanseven12/opencadstudio architecture

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

- Interactive diagram: https://gitdiagram.com/hakanseven12/opencadstudio
- Repository: https://github.com/hakanseven12/opencadstudio

## Overview

Open CAD Studio is a shared-core 2D drafting and 3D modeling application for desktop and web. Users open or create a drawing, issue interactive drafting/modeling commands, inspect the result in rendered viewports, and save or export it. The README also documents automation, plugins, and format-specific workflows. The graph combines those documented capabilities with visible module references; many domain links are documented at product level because their implementation excerpts were not sampled.

Main entry points: [`src/app/mod.rs`](https://github.com/hakanseven12/opencadstudio/blob/main/src/app/mod.rs) (App session), [`src/modules/mod.rs`](https://github.com/hakanseven12/opencadstudio/blob/main/src/modules/mod.rs) (CAD commands), [`src/scene/mod.rs`](https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/mod.rs) (Drawing document), [`src/main.rs`](https://github.com/hakanseven12/opencadstudio/blob/main/src/main.rs) (Desktop or web)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and interaction"]
  node_desktop_web["Desktop or web<br/>[main.rs]"]
  node_app_session["App session<br/>[mod.rs]"]
  node_command_tools["Command tools<br/>[command.rs]"]
  node_ui["Editor UI<br/>[mod.rs]"]
end

subgraph group_cad["CAD editing core"]
  node_modules["CAD commands<br/>[mod.rs]"]
  node_document[("Drawing document<br/>[mod.rs]")]
  node_entities["Drawing entities<br/>[mod.rs]"]
  node_constraints["Constraints and snaps"]
  node_layouts["Layouts and annotation<br/>[annotative.rs]"]
  node_modeling["3D modeling<br/>[primitive_cmd.rs]"]
end

subgraph group_output["Rendering and files"]
  node_render["Viewport rendering<br/>[render.rs]"]
  node_gpu["GPU pipeline<br/>[mod.rs]"]
  node_file_io["Drawing file I/O<br/>[mod.rs]"]
  node_xref["External references<br/>[xref.rs]"]
end

subgraph group_extensions["Automation and extensions"]
  node_automation["Automation API<br/>[transport.rs]"]
  node_plugin_runtime["Plugin runtime<br/>[external.rs]"]
  node_plugin_api["Plugin host API<br/>[host.rs]"]
  node_mcp["MCP endpoint<br/>[mcp.rs]"]
end

node_user(("CAD user"))

node_user -->|"opens editor"| node_desktop_web
node_desktop_web -.->|"starts session"| node_app_session
node_app_session -->|"presents editor"| node_ui
node_ui -.->|"issues commands"| node_command_tools
node_command_tools -->|"dispatches tools"| node_modules
node_modules -->|"edits drawing"| node_document
node_document -.->|"stores entities"| node_entities
node_modules -->|"uses drafting aids"| node_constraints
node_modules -->|"creates documentation"| node_layouts
node_modules -->|"runs modeling tools"| node_modeling
node_document -->|"feeds viewport"| node_render
node_render -->|"uses GPU"| node_gpu
node_app_session -->|"opens and saves"| node_file_io
node_file_io -->|"resolves references"| node_xref
node_user -->|"sends JSON commands"| node_automation
node_automation -->|"controls editor"| node_app_session
node_user -->|"connects client"| node_mcp
node_mcp -->|"exposes live editor"| node_app_session
node_app_session -->|"loads plugins"| node_plugin_runtime
node_plugin_runtime -.->|"uses plugin contract"| node_plugin_api

click node_desktop_web "https://github.com/hakanseven12/opencadstudio/blob/main/src/main.rs"
click node_app_session "https://github.com/hakanseven12/opencadstudio/blob/main/src/app/mod.rs"
click node_command_tools "https://github.com/hakanseven12/opencadstudio/blob/main/src/command.rs"
click node_ui "https://github.com/hakanseven12/opencadstudio/blob/main/src/ui/mod.rs"
click node_modules "https://github.com/hakanseven12/opencadstudio/blob/main/src/modules/mod.rs"
click node_document "https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/mod.rs"
click node_entities "https://github.com/hakanseven12/opencadstudio/blob/main/src/entities/mod.rs"
click node_constraints "https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/parametric_constraints.rs"
click node_layouts "https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/annotative.rs"
click node_modeling "https://github.com/hakanseven12/opencadstudio/blob/main/src/modules/model/primitive_cmd.rs"
click node_render "https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/view/render.rs"
click node_gpu "https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/pipeline/mod.rs"
click node_file_io "https://github.com/hakanseven12/opencadstudio/blob/main/src/io/mod.rs"
click node_xref "https://github.com/hakanseven12/opencadstudio/blob/main/src/io/xref.rs"
click node_automation "https://github.com/hakanseven12/opencadstudio/blob/main/src/app/control/transport.rs"
click node_plugin_runtime "https://github.com/hakanseven12/opencadstudio/blob/main/src/plugin/external.rs"
click node_plugin_api "https://github.com/hakanseven12/opencadstudio/blob/main/crates/ocs_plugin_api/src/host.rs"
click node_mcp "https://github.com/hakanseven12/opencadstudio/blob/main/src/mcp.rs"

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_desktop_web,node_app_session,node_command_tools,node_ui,node_user toneBlue
class node_modules,node_document,node_entities,node_constraints,node_layouts,node_modeling toneAmber
class node_render,node_gpu,node_file_io,node_xref toneMint
class node_automation,node_plugin_runtime,node_plugin_api,node_mcp toneRose
```

## Components

### App and interaction

- [Desktop or web](https://github.com/hakanseven12/opencadstudio/blob/main/src/main.rs): `src/main.rs`
- [App session](https://github.com/hakanseven12/opencadstudio/blob/main/src/app/mod.rs): `src/app/mod.rs`
- [Command tools](https://github.com/hakanseven12/opencadstudio/blob/main/src/command.rs): `src/command.rs`
- [Editor UI](https://github.com/hakanseven12/opencadstudio/blob/main/src/ui/mod.rs): `src/ui/mod.rs`

### CAD editing core

- [CAD commands](https://github.com/hakanseven12/opencadstudio/blob/main/src/modules/mod.rs): `src/modules/mod.rs`
- [Drawing document](https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/mod.rs): `src/scene/mod.rs`
- [Drawing entities](https://github.com/hakanseven12/opencadstudio/blob/main/src/entities/mod.rs): `src/entities/mod.rs`
- [Constraints and snaps](https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/parametric_constraints.rs): `src/scene/parametric_constraints.rs`
- [Layouts and annotation](https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/annotative.rs): `src/scene/annotative.rs`
- [3D modeling](https://github.com/hakanseven12/opencadstudio/blob/main/src/modules/model/primitive_cmd.rs): `src/modules/model/primitive_cmd.rs`

### Rendering and files

- [Viewport rendering](https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/view/render.rs): `src/scene/view/render.rs`
- [GPU pipeline](https://github.com/hakanseven12/opencadstudio/blob/main/src/scene/pipeline/mod.rs): `src/scene/pipeline/mod.rs`
- [Drawing file I/O](https://github.com/hakanseven12/opencadstudio/blob/main/src/io/mod.rs): `src/io/mod.rs`
- [External references](https://github.com/hakanseven12/opencadstudio/blob/main/src/io/xref.rs): `src/io/xref.rs`

### Automation and extensions

- [Automation API](https://github.com/hakanseven12/opencadstudio/blob/main/src/app/control/transport.rs): `src/app/control/transport.rs`
- [Plugin runtime](https://github.com/hakanseven12/opencadstudio/blob/main/src/plugin/external.rs): `src/plugin/external.rs`
- [Plugin host API](https://github.com/hakanseven12/opencadstudio/blob/main/crates/ocs_plugin_api/src/host.rs): `crates/ocs_plugin_api/src/host.rs`
- [MCP endpoint](https://github.com/hakanseven12/opencadstudio/blob/main/src/mcp.rs): `src/mcp.rs`

### Other components

- **CAD user**

## Connections

- CAD user → Desktop or web: opens editor (evidence: `README.md`)
- Desktop or web → App session: starts session
- App session → Editor UI: presents editor (evidence: `src/app/mod.rs`)
- Editor UI → Command tools: issues commands
- Command tools → CAD commands: dispatches tools (evidence: `src/command.rs`)
- CAD commands → Drawing document: edits drawing (evidence: `README.md`)
- Drawing document → Drawing entities: stores entities
- CAD commands → Constraints and snaps: uses drafting aids (evidence: `README.md`)
- CAD commands → Layouts and annotation: creates documentation (evidence: `README.md`)
- CAD commands → 3D modeling: runs modeling tools (evidence: `README.md`)
- Drawing document → Viewport rendering: feeds viewport (evidence: `README.md`)
- Viewport rendering → GPU pipeline: uses GPU (evidence: `README.md`)
- App session → Drawing file I/O: opens and saves (evidence: `src/app/mod.rs`)
- Drawing file I/O → External references: resolves references (evidence: `src/io/mod.rs`)
- CAD user → Automation API: sends JSON commands (evidence: `README.md`)
- Automation API → App session: controls editor (evidence: `README.md`)
- CAD user → MCP endpoint: connects client (evidence: `README.md`)
- MCP endpoint → App session: exposes live editor (evidence: `README.md`)
- App session → Plugin runtime: loads plugins (evidence: `src/app/mod.rs`)
- Plugin runtime → Plugin host API: uses plugin contract
