AppFolio リファレンスアーキテクチャ
アーキテクチャ
┌──────────────────────────────────────────────┐
│ Your Application │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │ダッシュボード│ │同期 │ │Webhook │ │
│ │(React) │ │サービス │ │ハンドラ │ │
│ └────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌────▼──────────────▼───────────────▼──────┐ │
│ │ AppFolio API クライアント │ │
│ │ (Basic Auth, リトライ, キャッシュ, レート制限) │
│ └────────────────────┬─────────────────────┘ │
└───────────────────────┼───────────────────────┘
│
┌─────────▼──────────┐
│ AppFolio Stack API │
│ /properties │
│ /tenants │
│ /leases │
│ /units │
│ /bills │
└────────────────────┘
プロジェクト構造
appfolio-integration/
├── src/
│ ├── appfolio/
│ │ ├── client.ts # Basic 認証を備えた型付き REST クライアント
│ │ ├── cache.ts # TTL 付きレスポンスキャッシュ
│ │ └── types.ts # Property、Tenant、Lease、Unit の型定義
│ ├── dashboard/
│ │ ├── portfolio.ts # ポートフォリオサマリー
│ │ └── vacancy.ts # 空室トラッキング
│ ├── sync/
│ │ └── incremental.ts # インクリメンタルデータ同期
│ ├── webhooks/
│ │ └── handler.ts # Webhook エンドポイント
│ └── server.ts
├── tests/
│ ├── mocks/ # モック API レスポンス
│ └── unit/
└── package.json
リソース