Skip to main content
Challenge

Build an IFC Operations Work Order BCF Dispatcher

Process property management maintenance requests against IFC spatial hierarchies using IfcOpenShell BCF modules. Construct standard BCF-XML action topics linking malfunctioning equipment to spatial locations.

EngineeringHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Process property management maintenance requests against IFC spatial hierarchies using IfcOpenShell BCF modules. Construct standard BCF-XML action topics linking malfunctioning equipment to spatial locations.

Facility Operations Manager

Receive tenant work orders detailing localized building service issues.

Resolve affected spatial rooms and equipment identifiers against IFC model definitions.

Generate standard BCF issue payload with camera viewpoint guidance via IfcOpenShell bcf library.

Export BCF-XML archive ready for contractor dispatch and operations tracking.

Operations ticket UI with IFC spatial location picker, issue description, and BCF download button.

Author mock maintenance requests mapped to synthetic IFC building storeys and mechanical spaces. Starter examples below are synthetic. They are not downloaded records.

IfcOpenShell Leverages the bcf library listed in IfcOpenShell documentation for reading and writing BCF-XML topics.

langgraph, python-bcf, fastapi. LangGraph manages stateful transitions between ticket ingestion, spatial IFC matching, and BCF generation. Local or cloud LLM with strong text extraction and structured JSON generation capability.

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.

Generated BCF topic contains valid title, guid, priority, and spatial reference.

Work orders without matching equipment are assigned to building storey level with fallback note.

BCF payload structure validates against buildingSMART XML schema standards.

```json [ { "input": { "ticket_id": "WO-4401", "description": "Leaking chilled water valve near mechanical room ceiling.", "storey": "Level 02", "room": "Room-204", "equipment_id": "VLV-CW-09" }, "expected_output": { "bcf_topic_guid": "a82f1b40-9e32-4e12-bbf1-893f44109121", "title": "Maintenance: VLV-CW-09 Leakage", "stage": "Assigned", "priority": "HIGH", "spatial_target": "Level 02 / Room-204", "bcf_xml_ready": true } }, { "input": { "ticket_id": "WO-4402", "description": "Flickering overhead light in main corridor.", "storey": "Level 01", "room": "Corridor-North", "equipment_id": null }, "expected_output": { "bcf_topic_guid": "b71e0c21-8d21-4f11-abf0-782e33098010", "title": "Maintenance: Unspecified Luminaire", "stage": "Triage", "priority": "MEDIUM", "spatial_target": "Level 01 / Corridor-North", "bcf_xml_ready": true } } ] ```

Simulates dispatch workflows; does not interact directly with live electrical or pressurized plumbing hardware. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Simulates dispatch workflows; does not interact directly with live electrical or pressurized plumbing hardware. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Generated BCF topic contains valid title, guid, priority, and spatial reference. Work orders without matching equipment are assigned to building storey level with fallback note. BCF payload structure validates against buildingSMART XML schema standards.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Receive tenant work orders detailing localized building service issues. Resolve affected spatial rooms and equipment identifiers against IFC model definitions. Generate standard BCF issue payload with camera viewpoint guidance via IfcOpenShell bcf library. Export BCF-XML archive ready for contractor dispatch and operations tracking.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Generated BCF topic contains valid title, guid, priority, and spatial reference. Work orders without matching equipment are assigned to building storey level with fallback note. BCF payload structure validates against buildingSMART XML schema standards.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Operations ticket UI with IFC spatial location picker, issue description, and BCF download button.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Simulates dispatch workflows; does not interact directly with live electrical or pressurized plumbing hardware.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Receive tenant work orders detailing localized building service issues.

  • Resolve affected spatial rooms and equipment identifiers against IFC model definitions.

  • Generate standard BCF issue payload with camera viewpoint guidance via IfcOpenShell bcf library.

  • Export BCF-XML archive ready for contractor dispatch and operations tracking.

Resources and assets

Reference links and supporting material

Dataset notes

Author mock maintenance requests mapped to synthetic IFC building storeys and mechanical spaces. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

LangGraph

Runtime for stateful agent workflows.

Evaluated output

No output checks are configured.

Evaluation checks
  • Receive tenant work orders detailing localized building service issues. Resolve affected spatial rooms and...
  • Generated BCF topic contains valid title, guid, priority, and spatial reference. Work orders without matchi...
  • Operations ticket UI with IFC spatial location picker, issue description, and BCF download button.
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • LangGraph · Optional
Orchestration
  • LangGraph · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build an IFC Operations Work Order BCF Dispatcher