🏗️ Architecture

ThermX system design, components, and data flow.

High-Level Overview

ThermX uses a modular design separating concerns into distinct layers:

• UI Layer (src/ui/) — Canvas-based geometry editor and visualization
• Model Layer (src/model/) — Data structures for geometry, materials, boundary conditions, and physics
• Solver Layer (src/solver/) — FEM and specialized calculation engines
• I/O Layer (src/io/) — File import/export (THMX, DXF, DWG via libopencad WASM, PDF, CSV)
• API Layer (src/api/) — Authentication and backend integration
• Auth Layer (src/auth/) — Token management and credential storage

Core Components

Model (src/model/)

Project — Root data structure containing:

• grid — Snap-to-grid settings
• layers — Drawable layers (geometry organization)
• regions — 2D polygonal regions with material assignments
• boundaryConditions — Temperature/convection edges
• materials — Material library with thermal properties
• meshSettings — FEM mesh refinement parameters
• solverSettings — Solver algorithm selection
• resultsDisplay — Visualization preferences
• circularPipes — Underfloor heating pipes
• psiComponents — Thermal bridge calculations (PSI values)
• sheets — PDF layout viewport definitions
• viewSettings — Per-tab visibility toggles

Physics (physics.ts) — Constants and utilities:

• Stefan-Boltzmann constant (thermal radiation)
• Gravitational acceleration (convection)
• Universal gas constant
• Thermophysical property helpers

Solver (src/solver/)

• Core Solver — 2D FEM (Cholesky, CG, WebGPU algorithms)
• ISO 15099 (iso15099.ts) — Glazing system calculations
  • Multi-pane window analysis
  • Gas gap properties (air, argon, krypton, xenon)
  • Nusselt number for natural convection
  • Center-of-glass U-value
• Underfloor Heating
  • pipes.ts — Circular pipe model
  • pipeMesh.ts — Mesh generation for pipes
  • pipeConvective.ts — Convective heat transfer coefficients
  • underfloor.ts — Full system calculations

Authentication (src/auth/)

tokenStore — localStorage-based token management:

• saveToken() — Persist license token
• loadToken() — Retrieve stored token
• clearToken() — Remove token on logout

API (src/api/)

auth.ts — Backend integration:

• login() — Email/password authentication
• loginWithLicence() — License key validation
• validateToken() — Verify token validity
• logout() — Clear token and session

Data Flow

Project Model
    ↓
Geometry + Materials + BCs
    ↓
Mesh Generation
    ↓
FEM Solver (2D) OR ISO 15099 (glazing) OR Pipe Heat Transfer
    ↓
Temperature & Heat Flux Results
    ↓
Visualization (color maps, isotherms, arrows)
    ↓
Export (PDF, CSV, DXF)

Build & Dependencies

• Vite — Module bundler for browser
• Tauri — Desktop app wrapper (Rust)
• PixiJS — Canvas rendering via WebGL
• spade WASM — Constrained Delaunay triangulation
• Immer — Immutable state updates
• Vitest — Unit testing framework
• TypeScript — Type safety

Testing

All modules include unit tests in tests/ directory. Run tests with:

npm test