用途:为 AppFolio 物业管理 API 集成搭建本地开发循环,提供快速反馈,用模拟的属性、租户和租约端点在不消耗线上 API 配额的情况下构建与测试集成,并可在模拟模式(快速迭代)与沙箱模式(部署前验证真实 AppFolio Stack API)间切换。
主要能力与用法:本地服务器仅以模拟模式运行,针对合成路由与确定性 fixture 进行读写;在接入沙箱前,用单元测试验证请求校验、幂等、脱敏与错误处理;沙箱通道单独运行,使用契约绑定的托管客户端和一个已授权的安全只读 fixture,不得把本地代理变成实时 API 隧道。环境设置示例:cp .env.example .env,本地留空提供方凭据,默认 MOCK_MODE=true;npm install express axios dotenv tsx typescript @types/node;npm install -D vitest supertest @types/express。测试命令:npm run dev:mock &、npm run test、npm run test -- --watch、npm run test:sandbox。
适用场景:物业管理数据集成开发、工单类 UI 变更的本地验证、无线上配额消耗的迭代。
限制与前提:需要仅含合成数据(无真实地址、姓名、付款)的本地环境与 fixture;需单独管理的沙箱凭据与已批准的安全只读 fixture,且不被本地开发服务器加载;日志策略仅记录请求形态与状态,并明确沙箱配额、fixture 重置和凭据轮换的负责人。当 fixture、凭据、请求预算或输出脱敏未验证时应停止并修正环境。常见错误包括 401、403、404、429 以及端口 3001 连接被拒。其余具体细节暂未提供。