AppFolio 参考架构
架构
┌──────────────────────────────────────────────┐
│ 你的应用 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │Dashboard │ │ 同步 │ │ Webhook │ │
│ │(React) │ │ 服务 │ │ 处理程序 │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ AppFolio API 客户端 │ │
│ │ (基本认证, 重试, 缓存, 速率限制) │ │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ AppFolio Stack API │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
项目结构
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # 带基本认证的类型化 REST 客户端
│ │ ├── cache.ts # 带 TTL 的响应缓存
│ │ └── types.ts # 物业、租户、租约、单元类型
│ ├── dashboard/
│ │ ├── portfolio.ts # 投资组合概览
│ │ └── vacancy.ts # 空置率追踪
│ ├── sync/
│ │ └── incremental.ts # 增量数据同步
│ ├── webhooks/
│ │ └── handler.ts # Webhook 端点
│ └── server.ts
├── tests/
│ ├── mocks/ # 模拟 API 响应
│ └── unit/
└── package.json
资源