# qymis-tech/qymcad architecture

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

## Overview

QymCAD is a desktop parametric mechanical CAD application. A user sketches constrained geometry, creates and edits solid features, then assembles parts with joints; changing an upstream dimension rebuilds dependent timeline features and the assembly. The architecture centers on the project model and its feature/rebuild machinery, backed by an OpenCASCADE B-rep kernel. Exchange and help are separate product capabilities. Relationships below rely on explicit README workflow statements and the shown source index; several implementation details were not sampled, so the graph avoids asserting finer call paths.

Main entry points: [`crates/qymcad/src/main.rs`](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad/src/main.rs) (Desktop application), [`crates/qymcad-core/src/feature.rs`](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/feature.rs) (Feature definitions), [`crates/qymcad-core/src/model.rs`](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model.rs) (Project model), [`crates/qymcad-sketch/src/lib.rs`](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-sketch/src/lib.rs) (Sketch workbench)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_app["Desktop application<br/>[main.rs]"]
  node_sketch_ui["Sketch workbench<br/>[lib.rs]"]
  node_part_ui["Part workbench<br/>[lib.rs]"]
  node_assembly_ui["Assembly workbench<br/>[lib.rs]"]
end

subgraph group_modeling["Parametric modeling"]
  node_project["Project model<br/>[model.rs]"]
  node_sketch_model["Sketch geometry<br/>[sketch.rs]"]
  node_expressions["Dimension expressions<br/>[expr.rs]"]
  node_feature["Feature definitions<br/>[feature.rs]"]
  node_regen["Timeline rebuild<br/>[regen.rs]"]
  node_assembly_model["Assembly model<br/>[assembly.rs]"]
end

subgraph group_geometry["Geometry engine"]
  node_geometry["Geometry primitives<br/>[geom.rs]"]
  node_kernel["B-rep kernel<br/>[lib.rs]"]
  node_tessellation["Model tessellation<br/>[tess.rs]"]
end

subgraph group_product["Product services"]
  node_exchange["Format exchange<br/>[formats.rs]"]
  node_project_file["Project persistence<br/>[doc_file.rs]"]
  node_renderer["Viewport rendering<br/>[lib.rs]"]
  node_help["Built-in help<br/>[lib.rs]"]
end

node_user(("CAD user"))

node_user -->|"uses"| node_app
node_app -->|"starts sketching"| node_sketch_ui
node_app -->|"creates parts"| node_part_ui
node_app -->|"creates assemblies"| node_assembly_ui
node_sketch_ui -.->|"edits sketch"| node_sketch_model
node_sketch_model -->|"solves dimensions"| node_expressions
node_part_ui -.->|"adds features"| node_feature
node_feature -->|"records timeline"| node_project
node_project -->|"rebuilds dependents"| node_regen
node_regen -->|"rebuilds assembly"| node_assembly_model
node_feature -->|"computes B-rep"| node_kernel
node_feature -->|"uses geometry"| node_geometry
node_project -->|"produces view meshes"| node_tessellation
node_assembly_ui -->|"edits joints"| node_assembly_model
node_app -->|"imports and exports"| node_exchange
node_app -->|"saves project"| node_project_file
node_app -.->|"shows model"| node_renderer
node_user -->|"opens help"| node_help

click node_app "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad/src/main.rs"
click node_sketch_ui "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-sketch/src/lib.rs"
click node_part_ui "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-part/src/lib.rs"
click node_project "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model.rs"
click node_sketch_model "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/sketch.rs"
click node_expressions "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/expr.rs"
click node_feature "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/feature.rs"
click node_regen "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/regen.rs"
click node_assembly_ui "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-assembly/src/lib.rs"
click node_assembly_model "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/assembly.rs"
click node_geometry "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/geom.rs"
click node_kernel "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-kernel/src/lib.rs"
click node_tessellation "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/tess.rs"
click node_exchange "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-io/src/formats.rs"
click node_project_file "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/doc_file.rs"
click node_renderer "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-render/src/lib.rs"
click node_help "https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-help/src/lib.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_app,node_sketch_ui,node_part_ui,node_assembly_ui,node_user toneBlue
class node_project,node_sketch_model,node_expressions,node_feature,node_regen,node_assembly_model toneAmber
class node_geometry,node_kernel,node_tessellation toneMint
class node_exchange,node_project_file,node_renderer,node_help toneRose
```

## Components

### User interaction

- [Desktop application](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad/src/main.rs): `crates/qymcad/src/main.rs`
- [Sketch workbench](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-sketch/src/lib.rs): `crates/qymcad-sketch/src/lib.rs`
- [Part workbench](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-part/src/lib.rs): `crates/qymcad-part/src/lib.rs`
- [Assembly workbench](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-assembly/src/lib.rs): `crates/qymcad-assembly/src/lib.rs`

### Parametric modeling

- [Project model](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model.rs): `crates/qymcad-core/src/model.rs`
- [Sketch geometry](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/sketch.rs): `crates/qymcad-core/src/model/sketch.rs`
- [Dimension expressions](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/expr.rs): `crates/qymcad-core/src/expr.rs`
- [Feature definitions](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/feature.rs): `crates/qymcad-core/src/feature.rs`
- [Timeline rebuild](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/regen.rs): `crates/qymcad-core/src/model/regen.rs`
- [Assembly model](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/assembly.rs): `crates/qymcad-core/src/model/assembly.rs`

### Geometry engine

- [Geometry primitives](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/geom.rs): `crates/qymcad-core/src/geom.rs`
- [B-rep kernel](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-kernel/src/lib.rs): `crates/qymcad-kernel/src/lib.rs`
- [Model tessellation](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/model/tess.rs): `crates/qymcad-core/src/model/tess.rs`

### Product services

- [Format exchange](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-io/src/formats.rs): `crates/qymcad-io/src/formats.rs`
- [Project persistence](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-core/src/doc_file.rs): `crates/qymcad-core/src/doc_file.rs`
- [Viewport rendering](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-render/src/lib.rs): `crates/qymcad-render/src/lib.rs`
- [Built-in help](https://github.com/qymis-tech/qymcad/blob/main/crates/qymcad-help/src/lib.rs): `crates/qymcad-help/src/lib.rs`

### Other components

- **CAD user**

## Connections

- CAD user → Desktop application: uses (evidence: `README.md`)
- Desktop application → Sketch workbench: starts sketching (evidence: `README.md`)
- Desktop application → Part workbench: creates parts (evidence: `README.md`)
- Desktop application → Assembly workbench: creates assemblies (evidence: `README.md`)
- Sketch workbench → Sketch geometry: edits sketch
- Sketch geometry → Dimension expressions: solves dimensions (evidence: `README.md`)
- Part workbench → Feature definitions: adds features
- Feature definitions → Project model: records timeline (evidence: `crates/qymcad-core/src/model.rs`)
- Project model → Timeline rebuild: rebuilds dependents (evidence: `README.md`)
- Timeline rebuild → Assembly model: rebuilds assembly (evidence: `README.md`)
- Feature definitions → B-rep kernel: computes B-rep (evidence: `README.md`)
- Feature definitions → Geometry primitives: uses geometry (evidence: `crates/qymcad-core/src/feature.rs`)
- Project model → Model tessellation: produces view meshes (evidence: `crates/qymcad-core/src/model.rs`)
- Assembly workbench → Assembly model: edits joints (evidence: `README.md`)
- Desktop application → Format exchange: imports and exports (evidence: `README.md`)
- Desktop application → Project persistence: saves project (evidence: `README.md`)
- Desktop application → Viewport rendering: shows model
- CAD user → Built-in help: opens help (evidence: `README.md`)
