用途：这是 AppFolio 物业管理集成的主工作流，用于构建物业管理仪表板，覆盖物业全生命周期——创建与更新物业记录、管理租户档案与租约协议、查询入住/空置数据。使用 AppFolio Stack API，采用 OAuth 2.0 客户端凭证做服务器间访问，端点返回 JSON 并支持游标分页。
主要能力：认证并初始化客户端；创建或更新物业（含单元信息）；添加租户并绑定租约；按状态查询单元（如 vacant）并统计空置数量。
使用方式：先确认服务商签发的 base URL 与认证流程，再复制客户端配置。认证示例：向 https://api.appfolio.com/oauth/token 以 client_credentials 方式请求，scope 为 'properties tenants leases'，使用环境变量 APPFOLIO_CLIENT_ID 与 APPFOLIO_CLIENT_SECRET。随后调用 /v1/properties、/v1/tenants、/v1/leases 等端点，查询空置用 /v1/properties/{id}/units?status=vacant。
适用场景：需要以编程方式管理物业组合、租户与租约，并生成入住率仪表板的团队。
限制与前置条件：需有效的 AppFolio 合作伙伴/API 合同，明确 base URL、认证方式、授权范围与写入能力，不得从教程或其他组合推断；需独立沙箱与合成数据、凭证负责人与请求预算；写入需幂等键及经批准的回滚/对账流程，因物业、租户、租约写入可能产生真实法律与计费后果。仅在沙箱用合成数据演练创建/更新路径，重试不确定写入前先读取规范记录；创建租约前校验所有权、租约日期与单元可用性，只输出记录 ID 与脱敏状态证据；只有在分阶段演练证明回滚、对账与最小权限边界后才推广可写流程。常见错误包括 401（令牌失效）、404（ID 错误）、422（缺必填字段）、409（单元重复租约）、429（超限，按 Retry-After 退避）。后续可继续使用 appfolio-core-workflow-b 处理维护请求与付款跟踪。