# stelioydev/construaar architecture

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

- Interactive diagram: https://gitdiagram.com/stelioydev/construaar
- Repository: https://github.com/stelioydev/construaar

## Overview

ConstruAR Studio is a Unity Android AR room-planning app. The user workflow is to establish a floor or room, place and edit construction elements or furnishings, apply finishes, review measurements and presentation options, then save or share a proposal. The README also documents costs, project versions, PDF/JSON export, video, and interface profiles. Unity source excerpts were not provided, so app-level connections are dashed and unverified; the backend relationships below are visible in its excerpt.

Main entry points: [`Assets/ConstruAR/Scripts/App/WorkspaceController.cs`](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/App/WorkspaceController.cs) (Workspace), [`Backend/server.py`](https://github.com/stelioydev/construaar/blob/main/Backend/server.py) (Proposal HTTP API), [`Assets/ConstruAR/Scripts/App/ConstruARApp.cs`](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/App/ConstruARApp.cs) (App & Profiles), [`Assets/ConstruAR/Scripts/AR/PlacementProvider.cs`](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/AR/PlacementProvider.cs) (AR Placement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["AR Planning"]
  node_app_entry["App &amp; Profiles<br/>[ConstruARApp.cs]"]
  node_workspace["Workspace"]
  node_floor["Floor Setup<br/>[FloorGeometry.cs]"]
  node_placement["AR Placement"]
end

subgraph group_design["Room Design"]
  node_construction["Construction Elements<br/>[ObjectSpawner.cs]"]
  node_catalog["Models &amp; Finishes<br/>[ModelCatalog.cs]"]
  node_manipulation["Object Editing"]
  node_wall["Wall Finishes<br/>[WallPainterV4.cs]"]
  node_measurement["Measurements<br/>[MeasurementV4.cs]"]
  node_lighting["Lighting &amp; Compare<br/>[LightingV4.cs]"]
end

subgraph group_projects["Projects &amp; Output"]
  node_projects_data["Project Layout<br/>[LayoutData.cs]"]
  node_project_store[("Project Storage<br/>[ProjectStore.cs]")]
  node_costs["Cost Estimates<br/>[StudioCostsV4.cs]"]
  node_capture["Capture &amp; Video<br/>[CaptureService.cs]"]
  node_export["Project Export<br/>[ProjectExporter.cs]"]
end

subgraph group_sharing["Proposal Sharing"]
  node_cloud_share["Cloud Sharing<br/>[CloudShareV4.cs]"]
  node_backend_handler["Proposal HTTP API<br/>[server.py]"]
  node_backend_store[("Proposal Store<br/>[server.py]")]
  node_proposal_page["Proposal Web View<br/>[server.py]"]
end

node_user(("User"))

node_user -.->|"uses"| node_app_entry
node_app_entry -.->|"opens workspace"| node_workspace
node_workspace -.->|"sets floor"| node_floor
node_workspace -.->|"places items"| node_placement
node_placement -.->|"positions"| node_construction
node_workspace -.->|"selects models"| node_catalog
node_workspace -.->|"edits objects"| node_manipulation
node_workspace -.->|"applies finishes"| node_wall
node_workspace -.->|"measures"| node_measurement
node_workspace -.->|"presents"| node_lighting
node_workspace -.->|"records layout"| node_projects_data
node_projects_data -.->|"persists"| node_project_store
node_workspace -.->|"estimates costs"| node_costs
node_workspace -.->|"captures"| node_capture
node_workspace -.->|"exports"| node_export
node_workspace -.->|"shares proposal"| node_cloud_share
node_backend_handler -->|"creates or reads"| node_backend_store
node_backend_handler -->|"renders page"| node_proposal_page
node_cloud_share -.->|"submits proposal"| node_backend_handler

click node_app_entry "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/App/ConstruARApp.cs"
click node_workspace "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/App/WorkspaceController.cs"
click node_floor "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/AR/FloorGeometry.cs"
click node_placement "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/AR/PlacementProvider.cs"
click node_construction "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Objects/ObjectSpawner.cs"
click node_catalog "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Objects/ModelCatalog.cs"
click node_manipulation "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Objects/ObjectManipulator.cs"
click node_wall "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/WallPainterV4.cs"
click node_measurement "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/MeasurementV4.cs"
click node_lighting "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/LightingV4.cs"
click node_projects_data "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/LayoutData.cs"
click node_project_store "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/ProjectStore.cs"
click node_costs "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/StudioCostsV4.cs"
click node_capture "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/CaptureService.cs"
click node_export "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/ProjectExporter.cs"
click node_cloud_share "https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/CloudShareV4.cs"
click node_backend_handler "https://github.com/stelioydev/construaar/blob/main/Backend/server.py"
click node_backend_store "https://github.com/stelioydev/construaar/blob/main/Backend/server.py"
click node_proposal_page "https://github.com/stelioydev/construaar/blob/main/Backend/server.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_app_entry,node_workspace,node_floor,node_placement,node_user toneBlue
class node_construction,node_catalog,node_manipulation,node_wall,node_measurement,node_lighting toneAmber
class node_projects_data,node_project_store,node_costs,node_capture,node_export toneMint
class node_cloud_share,node_backend_handler,node_backend_store,node_proposal_page toneRose
```

## Components

### AR Planning

- [App & Profiles](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/App/ConstruARApp.cs): `Assets/ConstruAR/Scripts/App/ConstruARApp.cs`
- [Workspace](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/App/WorkspaceController.cs): `Assets/ConstruAR/Scripts/App/WorkspaceController.cs`
- [Floor Setup](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/AR/FloorGeometry.cs): `Assets/ConstruAR/Scripts/AR/FloorGeometry.cs`
- [AR Placement](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/AR/PlacementProvider.cs): `Assets/ConstruAR/Scripts/AR/PlacementProvider.cs`

### Room Design

- [Construction Elements](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Objects/ObjectSpawner.cs): `Assets/ConstruAR/Scripts/Objects/ObjectSpawner.cs`
- [Models & Finishes](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Objects/ModelCatalog.cs): `Assets/ConstruAR/Scripts/Objects/ModelCatalog.cs`
- [Object Editing](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Objects/ObjectManipulator.cs): `Assets/ConstruAR/Scripts/Objects/ObjectManipulator.cs`
- [Wall Finishes](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/WallPainterV4.cs): `Assets/ConstruAR/Scripts/Studio/WallPainterV4.cs`
- [Measurements](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/MeasurementV4.cs): `Assets/ConstruAR/Scripts/Studio/MeasurementV4.cs`
- [Lighting & Compare](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/LightingV4.cs): `Assets/ConstruAR/Scripts/Studio/LightingV4.cs`

### Projects & Output

- [Project Layout](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/LayoutData.cs): `Assets/ConstruAR/Scripts/Projects/LayoutData.cs`
- [Project Storage](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/ProjectStore.cs): `Assets/ConstruAR/Scripts/Projects/ProjectStore.cs`
- [Cost Estimates](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/StudioCostsV4.cs): `Assets/ConstruAR/Scripts/Studio/StudioCostsV4.cs`
- [Capture & Video](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/CaptureService.cs): `Assets/ConstruAR/Scripts/Projects/CaptureService.cs`
- [Project Export](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Projects/ProjectExporter.cs): `Assets/ConstruAR/Scripts/Projects/ProjectExporter.cs`

### Proposal Sharing

- [Cloud Sharing](https://github.com/stelioydev/construaar/blob/main/Assets/ConstruAR/Scripts/Studio/CloudShareV4.cs): `Assets/ConstruAR/Scripts/Studio/CloudShareV4.cs`
- [Proposal HTTP API](https://github.com/stelioydev/construaar/blob/main/Backend/server.py): `Backend/server.py`
- [Proposal Store](https://github.com/stelioydev/construaar/blob/main/Backend/server.py): `Backend/server.py`
- [Proposal Web View](https://github.com/stelioydev/construaar/blob/main/Backend/server.py): `Backend/server.py`

### Other components

- **User**

## Connections

- User → App & Profiles: uses
- App & Profiles → Workspace: opens workspace
- Workspace → Floor Setup: sets floor
- Workspace → AR Placement: places items
- AR Placement → Construction Elements: positions
- Workspace → Models & Finishes: selects models
- Workspace → Object Editing: edits objects
- Workspace → Wall Finishes: applies finishes
- Workspace → Measurements: measures
- Workspace → Lighting & Compare: presents
- Workspace → Project Layout: records layout
- Project Layout → Project Storage: persists
- Workspace → Cost Estimates: estimates costs
- Workspace → Capture & Video: captures
- Workspace → Project Export: exports
- Workspace → Cloud Sharing: shares proposal
- Proposal HTTP API → Proposal Store: creates or reads (evidence: `Backend/server.py`)
- Proposal HTTP API → Proposal Web View: renders page (evidence: `Backend/server.py`)
- Cloud Sharing → Proposal HTTP API: submits proposal
