Build a Predictive Facility Maintenance Work-Order Generator — implementation

## Build
Combine building operational runtimes and BMS telemetry with IFC equipment metadata to generate preventive work orders. Prioritize maintenance schedules based on component degradation thresholds.

## User
Operations & Maintenance Facility Supervisor

## Workflow
1. Extract equipment service records and parent building associations from IFC assets.
2. Ingest sensor operational hours and vibration telemetry streams.
3. Compare cumulative operating hours against manufacturer recommended servicing milestones.
4. Dispatch prioritized preventive maintenance work orders to facility dispatch queue.

## Interface
Maintenance management console displaying equipment runtime progress bars, health scores, and work tickets.

## Data
Construct synthetic runtime logs matched against equipment GUIDs from sample IFC files.
Starter examples below are synthetic. They are not downloaded records.

## Source
[IfcOpenShell](https://raw.githubusercontent.com/IfcOpenShell/IfcOpenShell/v0.8.0/README.md)
Extracts facility asset information utilizing IfcOpenShell ifcfm data export conventions.

## Tools
crewai, pydantic, fastapi.
CrewAI facilitates multi-agent delegation between equipment health evaluation and work-order scheduling roles.
Reliable hosted or local language model capable of deterministic structured ticket generation.

## 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
- Correlates IFC asset GUID with incoming operating hour telemetry.
- Generates work-order payload when running hours exceed 90 percent of service interval.
- Calculates priority score based on system criticality and remaining runtime buffer.

## Starter Examples
```json
[
  {
    "input": {
      "asset_guid": "ASSET-CHILLER-01",
      "asset_name": "Centrifugal Chiller 1",
      "service_interval_hours": 2000,
      "current_run_hours": 1920,
      "criticality": "HIGH"
    },
    "expected_output": {
      "generate_work_order": true,
      "priority": "URGENT",
      "runtime_remaining_hours": 80,
      "ticket": {
        "task": "Compressor lubrication and seal inspection",
        "due_within_days": 5
      }
    }
  },
  {
    "input": {
      "asset_guid": "ASSET-FAN-08",
      "asset_name": "Exhaust Fan East",
      "service_interval_hours": 1500,
      "current_run_hours": 420,
      "criticality": "LOW"
    },
    "expected_output": {
      "generate_work_order": false,
      "priority": "NORMAL",
      "runtime_remaining_hours": 1080,
      "ticket": null
    }
  }
]
```

## Safety
Dispatches maintenance drafts into simulated CMMS; does not directly trigger physical plant control overrides.
Use mock external writes. Require human review before any real deployment.