用途：用于 AppFolio 物业管理集成在版本化 REST API 演进时的升级与迁移，处理字段重命名、分页模型变化、工单端点弃用及基础认证流程调整。
主要能力：检测当前 API 版本并与最新版本对比；根据变更日志梳理破坏性变更；对物业与租户响应对象套用 schema 迁移转换；将端点 URL 从旧版本前缀更新为新前缀；在需要时把偏移分页切换为游标分页；对 staging 运行冒烟测试；带自动回滚策略部署到生产；监控 410/401 响应以发现遗漏的迁移步骤。输出包括 VersionInfo（当前、最新、已弃用版本）、转换后的物业与租户对象、属性/租户/工单/会计端点的冒烟测试结果，以及回滚日志。
使用方式：前置条件为记录当前 API 版本前缀（如 /api/v1/）、可访问 AppFolio API 变更日志、具备含测试物业与租户数据的 staging 环境、在环境变量中保存 client ID 与 secret、存在覆盖核心端点的集成测试套件。流程为版本检测、审查变更日志、应用 schema 迁移、更新端点 URL、按需切换分页、运行冒烟测试、启用回滚部署生产、监控错误日志。示例代码展示了 detectApiVersion、migrateProperty、migrateTenant 与 versionAwareRequest 的用法。
适用场景：AppFolio 版本升级、端点变更、字段重命名、分页迁移及集成验证。
限制：资料未提供具体收费、价格或平台支持范围；迁移前需自行准备 staging 与测试数据，且需以真实变更日志为准。