AppFolio 參考架構
架構
┌──────────────────────────────────────────────┐
│ 您的應用程式 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │儀表板 │ │同步 │ │Webhook │ │
│ │(React) │ │服務 │ │處理器 │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ AppFolio API 用戶端 │ │
│ │ (Basic Auth, 重試, 快取, 速率限制) │ │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ AppFolio Stack API │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
專案結構
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # 具備 Basic Auth 的型別化 REST 用戶端
│ │ ├── cache.ts # 具備 TTL 的回應快取
│ │ └── types.ts # 屬性、租戶、租約、單位型別
│ ├── dashboard/
│ │ ├── portfolio.ts # 投資組合摘要
│ │ └── vacancy.ts # 空置率追蹤
│ ├── sync/
│ │ └── incremental.ts # 增量資料同步
│ ├── webhooks/
│ │ └── handler.ts # Webhook 端點
│ └── server.ts
├── tests/
│ ├── mocks/ # Mock API 回應
│ └── unit/
└── package.json
資源