# diez111/grafito-open architecture

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

- Interactive diagram: https://gitdiagram.com/diez111/grafito-open
- Repository: https://github.com/diez111/grafito-open

## Overview

Grafito is a Rust desktop mathematics workspace for interactive geometry, algebra, statistics, and calculus, with GPU-backed 2D/3D views. The main user flow is entering a command or using a canvas tool, updating a mathematical document, and viewing the result; the README also documents analysis and symbolic commands. The workspace includes assistant, classroom, and animation capabilities. Edges are limited to README statements and relationships visible in indexed excerpts; dashed, uncited links mark plausible integrations whose implementation was not sampled.

Main entry points: [`crates/grafito-app/src/app.rs`](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/app.rs) (App Loop), [`crates/grafito-command/src/command_registry.rs`](https://github.com/diez111/grafito-open/blob/main/crates/grafito-command/src/command_registry.rs) (Command Registry), [`crates/grafito-app/src/canvas.rs`](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/canvas.rs) (Canvas), [`crates/grafito-core/src/document.rs`](https://github.com/diez111/grafito-open/blob/main/crates/grafito-core/src/document.rs) (Math Document)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace UI"]
  node_app["App Loop<br/>[app.rs]"]
  node_ui["Workspace UI<br/>[ui.rs]"]
  node_panels["Algebra Panels<br/>[panels.rs]"]
  node_tools["Canvas Tools<br/>[tool_dispatcher.rs]"]
end

subgraph group_math["Math Model"]
  node_commands["Command Registry"]
  node_geometry["Math Engine<br/>[symbolic.rs]"]
  node_document[("Math Document<br/>[document.rs]")]
  node_constraints["Constraint Solver<br/>[numeric_solver.rs]"]
  node_complex["Complex Math<br/>[complex_expr.rs]"]
end

subgraph group_graphics["Rendering"]
  node_canvas["Canvas<br/>[canvas.rs]"]
  node_render2d["2D Rendering<br/>[render_2d.rs]"]
  node_render3d["3D Rendering<br/>[render_3d.rs]"]
  node_gpu["GPU Renderer<br/>[lib.rs]"]
end

subgraph group_learning["Learning Tools"]
  node_assistant["Assistant<br/>[agent.rs]"]
  node_assistant_web["Remote Assistant<br/>[web.rs]"]
  node_profile[("Student Profile<br/>[lib.rs]")]
  node_classroom["Classroom Sessions<br/>[session.rs]"]
end

subgraph group_media["Media"]
  node_animation["Animation Engine<br/>[engine.rs]"]
  node_anim_protocol["Animation Protocol<br/>[protocol.rs]"]
  node_anim_templates["Scene Templates<br/>[tpl_3d.rs]"]
  node_export["Export<br/>[export.rs]"]
  node_native_anim["Native Animation<br/>[anim_native.rs]"]
end

node_user(("Learner"))

node_user -->|"interacts"| node_ui
node_user -->|"enters commands"| node_commands
node_ui -.->|"drives"| node_app
node_commands -->|"creates objects"| node_document
node_user -->|"draws with"| node_tools
node_tools -.->|"updates"| node_document
node_document -->|"solves constraints"| node_constraints
node_commands -.->|"evaluates math"| node_geometry
node_app -->|"dispatches view"| node_canvas
node_canvas -->|"uses"| node_render2d
node_canvas -->|"uses"| node_render3d
node_render2d -.->|"renders via"| node_gpu
node_render3d -.->|"renders via"| node_gpu
node_app -->|"dispatches UI"| node_panels
node_assistant -->|"requests remote"| node_assistant_web
node_assistant -.->|"adapts learning"| node_profile
node_app -.->|"supports sessions"| node_classroom
node_animation -->|"uses wire format"| node_anim_protocol
node_anim_protocol -->|"dispatches scenes"| node_anim_templates
node_app -.->|"provides animation"| node_native_anim
node_app -.->|"orchestrates jobs"| node_animation
node_app -.->|"exports work"| node_export

click node_app "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/app.rs"
click node_ui "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/ui.rs"
click node_panels "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/panels.rs"
click node_tools "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/tool_dispatcher.rs"
click node_commands "https://github.com/diez111/grafito-open/blob/main/crates/grafito-command/src/command_registry.rs"
click node_geometry "https://github.com/diez111/grafito-open/blob/main/crates/grafito-geometry/src/symbolic.rs"
click node_document "https://github.com/diez111/grafito-open/blob/main/crates/grafito-core/src/document.rs"
click node_constraints "https://github.com/diez111/grafito-open/blob/main/crates/grafito-core/src/numeric_solver.rs"
click node_complex "https://github.com/diez111/grafito-open/blob/main/crates/grafito-complex/src/math/complex_expr.rs"
click node_canvas "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/canvas.rs"
click node_render2d "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/render_2d.rs"
click node_render3d "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/render_3d.rs"
click node_gpu "https://github.com/diez111/grafito-open/blob/main/crates/grafito-render/src/lib.rs"
click node_assistant "https://github.com/diez111/grafito-open/blob/main/crates/grafito-assistant/src/agent.rs"
click node_assistant_web "https://github.com/diez111/grafito-open/blob/main/crates/grafito-assistant/src/web.rs"
click node_profile "https://github.com/diez111/grafito-open/blob/main/crates/grafito-profile/src/lib.rs"
click node_classroom "https://github.com/diez111/grafito-open/blob/main/crates/grafito-classroom/src/session.rs"
click node_animation "https://github.com/diez111/grafito-open/blob/main/crates/grafito-anim/src/engine.rs"
click node_anim_protocol "https://github.com/diez111/grafito-open/blob/main/crates/grafito-anim/src/protocol.rs"
click node_anim_templates "https://github.com/diez111/grafito-open/blob/main/crates/grafito-anim/src/tpl_3d.rs"
click node_export "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/export.rs"
click node_native_anim "https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/anim_native.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_ui,node_panels,node_tools toneBlue
class node_commands,node_geometry,node_document,node_constraints,node_complex toneAmber
class node_canvas,node_render2d,node_render3d,node_gpu toneMint
class node_assistant,node_assistant_web,node_profile,node_classroom toneRose
class node_animation,node_anim_protocol,node_anim_templates,node_export,node_native_anim,node_user toneIndigo
```

## Components

### Workspace UI

- [App Loop](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/app.rs): `crates/grafito-app/src/app.rs`
- [Workspace UI](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/ui.rs): `crates/grafito-app/src/ui.rs`
- [Algebra Panels](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/panels.rs): `crates/grafito-app/src/panels.rs`
- [Canvas Tools](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/tool_dispatcher.rs): `crates/grafito-app/src/tool_dispatcher.rs`

### Math Model

- [Command Registry](https://github.com/diez111/grafito-open/blob/main/crates/grafito-command/src/command_registry.rs): `crates/grafito-command/src/command_registry.rs`
- [Math Engine](https://github.com/diez111/grafito-open/blob/main/crates/grafito-geometry/src/symbolic.rs): `crates/grafito-geometry/src/symbolic.rs`
- [Math Document](https://github.com/diez111/grafito-open/blob/main/crates/grafito-core/src/document.rs): `crates/grafito-core/src/document.rs`
- [Constraint Solver](https://github.com/diez111/grafito-open/blob/main/crates/grafito-core/src/numeric_solver.rs): `crates/grafito-core/src/numeric_solver.rs`
- [Complex Math](https://github.com/diez111/grafito-open/blob/main/crates/grafito-complex/src/math/complex_expr.rs): `crates/grafito-complex/src/math/complex_expr.rs`

### Rendering

- [Canvas](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/canvas.rs): `crates/grafito-app/src/canvas.rs`
- [2D Rendering](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/render_2d.rs): `crates/grafito-app/src/render_2d.rs`
- [3D Rendering](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/render_3d.rs): `crates/grafito-app/src/render_3d.rs`
- [GPU Renderer](https://github.com/diez111/grafito-open/blob/main/crates/grafito-render/src/lib.rs): `crates/grafito-render/src/lib.rs`

### Learning Tools

- [Assistant](https://github.com/diez111/grafito-open/blob/main/crates/grafito-assistant/src/agent.rs): `crates/grafito-assistant/src/agent.rs`
- [Remote Assistant](https://github.com/diez111/grafito-open/blob/main/crates/grafito-assistant/src/web.rs): `crates/grafito-assistant/src/web.rs`
- [Student Profile](https://github.com/diez111/grafito-open/blob/main/crates/grafito-profile/src/lib.rs): `crates/grafito-profile/src/lib.rs`
- [Classroom Sessions](https://github.com/diez111/grafito-open/blob/main/crates/grafito-classroom/src/session.rs): `crates/grafito-classroom/src/session.rs`

### Media

- [Animation Engine](https://github.com/diez111/grafito-open/blob/main/crates/grafito-anim/src/engine.rs): `crates/grafito-anim/src/engine.rs`
- [Animation Protocol](https://github.com/diez111/grafito-open/blob/main/crates/grafito-anim/src/protocol.rs): `crates/grafito-anim/src/protocol.rs`
- [Scene Templates](https://github.com/diez111/grafito-open/blob/main/crates/grafito-anim/src/tpl_3d.rs): `crates/grafito-anim/src/tpl_3d.rs`
- [Export](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/export.rs): `crates/grafito-app/src/export.rs`
- [Native Animation](https://github.com/diez111/grafito-open/blob/main/crates/grafito-app/src/anim_native.rs): `crates/grafito-app/src/anim_native.rs`

### Other components

- **Learner**

## Connections

- Learner → Workspace UI: interacts (evidence: `README.md`)
- Learner → Command Registry: enters commands (evidence: `README.md`)
- Workspace UI → App Loop: drives (evidence: `crates/grafito-app/src/app.rs`)
- Command Registry → Math Document: creates objects (evidence: `README.md`)
- Learner → Canvas Tools: draws with (evidence: `README.md`)
- Canvas Tools → Math Document: updates
- Math Document → Constraint Solver: solves constraints (evidence: `crates/grafito-core/src/document.rs`)
- Command Registry → Math Engine: evaluates math
- App Loop → Canvas: dispatches view (evidence: `crates/grafito-app/src/app.rs`)
- Canvas → 2D Rendering: uses (evidence: `crates/grafito-app/src/canvas.rs`)
- Canvas → 3D Rendering: uses (evidence: `crates/grafito-app/src/canvas.rs`)
- 2D Rendering → GPU Renderer: renders via
- 3D Rendering → GPU Renderer: renders via
- App Loop → Algebra Panels: dispatches UI (evidence: `crates/grafito-app/src/app.rs`)
- Assistant → Remote Assistant: requests remote (evidence: `crates/grafito-assistant/src/agent.rs`)
- Assistant → Student Profile: adapts learning
- App Loop → Classroom Sessions: supports sessions
- Animation Engine → Animation Protocol: uses wire format (evidence: `crates/grafito-anim/src/engine.rs`)
- Animation Protocol → Scene Templates: dispatches scenes (evidence: `crates/grafito-anim/src/protocol.rs`)
- App Loop → Native Animation: provides animation
- App Loop → Animation Engine: orchestrates jobs
- App Loop → Export: exports work (evidence: `crates/grafito-app/src/app.rs`)
