How Can Property-Management Automation Handle Maintenance Requests?

from pydantic import BaseModel
from typing import List, Optional
import httpx

class MaintenanceTicket(BaseModel):
    unit_id: str
    tenant_name: str
    tenant_phone: str
    category: str  # plumbing, hvac, electrical, appliance
    description: str
    severity: str  # emergency, high, routine
    media_urls: List[str]
    nte_limit_cents: int = 35000  # $350 Not-To-Exceed limit

async def route_work_order_to_appfolio(ticket: MaintenanceTicket, api_token: str):
    headers = {"Authorization": f"Bearer {api_token}", "Content-Type": "application/json"}
    
    # Construct structured work order payload
    work_order_data = {
        "unit_id": ticket.unit_id,
        "priority": "emergency" if ticket.severity == "emergency" else "normal",
        "description": f"AI Diagnostic Report:\n{ticket.description}",
        "not_to_exceed_cents": ticket.nte_limit_cents,
        "attachments": ticket.media_urls,
        "status": "assigned" if ticket.severity == "emergency" else "open"
    }
    
    async with httpx.AsyncClient() as client:
        # Step 1: Create work order ticket
        resp = await client.post("https://api.appfolio.com/v1/work_orders", headers=headers, json=work_order_data)
        wo_record = resp.json()
        
        # Step 2: If true emergency, trigger automated SMS dispatch to primary trade roster
        if ticket.severity == "emergency":
            await client.post(
                "https://api.appfolio.com/v1/vendor_dispatches",
                headers=headers,
                json={"work_order_id": wo_record["id"], "trade": ticket.category, "auto_notify": True}
            )
            
    return {"status": "success", "work_order_id": wo_record.get("id"), "dispatch_mode": ticket.severity}