用途：通过 AppFolio Stack API 管理维修工单全生命周期。当租户提交维修请求、需要为未结工单指派供应商、跨物业跟踪维修进度，或以成本记录结清完工任务时使用。这是次要工作流，物业仪表板与租赁相关功能见 appfolio-core-workflow-a。
前提条件：需具备已核验的 AppFolio 合约与沙箱组合，含合成的物业、单元、供应商和工单记录；不得对在用的生产单元测试维修自动化。需最小权限服务身份、创建与关闭操作的空等幂支持，以及针对安全关键维修的经批准升级路径。需遵循数据最小化策略，只存储与传输执行工作所需的维修事实，不得在供应商通用备注或日志中记录租户偏好、门禁码或详细居住信息。
主要能力与使用方式：
- 从维修请求创建工单：调用 client.workOrders.create，传入 property_id、unit_id、category、priority、description、requested_by、due_date。
- 指派供应商：调用 client.workOrders.assign，传入 vendor_id、scheduled_date、time_window、notes。
- 跟踪状态：调用 client.workOrders.list，按 property_id、status 数组、sort 查询未结工单。
- 结清工单：调用 client.workOrders.close，记录 resolution、labor_cost、materials_cost、completed_date、attachments。
错误处理：401 表示凭据过期或无效，需在 Stack 仪表板刷新 client_id/secret；404 为工单 ID 错误或已删除，用 workOrders.list() 核实；422 为缺少必填字段，如 category 或 property_id；409 为工单已关闭，关闭前先检查状态；429 为超出每分钟 120 次请求限制，需加入 1 秒基础延迟的指数退避。
输出：成功运行会创建工单、指派供应商并安排服务时间窗口、以成本记录与解决备注结清工单，物业经理可获得从请求到完成的完整审计轨迹。
示例要点：在沙箱管道工作流中，使用稳定空等幂键创建一个合成工单，指派沙箱供应商，在任何状态转换前读回其状态；仅附加非敏感测试收据，只关闭一次并验证总额与审计记录，不记录租户或门禁详情；重放同一请求以证明重复工单与重复成本记录会被拒绝。若供应商指派、安全分类、先前状态或关闭结果不确定，应保持工单未结并交由授权物业运营人员复核。
资源：AppFolio Stack APIs 与 AppFolio 工程博客。认证设置与分页辅助参见 appfolio-sdk-patterns。