# deadpiratelive/cadnet-3d architecture

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

- Interactive diagram: https://gitdiagram.com/deadpiratelive/cadnet-3d
- Repository: https://github.com/deadpiratelive/cadnet-3d

## Overview

CADNet-3D turns CAD/BIM files and floorplan images into low-voltage network designs and engineering deliverables. Users submit plans through the FastAPI backend; parsers produce building geometry, spatial analysis informs equipment placement, and cabling is routed before outputs such as BOMs, CAD overlays, runbooks, and a 3D visualization are presented. The graph combines explicit route calls with README-documented product stages; unsampled service wiring is shown only as documented workflow or left unconnected.

Main entry points: [`backend/app/main.py`](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/main.py) (FastAPI API), [`backend/app/schemas/geometry.py`](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/geometry.py) (Building Geometry), [`backend/app/services/manhattan_a_star.py`](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/manhattan_a_star.py) (Cable Pathfinding), [`backend/app/services/facility_location.py`](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/facility_location.py) (MDF/IDF Placement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Plan Ingestion"]
  node_dxf["DXF/DWG Parser<br/>[dxf_parser.py]"]
  node_ifc["IFC Parser<br/>[ifc_parser.py]"]
  node_raster["Raster Vectorizer"]
  node_geometry["Building Geometry<br/>[geometry.py]"]
end

subgraph group_spatial["Spatial Analysis"]
  node_extrusion["3D Extrusion"]
  node_wall["Wall Classification<br/>[wall_classifier.py]"]
  node_rooms["Room Topology<br/>[room_classifier.py]"]
  node_penetration["Penetration Analysis"]
end

subgraph group_design["Network Design"]
  node_facility["MDF/IDF Placement"]
  node_wifi["Wi-Fi Placement<br/>[wifi_solver.py]"]
  node_cctv["CCTV Placement<br/>[cctv_solver.py]"]
  node_poe["PoE Budgeting<br/>[poe_budgeter.py]"]
  node_hardware["Hardware Schemas<br/>[hardware.py]"]
end

subgraph group_routing["Cable Routing"]
  node_grid["Routing Grid"]
  node_astar["Cable Pathfinding"]
  node_riser["Riser Routing<br/>[riser_solver.py]"]
  node_pathschema["Routing Schemas<br/>[pathfinding.py]"]
end

subgraph group_deliver["Engineering Outputs"]
  node_bom["BOM Export<br/>[bom_exporter.py]"]
  node_dxfout["CAD Overlay<br/>[dxf_exporter.py]"]
  node_runbook["Installer Runbook"]
  node_visualizer["3D Studio<br/>[visualizer.html]"]
end

node_user(("Engineer"))
node_api["FastAPI API<br/>[main.py]"]

node_user -->|"submits plan"| node_api
node_api -->|"parses upload"| node_dxf
node_api -->|"routes IFC"| node_ifc
node_api -->|"routes images"| node_raster
node_dxf -->|"produces plan"| node_geometry
node_ifc -->|"produces envelope"| node_geometry
node_raster -->|"produces plan"| node_geometry
node_api -->|"builds topology"| node_rooms
node_api -->|"analyzes floorplan"| node_penetration
node_api -->|"solves racks"| node_facility
node_api -->|"solves coverage"| node_wifi
node_geometry -->|"extrudes geometry"| node_extrusion
node_geometry -->|"classifies walls"| node_wall
node_geometry -->|"classifies rooms"| node_rooms
node_geometry -->|"locates racks"| node_facility
node_geometry -->|"models coverage"| node_wifi
node_api -.->|"solves cameras"| node_cctv
node_api -.->|"budgets power"| node_poe
node_astar -->|"queries neighbors"| node_grid
node_api -.->|"routes cables"| node_astar
node_api -.->|"solves risers"| node_riser
node_api -.->|"exports BOM"| node_bom
node_api -.->|"exports overlay"| node_dxfout
node_api -.->|"generates guide"| node_runbook
node_api -->|"serves studio"| node_visualizer
node_facility -->|"uses device models"| node_hardware
node_astar -->|"returns cable run"| node_pathschema
node_api -.->|"downloads CAD"| node_dxfout
node_api -.->|"downloads schedule"| node_bom

click node_api "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/main.py"
click node_dxf "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/dxf_parser.py"
click node_ifc "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/ifc_parser.py"
click node_raster "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/raster_vectorizer.py"
click node_geometry "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/geometry.py"
click node_extrusion "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/extrusion_service.py"
click node_wall "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/wall_classifier.py"
click node_rooms "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/room_classifier.py"
click node_penetration "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/penetration_model.py"
click node_facility "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/facility_location.py"
click node_wifi "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/wifi_solver.py"
click node_cctv "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/cctv_solver.py"
click node_poe "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/poe_budgeter.py"
click node_grid "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/pathfinding_grid.py"
click node_astar "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/manhattan_a_star.py"
click node_riser "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/riser_solver.py"
click node_bom "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/bom_exporter.py"
click node_dxfout "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/dxf_exporter.py"
click node_runbook "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/runbook_generator.py"
click node_visualizer "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/static/visualizer.html"
click node_hardware "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/hardware.py"
click node_pathschema "https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/pathfinding.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_dxf,node_ifc,node_raster,node_geometry toneBlue
class node_extrusion,node_wall,node_rooms,node_penetration toneAmber
class node_facility,node_wifi,node_cctv,node_poe,node_hardware,node_api toneMint
class node_grid,node_astar,node_riser,node_pathschema toneRose
class node_bom,node_dxfout,node_runbook,node_visualizer,node_user toneIndigo
```

## Components

### Plan Ingestion

- [DXF/DWG Parser](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/dxf_parser.py): `backend/app/parsers/dxf_parser.py`
- [IFC Parser](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/ifc_parser.py): `backend/app/parsers/ifc_parser.py`
- [Raster Vectorizer](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/raster_vectorizer.py): `backend/app/parsers/raster_vectorizer.py`
- [Building Geometry](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/geometry.py): `backend/app/schemas/geometry.py`

### Spatial Analysis

- [3D Extrusion](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/extrusion_service.py): `backend/app/services/extrusion_service.py`
- [Wall Classification](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/wall_classifier.py): `backend/app/services/wall_classifier.py`
- [Room Topology](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/room_classifier.py): `backend/app/services/room_classifier.py`
- [Penetration Analysis](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/penetration_model.py): `backend/app/services/penetration_model.py`

### Network Design

- [MDF/IDF Placement](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/facility_location.py): `backend/app/services/facility_location.py`
- [Wi-Fi Placement](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/wifi_solver.py): `backend/app/services/wifi_solver.py`
- [CCTV Placement](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/cctv_solver.py): `backend/app/services/cctv_solver.py`
- [PoE Budgeting](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/poe_budgeter.py): `backend/app/services/poe_budgeter.py`
- [Hardware Schemas](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/hardware.py): `backend/app/schemas/hardware.py`

### Cable Routing

- [Routing Grid](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/pathfinding_grid.py): `backend/app/services/pathfinding_grid.py`
- [Cable Pathfinding](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/manhattan_a_star.py): `backend/app/services/manhattan_a_star.py`
- [Riser Routing](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/riser_solver.py): `backend/app/services/riser_solver.py`
- [Routing Schemas](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/schemas/pathfinding.py): `backend/app/schemas/pathfinding.py`

### Engineering Outputs

- [BOM Export](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/bom_exporter.py): `backend/app/services/bom_exporter.py`
- [CAD Overlay](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/parsers/dxf_exporter.py): `backend/app/parsers/dxf_exporter.py`
- [Installer Runbook](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/services/runbook_generator.py): `backend/app/services/runbook_generator.py`
- [3D Studio](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/static/visualizer.html): `backend/app/static/visualizer.html`

### Other components

- **Engineer**
- [FastAPI API](https://github.com/deadpiratelive/cadnet-3d/blob/main/backend/app/main.py): `backend/app/main.py`

## Connections

- Engineer → FastAPI API: submits plan (evidence: `README.md`)
- FastAPI API → DXF/DWG Parser: parses upload (evidence: `backend/app/main.py`)
- FastAPI API → IFC Parser: routes IFC (evidence: `README.md`)
- FastAPI API → Raster Vectorizer: routes images (evidence: `README.md`)
- DXF/DWG Parser → Building Geometry: produces plan (evidence: `backend/app/parsers/dxf_parser.py`)
- IFC Parser → Building Geometry: produces envelope (evidence: `backend/app/parsers/ifc_parser.py`)
- Raster Vectorizer → Building Geometry: produces plan (evidence: `backend/app/parsers/raster_vectorizer.py`)
- FastAPI API → Room Topology: builds topology (evidence: `backend/app/main.py`)
- FastAPI API → Penetration Analysis: analyzes floorplan (evidence: `backend/app/main.py`)
- FastAPI API → MDF/IDF Placement: solves racks (evidence: `backend/app/main.py`)
- FastAPI API → Wi-Fi Placement: solves coverage (evidence: `backend/app/main.py`)
- Building Geometry → 3D Extrusion: extrudes geometry (evidence: `backend/app/services/extrusion_service.py`)
- Building Geometry → Wall Classification: classifies walls (evidence: `backend/app/services/wall_classifier.py`)
- Building Geometry → Room Topology: classifies rooms (evidence: `backend/app/services/room_classifier.py`)
- Building Geometry → MDF/IDF Placement: locates racks (evidence: `backend/app/services/facility_location.py`)
- Building Geometry → Wi-Fi Placement: models coverage (evidence: `backend/app/services/wifi_solver.py`)
- FastAPI API → CCTV Placement: solves cameras (evidence: `backend/app/main.py`)
- FastAPI API → PoE Budgeting: budgets power (evidence: `backend/app/main.py`)
- Cable Pathfinding → Routing Grid: queries neighbors (evidence: `backend/app/services/manhattan_a_star.py`)
- FastAPI API → Cable Pathfinding: routes cables (evidence: `backend/app/main.py`)
- FastAPI API → Riser Routing: solves risers (evidence: `backend/app/main.py`)
- FastAPI API → BOM Export: exports BOM (evidence: `backend/app/main.py`)
- FastAPI API → CAD Overlay: exports overlay (evidence: `backend/app/main.py`)
- FastAPI API → Installer Runbook: generates guide (evidence: `backend/app/main.py`)
- FastAPI API → 3D Studio: serves studio (evidence: `backend/app/main.py`)
- MDF/IDF Placement → Hardware Schemas: uses device models (evidence: `backend/app/services/facility_location.py`)
- Cable Pathfinding → Routing Schemas: returns cable run (evidence: `backend/app/services/manhattan_a_star.py`)
- FastAPI API → CAD Overlay: downloads CAD (evidence: `backend/app/main.py`)
- FastAPI API → BOM Export: downloads schedule (evidence: `backend/app/main.py`)
