Build the application

## Build
Detect geometric clashes between HVAC ductwork and structural elements using IfcOpenShell. Formulate collision mitigation offsets and generate standard BIM Collaboration Format coordination topics.

## User
MEP BIM Coordination Specialist

## Workflow
1. Upload structural and mechanical IFC models into the coordination platform.
2. Execute automated geometric collision checks between IfcDuctSegment and IfcBeam entities.
3. Calculate minimal non-colliding lateral and vertical routing elevation adjustments.
4. Generate structured BCF-XML coordination issues assigned to the HVAC design team.

## Interface
3D collision viewer displaying clashing elements in red, clash coordinates, clearance metrics, and BCF issue export options.

## Data
Use open-source multidisciplinary BIM coordination test models from the IfcClash test suite on GitHub.
Starter examples below are synthetic. They are not downloaded records.

## Source
[IfcOpenShell](https://raw.githubusercontent.com/IfcOpenShell/IfcOpenShell/v0.8.0/README.md)
Leverages IfcOpenShell ifcclash and bcf modules to parse intersecting solids and author BCF coordination issues.

## Tools
pydantic-ai, ifcopenshell, fastapi.
Pydantic AI guarantees type safety and strict schema conformance when generating BCF issue records and routing offsets.
Instruction model capable of analyzing geometric coordinate clashes and drafting technical resolution instructions.

## Deliverables
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

## Acceptance
- Identifies intersections between mechanical duct segments and structural framing elements.
- Computes vertical clearance requirements based on duct external cross-sectional dimensions.
- Generates valid BCF-compliant issue payloads containing element GUIDs and viewpoints.

## Starter Examples
```json
[
  {
    "input": {
      "clash_id": "CLASH-MEP-STR-042",
      "duct_element": {
        "guid": "2Vw89a1Lb9FfW0e78c6V12",
        "system": "Supply Air",
        "elevation_center_mm": 3200,
        "height_mm": 400,
        "width_mm": 600
      },
      "beam_element": {
        "guid": "0Kx32b5Mc1HgV3d90a8B34",
        "soffit_elevation_mm": 3100,
        "depth_mm": 500
      }
    },
    "expected_output": {
      "clash_id": "CLASH-MEP-STR-042",
      "collision_detected": true,
      "overlap_distance_mm": 300,
      "resolution_proposal": {
        "recommended_action": "Lower duct elevation",
        "new_center_elevation_mm": 2850,
        "clearance_margin_mm": 50
      },
      "bcf_issue": {
        "topic_type": "Clash",
        "title": "Supply Air Duct Clashing with Structural Steel Beam",
        "priority": "Critical",
        "assigned_to": "HVAC_Lead_Engineer"
      }
    }
  },
  {
    "input": {
      "clash_id": "CLASH-MEP-STR-088",
      "duct_element": {
        "guid": "1Aa11a1Lb9FfW0e78c6V99",
        "system": "Exhaust Air",
        "elevation_center_mm": 2700,
        "height_mm": 300,
        "width_mm": 400
      },
      "beam_element": {
        "guid": "3Zz99b5Mc1HgV3d90a8B11",
        "soffit_elevation_mm": 3200,
        "depth_mm": 450
      }
    },
    "expected_output": {
      "clash_id": "CLASH-MEP-STR-088",
      "collision_detected": false,
      "overlap_distance_mm": 0,
      "resolution_proposal": {
        "recommended_action": "Maintain current alignment",
        "new_center_elevation_mm": 2700,
        "clearance_margin_mm": 350
      },
      "bcf_issue": null
    }
  }
]
```

## Safety
Routing changes are proposed advisory adjustments. Structural and ductwork re-routing must be approved by licensed consulting engineers.
Use mock external writes. Require human review before any real deployment.